Update Mar 1st

.dockerignore

@@ -1,12 +1,13 @@
-# Dependencies
+# Dependencies (reinstalled inside container)
 node_modules
 .pnp
 .pnp.js
 
-# Build output
+# Build output (rebuilt inside container)
 .next
 out
 build
+dist
 
 # Generated assets (created by postinstall from node_modules)
 public/vad
@@ -24,24 +25,41 @@ __tests__
 *.spec.tsx
 jest.config.js
 jest.babel.config.cjs
+playwright.config.*
+playwright-report
 
+# Env files
 .env
-.env*.local
+.env.*
 
-# IDE and misc
+# IDE and editor
 .DS_Store
 .idea
+.vscode
+*.swp
+*.swo
+
+# Docs (not needed in image)
 *.md
 !README.md
 
 # Vercel
 .vercel
 
-# Debug
+# Debug logs
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
 .pnpm-debug.log*
 
-# TypeScript
+# TypeScript incremental
 *.tsbuildinfo
+
+# Sidecar (has its own build context)
+sidecar
+
+# Docker files (don't copy into context recursively)
+docker-compose*.yml
+Dockerfile
+.dockerignore
+start-database.sh

.gitignore

@@ -46,3 +46,6 @@ yarn-error.log*
 .idea
 /.localFiles
 .windsurf/rules/markdowncreation.md
+
+# kiro
+.kiro

Dockerfile

@@ -1,56 +1,55 @@
-# Installing dependencies
-FROM node:20-alpine AS deps
-RUN npm install -g pnpm@10.15.1
+# syntax=docker/dockerfile:1
+
+# ── Base: shared Alpine + corepack-managed pnpm ──────────────────────
+FROM node:20-alpine AS base
+ENV PNPM_HOME="/pnpm"
+ENV PATH="$PNPM_HOME:$PATH"
+RUN corepack enable && corepack prepare pnpm@10.15.1 --activate
 WORKDIR /app
 
+# ── Dependencies ─────────────────────────────────────────────────────
+FROM base AS deps
 COPY package.json pnpm-lock.yaml ./
-# scripts currently only include vad-web assets. 
-COPY scripts ./scripts 
-RUN pnpm install --frozen-lockfile
-
-# Builder
-FROM node:20-alpine AS builder
-RUN npm install -g pnpm@10.15.1
-WORKDIR /app
+COPY scripts ./scripts
+RUN --mount=type=cache,id=pnpm,target=/pnpm/store \
+    pnpm install --frozen-lockfile
 
+# ── Builder ──────────────────────────────────────────────────────────
+FROM base AS builder
 COPY --from=deps /app/node_modules ./node_modules
 COPY . .
-# public/vad is excluded from context; copy from deps (created by postinstall)
 COPY --from=deps /app/public/vad ./public/vad
 
-# Build env validation runs at import time; skip during Docker build
 ENV SKIP_ENV_VALIDATION=1
 ENV NEXT_TELEMETRY_DISABLED=1
 
-# Build args from docker-compose (passed via --env-file .env)
 ARG NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY
 ARG OPENAI_API_KEY
 ENV NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=${NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY}
 ENV OPENAI_API_KEY=${OPENAI_API_KEY}
 
 RUN pnpm build
 
-# Schema sync
-FROM node:20-alpine AS migrate
-RUN npm install -g pnpm@10.15.1
-WORKDIR /app
-COPY --from=builder /app/package.json ./package.json
-COPY --from=builder /app/pnpm-lock.yaml ./pnpm-lock.yaml
-RUN pnpm install --frozen-lockfile --ignore-scripts
+# ── Schema sync (migrate) ───────────────────────────────────────────
+# Reuses node_modules from deps instead of running a second install
+FROM base AS migrate
+COPY --from=deps /app/node_modules ./node_modules
+COPY --from=deps /app/package.json ./package.json
+COPY --from=deps /app/pnpm-lock.yaml ./pnpm-lock.yaml
 COPY --from=builder /app/drizzle.config.ts ./drizzle.config.ts
 COPY --from=builder /app/src ./src
 COPY --from=builder /app/scripts ./scripts
 
 CMD ["sh", "-c", "node scripts/ensure-pgvector.mjs && pnpm db:push"]
 
-# Runner
+# ── Runner ───────────────────────────────────────────────────────────
 FROM node:20-alpine AS runner
 WORKDIR /app
 
 ENV NEXT_TELEMETRY_DISABLED=1
 
-RUN addgroup --system --gid 1001 nodejs
-RUN adduser --system --uid 1001 nextjs
+RUN addgroup --system --gid 1001 nodejs && \
+    adduser --system --uid 1001 nextjs
 
 COPY --from=builder /app/public ./public
 COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./

README.md

@@ -2,7 +2,7 @@
 
 PDR AI is a Next.js platform for role-based document management, AI-assisted Q&A, and predictive document analysis. It combines document upload, optional OCR, embeddings, and retrieval to help teams find gaps and act faster.
 
-## ✨ Core Features
+## Core Features
 
 - Clerk-based Employer/Employee authentication with role-aware middleware.
 - Document upload pipeline with optional OCR for scanned PDFs.
@@ -11,7 +11,7 @@ PDR AI is a Next.js platform for role-based document management, AI-assisted Q&A
 - Optional web-enriched analysis with Tavily.
 - Optional reliability/observability via Inngest and LangSmith.
 
-## 🏗️ Architecture
+## Architecture
 
 PDR AI follows a three-layer modular architecture:
 
@@ -91,7 +91,7 @@ The platform is organized into:
 
 All services operate within domain-partitioned boundaries enforced by Clerk RBAC. RAG queries are scoped by `domain + company_id` to ensure data isolation.
 
-## 🛠 Tech Stack
+## Tech Stack
 
 - Next.js 15 + TypeScript
 - PostgreSQL + Drizzle ORM + pgvector
@@ -100,14 +100,14 @@ All services operate within domain-partitioned boundaries enforced by Clerk RBAC
 - UploadThing + optional OCR providers
 - Tailwind CSS
 
-## 📋 Prerequisites
+## Prerequisites
 
 - Node.js 18+
 - pnpm
 - Docker + Docker Compose (recommended for local DB/full stack)
 - Git
 
-## ⚡ Quick Start
+## Quick Start
 
 ### 1) Clone and install
 
@@ -146,13 +146,12 @@ pnpm db:push
 ### 4) Run app
 
 ```bash
-pnpm inngest:dev
 pnpm run dev
 ```
 
 Open `http://localhost:3000`.
 
-## 🐳 Docker Deployment Methods
+## Docker Deployment Methods
 
 ### Method 1: Full stack (recommended)
 
@@ -191,34 +190,34 @@ pnpm dev
 
 For host DB tools, use `localhost:5433`.
 
-## 🧩 How Docker Supports Platform Features
+## How Docker Supports Platform Features
 
 - `app` service runs auth, upload, OCR integration, RAG chat, and predictive analysis.
 - `db` service provides pgvector-backed storage/retrieval for embeddings.
 - `migrate` service ensures schema readiness before app startup.
 - Optional providers (Inngest, Tavily, OCR, LangSmith) are enabled by env vars in the same runtime.
 
-## 📚 Documentation
+## Documentation
 
 - Deployment details (Docker, Vercel, VPS): [docs/deployment.md](docs/deployment.md)
 - Feature workflows and architecture: [docs/feature-workflows.md](docs/feature-workflow.md)
 - Usage and API examples: [docs/usage-examples.md](docs/usage-examples.md)
 - Observability and metrics: [docs/observability.md](docs/observability.md)
 - **Manual testing (dev, post-PR):** [docs/manual-testing-guide.md](docs/manual-testing-guide.md)
 
-## 🔌 API Endpoints (high-level)
+## API Endpoints (high-level)
 
 - `POST /api/uploadDocument` - upload and process document (OCR optional)
 - `POST /api/LangChain` - document-grounded Q&A
 - `POST /api/agents/predictive-document-analysis` - detect gaps and recommendations
 - `GET /api/metrics` - Prometheus metrics stream
 
-## 🔐 User Roles
+## User Roles
 
 - **Employee**: view assigned documents, use AI chat/analysis.
 - **Employer**: upload/manage documents, categories, and employee access.
 
-## 🧪 Useful Scripts
+## Useful Scripts
 
 ```bash
 pnpm db:studio
@@ -230,14 +229,14 @@ pnpm build
 pnpm start
 ```
 
-## 🐛 Troubleshooting
+## Troubleshooting
 
 - Confirm Docker is running before DB startup.
 - If build issues occur: remove `.next` and reinstall dependencies.
 - If OCR UI is missing: verify OCR provider keys are configured.
 - If Docker image pull/build is corrupted: remove image and rebuild with `--no-cache`.
 
-## 🤝 Contributing
+## Contributing
 
 1. Create a feature branch.
 2. Make changes and run `pnpm check`.