feat(lab-01): implement standalone Lab 01 compose + test script

- Replace  stub compose with complete multi-service stack
- Add proper healthchecks, named volumes, and container conventions
- Implement functional Phase 3 tests with real endpoint validation
- Add cleanup() trap for reliable teardown (NO_CLEANUP=1 support)
- Fix CI lab-01-smoke: reference correct module-numbered test script

Author: RedjiJB

.github/workflows/ci.yml

@@ -102,7 +102,7 @@ jobs:
           docker compose -f docker/docker-compose.standalone.yml ps
 
       - name: Run Lab 01 test script
-        run: bash tests/labs/test-lab-01.sh
+run: bash tests/labs/test-lab-16-01.sh
 
       - name: Collect logs on failure
         if: failure()

docker/docker-compose.standalone.yml

@@ -1,29 +1,71 @@
-# Lab 01 — Standalone: Complete Snipe-IT IT asset management in isolation
-# No external dependencies required.
+# Lab 01 — Standalone: Snipe-IT IT asset management in isolation
+# Uses MariaDB as local database — no external dependencies required.
 ---
+name: it-stack-snipeit-lab01
+
 services:
-  snipeit:
+
+  snipeit-s01-db:
+    image: mariadb:10.11
+    container_name: snipeit-s01-db
+    restart: unless-stopped
+    environment:
+      MARIADB_ROOT_PASSWORD: root_lab_password
+      MARIADB_DATABASE: snipeit
+      MARIADB_USER: snipeit
+      MARIADB_PASSWORD: snipeit_lab_password
+    volumes:
+      - snipeit-s01-db-data:/var/lib/mysql
+    healthcheck:
+      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
+      interval: 15s
+      timeout: 10s
+      retries: 6
+      start_period: 60s
+    networks:
+      - snipeit-s01-net
+
+  snipeit-s01-app:
     image: snipe/snipe-it:latest
-    container_name: it-stack-snipeit
+    container_name: snipeit-s01-app
     restart: unless-stopped
-    ports:
-      - "80:$firstPort"
+    depends_on:
+      snipeit-s01-db:
+        condition: service_healthy
     environment:
-      - IT_STACK_ENV=lab-01-standalone
+      APP_ENV: local
+      APP_DEBUG: "false"
+      APP_KEY: "base64:3HLPbBKd9G4zWPKnQLxh4OTCKNWCGbSZFGbpfbpHPqk="
+      APP_URL: "http://localhost:8401"
+      DB_CONNECTION: mysql
+      DB_HOST: snipeit-s01-db
+      DB_PORT: 3306
+      DB_DATABASE: snipeit
+      DB_USERNAME: snipeit
+      DB_PASSWORD: snipeit_lab_password
+      DB_PREFIX: ""
+      MAIL_DRIVER: log
+      MAIL_PORT: 1025
+      MAIL_ENCRYPTION: "null"
+      SESSION_DRIVER: file
+      CACHE_DRIVER: file
+    ports:
+      - "8401:80"
     volumes:
-      - snipeit_data:/var/lib/snipeit
+      - snipeit-s01-data:/var/lib/snipeit
     healthcheck:
       test: ["CMD-SHELL", "curl -sf http://localhost/health || exit 1"]
       interval: 30s
-      timeout: 10s
-      retries: 5
-      start_period: 60s
+      timeout: 15s
+      retries: 8
+      start_period: 120s
     networks:
-      - it-stack-net
+      - snipeit-s01-net
 
 networks:
-  it-stack-net:
+  snipeit-s01-net:
     driver: bridge
 
 volumes:
-  snipeit_data:
+  snipeit-s01-db-data:
+  snipeit-s01-data:

tests/labs/test-lab-16-01.sh

@@ -26,38 +26,69 @@ echo -e "${CYAN} Module: ${MODULE}${NC}"
 echo -e "${CYAN}======================================${NC}"
 echo ""
 
+SNIPEIT_URL="http://localhost:8401"
+NO_CLEANUP=${NO_CLEANUP:-0}
+
+cleanup() {
+    if [ "${NO_CLEANUP}" = "1" ]; then
+        info "NO_CLEANUP=1 — skipping teardown"
+    else
+        info "Phase 4: Cleanup"
+        docker compose -f "${COMPOSE_FILE}" down -v --remove-orphans 2>/dev/null || true
+        info "Cleanup complete"
+    fi
+}
+trap cleanup EXIT
+
+section() { echo -e "\n${CYAN}## $1${NC}"; }
+
 # ── PHASE 1: Setup ────────────────────────────────────────────────────────────
-info "Phase 1: Setup"
+section "Phase 1: Setup"
 docker compose -f "${COMPOSE_FILE}" up -d
-info "Waiting 30s for ${MODULE} to initialize..."
-sleep 30
+info "Waiting 120s for Snipe-IT to initialize (MariaDB + Laravel seed)..."
+sleep 120
 
 # ── PHASE 2: Health Checks ────────────────────────────────────────────────────
-info "Phase 2: Health Checks"
+section "Phase 2: Health Checks"
+
+if docker compose -f "${COMPOSE_FILE}" ps snipeit-s01-db 2>/dev/null | grep -q 'Up\|running'; then
+    pass "2.1 MariaDB (snipeit-s01-db) is up"
+else
+    fail "2.1 MariaDB is not running"
+fi
 
-if docker compose -f "${COMPOSE_FILE}" ps | grep -q "running\|Up"; then
-    pass "Container is running"
+if docker compose -f "${COMPOSE_FILE}" ps snipeit-s01-app 2>/dev/null | grep -q 'Up\|running'; then
+    pass "2.2 Snipe-IT app (snipeit-s01-app) is up"
 else
-    fail "Container is not running"
+    fail "2.2 Snipe-IT app is not running"
 fi
 
 # ── PHASE 3: Functional Tests ─────────────────────────────────────────────────
-info "Phase 3: Functional Tests (Lab 01 — Standalone)"
-
-# TODO: Add module-specific functional tests here
-# Example:
-# if curl -sf http://localhost:80/health > /dev/null 2>&1; then
-#     pass "Health endpoint responds"
-# else
-#     fail "Health endpoint not reachable"
-# fi
-
-warn "Functional tests for Lab 16-01 pending implementation"
-
-# ── PHASE 4: Cleanup ──────────────────────────────────────────────────────────
-info "Phase 4: Cleanup"
-docker compose -f "${COMPOSE_FILE}" down -v --remove-orphans
-info "Cleanup complete"
+section "Phase 3: Functional Tests"
+
+# 3.1 Root URL responds
+HTTP_CODE=$(curl -o /dev/null -sw '%{http_code}' -L "${SNIPEIT_URL}/" 2>/dev/null || echo 000)
+if echo "${HTTP_CODE}" | grep -q '^[23]'; then
+    pass "3.1 Snipe-IT web UI accessible (HTTP ${HTTP_CODE})"
+else
+    fail "3.1 Snipe-IT web UI not accessible (HTTP ${HTTP_CODE})"
+fi
+
+# 3.2 Response contains recognizable Snipe-IT content
+RESPONSE=$(curl -sfL "${SNIPEIT_URL}/" 2>/dev/null || echo '')
+if echo "${RESPONSE}" | grep -qi 'snipe\|laravel\|login\|asset'; then
+    pass "3.2 Response contains Snipe-IT application content"
+else
+    warn "3.2 Could not confirm Snipe-IT content in response (app may still be starting)"
+fi
+
+# 3.3 Health endpoint
+HTTP_HEALTH=$(curl -o /dev/null -sw '%{http_code}' "${SNIPEIT_URL}/health" 2>/dev/null || echo 000)
+if echo "${HTTP_HEALTH}" | grep -q '^[23]'; then
+    pass "3.3 Health endpoint responds (HTTP ${HTTP_HEALTH})"
+else
+    warn "3.3 Health endpoint not available (HTTP ${HTTP_HEALTH}) — may not be implemented"
+fi
 
 # ── Results ───────────────────────────────────────────────────────────────────
 echo ""