Epic/phase 2

.copilotignore

@@ -0,0 +1,2 @@
+AI_RULES.md
+README.md

.github/copilot-instructions.md

@@ -0,0 +1,5 @@
+- Role: Senior Backend Engineer (Node.js, TypeScript, PostgreSQL, Redis, Prisma)
+- Package Manager: Strict pnpm usage only. Never suggest npm or yarn.
+- TypeScript: Strict typing. Banned keyword: any. Explicit return types required.
+- Formatting: Professional English comments only. Strictly zero emojis across codebase and logs.
+- Logging: Pino logger only via src/utils/logger.js. Zero console.log.

PROJECT_CONTEXT.md

@@ -115,9 +115,9 @@ distributed-ticket-engine-redis/
   * **Objective:** Implement a native Redis `ZSET` Sliding Window Log Rate Limiter middleware to drop abusive traffic at the API edge.
   * **Target Deliverables:** `src/middlewares/rateLimiter.ts`, `src/scripts/lua/sliding_window.lua`, `src/config/redis.config.ts`.
 
-- [ ] **Phase 2: Database Protection & Stampede Shield** `[STATUS: IN_PROGRESS]`
+- [x] **Phase 2: Database Protection & Stampede Shield** `[STATUS: COMPLETED]`
   * **Objective:** Build a Distributed Mutex Lock (`SET NX PX`) re-hydration guard to defend PostgreSQL against thundering herd spikes when 1M+ key caches expire.
-  * **Target Deliverables:** `src/services/stampede.service.ts`, production-tuned `redis.conf` LRU memory policies.
+  * **Completed Deliverables:** `src/services/stampede.service.ts`, `src/scripts/lua/release_mutex.lua`, `tests/concurrency/stampede.concurrency.test.ts`, production-tuned `redis.conf` eviction policy, and seating-map API wiring.
 
 - [ ] **Phase 3: Atomic Concurrency & Race Condition Elimination** `[STATUS: NOT_STARTED]`
   * **Objective:** Eliminate double-booking by executing check-and-hold seat locks inside atomic C-like Redis Lua scripts (`atomic_seat_lock.lua`).
@@ -143,12 +143,12 @@ distributed-ticket-engine-redis/
 
 ## 🎯 Current Active Milestone Focus
 
-**Active Milestone:** **Phase 2 — Database Protection & Cache Stampede Shield**
+**Completed Milestone:** **Phase 2 — Database Protection & Cache Stampede Shield**
 * **Active Tasks:**
-  1. Implement a distributed mutex using Redis `SET NX PX`.
-  2. Build cache-aside seating-map re-hydration around the mutex.
-  3. Configure cache TTL and production Redis eviction policy.
-  4. Add stampede protection tests for concurrent cache misses.
+  1. Implemented a distributed mutex using Redis `SET NX PX`.
+  2. Implemented cache-aside seating-map re-hydration around the mutex.
+  3. Configured cache TTL and production Redis eviction policy.
+  4. Added stampede protection tests for concurrent cache misses.
 
 ---
 

docker-compose.yml

@@ -1,10 +1,23 @@
 services:
+  app:
+    build: .
+    container_name: ticket_engine_app
+    restart: always
+    ports:
+      - "5000:5000"
+    env_file:
+      - .env
+    environment:
+      DATABASE_URL: postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@postgres:5432/${POSTGRES_DB}
+      REDIS_URL: redis://redis:6379
+    depends_on:
+      - postgres
+      - redis
+
   redis:
     image: redis:alpine
     container_name: ticket_engine_redis
     restart: always
-    ports:
-      - "6379:6379"
     volumes:
       - redis_data:/data
 
@@ -13,11 +26,9 @@ services:
     container_name: ticket_engine_postgres
     restart: always
     environment:
-      POSTGRES_USER: postgres
-      POSTGRES_PASSWORD: postgres123
-      POSTGRES_DB: ticket-engine-redis-db
-    ports:
-      - "5432:5432"
+      POSTGRES_USER: ${POSTGRES_USER}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
+      POSTGRES_DB: ${POSTGRES_DB}
     volumes:
       - postgres_data:/var/lib/postgresql/data
 

package.json

@@ -41,6 +41,7 @@
     "zod": "^4.5.4"
   },
   "devDependencies": {
+    "@jest/globals": "^30.5.1",
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.6",
     "@types/jest": "^30.0.0",