Initial commit

civic-platform/.env.example

@@ -0,0 +1,6 @@
+NEXT_PUBLIC_API_BASE_URL=http://localhost:4000/api
+
+# Optional. If set, the public map uses Mapbox streets tiles.
+# Leave blank to use free OpenStreetMap tiles.
+MAPBOX_TOKEN=
+NEXT_PUBLIC_MAPBOX_TOKEN=

civic-platform/.gitignore

@@ -0,0 +1,7 @@
+node_modules/
+.next/
+dist/
+.env
+.env.local
+backend/.env
+backend/dist/

civic-platform/README.md

@@ -0,0 +1,119 @@
+# Civic Platform
+
+A mobile-first civic issue reporting and resolution platform for day-to-day public problems and emergency incidents.
+
+## Vision
+
+Citizens report issues with photo, video, voice, text, and geo-location. The system classifies the complaint, assigns priority, routes it to the correct government department, and tracks the full lifecycle from submission to closure.
+
+## Core goals
+
+- Make complaint reporting simple and fast
+- Support day-to-day civic domains and emergency domains
+- Route complaints to the correct department with priority
+- Provide transparent status tracking to citizens
+- Give officials a fast dashboard for triage, assignment, and monitoring
+- Keep the system scalable, low-latency, and future-ready
+
+## Main domains
+
+1. Roads and Transportation
+2. Sanitation and Waste Management
+3. Water Supply, Sewerage, and Drainage
+4. Street Lighting and Electrical Infrastructure
+5. Public Infrastructure and Amenities
+6. Environment and Public Health
+
+## Emergency domains
+
+1. Fire Emergencies
+2. Flood and Water Disaster
+3. Structural and Infrastructure Hazard
+4. Electrical Hazard
+5. Disaster and Rescue
+
+## Complaint lifecycle
+
+1. Draft
+2. Submitted
+3. Validated
+4. Classified
+5. Prioritized
+6. Assigned
+7. Accepted
+8. In Progress
+9. Resolved
+10. Citizen Verified
+11. Closed
+
+Additional states:
+
+- Escalated
+- Reopened
+- Duplicate
+- Rejected
+- On Hold
+
+## Proposed stack
+
+### Frontend
+
+- Next.js
+- TypeScript
+- Tailwind CSS
+- shadcn/ui
+- Framer Motion
+- Leaflet with OpenStreetMap
+
+### Platform
+
+- Supabase Auth
+- Supabase Postgres
+- PostGIS
+- Supabase Storage
+- Supabase Realtime
+- Supabase Edge Functions
+
+### AI
+
+- Whisper for speech-to-text
+- DistilBERT or similar lightweight text classifier
+- YOLOv8n or MobileNet for image classification
+
+## App areas
+
+- Citizen portal
+- Department dashboard
+- Field officer workspace
+- Super admin configuration
+- Analytics and SLA dashboard
+
+## Folder plan
+
+- `app/` Next.js App Router pages
+- `components/` shared UI sections
+- `lib/` config, types, and helpers
+- `data/` static seed content used by the frontend
+- `docs/` architecture, lifecycle, and page planning
+
+## Planning docs
+
+- `docs/PROJECT_BLUEPRINT.md`
+- `docs/FRONTEND_PLAN.md`
+- `docs/PAGE_MAP.md`
+- `docs/ROLES_AND_PERMISSIONS.md`
+- `docs/COMPLAINT_LIFECYCLE.md`
+- `docs/DOMAIN_ROUTING_MAP.md`
+- `docs/PRIORITY_SCORING.md`
+- `docs/DATABASE_SCHEMA.md`
+- `docs/BACKEND_STRUCTURE.md`
+- `docs/LOCAL_DATABASE_SETUP.md`
+
+## Next build steps
+
+1. Finalize data model and routing rules
+2. Build the design system and page structure
+3. Implement citizen report flow
+4. Add admin dashboard and complaint lifecycle updates
+5. Connect Supabase auth, database, storage, and realtime
+6. Add AI-assisted classification after the MVP workflow is stable

civic-platform/ai/README.md

@@ -0,0 +1,15 @@
+# CivicPulse AI Workspace
+
+This folder is reserved for model training assets, dataset schemas, experiments, and evaluation results.
+
+Recommended subfolders:
+
+- `datasets/text`
+- `datasets/vision`
+- `datasets/audio`
+- `evals`
+- `notebooks`
+- `schemas`
+
+The live product currently uses an assistive heuristic AI layer in the application code. This workspace is where model-backed training and evaluation can be added next.
+

civic-platform/ai/schemas/civic-image-record.example.json

@@ -0,0 +1,11 @@
+{
+  "image": "path-or-huggingface-image-object",
+  "label": "Roads and Transportation",
+  "metadata": {
+    "complaintCode": "CP-2026-000001",
+    "source": "citizen_upload",
+    "city": "Hyderabad",
+    "latitude": 17.385,
+    "longitude": 78.4867
+  }
+}

civic-platform/ai/schemas/complaint-text-record.example.json

@@ -0,0 +1,12 @@
+{
+  "title": "Streetlight not working near school gate",
+  "description": "Two streetlights are off near the main gate and the road is dark at night.",
+  "address_line": "School Road",
+  "landmark": "Near Government High School",
+  "city_name": "Sample City",
+  "state_name": "Sample State",
+  "domain": "Street Lighting and Electrical Infrastructure",
+  "sub_problem": "Broken streetlight",
+  "priority": "P2",
+  "is_emergency": false
+}

civic-platform/ai/training/README.md

@@ -0,0 +1,73 @@
+# CivicPulse Vision Training Plan
+
+The current app has a safe baseline for image evidence:
+
+- It extracts GPS metadata from JPEG photos when available.
+- It uses address search, GPS, or map pinning when photo GPS metadata is missing.
+- It passes lightweight visual signals into the AI assistant when filenames contain civic issue hints.
+
+For accurate image classification, train a real model on labeled civic images. A perfect model is not realistic, but a good production model is achievable with enough labeled examples and evaluation.
+
+## Recommended Labels
+
+Use the same project domains as labels:
+
+- Roads and Transportation
+- Sanitation and Waste Management
+- Water Supply, Sewerage, and Drainage
+- Street Lighting and Electrical Infrastructure
+- Public Infrastructure and Amenities
+- Environment and Public Health
+- Fire Emergencies
+- Flood and Water Disaster
+- Structural and Infrastructure Hazard
+- Electrical Hazard
+- Disaster and Rescue
+
+## Dataset Format
+
+For Hugging Face image classification, publish a dataset with:
+
+- `image`: image column
+- `label`: one of the labels above
+
+Example record:
+
+[civic-image-record.example.json](/C:/Users/Praveen/Documents/New%20project/civic-platform/ai/schemas/civic-image-record.example.json)
+
+## Training Recommendation
+
+Start with image classification:
+
+- Model: `timm/mobilenetv3_small_100.lamb_in1k` for fast iteration
+- Upgrade: `timm/resnet50.a1_in1k` or `timm/vit_base_patch16_dinov3.lvd1689m` for better accuracy
+- Target metric: validation accuracy and per-class recall
+- Minimum data target: 300 to 500 images per label for a useful first model
+- Better data target: 1,000+ images per label with different lighting, angles, weather, and phones
+
+For localization such as detecting a pothole box inside the image, move to object detection later with D-FINE or RT-DETR.
+
+## Deployment Path
+
+1. Collect and label civic images from real reports.
+2. Upload the dataset to Hugging Face Hub.
+3. Validate the dataset format before training.
+4. Fine-tune an image classifier using Hugging Face Jobs.
+5. Push the trained model to the Hub.
+6. Add a backend inference endpoint that calls the trained model and returns:
+   - predicted domain
+   - confidence
+   - top 3 alternatives
+   - model version
+7. Keep the operator override flow because image models can be wrong.
+
+## Important Note
+
+Do not rely only on image classification. The best production result should combine:
+
+- image prediction
+- text/voice description
+- issue domain chosen by the citizen
+- geo-location and ward
+- nearby duplicate complaints
+- operator override

civic-platform/ai/training/civic-image-labels.md

@@ -0,0 +1,19 @@
+# CivicPulse Image Labels
+
+Use these labels for the first image classification dataset.
+
+| Label | Example visual cases |
+|---|---|
+| Roads and Transportation | potholes, broken roads, road blockage, damaged footpath, damaged divider |
+| Sanitation and Waste Management | garbage piles, overflowing bins, illegal dumping, dirty streets |
+| Water Supply, Sewerage, and Drainage | water leakage, sewage overflow, clogged drains, waterlogging |
+| Street Lighting and Electrical Infrastructure | broken streetlights, damaged poles, exposed wires, transformer issues |
+| Public Infrastructure and Amenities | open manholes, broken bus stops, damaged public toilets, park damage |
+| Environment and Public Health | fallen trees, stagnant water, smoke, dead animals, mosquito breeding areas |
+| Fire Emergencies | visible fire, heavy smoke, burning debris |
+| Flood and Water Disaster | floodwater, severe rain overflow, storm damage |
+| Structural and Infrastructure Hazard | wall cracks, building collapse signs, bridge damage |
+| Electrical Hazard | live wires, transformer blast, major short circuit evidence |
+| Disaster and Rescue | landslide, storm collapse, road-blocking tree fall, rescue hazard |
+
+Labeling rule: if one image contains multiple issues, choose the most urgent visible issue and store secondary labels in metadata for future multi-label training.

civic-platform/app/api/session/login/route.ts

@@ -0,0 +1,77 @@
+import { cookies } from "next/headers";
+import { NextRequest, NextResponse } from "next/server";
+import bcrypt from "bcryptjs";
+import pool from "@/lib/db";
+import { encodeSession, SESSION_COOKIE_NAME, type SessionUser } from "@/lib/session";
+
+type UserRow = SessionUser & { passwordHash: string | null };
+
+export async function POST(request: NextRequest) {
+  try {
+    const body = (await request.json()) as { email?: string; password?: string };
+    const email = body.email?.trim().toLowerCase() ?? "";
+    const password = body.password ?? "";
+
+    if (!email) {
+      return NextResponse.json({ error: "Email is required" }, { status: 400 });
+    }
+    if (!password) {
+      return NextResponse.json({ error: "Password is required" }, { status: 400 });
+    }
+
+    // Query users table joined with roles
+    const result = await pool.query<UserRow>(
+      `SELECT
+         u.id,
+         u.full_name   AS "fullName",
+         u.email,
+         r.name        AS role,
+         u.department_id AS "departmentId",
+         u.ward_id     AS "wardId",
+         u.password_hash AS "passwordHash"
+       FROM users u
+       INNER JOIN roles r ON r.id = u.role_id
+       WHERE lower(u.email) = $1
+         AND u.is_active = TRUE
+       LIMIT 1`,
+      [email],
+    );
+
+    const user = result.rows[0] ?? null;
+
+    if (!user) {
+      return NextResponse.json({ error: "Invalid email or password" }, { status: 401 });
+    }
+
+    // Support both real bcrypt hashes AND the dev-placeholder-hash used in seed data
+    let passwordValid = false;
+    if (user.passwordHash === "dev-placeholder-hash" && password === "civicpulse123") {
+      passwordValid = true;
+    } else if (user.passwordHash) {
+      passwordValid = await bcrypt.compare(password, user.passwordHash);
+    }
+
+    if (!passwordValid) {
+      return NextResponse.json({ error: "Invalid email or password" }, { status: 401 });
+    }
+
+    const { passwordHash: _ph, ...sessionUser } = user;
+    const cookieStore = await cookies();
+
+    cookieStore.set(SESSION_COOKIE_NAME, encodeSession(sessionUser), {
+      httpOnly: true,
+      sameSite: "lax",
+      path: "/",
+      secure: process.env.NODE_ENV === "production",
+      maxAge: 60 * 60 * 12,
+    });
+
+    return NextResponse.json({ data: sessionUser });
+  } catch (error) {
+    console.error("[login] Error:", error);
+    return NextResponse.json(
+      { error: error instanceof Error ? error.message : "Login failed" },
+      { status: 500 },
+    );
+  }
+}

civic-platform/app/api/session/logout/route.ts

@@ -0,0 +1,10 @@
+import { cookies } from "next/headers";
+import { NextResponse } from "next/server";
+import { SESSION_COOKIE_NAME } from "@/lib/session";
+
+export async function POST() {
+  const cookieStore = await cookies();
+  cookieStore.delete(SESSION_COOKIE_NAME);
+
+  return NextResponse.json({ data: { ok: true } });
+}

civic-platform/app/api/session/register/route.ts

@@ -0,0 +1,83 @@
+import { cookies } from "next/headers";
+import { NextRequest, NextResponse } from "next/server";
+import bcrypt from "bcryptjs";
+import pool from "@/lib/db";
+import { encodeSession, SESSION_COOKIE_NAME, type SessionUser } from "@/lib/session";
+
+type UserRow = SessionUser & { passwordHash: string | null };
+
+export async function POST(request: NextRequest) {
+  try {
+    const body = (await request.json()) as {
+      fullName?: string;
+      email?: string;
+      phone?: string;
+      password?: string;
+    };
+
+    const fullName = body.fullName?.trim() ?? "";
+    const email = body.email?.trim().toLowerCase() ?? "";
+    const phone = body.phone?.trim() || null;
+    const password = body.password ?? "";
+
+    // Validation
+    if (!fullName) {
+      return NextResponse.json({ error: "Full name is required" }, { status: 400 });
+    }
+    if (!email) {
+      return NextResponse.json({ error: "Email is required" }, { status: 400 });
+    }
+    if (!password || password.length < 8) {
+      return NextResponse.json({ error: "Password must be at least 8 characters" }, { status: 400 });
+    }
+
+    // Check if email already exists
+    const existing = await pool.query("SELECT id FROM users WHERE lower(email) = $1", [email]);
+    if (existing.rows.length > 0) {
+      return NextResponse.json({ error: "An account already exists for this email" }, { status: 409 });
+    }
+
+    // Hash password
+    const passwordHash = await bcrypt.hash(password, 12);
+
+    // Look up citizen role ID
+    const roleResult = await pool.query("SELECT id FROM roles WHERE name = 'citizen' LIMIT 1");
+    const roleId = roleResult.rows[0]?.id;
+    if (!roleId) {
+      return NextResponse.json({ error: "Citizen role is not configured in the database" }, { status: 500 });
+    }
+
+    // Insert new user
+    const insertResult = await pool.query<UserRow>(
+      `INSERT INTO users (full_name, email, phone, password_hash, role_id)
+       VALUES ($1, $2, $3, $4, $5)
+       RETURNING
+         id,
+         full_name   AS "fullName",
+         email,
+         'citizen'   AS role,
+         department_id AS "departmentId",
+         ward_id     AS "wardId",
+         password_hash AS "passwordHash"`,
+      [fullName, email, phone, passwordHash, roleId],
+    );
+
+    const user = insertResult.rows[0];
+    const { passwordHash: _ph, ...sessionUser } = user;
+
+    const cookieStore = await cookies();
+    cookieStore.set(SESSION_COOKIE_NAME, encodeSession(sessionUser), {
+      httpOnly: true,
+      sameSite: "lax",
+      path: "/",
+      secure: process.env.NODE_ENV === "production",
+      maxAge: 60 * 60 * 12,
+    });
+
+    return NextResponse.json({ data: sessionUser }, { status: 201 });
+  } catch (error) {
+    console.error("[register] Error:", error);
+    const message = error instanceof Error ? error.message : "Registration failed";
+    return NextResponse.json({ error: message }, { status: 500 });
+  }
+}

civic-platform/app/complaints/[id]/page.tsx

@@ -0,0 +1,264 @@
+import Link from "next/link";
+import { AlertTriangle, Clock3, MapPinned, ShieldCheck, Waves } from "lucide-react";
+import { AppShell } from "@/components/app-shell";
+import { CitizenFollowUpPanel } from "@/components/citizen-follow-up-panel";
+import { ComplaintMediaGallery } from "@/components/complaint-media-gallery";
+import { SectionHeader } from "@/components/section-header";
+import { requireRole } from "@/lib/auth";
+import {
+  getComplaintDetail,
+  getComplaintFeedback,
+  getComplaintHistory,
+  getComplaintMedia,
+  type ComplaintFeedbackItem,
+  type ComplaintMediaItem,
+  type ComplaintStatusHistoryItem,
+} from "@/lib/api";
+
+type ComplaintDetailPageProps = {
+  params: Promise<{
+    id: string;
+  }>;
+};
+
+function formatStatus(status: string) {
+  return status
+    .split("_")
+    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+    .join(" ");
+}
+
+function formatPriority(priority: string) {
+  switch (priority) {
+    case "P1":
+      return "P1 Critical";
+    case "P2":
+      return "P2 High";
+    case "P3":
+      return "P3 Medium";
+    default:
+      return "P4 Low";
+  }
+}
+
+function formatDateTime(value: string) {
+  return new Date(value).toLocaleString();
+}
+
+function timelineTone(status: string) {
+  switch (status) {
+    case "submitted":
+      return "bg-civic-primary";
+    case "validated":
+      return "bg-civic-secondary";
+    case "classified":
+    case "prioritized":
+      return "bg-amber-500";
+    case "assigned":
+      return "bg-slate-800";
+    case "in_progress":
+      return "bg-emerald-600";
+    case "resolved":
+    case "closed":
+      return "bg-emerald-700";
+    case "reopened":
+    case "escalated":
+      return "bg-civic-danger";
+    default:
+      return "bg-slate-300";
+  }
+}
+
+export default async function ComplaintDetailPage({ params }: ComplaintDetailPageProps) {
+  await requireRole(["citizen"]);
+  const { id } = await params;
+
+  let complaintStatus = "In Progress";
+  let complaintPriority = "P2 High";
+  let complaintLocation = "Market Road, Ward 12";
+  let complaintDomain = "Water Supply, Sewerage, and Drainage";
+  let complaintDescription = "Overflow affecting entry and traffic movement near the market.";
+  let complaintCode = "CP-2026-00124";
+  let complaintDepartment = "Water and Sewerage";
+  let media: ComplaintMediaItem[] = [];
+  let feedback: ComplaintFeedbackItem[] = [];
+  let rawStatus = "in_progress";
+  let citizenId = "00000000-0000-0000-0000-000000000001";
+  let timeline: Array<{ title: string; time: string; note: string; tone: string }> = [
+    {
+      title: "Submitted",
+      time: "Pending",
+      note: "Complaint created by citizen with image, description, and geo-tagged location.",
+      tone: "bg-civic-primary",
+    },
+  ];
+
+  try {
+    const [complaint, history, mediaItems, feedbackItems] = await Promise.all([
+      getComplaintDetail(id),
+      getComplaintHistory(id),
+      getComplaintMedia(id),
+      getComplaintFeedback(id),
+    ]);
+
+    rawStatus = complaint.status;
+    complaintStatus = formatStatus(complaint.status);
+    complaintPriority = formatPriority(complaint.priorityLevel);
+    complaintLocation = complaint.addressLine ?? complaint.landmark ?? "Location pending";
+    complaintDomain = complaint.domainName ?? "Unclassified";
+    complaintDescription = complaint.description ?? complaintDescription;
+    complaintCode = complaint.complaintCode;
+    complaintDepartment = complaint.departmentName ?? complaintDepartment;
+    citizenId = complaint.citizenId;
+    media = mediaItems;
+    feedback = feedbackItems;
+
+    if (history.length > 0) {
+      timeline = history.map((entry: ComplaintStatusHistoryItem) => ({
+        title: formatStatus(entry.newStatus),
+        time: formatDateTime(entry.createdAt),
+        note: entry.changeReason ?? `Complaint moved to ${formatStatus(entry.newStatus)}.`,
+        tone: timelineTone(entry.newStatus),
+      }));
+    }
+  } catch {
+    // Keep fallback values for design flow when backend is unavailable.
+  }
+
+  return (
+    <AppShell>
+      <section className="grid gap-6 rounded-[2rem] bg-civic-primary px-6 py-8 text-white shadow-civic lg:grid-cols-[1.08fr_0.92fr] lg:px-8">
+        <div className="space-y-4">
+          <p className="text-sm font-semibold uppercase tracking-[0.22em] text-white/75">Complaint detail</p>
+          <h1 className="text-4xl font-semibold tracking-tight">Track your complaint in one place.</h1>
+          <p className="max-w-2xl text-sm leading-7 text-white/80">
+            Check the current status, department ownership, attached evidence, and any updates from the city team.
+          </p>
+        </div>
+
+        <div className="grid gap-4 sm:grid-cols-2">
+          {[
+            { label: "Complaint ID", value: complaintCode },
+            { label: "Current status", value: complaintStatus },
+            { label: "Priority", value: complaintPriority },
+            { label: "Assigned department", value: complaintDepartment },
+          ].map((card) => (
+            <div key={card.label} className="rounded-3xl border border-white/15 bg-white/10 p-5 backdrop-blur">
+              <p className="text-sm font-semibold uppercase tracking-[0.16em] text-white/75">{card.label}</p>
+              <p className="mt-3 text-xl font-semibold text-white">{card.value}</p>
+            </div>
+          ))}
+        </div>
+      </section>
+
+      <section className="grid gap-6 lg:grid-cols-[1.1fr_0.9fr]">
+        <section className="rounded-[2rem] border border-slate-200 bg-white p-6 shadow-sm sm:p-8">
+          <div className="flex flex-wrap items-start justify-between gap-4">
+            <div>
+              <p className="text-sm font-semibold uppercase tracking-[0.22em] text-civic-secondary">Timeline</p>
+              <h2 className="mt-2 text-2xl font-semibold text-civic-text">Status history</h2>
+            </div>
+            <div className="rounded-full bg-amber-50 px-4 py-2 text-sm font-semibold text-amber-800">
+              Current state: {complaintStatus}
+            </div>
+          </div>
+
+          <div className="mt-8 space-y-6">
+            {timeline.map((entry, index) => (
+              <div key={`${entry.title}-${entry.time}-${index}`} className="grid gap-4 md:grid-cols-[auto_1fr] md:gap-5">
+                <div className="flex items-start gap-4 md:flex-col md:items-center">
+                  <div className={["mt-1 h-4 w-4 rounded-full", entry.tone].join(" ")} />
+                  {index !== timeline.length - 1 ? <div className="hidden h-16 w-px bg-slate-200 md:block" /> : null}
+                </div>
+                <div className="rounded-3xl bg-slate-50 p-5">
+                  <div className="flex flex-wrap items-center justify-between gap-3">
+                    <h3 className="text-lg font-semibold text-civic-text">{entry.title}</h3>
+                    <div className="inline-flex items-center gap-2 rounded-full bg-white px-3 py-2 text-xs font-semibold text-slate-700">
+                      <Clock3 className="h-4 w-4" />
+                      {entry.time}
+                    </div>
+                  </div>
+                  <p className="mt-3 text-sm leading-6 text-civic-muted">{entry.note}</p>
+                </div>
+              </div>
+            ))}
+          </div>
+        </section>
+
+        <div className="space-y-6">
+          <section className="rounded-[2rem] border border-slate-200 bg-white p-6 shadow-sm">
+            <SectionHeader eyebrow="Location" icon={MapPinned} title="Complaint context" />
+
+            <div className="mt-5 space-y-3">
+              {[complaintLocation, `Domain: ${complaintDomain}`, complaintDescription].map((item) => (
+                <div key={item} className="rounded-2xl bg-slate-50 px-4 py-3 text-sm leading-6 text-civic-text">
+                  {item}
+                </div>
+              ))}
+            </div>
+          </section>
+
+          <ComplaintMediaGallery
+            items={media}
+            title="Photos, video, and audio"
+            emptyLabel="No evidence has been added to this complaint yet."
+          />
+
+          <CitizenFollowUpPanel complaintId={id} citizenId={citizenId} status={rawStatus} feedback={feedback} />
+        </div>
+      </section>
+
+      <section className="grid gap-6 lg:grid-cols-[0.95fr_1.05fr]">
+        <section className="rounded-[2rem] border border-emerald-200 bg-emerald-50 p-6 shadow-sm">
+          <div className="flex items-start gap-3">
+            <ShieldCheck className="mt-0.5 h-5 w-5 text-emerald-700" />
+            <div>
+              <h2 className="text-lg font-semibold text-emerald-950">What you can see here</h2>
+              <p className="mt-2 text-sm leading-6 text-emerald-900/85">
+                This page shows your complaint progress and public-safe updates without exposing internal staff notes.
+              </p>
+            </div>
+          </div>
+        </section>
+
+        <section className="rounded-[2rem] border border-amber-200 bg-amber-50 p-6 shadow-sm">
+          <div className="flex items-start gap-3">
+            <AlertTriangle className="mt-0.5 h-5 w-5 text-amber-700" />
+            <div>
+              <h2 className="text-lg font-semibold text-amber-950">Need more help?</h2>
+              <p className="mt-2 text-sm leading-6 text-amber-900/85">
+                If the issue is marked resolved but still exists, use the reopen option below so the team can review it again.
+              </p>
+            </div>
+          </div>
+        </section>
+      </section>
+
+      <section className="flex flex-wrap items-center justify-between gap-4 rounded-[2rem] border border-slate-200 bg-white p-6 shadow-sm">
+        <div className="space-y-2">
+          <p className="text-sm font-semibold uppercase tracking-[0.22em] text-civic-secondary">Quick actions</p>
+          <h2 className="text-2xl font-semibold text-civic-text">Keep track of this report or return to your list.</h2>
+          <p className="max-w-2xl text-sm leading-6 text-civic-muted">
+            You can go back to all complaints, stay on this page for updates, or report another issue if needed.
+          </p>
+        </div>
+
+        <div className="flex flex-wrap gap-3">
+          <Link
+            className="inline-flex rounded-full border border-slate-200 px-5 py-3 text-sm font-semibold text-slate-700 transition hover:border-civic-primary hover:text-civic-primary"
+            href="/complaints"
+          >
+            Back to complaints
+          </Link>
+          <Link
+            className="inline-flex items-center gap-2 rounded-full bg-slate-900 px-5 py-3 text-sm font-semibold text-white transition hover:-translate-y-0.5"
+            href="/report"
+          >
+            Report another issue
+            <Waves className="h-4 w-4" />
+          </Link>
+        </div>
+      </section>
+    </AppShell>
+  );
+}

civic-platform/app/complaints/page.tsx

@@ -0,0 +1,217 @@
+import Link from "next/link";
+import { Clock3, MapPinned, Search } from "lucide-react";
+import { AppShell } from "@/components/app-shell";
+import { PriorityBadge } from "@/components/priority-badge";
+import { StatusBadge } from "@/components/status-badge";
+import { getCitizenComplaints } from "@/lib/api";
+import { requireRole } from "@/lib/auth";
+
+const complaintStats = [
+  { label: "Active", value: "04" },
+  { label: "Resolved", value: "09" },
+  { label: "Reopened", value: "01" },
+];
+
+type ComplaintCard = {
+  id: string;
+  complaintCode?: string;
+  title: string;
+  domain: string;
+  status: string;
+  priority: string;
+  location: string;
+  updatedAt: string;
+};
+
+const fallbackComplaints: ComplaintCard[] = [
+  {
+    id: "CP-2026-00124",
+    complaintCode: "CP-2026-00124",
+    title: "Sewage overflow near market entrance",
+    domain: "Water Supply, Sewerage, and Drainage",
+    status: "In Progress",
+    priority: "P2 High",
+    location: "Market Road, Ward 12",
+    updatedAt: "Updated 1 hour ago",
+  },
+  {
+    id: "CP-2026-00108",
+    complaintCode: "CP-2026-00108",
+    title: "Streetlight not working on school road",
+    domain: "Street Lighting and Electrical Infrastructure",
+    status: "Assigned",
+    priority: "P3 Medium",
+    location: "School Street, Ward 8",
+    updatedAt: "Updated today",
+  },
+  {
+    id: "CP-2026-00097",
+    complaintCode: "CP-2026-00097",
+    title: "Overflowing garbage bin near bus stop",
+    domain: "Sanitation and Waste Management",
+    status: "Resolved",
+    priority: "P3 Medium",
+    location: "Central Bus Stop, Ward 3",
+    updatedAt: "Resolved yesterday",
+  },
+  {
+    id: "CP-2026-00091",
+    complaintCode: "CP-2026-00091",
+    title: "Open manhole beside community hall",
+    domain: "Public Infrastructure and Amenities",
+    status: "Reopened",
+    priority: "P1 Critical",
+    location: "Community Hall Lane, Ward 5",
+    updatedAt: "Reopened 3 hours ago",
+  },
+];
+
+const filters = ["All", "Active", "Resolved", "Reopened", "Emergency"];
+
+function formatStatus(status: string) {
+  return status
+    .split("_")
+    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+    .join(" ");
+}
+
+function formatPriority(priority: string) {
+  switch (priority) {
+    case "P1":
+      return "P1 Critical";
+    case "P2":
+      return "P2 High";
+    case "P3":
+      return "P3 Medium";
+    default:
+      return "P4 Low";
+  }
+}
+
+export default async function ComplaintsPage() {
+  const user = await requireRole(["citizen"]);
+  let complaints: ComplaintCard[] = fallbackComplaints;
+
+  try {
+    const apiComplaints = await getCitizenComplaints(user.id);
+
+    if (apiComplaints.length > 0) {
+      complaints = apiComplaints.map((complaint) => ({
+        id: complaint.id,
+        title: complaint.title,
+        domain: complaint.domainName ?? "Unclassified",
+        status: formatStatus(complaint.status),
+        priority: formatPriority(complaint.priorityLevel),
+        location: complaint.departmentName ?? "Department pending",
+        updatedAt: new Date(complaint.submittedAt).toLocaleString(),
+        complaintCode: complaint.complaintCode,
+      }));
+    }
+  } catch {
+    complaints = fallbackComplaints;
+  }
+
+  return (
+    <AppShell>
+      <section className="relative overflow-hidden rounded-[2.5rem] bg-gradient-to-br from-[#0F172A] via-civic-primary to-[#1E3A8A] px-8 py-12 text-white shadow-civic lg:px-12 lg:py-16">
+        <div className="absolute -left-32 -top-32 h-96 w-96 rounded-full bg-white/10 blur-[100px]" />
+        
+        <div className="relative flex flex-wrap items-center justify-between gap-6">
+          <div className="space-y-4">
+            <h1 className="text-4xl font-extrabold tracking-tight sm:text-5xl">My Reports</h1>
+            <p className="text-lg text-slate-300">Track the status of the issues you've reported in your neighborhood.</p>
+          </div>
+          <Link
+            className="group inline-flex items-center gap-2 rounded-full bg-white px-7 py-4 text-base font-bold text-civic-primary shadow-xl transition-all hover:-translate-y-1 hover:shadow-2xl"
+            href="/report"
+          >
+            Report a new issue
+          </Link>
+        </div>
+
+        <div className="relative mt-10 grid gap-5 sm:grid-cols-3">
+          {complaintStats.map((stat) => (
+            <div key={stat.label} className="rounded-[2rem] border border-white/15 bg-white/10 p-6 backdrop-blur-xl">
+              <p className="text-xs font-bold uppercase tracking-[0.2em] text-white/60">{stat.label}</p>
+              <p className="mt-4 text-4xl font-extrabold text-white">{stat.value}</p>
+            </div>
+          ))}
+        </div>
+      </section>
+
+      <section className="space-y-6">
+        <div className="rounded-[2rem] border border-slate-200 bg-white p-5 shadow-sm">
+          <div className="flex flex-col gap-4 lg:flex-row lg:items-center lg:justify-between">
+            <div className="flex flex-wrap gap-2">
+              {filters.map((filter) => (
+                <button
+                  key={filter}
+                  type="button"
+                  className={[
+                    "rounded-full px-4 py-2 text-sm font-semibold transition",
+                    filter === "All"
+                      ? "bg-civic-primary text-white"
+                      : "bg-slate-100 text-slate-700 hover:bg-slate-200",
+                  ].join(" ")}
+                >
+                  {filter}
+                </button>
+              ))}
+            </div>
+
+            <div className="flex items-center gap-3 rounded-full border border-slate-200 bg-slate-50 px-4 py-3 text-sm text-civic-muted lg:min-w-80">
+              <Search className="h-4 w-4" />
+              Search by complaint ID or area
+            </div>
+          </div>
+        </div>
+
+        <section className="rounded-[2.5rem] border border-slate-200 bg-white/70 p-8 shadow-glass backdrop-blur-xl">
+          <h2 className="text-2xl font-extrabold text-slate-900">Recent Activity</h2>
+
+          <div className="mt-8 space-y-5">
+            {complaints.map((complaint) => (
+              <article
+                key={complaint.id}
+                className="group relative overflow-hidden rounded-[2rem] border border-slate-200 bg-white p-6 shadow-sm transition-all hover:-translate-y-1 hover:border-slate-300 hover:shadow-xl"
+              >
+                <div className="flex flex-wrap items-start justify-between gap-4">
+                  <div className="space-y-3">
+                    <div className="flex flex-wrap items-center gap-3">
+                      <span className="rounded-full bg-slate-100 px-3.5 py-1 text-xs font-bold text-slate-700">
+                        {complaint.complaintCode ?? complaint.id}
+                      </span>
+                      <StatusBadge status={complaint.status} />
+                      <PriorityBadge priority={complaint.priority} />
+                    </div>
+                    <h3 className="text-2xl font-bold text-slate-900">{complaint.title}</h3>
+                    <p className="text-sm font-medium text-slate-500">{complaint.domain}</p>
+                  </div>
+
+                  <div className="flex items-center gap-2 rounded-full border border-slate-100 bg-slate-50 px-4 py-2 text-xs font-bold text-slate-500">
+                    <Clock3 className="h-4 w-4" />
+                    {complaint.updatedAt}
+                  </div>
+                </div>
+
+                <div className="mt-6 flex items-center gap-2 text-sm font-medium text-slate-500">
+                  <MapPinned className="h-4 w-4" />
+                  {complaint.location}
+                </div>
+
+                <div className="mt-6 flex flex-wrap gap-3">
+                  <Link
+                    className="inline-flex items-center gap-2 rounded-full bg-slate-900 px-6 py-3 text-sm font-bold text-white shadow-md transition hover:bg-slate-800 hover:shadow-lg"
+                    href={`/complaints/${complaint.id}`}
+                  >
+                    View Details
+                  </Link>
+                </div>
+              </article>
+            ))}
+          </div>
+        </section>
+      </section>
+    </AppShell>
+  );
+}

civic-platform/app/dashboard/analytics/page.tsx

@@ -0,0 +1,184 @@
+import Link from "next/link";
+import { AppShell } from "@/components/app-shell";
+import { EmptyState } from "@/components/empty-state";
+import { LiveSyncBadge } from "@/components/live-sync-badge";
+import { requireRole } from "@/lib/auth";
+import { getAnalyticsExportUrl, getAnalyticsSummary, type AnalyticsSummary } from "@/lib/api";
+import { ArrowDownToLine, BarChart3, Clock3, Siren, TrendingUp } from "lucide-react";
+
+const fallbackAnalytics: AnalyticsSummary = {
+  trends: [],
+  domainBreakdown: [],
+  departmentPerformance: [],
+  kpis: {
+    emergencyCount: 0,
+    reopenedCount: 0,
+    repeatComplaintRiskCount: 0,
+    slaBreaches: 0,
+  },
+};
+
+export default async function DashboardAnalyticsPage() {
+  await requireRole(["department_operator", "municipal_admin"]);
+
+  let analytics = fallbackAnalytics;
+
+  try {
+    analytics = await getAnalyticsSummary();
+  } catch {
+    analytics = fallbackAnalytics;
+  }
+
+  const maxTrend = Math.max(
+    1,
+    ...analytics.trends.flatMap((item) => [item.reportedCount, item.resolvedCount]),
+  );
+
+  return (
+    <AppShell>
+      <section className="rounded-[2rem] bg-gradient-to-br from-slate-950 via-civic-primary to-[#0b6a8f] px-6 py-8 text-white shadow-civic lg:px-8">
+        <div className="flex flex-wrap items-center justify-between gap-4">
+          <div className="space-y-3">
+            <p className="text-sm font-semibold uppercase tracking-[0.22em] text-white/70">Analytics</p>
+            <h1 className="text-4xl font-semibold tracking-tight">Track performance, trends, and launch readiness.</h1>
+            <p className="max-w-2xl text-sm leading-7 text-white/80">
+              Use this view to monitor complaint trends, department throughput, SLA risk, and repeat civic failures.
+            </p>
+          </div>
+          <div className="flex flex-wrap items-center gap-3">
+            <LiveSyncBadge label="Analytics live refresh" />
+            <a
+              className="inline-flex items-center gap-2 rounded-full bg-white px-5 py-3 text-sm font-semibold text-civic-primary transition hover:-translate-y-0.5"
+              href={getAnalyticsExportUrl()}
+              target="_blank"
+              rel="noreferrer"
+            >
+              <ArrowDownToLine className="h-4 w-4" />
+              Export CSV
+            </a>
+          </div>
+        </div>
+      </section>
+
+      <section className="grid gap-6 lg:grid-cols-4">
+        {[
+          { label: "Emergency", value: analytics.kpis.emergencyCount, icon: Siren },
+          { label: "Reopened", value: analytics.kpis.reopenedCount, icon: TrendingUp },
+          { label: "Repeat risk", value: analytics.kpis.repeatComplaintRiskCount, icon: BarChart3 },
+          { label: "SLA breaches", value: analytics.kpis.slaBreaches, icon: Clock3 },
+        ].map((item) => {
+          const Icon = item.icon;
+          return (
+            <div key={item.label} className="rounded-[2rem] border border-slate-200 bg-white p-6 shadow-sm">
+              <div className="flex h-11 w-11 items-center justify-center rounded-2xl bg-civic-secondary/15 text-civic-secondary">
+                <Icon className="h-5 w-5" />
+              </div>
+              <p className="mt-5 text-sm font-semibold uppercase tracking-[0.16em] text-civic-muted">{item.label}</p>
+              <p className="mt-2 text-3xl font-semibold text-civic-text">{item.value}</p>
+            </div>
+          );
+        })}
+      </section>
+
+      <section className="grid gap-6 xl:grid-cols-[1.15fr_0.85fr]">
+        <section className="rounded-[2rem] border border-slate-200 bg-white p-6 shadow-sm">
+          <div>
+            <p className="text-sm font-semibold uppercase tracking-[0.22em] text-civic-secondary">Trends</p>
+            <h2 className="mt-2 text-2xl font-semibold text-civic-text">Reported vs resolved over the last 7 days</h2>
+          </div>
+          <div className="mt-6 space-y-4">
+            {analytics.trends.length === 0 ? (
+              <EmptyState icon={TrendingUp} title="No trend data yet" description="Trend data will appear once complaints start moving through the system." />
+            ) : (
+              analytics.trends.map((item) => (
+                <div key={item.day} className="space-y-2">
+                  <div className="flex items-center justify-between gap-4 text-sm">
+                    <span className="font-semibold text-civic-text">{item.day}</span>
+                    <span className="text-civic-muted">
+                      reported {item.reportedCount} · resolved {item.resolvedCount}
+                    </span>
+                  </div>
+                  <div className="grid gap-2">
+                    <div className="h-3 overflow-hidden rounded-full bg-slate-100">
+                      <div
+                        className="h-full rounded-full bg-civic-primary"
+                        style={{ width: `${(item.reportedCount / maxTrend) * 100}%` }}
+                      />
+                    </div>
+                    <div className="h-3 overflow-hidden rounded-full bg-slate-100">
+                      <div
+                        className="h-full rounded-full bg-civic-success"
+                        style={{ width: `${(item.resolvedCount / maxTrend) * 100}%` }}
+                      />
+                    </div>
+                  </div>
+                </div>
+              ))
+            )}
+          </div>
+        </section>
+
+        <section className="rounded-[2rem] border border-slate-200 bg-white p-6 shadow-sm">
+          <div>
+            <p className="text-sm font-semibold uppercase tracking-[0.22em] text-civic-secondary">Domains</p>
+            <h2 className="mt-2 text-2xl font-semibold text-civic-text">Complaint share by category</h2>
+          </div>
+          <div className="mt-6 space-y-3">
+            {analytics.domainBreakdown.length === 0 ? (
+              <EmptyState icon={BarChart3} title="No domain data yet" description="Domain distribution appears once complaints are recorded." />
+            ) : (
+              analytics.domainBreakdown.map((item) => (
+                <div key={item.domainName} className="rounded-3xl bg-slate-50 p-4">
+                  <div className="flex items-center justify-between gap-4">
+                    <span className="text-sm font-semibold text-civic-text">{item.domainName}</span>
+                    <span className="rounded-full bg-white px-3 py-1 text-xs font-semibold text-slate-700">
+                      {item.complaintCount}
+                    </span>
+                  </div>
+                </div>
+              ))
+            )}
+          </div>
+        </section>
+      </section>
+
+      <section className="rounded-[2rem] border border-slate-200 bg-white p-6 shadow-sm">
+        <div className="flex flex-wrap items-center justify-between gap-4">
+          <div>
+            <p className="text-sm font-semibold uppercase tracking-[0.22em] text-civic-secondary">Departments</p>
+            <h2 className="mt-2 text-2xl font-semibold text-civic-text">Performance and response time</h2>
+          </div>
+          <Link
+            href="/dashboard"
+            className="rounded-full border border-slate-200 px-4 py-2 text-sm font-semibold text-slate-700 transition hover:border-civic-primary hover:text-civic-primary"
+          >
+            Back to overview
+          </Link>
+        </div>
+
+        <div className="mt-6 overflow-x-auto">
+          <table className="min-w-full text-left text-sm">
+            <thead>
+              <tr className="border-b border-slate-200 text-civic-muted">
+                <th className="px-3 py-3 font-semibold">Department</th>
+                <th className="px-3 py-3 font-semibold">Pending</th>
+                <th className="px-3 py-3 font-semibold">Resolved</th>
+                <th className="px-3 py-3 font-semibold">Avg resolution (hrs)</th>
+              </tr>
+            </thead>
+            <tbody>
+              {analytics.departmentPerformance.map((item) => (
+                <tr key={item.departmentName} className="border-b border-slate-100">
+                  <td className="px-3 py-4 font-semibold text-civic-text">{item.departmentName}</td>
+                  <td className="px-3 py-4 text-civic-muted">{item.pendingCount}</td>
+                  <td className="px-3 py-4 text-civic-muted">{item.resolvedCount}</td>
+                  <td className="px-3 py-4 text-civic-muted">{item.averageResolutionHours.toFixed(2)}</td>
+                </tr>
+              ))}
+            </tbody>
+          </table>
+        </div>
+      </section>
+    </AppShell>
+  );
+}

civic-platform/app/dashboard/complaints/[id]/page.tsx

@@ -0,0 +1,383 @@
+import Link from "next/link";
+import {
+  ArrowRight,
+  CheckCircle2,
+  ClipboardList,
+  Clock3,
+  MessageSquareText,
+  ShieldAlert,
+  UserCog,
+} from "lucide-react";
+import { AdminAssignAction } from "@/components/admin-assign-action";
+import { AdminAssignmentHistory } from "@/components/admin-assignment-history";
+import { AdminNotesPanel } from "@/components/admin-notes-panel";
+import { AppShell } from "@/components/app-shell";
+import { AdminStatusActions } from "@/components/admin-status-actions";
+import { ComplaintAiPanel } from "@/components/complaint-ai-panel";
+import { ComplaintMediaGallery } from "@/components/complaint-media-gallery";
+import { ResolutionProofUploader } from "@/components/resolution-proof-uploader";
+import { SectionHeader } from "@/components/section-header";
+import { requireRole } from "@/lib/auth";
+import {
+  getComplaintDetail,
+  getComplaintAssignments,
+  getComplaintAiInsights,
+  getComplaintHistory,
+  getComplaintMedia,
+  getComplaintNotes,
+  type ComplaintAiInsights,
+  type ComplaintAssignmentItem,
+  type ComplaintMediaItem,
+  type ComplaintNoteItem,
+  type ComplaintStatusHistoryItem,
+} from "@/lib/api";
+
+const internalActions = [
+  "Validate complaint",
+  "Adjust domain or sub-problem if needed",
+  "Assign responsible department",
+  "Assign field officer later",
+  "Change lifecycle state",
+  "Escalate if public danger is immediate",
+];
+
+type DashboardComplaintDetailPageProps = {
+  params: Promise<{
+    id: string;
+  }>;
+};
+
+function formatStatus(status: string) {
+  return status
+    .split("_")
+    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+    .join(" ");
+}
+
+function formatPriority(priority: string) {
+  switch (priority) {
+    case "P1":
+      return "P1 Critical";
+    case "P2":
+      return "P2 High";
+    case "P3":
+      return "P3 Medium";
+    default:
+      return "P4 Low";
+  }
+}
+
+function formatDateTime(value: string) {
+  return new Date(value).toLocaleString();
+}
+
+function getPriorityRationale(priority: string, isEmergency: boolean) {
+  if (isEmergency || priority === "P1 Critical") {
+    return "Emergency or public-danger signals require immediate routing and shortest possible response time.";
+  }
+
+  if (priority === "P2 High") {
+    return "High-impact infrastructure or safety risk needs fast ownership before it grows into a wider area failure.";
+  }
+
+  if (priority === "P3 Medium") {
+    return "Standard operational issue with visible citizen impact. Keep it moving through the active queue.";
+  }
+
+  return "Lower-impact maintenance issue that can stay in the planned service backlog unless conditions worsen.";
+}
+
+function getRoutingConfidence(domain: string, assignments: ComplaintAssignmentItem[], department: string) {
+  if (assignments.length > 0) {
+    return `Routing has already been acted on. The latest ownership sits with ${assignments[0]?.departmentName ?? department}.`;
+  }
+
+  if (domain === "Fire Emergencies" || domain === "Flood and Water Disaster" || domain === "Disaster and Rescue") {
+    return `Emergency domain strongly matches ${department} and should stay on the fastest escalation path.`;
+  }
+
+  return `Current domain and complaint context point to ${department} as the primary queue owner.`;
+}
+
+function getOperationalState(status: string, assignments: ComplaintAssignmentItem[]) {
+  if (status === "Resolved" || status === "Closed") {
+    return "Work appears completed. Review proof, citizen follow-up, and any reopen risk.";
+  }
+
+  if (status === "Reopened" || status === "Escalated") {
+    return "Complaint needs renewed attention. Recheck ownership, on-ground risk, and SLA exposure.";
+  }
+
+  if (assignments.length > 0) {
+    return "Complaint is in active departmental handling. Track acceptance and field progress closely.";
+  }
+
+  return "Complaint still needs clear ownership. Assignment is the next critical operator action.";
+}
+
+function timelineTone(status: string) {
+  switch (status) {
+    case "submitted":
+      return "bg-civic-primary";
+    case "validated":
+      return "bg-civic-secondary";
+    case "classified":
+    case "prioritized":
+      return "bg-amber-500";
+    case "assigned":
+      return "bg-slate-800";
+    case "in_progress":
+      return "bg-emerald-600";
+    case "resolved":
+    case "closed":
+      return "bg-emerald-700";
+    case "reopened":
+    case "escalated":
+      return "bg-civic-danger";
+    default:
+      return "bg-slate-300";
+  }
+}
+
+export default async function DashboardComplaintDetailPage({ params }: DashboardComplaintDetailPageProps) {
+  const user = await requireRole(["department_operator", "municipal_admin"]);
+  const { id } = await params;
+
+  let complaintCode = "CP-2026-00141";
+  let complaintStatusValue = "submitted";
+  let complaintStatus = "Submitted";
+  let complaintPriority = "P1 Critical";
+  let complaintDomain = "Public Infrastructure and Amenities";
+  let complaintTitle = "Open manhole on high-traffic road";
+  let complaintLocation = "Temple Junction, Ward 4";
+  let complaintDescription = "High-risk public hazard affecting traffic near the junction.";
+  let complaintDepartment = "Municipal Maintenance";
+  let isEmergency = true;
+  let media: ComplaintMediaItem[] = [];
+  let assignments: ComplaintAssignmentItem[] = [];
+  let notes: ComplaintNoteItem[] = [];
+  let aiInsights: ComplaintAiInsights | null = null;
+  let internalTimeline: Array<{ title: string; time: string; note: string; tone: string }> = [
+    {
+      title: "Submitted",
+      time: "Pending",
+      note: "Complaint created by citizen with image and geo-tag.",
+      tone: "bg-civic-primary",
+    },
+  ];
+
+  try {
+    const [complaint, assignmentItems, history, mediaItems, noteItems, aiData] = await Promise.all([
+      getComplaintDetail(id),
+      getComplaintAssignments(id),
+      getComplaintHistory(id),
+      getComplaintMedia(id),
+      getComplaintNotes(id),
+      getComplaintAiInsights(id),
+    ]);
+
+    complaintCode = complaint.complaintCode;
+    complaintStatusValue = complaint.status;
+    complaintStatus = formatStatus(complaint.status);
+    complaintPriority = formatPriority(complaint.priorityLevel);
+    complaintDomain = complaint.domainName ?? complaintDomain;
+    complaintTitle = complaint.title;
+    complaintLocation = complaint.addressLine ?? complaint.landmark ?? complaintLocation;
+    complaintDescription = complaint.description ?? complaintDescription;
+    complaintDepartment = complaint.departmentName ?? complaintDepartment;
+    isEmergency = complaint.isEmergency;
+    assignments = assignmentItems;
+    media = mediaItems;
+    notes = noteItems;
+    aiInsights = aiData;
+
+    if (history.length > 0) {
+      internalTimeline = history.map((entry: ComplaintStatusHistoryItem) => ({
+        title: formatStatus(entry.newStatus),
+        time: formatDateTime(entry.createdAt),
+        note: entry.changeReason ?? `Complaint moved to ${formatStatus(entry.newStatus)}.`,
+        tone: timelineTone(entry.newStatus),
+      }));
+    }
+  } catch {
+    // Keep fallback values when backend is unavailable.
+  }
+
+  const complaintMeta = [
+    { label: "Complaint ID", value: complaintCode },
+    { label: "Current status", value: complaintStatus },
+    { label: "Priority", value: complaintPriority },
+    { label: "Domain", value: complaintDomain },
+  ];
+
+  const complaintContext = [
+    `Issue: ${complaintTitle}`,
+    `Location: ${complaintLocation}`,
+    `Likely department: ${complaintDepartment}`,
+    complaintDescription,
+  ];
+
+  const routingDecisionItems = [
+    `Current queue owner: ${assignments[0]?.departmentName ?? complaintDepartment}`,
+    `Operational mode: ${isEmergency ? "Emergency escalation path" : "Standard civic workflow"}`,
+    `Priority rationale: ${getPriorityRationale(complaintPriority, isEmergency)}`,
+    `Routing confidence: ${getRoutingConfidence(complaintDomain, assignments, complaintDepartment)}`,
+    `Current action state: ${getOperationalState(complaintStatus, assignments)}`,
+  ];
+
+  return (
+    <AppShell>
+      <section className="grid gap-6 rounded-[2rem] bg-civic-primary px-6 py-8 text-white shadow-civic lg:grid-cols-[1.08fr_0.92fr] lg:px-8">
+        <div className="space-y-4">
+          <p className="text-sm font-semibold uppercase tracking-[0.22em] text-white/75">Internal complaint view</p>
+          <h1 className="text-4xl font-semibold tracking-tight">Manage one complaint from triage to resolution.</h1>
+          <p className="max-w-2xl text-sm leading-7 text-white/80">
+            Review context, route the work, assign the right team, and move the complaint through the next action.
+          </p>
+        </div>
+
+        <div className="grid gap-4 sm:grid-cols-2">
+          {complaintMeta.map((item) => (
+            <div key={item.label} className="rounded-3xl border border-white/15 bg-white/10 p-5 backdrop-blur">
+              <p className="text-sm font-semibold uppercase tracking-[0.16em] text-white/75">{item.label}</p>
+              <p className="mt-3 text-xl font-semibold text-white">{item.value}</p>
+            </div>
+          ))}
+        </div>
+      </section>
+
+      <section className="grid gap-6 lg:grid-cols-[1.12fr_0.88fr]">
+        <div className="space-y-6">
+          <section className="rounded-[2rem] border border-slate-200 bg-white p-6 shadow-sm">
+            <SectionHeader eyebrow="Complaint context" icon={ClipboardList} title="Citizen submission details" />
+
+            <div className="mt-5 space-y-3">
+              {complaintContext.map((item) => (
+                <div key={item} className="rounded-2xl bg-slate-50 px-4 py-3 text-sm leading-6 text-civic-text">
+                  {item}
+                </div>
+              ))}
+            </div>
+          </section>
+
+          <section className="rounded-[2rem] border border-slate-200 bg-white p-6 shadow-sm">
+            <SectionHeader eyebrow="Lifecycle" icon={Clock3} iconClassName="bg-civic-primary text-white" title="Internal status timeline" />
+
+            <div className="mt-6 space-y-5">
+              {internalTimeline.map((entry, index) => (
+                <div key={`${entry.title}-${entry.time}-${index}`} className="grid gap-4 md:grid-cols-[auto_1fr] md:gap-5">
+                  <div className="flex items-start gap-4 md:flex-col md:items-center">
+                    <div className={["mt-1 h-4 w-4 rounded-full", entry.tone].join(" ")} />
+                    {index !== internalTimeline.length - 1 ? <div className="hidden h-16 w-px bg-slate-200 md:block" /> : null}
+                  </div>
+                  <div className="rounded-3xl bg-slate-50 p-5">
+                    <div className="flex flex-wrap items-center justify-between gap-3">
+                      <h3 className="text-lg font-semibold text-civic-text">{entry.title}</h3>
+                      <div className="inline-flex items-center gap-2 rounded-full bg-white px-3 py-2 text-xs font-semibold text-slate-700">
+                        <Clock3 className="h-4 w-4" />
+                        {entry.time}
+                      </div>
+                    </div>
+                    <p className="mt-3 text-sm leading-6 text-civic-muted">{entry.note}</p>
+                  </div>
+                </div>
+              ))}
+            </div>
+          </section>
+
+          <section className="rounded-[2rem] border border-slate-200 bg-white p-6 shadow-sm">
+            <SectionHeader eyebrow="Internal notes" icon={MessageSquareText} iconClassName="bg-amber-100 text-amber-700" title="Operator-only information" />
+
+            <div className="mt-5">
+              <AdminNotesPanel complaintId={id} initialNotes={notes} operatorId={user.id} />
+            </div>
+          </section>
+
+          <AdminAssignmentHistory assignments={assignments} />
+        </div>
+
+        <div className="space-y-6">
+          <section className="rounded-[2rem] border border-slate-200 bg-white p-6 shadow-sm">
+            <SectionHeader eyebrow="Priority and routing" icon={ShieldAlert} iconClassName="bg-red-100 text-civic-danger" title="Department decision block" />
+
+            <div className="mt-5 space-y-3">
+              {routingDecisionItems.map((item) => (
+                <div key={item} className="rounded-2xl bg-slate-50 px-4 py-3 text-sm leading-6 text-civic-text">
+                  {item}
+                </div>
+              ))}
+            </div>
+
+            <div className="mt-5">
+              <AdminAssignAction complaintId={id} suggestedDepartment={complaintDepartment} operatorId={user.id} />
+            </div>
+          </section>
+
+          <ComplaintAiPanel insights={aiInsights} />
+
+          <section className="rounded-[2rem] border border-slate-200 bg-white p-6 shadow-sm">
+            <SectionHeader eyebrow="Actions" icon={UserCog} title="Operator workflow controls" />
+
+            <div className="mt-5 space-y-3">
+              {internalActions.map((action) => (
+                <div key={action} className="rounded-2xl bg-slate-50 px-4 py-3 text-sm leading-6 text-civic-text">
+                  {action}
+                </div>
+              ))}
+            </div>
+
+            <div className="mt-5">
+              <AdminStatusActions complaintId={id} currentStatus={complaintStatusValue} operatorId={user.id} />
+            </div>
+          </section>
+
+          <ComplaintMediaGallery
+            items={media}
+            title="Complaint evidence"
+            emptyLabel="No evidence has been uploaded for this complaint yet."
+          />
+
+          <ResolutionProofUploader complaintId={id} uploadedBy={user.id} label="Attach final proof from operations" />
+
+          <section className="rounded-[2rem] border border-emerald-200 bg-emerald-50 p-6 shadow-sm">
+            <div className="flex items-start gap-3">
+              <CheckCircle2 className="mt-0.5 h-5 w-5 text-emerald-700" />
+              <div>
+                <h2 className="text-lg font-semibold text-emerald-950">Internal-only context</h2>
+                <p className="mt-2 text-sm leading-6 text-emerald-900/85">
+                  Notes, routing context, and assignment controls stay visible only to internal teams.
+                </p>
+              </div>
+            </div>
+          </section>
+        </div>
+      </section>
+
+      <section className="flex flex-wrap items-center justify-between gap-4 rounded-[2rem] border border-slate-200 bg-white p-6 shadow-sm">
+        <div className="space-y-2">
+          <p className="text-sm font-semibold uppercase tracking-[0.22em] text-civic-secondary">Queue navigation</p>
+          <h2 className="text-2xl font-semibold text-civic-text">Jump back to the queue or move into emergency operations.</h2>
+          <p className="max-w-2xl text-sm leading-6 text-civic-muted">
+            Use the queue to continue triage work, or switch to emergency reporting when a fast-response situation needs immediate handling.
+          </p>
+        </div>
+
+        <div className="flex flex-wrap gap-3">
+          <Link
+            className="inline-flex rounded-full border border-slate-200 px-5 py-3 text-sm font-semibold text-slate-700 transition hover:border-civic-primary hover:text-civic-primary"
+            href="/dashboard/complaints"
+          >
+            Back to queue
+          </Link>
+          <Link
+            className="inline-flex items-center gap-2 rounded-full bg-slate-900 px-5 py-3 text-sm font-semibold text-white transition hover:-translate-y-0.5"
+            href="/emergency"
+          >
+            Open emergency reporting
+            <ArrowRight className="h-4 w-4" />
+          </Link>
+        </div>
+      </section>
+    </AppShell>
+  );
+}

civic-platform/app/dashboard/complaints/page.tsx

@@ -0,0 +1,113 @@
+import { AppShell } from "@/components/app-shell";
+import {
+  DashboardQueueClient,
+  type QueueComplaintCard,
+} from "@/components/dashboard-queue-client";
+import { getAllComplaints } from "@/lib/api";
+import { requireRole } from "@/lib/auth";
+
+const filterGroups = [
+  {
+    title: "Status" as const,
+    options: ["All", "Submitted", "Assigned", "In Progress", "Resolved", "Reopened"],
+  },
+  {
+    title: "Priority" as const,
+    options: ["All", "P1 Critical", "P2 High", "P3 Medium", "P4 Low"],
+  },
+  {
+    title: "Domain" as const,
+    options: ["All", "Roads", "Sanitation", "Water", "Electrical", "Infrastructure", "Environment"],
+  },
+];
+
+const fallbackComplaints: QueueComplaintCard[] = [
+  {
+    id: "CP-2026-00141",
+    complaintCode: "CP-2026-00141",
+    title: "Open manhole on high-traffic road",
+    domain: "Public Infrastructure and Amenities",
+    status: "Submitted",
+    priority: "P1 Critical",
+    department: "Municipal Maintenance",
+    location: "Temple Junction, Ward 4",
+    updatedAt: "5 minutes ago",
+    submittedAt: new Date(Date.now() - 5 * 60 * 1000).toISOString(),
+  },
+  {
+    id: "CP-2026-00139",
+    complaintCode: "CP-2026-00139",
+    title: "Live wire hanging near bus stop",
+    domain: "Electrical Hazard",
+    status: "Assigned",
+    priority: "P1 Critical",
+    department: "Electrical Safety Response",
+    location: "Bus Stand Road, Ward 9",
+    updatedAt: "12 minutes ago",
+    submittedAt: new Date(Date.now() - 12 * 60 * 1000).toISOString(),
+  },
+  {
+    id: "CP-2026-00124",
+    complaintCode: "CP-2026-00124",
+    title: "Sewage overflow near market entrance",
+    domain: "Water Supply, Sewerage, and Drainage",
+    status: "In Progress",
+    priority: "P2 High",
+    department: "Water and Sewerage",
+    location: "Market Road, Ward 12",
+    updatedAt: "1 hour ago",
+    submittedAt: new Date(Date.now() - 60 * 60 * 1000).toISOString(),
+  },
+];
+
+function formatStatus(status: string) {
+  return status
+    .split("_")
+    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+    .join(" ");
+}
+
+function formatPriority(priority: string) {
+  switch (priority) {
+    case "P1":
+      return "P1 Critical";
+    case "P2":
+      return "P2 High";
+    case "P3":
+      return "P3 Medium";
+    default:
+      return "P4 Low";
+  }
+}
+
+export default async function DashboardComplaintsPage() {
+  const user = await requireRole(["department_operator", "municipal_admin"]);
+  let complaints: QueueComplaintCard[] = fallbackComplaints;
+
+  try {
+    const apiComplaints = await getAllComplaints();
+
+    if (apiComplaints.length > 0) {
+      complaints = apiComplaints.map((complaint) => ({
+        id: complaint.id,
+        complaintCode: complaint.complaintCode,
+        title: complaint.title,
+        domain: complaint.domainName ?? "Unclassified",
+        status: formatStatus(complaint.status),
+        priority: formatPriority(complaint.priorityLevel),
+        department: complaint.departmentName ?? "Department pending",
+        location: complaint.addressLine ?? complaint.landmark ?? "Location pending",
+        updatedAt: new Date(complaint.submittedAt).toLocaleString(),
+        submittedAt: complaint.submittedAt,
+      }));
+    }
+  } catch {
+    complaints = fallbackComplaints;
+  }
+
+  return (
+    <AppShell>
+      <DashboardQueueClient complaints={complaints} filterGroups={filterGroups} operatorId={user.id} />
+    </AppShell>
+  );
+}

civic-platform/app/dashboard/page.tsx

@@ -0,0 +1,257 @@
+import Link from "next/link";
+import {
+  ArrowRight,
+  Building2,
+  Clock3,
+  MapPinned,
+  Siren,
+  TimerReset,
+} from "lucide-react";
+import { AppShell } from "@/components/app-shell";
+import { EmptyState } from "@/components/empty-state";
+import { LiveSyncBadge } from "@/components/live-sync-badge";
+import { PriorityBadge } from "@/components/priority-badge";
+import { requireRole } from "@/lib/auth";
+import { getDashboardSummary, type DashboardSummary } from "@/lib/api";
+
+const focusItems = [
+  "Urgent complaints",
+  "Unaccepted assignments",
+  "SLA breaches",
+  "Pending field updates",
+];
+
+export default async function DashboardPage() {
+  await requireRole(["department_operator", "municipal_admin"]);
+
+  const fallbackSummary: DashboardSummary = {
+    overview: {
+      openComplaints: 184,
+      criticalComplaints: 7,
+      slaRisk: 19,
+      resolvedToday: 42,
+    },
+    urgentQueue: [
+      {
+        id: "sample-urgent-1",
+        complaintCode: "CP-2026-00141",
+        title: "Open manhole on high-traffic road",
+        domainName: "Public Infrastructure and Amenities",
+        priorityLevel: "P1",
+        location: "Temple Junction, Ward 4",
+        submittedAt: new Date().toISOString(),
+      },
+      {
+        id: "sample-urgent-2",
+        complaintCode: "CP-2026-00139",
+        title: "Live wire hanging near bus stop",
+        domainName: "Electrical Hazard",
+        priorityLevel: "P1",
+        location: "Bus Stand Road, Ward 9",
+        submittedAt: new Date().toISOString(),
+      },
+    ],
+    departmentWorkload: [
+      { departmentName: "Roads and Public Works", pendingCount: 31 },
+      { departmentName: "Sanitation and Solid Waste", pendingCount: 28 },
+      { departmentName: "Water and Sewerage", pendingCount: 44 },
+      { departmentName: "Electrical and Street Lighting", pendingCount: 22 },
+    ],
+  };
+
+  let summary: DashboardSummary = fallbackSummary;
+
+  try {
+    summary = await getDashboardSummary();
+  } catch {
+    summary = fallbackSummary;
+  }
+
+  const overviewStats = [
+    { label: "Open complaints", value: String(summary.overview.openComplaints), tone: "text-civic-text" },
+    { label: "Critical", value: String(summary.overview.criticalComplaints), tone: "text-civic-danger" },
+    { label: "SLA risk", value: String(summary.overview.slaRisk), tone: "text-amber-700" },
+    { label: "Resolved today", value: String(summary.overview.resolvedToday), tone: "text-emerald-700" },
+  ];
+
+  return (
+    <AppShell>
+      <section className="relative overflow-hidden rounded-[2.5rem] bg-gradient-to-br from-[#09090b] via-civic-primary to-[#1e3a8a] px-8 py-10 text-white shadow-civic lg:px-10 lg:py-12">
+        <div className="absolute -left-32 -top-32 h-96 w-96 rounded-full bg-white/5 blur-[100px]" />
+        <div className="relative flex flex-wrap items-end justify-between gap-6">
+          <div className="space-y-4">
+            <p className="text-sm font-bold uppercase tracking-[0.25em] text-white/70">Operations</p>
+            <h1 className="text-5xl font-extrabold tracking-tight">Command Center</h1>
+          </div>
+          <div className="flex flex-wrap items-center gap-4">
+            <LiveSyncBadge label="Live Refresh" />
+            <Link
+              className="group inline-flex items-center gap-2 rounded-full border border-white/20 bg-white/5 px-6 py-3.5 text-sm font-semibold text-white backdrop-blur-md transition hover:border-white/40 hover:bg-white/10"
+              href="/dashboard/analytics"
+            >
+              Analytics
+              <ArrowRight className="h-4 w-4 transition-transform group-hover:translate-x-1" />
+            </Link>
+            <Link
+              className="group inline-flex items-center gap-2 rounded-full bg-white px-6 py-3.5 text-sm font-bold text-civic-primary shadow-xl transition hover:-translate-y-0.5 hover:shadow-2xl"
+              href="/dashboard/complaints"
+            >
+              Open Queue
+              <ArrowRight className="h-4 w-4 transition-transform group-hover:translate-x-1" />
+            </Link>
+          </div>
+        </div>
+
+        <div className="relative mt-8 grid gap-5 sm:grid-cols-2 xl:grid-cols-4">
+          {overviewStats.map((stat) => (
+            <div key={stat.label} className="group rounded-[2rem] border border-white/15 bg-white/10 p-6 backdrop-blur-xl transition hover:bg-white/15">
+              <p className="text-xs font-bold uppercase tracking-[0.2em] text-white/60">{stat.label}</p>
+              <p className={["mt-4 text-4xl font-extrabold tracking-tight", stat.tone.replace("text-civic-text", "text-white").replace("text-civic-danger", "text-rose-400").replace("text-amber-700", "text-amber-400").replace("text-emerald-700", "text-emerald-400")].join(" ")}>{stat.value}</p>
+            </div>
+          ))}
+        </div>
+      </section>
+
+      <section className="grid gap-6 xl:grid-cols-[1.1fr_0.9fr]">
+        <section className="rounded-[2.5rem] border border-slate-200 bg-white/80 p-8 shadow-glass backdrop-blur-3xl transition hover:shadow-glass-hover">
+          <div className="flex flex-wrap items-center justify-between gap-4">
+            <div>
+              <p className="text-sm font-bold uppercase tracking-[0.25em] text-civic-secondary">Urgent queue</p>
+              <h2 className="mt-2 text-3xl font-extrabold text-slate-900">Priority Incidents</h2>
+            </div>
+            <div className="inline-flex animate-pulse items-center gap-2 rounded-full bg-rose-100 px-4 py-2 text-sm font-bold text-rose-700">
+              <Siren className="h-4 w-4" />
+              Live Feed
+            </div>
+          </div>
+
+          <div className="mt-8 space-y-5">
+            {summary.urgentQueue.length === 0 ? (
+              <EmptyState
+                description="Critical complaints will appear here as soon as they enter the queue."
+                icon={Siren}
+                title="No urgent complaints right now"
+              />
+            ) : (
+              summary.urgentQueue.map((item) => (
+                <article key={item.id} className="group relative overflow-hidden rounded-[2rem] border-2 border-rose-100 bg-gradient-to-br from-rose-50 to-white p-6 shadow-sm transition-all hover:-translate-y-1 hover:border-rose-200 hover:shadow-xl">
+                  <div className="absolute right-0 top-0 h-32 w-32 -translate-y-8 translate-x-8 rounded-full bg-rose-200/50 blur-3xl transition group-hover:bg-rose-300/50" />
+                  <div className="relative flex flex-wrap items-start justify-between gap-4">
+                    <div className="space-y-3">
+                      <div className="flex flex-wrap items-center gap-3">
+                        <span className="rounded-full bg-white px-3.5 py-1 text-xs font-bold text-slate-700 shadow-sm">
+                          {item.complaintCode}
+                        </span>
+                        <PriorityBadge priority={`${item.priorityLevel} ${item.priorityLevel === "P1" ? "Critical" : item.priorityLevel === "P2" ? "High" : item.priorityLevel === "P3" ? "Medium" : "Low"}`} />
+                      </div>
+                      <h3 className="text-2xl font-bold text-slate-900">{item.title}</h3>
+                      <p className="text-sm font-medium text-slate-500">{item.domainName ?? "Unclassified"}</p>
+                    </div>
+
+                    <div className="rounded-full bg-white/80 px-4 py-2 text-xs font-bold text-rose-700 shadow-sm backdrop-blur-md">
+                      {new Date(item.submittedAt).toLocaleString()}
+                    </div>
+                  </div>
+
+                  <div className="relative mt-5 flex flex-wrap items-center gap-4 text-sm font-medium text-slate-600">
+                    <div className="inline-flex items-center gap-2">
+                      <MapPinned className="h-4 w-4 text-slate-400" />
+                      {item.location ?? "Location pending"}
+                    </div>
+                  </div>
+
+                  <div className="relative mt-6">
+                    <Link
+                      className="group/btn inline-flex items-center gap-2 rounded-full bg-slate-900 px-6 py-3 text-sm font-bold text-white shadow-md transition hover:bg-slate-800 hover:shadow-lg"
+                      href={`/dashboard/complaints/${item.id}`}
+                    >
+                      Open Incident
+                      <ArrowRight className="h-4 w-4 transition-transform group-hover/btn:translate-x-1" />
+                    </Link>
+                  </div>
+                </article>
+              ))
+            )}
+          </div>
+        </section>
+
+        <div className="space-y-6">
+          <section className="rounded-[2.5rem] border border-slate-200 bg-white/80 p-8 shadow-glass backdrop-blur-3xl transition hover:shadow-glass-hover">
+            <div className="flex items-center gap-4">
+              <div className="flex h-14 w-14 items-center justify-center rounded-2xl bg-civic-secondary/15 text-civic-secondary shadow-inner">
+                <Building2 className="h-6 w-6" />
+              </div>
+              <div>
+                <p className="text-sm font-bold uppercase tracking-[0.2em] text-civic-secondary">Departments</p>
+                <h2 className="text-2xl font-extrabold text-slate-900">Current Workload</h2>
+              </div>
+            </div>
+
+            <div className="mt-8 space-y-4">
+              {summary.departmentWorkload.length === 0 ? (
+                <EmptyState
+                  description="Department workload will appear here once complaints are assigned into active queues."
+                  icon={Building2}
+                  title="No department workload yet"
+                />
+              ) : (
+                summary.departmentWorkload.map((item) => (
+                  <div key={item.departmentName} className="group rounded-3xl border border-slate-100 bg-white p-5 shadow-sm transition hover:-translate-y-1 hover:border-slate-200 hover:shadow-md">
+                    <div className="flex items-center justify-between gap-4">
+                      <h3 className="text-lg font-bold text-slate-800">{item.departmentName}</h3>
+                      <span className="rounded-full bg-slate-100 px-4 py-1.5 text-xs font-bold text-slate-700 transition group-hover:bg-civic-secondary group-hover:text-white">
+                        {item.pendingCount} pending
+                      </span>
+                    </div>
+                  </div>
+                ))
+              )}
+            </div>
+          </section>
+
+          <section className="rounded-[2.5rem] border border-slate-200 bg-white/80 p-8 shadow-glass backdrop-blur-3xl transition hover:shadow-glass-hover">
+            <div className="flex items-center gap-4">
+              <div className="flex h-14 w-14 items-center justify-center rounded-2xl bg-amber-100 text-amber-600 shadow-inner">
+                <TimerReset className="h-6 w-6" />
+              </div>
+              <div>
+                <p className="text-sm font-bold uppercase tracking-[0.2em] text-civic-secondary">Focus</p>
+                <h2 className="text-2xl font-extrabold text-slate-900">Immediate Attention</h2>
+              </div>
+            </div>
+
+            <div className="mt-8 grid gap-4 sm:grid-cols-2">
+              {focusItems.map((item) => (
+                <div key={item} className="rounded-2xl border border-slate-100 bg-white px-5 py-4 text-sm font-bold text-slate-700 shadow-sm transition hover:border-slate-200 hover:shadow-md">
+                  {item}
+                </div>
+              ))}
+            </div>
+          </section>
+
+          <section className="overflow-hidden rounded-[2.5rem] bg-gradient-to-br from-civic-primary to-blue-900 p-8 text-white shadow-xl transition hover:shadow-2xl">
+            <div className="flex items-center gap-4">
+              <div className="flex h-14 w-14 items-center justify-center rounded-2xl bg-white/20 shadow-inner backdrop-blur-md">
+                <Clock3 className="h-6 w-6 text-white" />
+              </div>
+              <div>
+                <p className="text-sm font-bold uppercase tracking-[0.2em] text-white/70">Queue</p>
+                <h2 className="text-2xl font-extrabold">Continue Operations</h2>
+              </div>
+            </div>
+
+            <div className="mt-8">
+              <Link
+                className="group inline-flex items-center gap-3 rounded-full bg-white px-7 py-4 text-sm font-bold text-civic-primary shadow-lg transition hover:-translate-y-1 hover:shadow-xl"
+                href="/dashboard/complaints"
+              >
+                Go to Complaint Queue
+                <ArrowRight className="h-5 w-5 transition-transform group-hover:translate-x-1" />
+              </Link>
+            </div>
+          </section>
+        </div>
+      </section>
+    </AppShell>
+  );
+}

civic-platform/app/emergency/page.tsx

@@ -0,0 +1,176 @@
+import Link from "next/link";
+import { AlertTriangle, Flame, RadioTower, ShieldAlert, Siren, Waves, Zap } from "lucide-react";
+import { AppShell } from "@/components/app-shell";
+
+const emergencyTypes = [
+  {
+    title: "Fire",
+    summary: "Fire outbreak, smoke, electrical fire, or public flame hazard.",
+    icon: Flame,
+  },
+  {
+    title: "Flood",
+    summary: "Flooding, dangerous water accumulation, or rapid overflow.",
+    icon: Waves,
+  },
+  {
+    title: "Electrical Hazard",
+    summary: "Live wire, transformer blast, or severe public electrical risk.",
+    icon: Zap,
+  },
+  {
+    title: "Rescue / Disaster",
+    summary: "Collapse, storm damage, trapped people, or multi-agency incident.",
+    icon: RadioTower,
+  },
+];
+
+const emergencyRules = [
+  "Emergency reports should take fewer steps than standard complaints.",
+  "Location must be captured first or confirmed manually.",
+  "Priority should default to P1 unless the complaint is invalid.",
+  "The system should route directly to the emergency queue.",
+];
+
+const minimalFields = [
+  "Emergency type",
+  "Photo or short video",
+  "Current location or exact pin",
+  "Short description of danger",
+  "Optional contact number",
+];
+
+export default function EmergencyPage() {
+  return (
+    <AppShell>
+      <section className="grid gap-6 rounded-[2rem] bg-civic-danger px-6 py-8 text-white shadow-civic lg:grid-cols-[1.08fr_0.92fr] lg:px-8">
+        <div className="space-y-4">
+          <div className="inline-flex items-center gap-2 rounded-full bg-white/10 px-4 py-2 text-sm font-medium text-white/90">
+            <Siren className="h-4 w-4" />
+            Emergency reporting flow
+          </div>
+          <h1 className="text-4xl font-semibold tracking-tight">Use the fastest possible flow for urgent public danger.</h1>
+          <p className="max-w-2xl text-sm leading-7 text-white/85">
+            Report fire, flood, electrical danger, or rescue situations with the fewest possible steps so the response team can act quickly.
+          </p>
+        </div>
+
+        <div className="rounded-[1.75rem] border border-white/15 bg-white/10 p-5 backdrop-blur">
+          <p className="text-sm font-semibold uppercase tracking-[0.22em] text-white/75">Default response behavior</p>
+          <div className="mt-4 space-y-3">
+            {[
+              "Priority set to P1 Critical",
+              "Emergency queue routing",
+              "Immediate operator visibility",
+              "Stronger notification path",
+            ].map((item) => (
+              <div key={item} className="rounded-2xl bg-white/10 px-4 py-3 text-sm font-medium text-white">
+                {item}
+              </div>
+            ))}
+          </div>
+        </div>
+      </section>
+
+      <section className="grid gap-6 lg:grid-cols-[1.02fr_0.98fr]">
+        <section className="rounded-[2rem] border border-slate-200 bg-white p-6 shadow-sm">
+          <div className="flex flex-wrap items-start justify-between gap-4">
+            <div>
+              <p className="text-sm font-semibold uppercase tracking-[0.22em] text-civic-secondary">Emergency type</p>
+              <h2 className="mt-2 text-2xl font-semibold text-civic-text">Choose the urgent incident category</h2>
+            </div>
+            <div className="rounded-full bg-red-50 px-4 py-2 text-sm font-semibold text-red-700">
+              High priority flow
+            </div>
+          </div>
+
+          <div className="mt-6 grid gap-4 md:grid-cols-2">
+            {emergencyTypes.map(({ title, summary, icon: Icon }) => (
+              <button
+                key={title}
+                type="button"
+                className="group rounded-3xl border border-red-100 bg-red-50/50 p-5 text-left transition duration-200 hover:-translate-y-1 hover:border-civic-danger hover:bg-white hover:shadow-civic"
+              >
+                <div className="flex items-start justify-between gap-4">
+                  <div className="flex h-12 w-12 items-center justify-center rounded-2xl bg-white text-civic-danger">
+                    <Icon className="h-6 w-6" />
+                  </div>
+                  <span className="rounded-full bg-white px-3 py-1 text-xs font-semibold text-civic-danger">Select</span>
+                </div>
+                <h3 className="mt-4 text-lg font-semibold text-civic-text">{title}</h3>
+                <p className="mt-2 text-sm leading-6 text-civic-muted">{summary}</p>
+              </button>
+            ))}
+          </div>
+        </section>
+
+        <div className="space-y-6">
+          <section className="rounded-[2rem] border border-slate-200 bg-white p-6 shadow-sm">
+            <div className="flex items-center gap-3">
+              <div className="flex h-11 w-11 items-center justify-center rounded-2xl bg-civic-danger/10 text-civic-danger">
+                <ShieldAlert className="h-5 w-5" />
+              </div>
+              <div>
+                <p className="text-sm font-semibold uppercase tracking-[0.16em] text-civic-secondary">Form scope</p>
+                <h2 className="text-xl font-semibold text-civic-text">Minimal fields for emergency submission</h2>
+              </div>
+            </div>
+
+            <div className="mt-5 space-y-3">
+              {minimalFields.map((field) => (
+                <div key={field} className="rounded-2xl bg-slate-50 px-4 py-3 text-sm font-medium text-civic-text">
+                  {field}
+                </div>
+              ))}
+            </div>
+          </section>
+
+          <section className="rounded-[2rem] border border-amber-200 bg-amber-50 p-6 shadow-sm">
+            <div className="flex items-start gap-3">
+              <AlertTriangle className="mt-0.5 h-5 w-5 text-amber-700" />
+              <div>
+                <h2 className="text-lg font-semibold text-amber-950">Emergency reporting principles</h2>
+                <p className="mt-2 text-sm leading-6 text-amber-900/85">
+                  This flow stays shorter than normal reporting and focuses only on what responders need first.
+                </p>
+              </div>
+            </div>
+
+            <div className="mt-5 space-y-3">
+              {emergencyRules.map((rule) => (
+                <div key={rule} className="rounded-2xl bg-white/75 px-4 py-3 text-sm leading-6 text-amber-950">
+                  {rule}
+                </div>
+              ))}
+            </div>
+          </section>
+        </div>
+      </section>
+
+      <section className="flex flex-wrap items-center justify-between gap-4 rounded-[2rem] border border-slate-200 bg-white p-6 shadow-sm">
+        <div>
+          <p className="text-sm font-semibold uppercase tracking-[0.22em] text-civic-secondary">Switch reporting modes</p>
+          <h2 className="mt-2 text-2xl font-semibold text-civic-text">Return to the normal report flow or operations dashboard.</h2>
+          <p className="mt-2 max-w-2xl text-sm leading-6 text-civic-muted">
+            Use the standard reporting flow for non-emergency complaints, or return to the dashboard to monitor active work.
+          </p>
+        </div>
+
+        <div className="flex flex-wrap gap-3">
+          <Link
+            className="inline-flex rounded-full border border-slate-200 px-5 py-3 text-sm font-semibold text-slate-700 transition hover:border-civic-primary hover:text-civic-primary"
+            href="/report"
+          >
+            Back to normal report flow
+          </Link>
+          <Link
+            className="inline-flex rounded-full bg-slate-900 px-5 py-3 text-sm font-semibold text-white transition hover:-translate-y-0.5"
+            href="/dashboard"
+          >
+            Return to dashboard
+          </Link>
+        </div>
+      </section>
+    </AppShell>
+  );
+}

civic-platform/app/globals.css

@@ -0,0 +1,61 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+@import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&display=swap');
+@import "mapbox-gl/dist/mapbox-gl.css";
+
+:root {
+  color-scheme: light;
+}
+
+html {
+  scroll-behavior: smooth;
+}
+
+body {
+  margin: 0;
+  min-height: 100vh;
+  background: 
+    radial-gradient(circle at top left, rgba(20, 184, 166, 0.08), transparent 45%),
+    radial-gradient(circle at bottom right, rgba(15, 76, 129, 0.08), transparent 40%),
+    linear-gradient(to bottom, #f8fafc, #f1f5f9);
+  background-attachment: fixed;
+  color: #0f172a;
+  font-family: 'Inter', Arial, Helvetica, sans-serif;
+  letter-spacing: -0.015em;
+  overflow-x: hidden;
+  -webkit-font-smoothing: antialiased;
+}
+
+/* Premium Scrollbar */
+::-webkit-scrollbar {
+  width: 8px;
+  height: 8px;
+}
+
+::-webkit-scrollbar-track {
+  background: transparent;
+}
+
+::-webkit-scrollbar-thumb {
+  background: rgba(100, 116, 139, 0.3);
+  border-radius: 10px;
+}
+
+::-webkit-scrollbar-thumb:hover {
+  background: rgba(100, 116, 139, 0.5);
+}
+
+* {
+  box-sizing: border-box;
+}
+
+a {
+  color: inherit;
+  text-decoration: none;
+}
+
+a {
+  color: inherit;
+  text-decoration: none;
+}

civic-platform/app/layout.tsx

@@ -0,0 +1,19 @@
+import type { Metadata } from "next";
+import "./globals.css";
+
+export const metadata: Metadata = {
+  title: "Civic Platform",
+  description: "Crowdsourced civic issue reporting and resolution system",
+};
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode;
+}>) {
+  return (
+    <html lang="en">
+      <body suppressHydrationWarning>{children}</body>
+    </html>
+  );
+}

civic-platform/app/login/page.tsx

@@ -0,0 +1,40 @@
+import { redirect } from "next/navigation";
+import { ShieldCheck } from "lucide-react";
+import { AppShell } from "@/components/app-shell";
+import { LoginForm } from "@/components/login-form";
+import { getCurrentUser } from "@/lib/auth";
+
+export default async function LoginPage() {
+  const user = await getCurrentUser();
+
+  if (user) {
+    redirect(user.role === "citizen" ? "/complaints" : user.role === "field_officer" ? "/tasks" : "/dashboard");
+  }
+
+  return (
+    <AppShell>
+      <div className="mx-auto flex min-h-[75vh] w-full max-w-[420px] flex-col justify-center py-10 px-4 sm:px-0">
+        <div className="mb-8 flex flex-col items-center text-center">
+          <div className="mb-6 flex h-16 w-16 items-center justify-center rounded-[1.5rem] bg-gradient-to-br from-civic-primary to-[#0b5d87] text-white shadow-xl shadow-civic-primary/20">
+            <ShieldCheck className="h-8 w-8" />
+          </div>
+          <h1 className="text-3xl font-extrabold tracking-tight text-slate-900">
+            Welcome back
+          </h1>
+          <p className="mt-2 text-base text-slate-500">
+            Sign in or create an account to participate
+          </p>
+        </div>
+
+        <div className="relative w-full">
+          {/* Subtle background glow */}
+          <div className="absolute -inset-1 rounded-[2.5rem] bg-gradient-to-br from-civic-primary/15 via-transparent to-civic-secondary/10 blur-xl"></div>
+          
+          <div className="relative rounded-[2.5rem] border border-white/60 bg-white/70 p-6 shadow-2xl shadow-sky-900/5 backdrop-blur-2xl sm:p-8">
+            <LoginForm />
+          </div>
+        </div>
+      </div>
+    </AppShell>
+  );
+}

civic-platform/app/map/page.tsx

@@ -0,0 +1,59 @@
+import { AppShell } from "@/components/app-shell";
+import { IssueMapBoard } from "@/components/issue-map-board";
+import { getCurrentUser } from "@/lib/auth";
+import {
+  getMapComplaints,
+  getPublicHotspots,
+  type ComplaintHotspotItem,
+  type ComplaintMapItem,
+} from "@/lib/api";
+
+const fallbackComplaints: ComplaintMapItem[] = [];
+const fallbackHotspots: ComplaintHotspotItem[] = [];
+
+export default async function MapPage() {
+  const user = await getCurrentUser();
+  const mapboxToken = process.env.MAPBOX_TOKEN ?? process.env.NEXT_PUBLIC_MAPBOX_TOKEN;
+  const isOperationsView =
+    user?.role === "department_operator" || user?.role === "municipal_admin" || user?.role === "field_officer";
+
+  let complaints = fallbackComplaints;
+  let hotspots = fallbackHotspots;
+
+  try {
+    [complaints, hotspots] = await Promise.all([
+      getMapComplaints({ publicOnly: !isOperationsView }),
+      getPublicHotspots(),
+    ]);
+  } catch {
+    complaints = fallbackComplaints;
+    hotspots = fallbackHotspots;
+  }
+
+  return (
+    <AppShell>
+      <section className="space-y-3">
+        <p className="text-sm font-semibold uppercase tracking-[0.22em] text-civic-secondary">
+          {isOperationsView ? "Operations map" : "Public map"}
+        </p>
+        <h1 className="text-4xl font-semibold tracking-tight text-civic-text">
+          {isOperationsView
+            ? "Monitor live civic issue activity with city-wide visibility."
+            : "Explore active civic issues and hotspots across the city."}
+        </h1>
+        <p className="max-w-3xl text-sm leading-7 text-civic-muted">
+          {isOperationsView
+            ? "Use the live operations map to spot workload clusters, emergency incidents, and active complaint zones."
+            : "Residents can browse public-safe complaint activity, see active clusters, and understand where issues are already being addressed."}
+        </p>
+      </section>
+
+      <IssueMapBoard
+        complaints={complaints}
+        hotspots={hotspots}
+        mapboxToken={mapboxToken}
+        mode={isOperationsView ? "operations" : "public"}
+      />
+    </AppShell>
+  );
+}

civic-platform/app/notifications/page.tsx

@@ -0,0 +1,35 @@
+import { AppShell } from "@/components/app-shell";
+import { LiveSyncBadge } from "@/components/live-sync-badge";
+import { NotificationCenter } from "@/components/notification-center";
+import { requireUser } from "@/lib/auth";
+import { getNotifications, type ComplaintNotificationItem } from "@/lib/api";
+
+const fallbackNotifications: ComplaintNotificationItem[] = [];
+
+export default async function NotificationsPage() {
+  const user = await requireUser();
+  let notifications = fallbackNotifications;
+
+  try {
+    notifications = await getNotifications(user.id);
+  } catch {
+    notifications = fallbackNotifications;
+  }
+
+  return (
+    <AppShell>
+      <section className="space-y-3">
+        <div className="flex flex-wrap items-center justify-between gap-3">
+          <p className="text-sm font-semibold uppercase tracking-[0.22em] text-civic-secondary">Notifications</p>
+          <LiveSyncBadge label="Inbox live refresh" />
+        </div>
+        <h1 className="text-4xl font-semibold tracking-tight text-civic-text">See the latest updates on your work and complaints.</h1>
+        <p className="max-w-3xl text-sm leading-7 text-civic-muted">
+          Assignment, field progress, reopening, and citizen verification updates appear here.
+        </p>
+      </section>
+
+      <NotificationCenter notifications={notifications} userId={user.id} />
+    </AppShell>
+  );
+}

civic-platform/app/page.tsx

@@ -0,0 +1,15 @@
+import { DomainGrid } from "@/components/domain-grid";
+import { Hero } from "@/components/hero";
+import { AppShell } from "@/components/app-shell";
+
+export default function Home() {
+  return (
+    <AppShell>
+      <Hero />
+
+      <section id="domains" className="py-6">
+        <DomainGrid />
+      </section>
+    </AppShell>
+  );
+}

civic-platform/app/report/location/page.tsx

@@ -0,0 +1,170 @@
+import Link from "next/link";
+import { Crosshair, MapPinned, Navigation, ShieldAlert, Sparkles } from "lucide-react";
+import { AppShell } from "@/components/app-shell";
+import { FlowSteps } from "@/components/flow-steps";
+
+const steps = ["Choose domain", "Add evidence", "Confirm location", "Review", "Submit"];
+
+const locationChecks = [
+  "Use current GPS for the quickest routing path.",
+  "If GPS is weak, move the map pin to the exact road, lane, or landmark.",
+  "Mention a nearby landmark so field staff can find the problem faster.",
+  "Emergency incidents should be pinned as precisely as possible.",
+];
+
+const locationFields = [
+  "Latitude and longitude",
+  "Resolved address",
+  "Ward or zone",
+  "Nearby landmark",
+  "Road or locality name",
+  "Manual pin adjustment status",
+];
+
+export default function ReportLocationPage() {
+  return (
+    <AppShell>
+      <section className="space-y-6">
+        <div className="space-y-3">
+          <p className="text-sm font-semibold uppercase tracking-[0.22em] text-civic-secondary">Report flow</p>
+          <h1 className="text-4xl font-semibold tracking-tight text-civic-text">Confirm the issue location</h1>
+          <p className="max-w-3xl text-sm leading-7 text-civic-muted">
+            This step helps the system assign the correct ward, identify the responsible department, and improve
+            routing accuracy for field teams.
+          </p>
+        </div>
+
+        <FlowSteps currentStep={3} steps={steps} />
+      </section>
+
+      <section className="grid gap-6 lg:grid-cols-[1.15fr_0.85fr]">
+        <div className="rounded-[2rem] border border-slate-200 bg-white p-6 shadow-sm sm:p-8">
+          <div className="flex flex-wrap items-start justify-between gap-4">
+            <div className="space-y-2">
+              <p className="text-sm font-semibold uppercase tracking-[0.22em] text-civic-secondary">Step 3</p>
+              <h2 className="text-2xl font-semibold text-civic-text">Map and address confirmation</h2>
+              <p className="max-w-2xl text-sm leading-6 text-civic-muted">
+                In the MVP, this screen should open the user location, show a map preview, and let the citizen correct
+                the pin before moving to review.
+              </p>
+            </div>
+            <div className="rounded-full bg-slate-100 px-4 py-2 text-sm font-semibold text-slate-700">
+              Routing-ready
+            </div>
+          </div>
+
+          <div className="mt-6 rounded-[1.75rem] border border-slate-200 bg-slate-50 p-5">
+            <div className="flex items-center gap-3">
+              <div className="flex h-12 w-12 items-center justify-center rounded-2xl bg-civic-primary text-white">
+                <MapPinned className="h-6 w-6" />
+              </div>
+              <div>
+                <p className="text-sm font-semibold uppercase tracking-[0.16em] text-civic-secondary">Interactive map</p>
+                <h3 className="text-lg font-semibold text-civic-text">Pinned complaint location</h3>
+              </div>
+            </div>
+
+            <div className="mt-5 flex min-h-[22rem] items-center justify-center rounded-[1.5rem] border border-dashed border-slate-300 bg-[linear-gradient(135deg,rgba(15,76,129,0.05),rgba(20,184,166,0.08))] p-6 text-center">
+              <div className="max-w-md space-y-3">
+                <div className="mx-auto flex h-14 w-14 items-center justify-center rounded-full bg-white shadow-sm">
+                  <Navigation className="h-6 w-6 text-civic-primary" />
+                </div>
+                <h4 className="text-xl font-semibold text-civic-text">Map preview placeholder</h4>
+                <p className="text-sm leading-6 text-civic-muted">
+                  This area will use Leaflet with OpenStreetMap tiles, current location detection, drag-to-adjust pin,
+                  and reverse geocoding for address confirmation.
+                </p>
+              </div>
+            </div>
+
+            <div className="mt-5 flex flex-wrap gap-3">
+              <button
+                type="button"
+                className="inline-flex items-center gap-2 rounded-full bg-civic-primary px-5 py-3 text-sm font-semibold text-white transition hover:-translate-y-0.5"
+              >
+                <Crosshair className="h-4 w-4" />
+                Use current location
+              </button>
+              <button
+                type="button"
+                className="inline-flex items-center gap-2 rounded-full border border-slate-200 bg-white px-5 py-3 text-sm font-semibold text-slate-700 transition hover:border-civic-primary hover:text-civic-primary"
+              >
+                <MapPinned className="h-4 w-4" />
+                Adjust map pin
+              </button>
+            </div>
+          </div>
+        </div>
+
+        <div className="space-y-6">
+          <section className="rounded-[2rem] border border-slate-200 bg-white p-6 shadow-sm">
+            <div className="flex items-center gap-3">
+              <div className="flex h-11 w-11 items-center justify-center rounded-2xl bg-civic-secondary/15 text-civic-secondary">
+                <Sparkles className="h-5 w-5" />
+              </div>
+              <div>
+                <p className="text-sm font-semibold uppercase tracking-[0.16em] text-civic-secondary">Stored data</p>
+                <h2 className="text-xl font-semibold text-civic-text">Location fields for the complaint</h2>
+              </div>
+            </div>
+
+            <div className="mt-5 grid gap-3">
+              {locationFields.map((field) => (
+                <div key={field} className="rounded-2xl bg-slate-50 px-4 py-3 text-sm font-medium text-civic-text">
+                  {field}
+                </div>
+              ))}
+            </div>
+          </section>
+
+          <section className="rounded-[2rem] border border-amber-200 bg-amber-50 p-6 shadow-sm">
+            <div className="flex items-start gap-3">
+              <ShieldAlert className="mt-0.5 h-5 w-5 text-amber-700" />
+              <div>
+                <h2 className="text-lg font-semibold text-amber-950">Accuracy matters for emergency routing</h2>
+                <p className="mt-2 text-sm leading-6 text-amber-900/85">
+                  A precise location helps responders find the incident faster, especially in flood, fire, collapse,
+                  or live wire complaints.
+                </p>
+              </div>
+            </div>
+
+            <div className="mt-5 space-y-3">
+              {locationChecks.map((item) => (
+                <div key={item} className="rounded-2xl bg-white/70 px-4 py-3 text-sm leading-6 text-amber-950">
+                  {item}
+                </div>
+              ))}
+            </div>
+          </section>
+        </div>
+      </section>
+
+      <section className="flex flex-wrap items-center justify-between gap-4 rounded-[2rem] border border-slate-200 bg-white p-6 shadow-sm">
+        <div>
+          <p className="text-sm font-semibold uppercase tracking-[0.22em] text-civic-secondary">Next step</p>
+          <h2 className="mt-2 text-2xl font-semibold text-civic-text">Review complaint details before submission</h2>
+          <p className="mt-2 max-w-2xl text-sm leading-6 text-civic-muted">
+            After location is confirmed, the user should see a review screen with domain, evidence, location, and the
+            initial routing preview.
+          </p>
+        </div>
+
+        <div className="flex flex-wrap gap-3">
+          <Link
+            className="inline-flex rounded-full border border-slate-200 px-5 py-3 text-sm font-semibold text-slate-700 transition hover:border-civic-primary hover:text-civic-primary"
+            href="/report"
+          >
+            Back to report
+          </Link>
+          <Link
+            className="inline-flex rounded-full bg-civic-primary px-5 py-3 text-sm font-semibold text-white transition hover:-translate-y-0.5"
+            href="/report/review"
+          >
+            Continue to review
+          </Link>
+        </div>
+      </section>
+    </AppShell>
+  );
+}

civic-platform/app/report/page.tsx

@@ -0,0 +1,27 @@
+import { AppShell } from "@/components/app-shell";
+import { ReportForm } from "@/components/report-form";
+import { requireRole } from "@/lib/auth";
+
+export default async function ReportIssuePage() {
+  const user = await requireRole(["citizen"]);
+
+  return (
+    <AppShell>
+      <div className="mx-auto max-w-3xl space-y-8 pt-8">
+        <div className="text-center space-y-4">
+          <p className="text-sm font-bold uppercase tracking-[0.2em] text-civic-secondary">
+            Citizen Reporting
+          </p>
+          <h1 className="text-4xl font-extrabold tracking-tight text-slate-900 sm:text-5xl">
+            File a Report
+          </h1>
+          <p className="mx-auto max-w-xl text-lg text-slate-500">
+            Tell us what happened and where. We will get it to the right department.
+          </p>
+        </div>
+
+        <ReportForm citizenId={user.id} />
+      </div>
+    </AppShell>
+  );
+}

civic-platform/app/report/review/page.tsx

@@ -0,0 +1,165 @@
+import Link from "next/link";
+import { AlertTriangle, CheckCircle2, ChevronRight, ClipboardList, LocateFixed, ShieldAlert } from "lucide-react";
+import { AppShell } from "@/components/app-shell";
+import { FlowSteps } from "@/components/flow-steps";
+
+const steps = ["Choose domain", "Add evidence", "Confirm location", "Review", "Submit"];
+
+const reviewSections = [
+  {
+    icon: ClipboardList,
+    title: "Complaint summary",
+    items: [
+      "Selected domain: Water Supply, Sewerage, and Drainage",
+      "Likely sub-problem: Sewage overflow",
+      "Urgency hint: High public impact",
+      "Citizen note: Overflow near market entrance and bus stop",
+    ],
+  },
+  {
+    icon: LocateFixed,
+    title: "Location confirmation",
+    items: [
+      "Coordinates captured from device",
+      "Address resolved from map pin",
+      "Ward and routing zone ready",
+      "Nearby landmark noted for field staff",
+    ],
+  },
+  {
+    icon: CheckCircle2,
+    title: "Evidence attached",
+    items: [
+      "1 photo uploaded",
+      "0 video clips",
+      "Optional voice note available for later support",
+      "Media summary ready for department review",
+    ],
+  },
+];
+
+const routingPreview = [
+  "Primary department: Water and Sewerage",
+  "Secondary support: Drainage unit if monsoon overflow is detected",
+  "Initial priority: P2 High",
+  "Notification path: citizen confirmation after submission",
+];
+
+const submitChecks = [
+  "Location is correct",
+  "Complaint is within city jurisdiction",
+  "Media is safe and relevant",
+  "Description is clear enough for field response",
+];
+
+export default function ReportReviewPage() {
+  return (
+    <AppShell>
+      <section className="space-y-6">
+        <div className="space-y-3">
+          <p className="text-sm font-semibold uppercase tracking-[0.22em] text-civic-secondary">Report flow</p>
+          <h1 className="text-4xl font-semibold tracking-tight text-civic-text">Review before final submission</h1>
+          <p className="max-w-3xl text-sm leading-7 text-civic-muted">
+            Check the issue details, location, and evidence once more before sending the complaint to the city team.
+          </p>
+        </div>
+
+        <FlowSteps currentStep={4} steps={steps} />
+      </section>
+
+      <section className="grid gap-6 lg:grid-cols-[1.12fr_0.88fr]">
+        <div className="space-y-6">
+          {reviewSections.map(({ icon: Icon, title, items }) => (
+            <section key={title} className="rounded-[2rem] border border-slate-200 bg-white p-6 shadow-sm">
+              <div className="flex items-center gap-3">
+                <div className="flex h-11 w-11 items-center justify-center rounded-2xl bg-civic-secondary/15 text-civic-secondary">
+                  <Icon className="h-5 w-5" />
+                </div>
+              <div>
+                  <p className="text-sm font-semibold uppercase tracking-[0.16em] text-civic-secondary">Summary</p>
+                  <h2 className="text-xl font-semibold text-civic-text">{title}</h2>
+              </div>
+              </div>
+
+              <div className="mt-5 grid gap-3">
+                {items.map((item) => (
+                  <div key={item} className="rounded-2xl bg-slate-50 px-4 py-3 text-sm leading-6 text-civic-text">
+                    {item}
+                  </div>
+                ))}
+              </div>
+            </section>
+          ))}
+        </div>
+
+        <div className="space-y-6">
+          <section className="rounded-[2rem] border border-slate-200 bg-white p-6 shadow-sm">
+            <div className="flex items-center gap-3">
+              <div className="flex h-11 w-11 items-center justify-center rounded-2xl bg-civic-primary text-white">
+                <ShieldAlert className="h-5 w-5" />
+              </div>
+              <div>
+                <p className="text-sm font-semibold uppercase tracking-[0.16em] text-civic-secondary">Routing preview</p>
+                <h2 className="text-xl font-semibold text-civic-text">What the system will do next</h2>
+              </div>
+            </div>
+
+            <div className="mt-5 space-y-3">
+              {routingPreview.map((item) => (
+                <div key={item} className="rounded-2xl bg-slate-50 px-4 py-3 text-sm leading-6 text-civic-text">
+                  {item}
+                </div>
+              ))}
+            </div>
+          </section>
+
+          <section className="rounded-[2rem] border border-amber-200 bg-amber-50 p-6 shadow-sm">
+            <div className="flex items-start gap-3">
+              <AlertTriangle className="mt-0.5 h-5 w-5 text-amber-700" />
+              <div>
+                <h2 className="text-lg font-semibold text-amber-950">Final checks before submission</h2>
+                <p className="mt-2 text-sm leading-6 text-amber-900/85">
+                  A quick final check helps the city team act faster and reduces follow-up questions.
+                </p>
+              </div>
+            </div>
+
+            <div className="mt-5 space-y-3">
+              {submitChecks.map((item) => (
+                <div key={item} className="rounded-2xl bg-white/75 px-4 py-3 text-sm font-medium text-amber-950">
+                  {item}
+                </div>
+              ))}
+            </div>
+          </section>
+        </div>
+      </section>
+
+      <section className="flex flex-wrap items-center justify-between gap-4 rounded-[2rem] border border-slate-200 bg-white p-6 shadow-sm">
+        <div>
+          <p className="text-sm font-semibold uppercase tracking-[0.22em] text-civic-secondary">Submit complaint</p>
+          <h2 className="mt-2 text-2xl font-semibold text-civic-text">Ready to create the complaint record</h2>
+          <p className="mt-2 max-w-2xl text-sm leading-6 text-civic-muted">
+            Once submitted, your complaint will receive an ID and move into review, routing, and department assignment.
+          </p>
+        </div>
+
+        <div className="flex flex-wrap gap-3">
+          <Link
+            className="inline-flex rounded-full border border-slate-200 px-5 py-3 text-sm font-semibold text-slate-700 transition hover:border-civic-primary hover:text-civic-primary"
+            href="/report/location"
+          >
+            Back to location
+          </Link>
+          <Link
+            className="inline-flex items-center gap-2 rounded-full bg-civic-primary px-5 py-3 text-sm font-semibold text-white transition hover:-translate-y-0.5"
+            href="/report/success"
+          >
+            Submit complaint
+            <ChevronRight className="h-4 w-4" />
+          </Link>
+        </div>
+      </section>
+    </AppShell>
+  );
+}

civic-platform/app/report/success/page.tsx

@@ -0,0 +1,173 @@
+import Link from "next/link";
+import { ArrowRight, CheckCircle2, Clock3, Hash, MapPinned, ShieldCheck } from "lucide-react";
+import { AppShell } from "@/components/app-shell";
+import { FlowSteps } from "@/components/flow-steps";
+
+const steps = ["Choose domain", "Add evidence", "Confirm location", "Review", "Submit"];
+
+const nextActions = [
+  "Your report is stored with a complaint ID for tracking.",
+  "The first visible status is Submitted.",
+  "Routing and priority decide which department picks it up next.",
+  "You will see updates when the complaint is assigned, worked on, or resolved.",
+];
+
+const summaryCards = [
+  {
+    icon: Hash,
+    label: "Complaint ID",
+    value: "CP-2026-00124",
+  },
+  {
+    icon: Clock3,
+    label: "Current status",
+    value: "Submitted",
+  },
+  {
+    icon: MapPinned,
+    label: "Location state",
+    value: "Geo-tag confirmed",
+  },
+];
+
+type ReportSuccessPageProps = {
+  searchParams?: Promise<{
+    id?: string;
+    code?: string;
+    media?: string;
+  }>;
+};
+
+export default async function ReportSuccessPage({ searchParams }: ReportSuccessPageProps) {
+  const resolvedSearchParams = searchParams ? await searchParams : undefined;
+  const complaintId = resolvedSearchParams?.id ?? "sample-complaint";
+  const complaintCode = resolvedSearchParams?.code ?? "CP-2026-00124";
+  const mediaStatus = resolvedSearchParams?.media ?? "complete";
+
+  return (
+    <AppShell>
+      <section className="space-y-6">
+        <div className="space-y-3">
+          <p className="text-sm font-semibold uppercase tracking-[0.22em] text-civic-secondary">Report flow</p>
+          <h1 className="text-4xl font-semibold tracking-tight text-civic-text">Complaint submitted successfully</h1>
+          <p className="max-w-3xl text-sm leading-7 text-civic-muted">
+            Your complaint has been recorded. Keep the complaint ID handy and use the tracking page for updates.
+          </p>
+        </div>
+
+        <FlowSteps currentStep={5} steps={steps} />
+      </section>
+
+      <section className="rounded-[2rem] bg-civic-primary px-6 py-8 text-white shadow-civic lg:px-8">
+        <div className="grid gap-8 lg:grid-cols-[1.15fr_0.85fr]">
+          <div className="space-y-5">
+            <div className="flex h-16 w-16 items-center justify-center rounded-3xl bg-white text-civic-primary">
+              <CheckCircle2 className="h-8 w-8" />
+            </div>
+            <div className="space-y-3">
+              <h2 className="text-3xl font-semibold tracking-tight">Your complaint is now in the system.</h2>
+              <p className="max-w-2xl text-sm leading-7 text-white/80">
+                It will now move through review, routing, assignment, and resolution. You can track progress from your
+                complaints page at any time.
+              </p>
+              {mediaStatus === "partial" ? (
+                <p className="rounded-2xl bg-white/10 px-4 py-3 text-sm text-white/90">
+                  Your complaint was submitted, but one or more media files could not be uploaded.
+                </p>
+              ) : null}
+            </div>
+            <div className="flex flex-wrap gap-3">
+              <Link
+                className="inline-flex items-center gap-2 rounded-full bg-white px-5 py-3 text-sm font-semibold text-civic-primary transition hover:-translate-y-0.5"
+                href="/complaints"
+              >
+                View my complaints
+                <ArrowRight className="h-4 w-4" />
+              </Link>
+              <Link
+                className="inline-flex items-center gap-2 rounded-full border border-white/30 px-5 py-3 text-sm font-semibold text-white transition hover:bg-white/10"
+                href={`/complaints/${complaintId}`}
+              >
+                Open complaint detail
+                <ArrowRight className="h-4 w-4" />
+              </Link>
+            </div>
+          </div>
+
+          <div className="grid gap-4">
+            {summaryCards.map(({ icon: Icon, label, value }) => (
+              <div key={label} className="rounded-3xl border border-white/15 bg-white/10 p-5 backdrop-blur">
+                <Icon className="mb-4 h-6 w-6 text-civic-accent" />
+                <p className="text-sm font-semibold uppercase tracking-[0.16em] text-white/75">{label}</p>
+                <p className="mt-2 text-xl font-semibold text-white">
+                  {label === "Complaint ID" ? complaintCode : value}
+                </p>
+              </div>
+            ))}
+          </div>
+        </div>
+      </section>
+
+      <section className="grid gap-6 lg:grid-cols-[1fr_1fr]">
+        <section className="rounded-[2rem] border border-slate-200 bg-white p-6 shadow-sm">
+          <div className="flex items-center gap-3">
+            <div className="flex h-11 w-11 items-center justify-center rounded-2xl bg-civic-secondary/15 text-civic-secondary">
+              <ShieldCheck className="h-5 w-5" />
+            </div>
+            <div>
+              <p className="text-sm font-semibold uppercase tracking-[0.16em] text-civic-secondary">What happens next</p>
+              <h2 className="text-xl font-semibold text-civic-text">Post-submission workflow</h2>
+            </div>
+          </div>
+
+          <div className="mt-5 space-y-3">
+            {nextActions.map((item) => (
+              <div key={item} className="rounded-2xl bg-slate-50 px-4 py-3 text-sm leading-6 text-civic-text">
+                {item}
+              </div>
+            ))}
+          </div>
+        </section>
+
+          <section className="rounded-[2rem] border border-slate-200 bg-white p-6 shadow-sm">
+          <p className="text-sm font-semibold uppercase tracking-[0.22em] text-civic-secondary">Helpful shortcuts</p>
+          <h2 className="mt-2 text-2xl font-semibold text-civic-text">What you can do from here</h2>
+          <p className="mt-3 text-sm leading-7 text-civic-muted">
+            You can report another issue, open the complaint detail page, or switch to emergency reporting if the
+            situation has become urgent.
+          </p>
+
+          <div className="mt-6 grid gap-3 sm:grid-cols-2">
+            {[
+              "Complaint ID",
+              "Current status",
+              "Expected next step",
+              "Tracking shortcut",
+              "Submit another issue",
+              "Emergency reporting shortcut",
+            ].map((item) => (
+              <div key={item} className="rounded-2xl border border-slate-200 p-4 text-sm font-medium text-civic-text">
+                {item}
+              </div>
+            ))}
+          </div>
+
+          <div className="mt-6 flex flex-wrap gap-3">
+            <Link
+              className="inline-flex rounded-full border border-slate-200 px-5 py-3 text-sm font-semibold text-slate-700 transition hover:border-civic-primary hover:text-civic-primary"
+              href="/report"
+            >
+              Submit another issue
+            </Link>
+            <Link
+              className="inline-flex rounded-full bg-civic-danger px-5 py-3 text-sm font-semibold text-white transition hover:-translate-y-0.5"
+              href="/emergency"
+            >
+              Emergency reporting
+            </Link>
+          </div>
+        </section>
+      </section>
+    </AppShell>
+  );
+}

civic-platform/app/tasks/page.tsx

@@ -0,0 +1,35 @@
+import { AppShell } from "@/components/app-shell";
+import { FieldTaskBoard } from "@/components/field-task-board";
+import { LiveSyncBadge } from "@/components/live-sync-badge";
+import { requireRole } from "@/lib/auth";
+import { getOfficerAssignments, type ComplaintAssignmentItem } from "@/lib/api";
+
+const fallbackAssignments: ComplaintAssignmentItem[] = [];
+
+export default async function TasksPage() {
+  const user = await requireRole(["field_officer"]);
+  let assignments = fallbackAssignments;
+
+  try {
+    assignments = await getOfficerAssignments(user.id);
+  } catch {
+    assignments = fallbackAssignments;
+  }
+
+  return (
+    <AppShell>
+      <section className="space-y-3">
+        <div className="flex flex-wrap items-center justify-between gap-3">
+          <p className="text-sm font-semibold uppercase tracking-[0.22em] text-civic-secondary">Field operations</p>
+          <LiveSyncBadge label="Task board live refresh" />
+        </div>
+        <h1 className="text-4xl font-semibold tracking-tight text-civic-text">Work through assigned on-ground tasks.</h1>
+        <p className="max-w-3xl text-sm leading-7 text-civic-muted">
+          Accept work, start field action, and mark completion so the complaint lifecycle stays accurate for citizens and operators.
+        </p>
+      </section>
+
+      <FieldTaskBoard assignments={assignments} officerId={user.id} />
+    </AppShell>
+  );
+}

civic-platform/app/template.tsx

@@ -0,0 +1,16 @@
+"use client";
+
+import { motion } from "framer-motion";
+
+export default function Template({ children }: { children: React.ReactNode }) {
+  return (
+    <motion.div
+      initial={{ opacity: 0, y: 15 }}
+      animate={{ opacity: 1, y: 0 }}
+      exit={{ opacity: 0, y: -15 }}
+      transition={{ ease: "circOut", duration: 0.4 }}
+    >
+      {children}
+    </motion.div>
+  );
+}

civic-platform/backend/.env.example

@@ -0,0 +1,12 @@
+PORT=4000
+NODE_ENV=development
+DB_HOST=localhost
+DB_PORT=5432
+DB_NAME=civicpulse
+DB_USER=postgres
+DB_PASSWORD=your_password_here
+DB_SSL=false
+DEMO_AUTH_PASSWORD=civicpulse123
+CORS_ORIGINS=http://localhost:3000
+RATE_LIMIT_WINDOW_MS=60000
+RATE_LIMIT_MAX_REQUESTS=120

civic-platform/backend/README.md

@@ -0,0 +1,38 @@
+# Backend
+
+Node.js and TypeScript backend for the CivicPulse project.
+
+## Quick start
+
+1. Copy `.env.example` to `.env`
+2. Set your PostgreSQL connection values
+3. Create the `civicpulse` database
+4. Apply `sql/001_initial_schema.sql`
+5. Apply `sql/002_seed_core_data.sql`
+6. Run `npm install`
+7. Run `npm run dev`
+
+Alternative local setup:
+
+- Run `npm run db:init` to apply both SQL files using the configured PostgreSQL connection
+
+## Main folders
+
+- `src/config` environment config
+- `src/db` PostgreSQL connection
+- `src/routes` shared routes
+- `src/modules/complaints` complaint APIs
+- `sql` database schema files
+
+## First routes
+
+- `GET /api/health`
+- `GET /api/departments`
+- `GET /api/domains`
+- `GET /api/complaints`
+- `GET /api/complaints/citizen/:citizenId`
+- `GET /api/complaints/:id`
+- `GET /api/complaints/:id/history`
+- `POST /api/complaints`
+- `PATCH /api/complaints/:id/status`
+- `POST /api/complaints/:id/assign`

civic-platform/backend/backend-dev.log

@@ -0,0 +1,5 @@
+
+> civicpulse-backend@0.1.0 dev
+> tsx watch src/server.ts
+
+CivicPulse backend listening on port 4000

civic-platform/backend/backend-run.log

@@ -0,0 +1,2 @@
+CivicPulse backend listening on port 4000
+^C

civic-platform/backend/backend.detached.log

@@ -0,0 +1 @@
+CivicPulse backend listening on port 4000

civic-platform/backend/package-lock.json

@@ -0,0 +1,1817 @@
+{
+  "name": "civicpulse-backend",
+  "version": "0.1.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "civicpulse-backend",
+      "version": "0.1.0",
+      "dependencies": {
+        "cors": "^2.8.5",
+        "dotenv": "^16.4.7",
+        "express": "^4.21.2",
+        "multer": "^2.1.1",
+        "pg": "^8.13.3"
+      },
+      "devDependencies": {
+        "@types/cors": "^2.8.17",
+        "@types/express": "^5.0.1",
+        "@types/multer": "^2.1.0",
+        "@types/node": "^22.13.10",
+        "@types/pg": "^8.11.11",
+        "tsx": "^4.19.3",
+        "typescript": "^5.8.2"
+      }
+    },
+    "node_modules/@esbuild/aix-ppc64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.27.4.tgz",
+      "integrity": "sha512-cQPwL2mp2nSmHHJlCyoXgHGhbEPMrEEU5xhkcy3Hs/O7nGZqEpZ2sUtLaL9MORLtDfRvVl2/3PAuEkYZH0Ty8Q==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "aix"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-arm": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.27.4.tgz",
+      "integrity": "sha512-X9bUgvxiC8CHAGKYufLIHGXPJWnr0OCdR0anD2e21vdvgCI8lIfqFbnoeOz7lBjdrAGUhqLZLcQo6MLhTO2DKQ==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-arm64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.27.4.tgz",
+      "integrity": "sha512-gdLscB7v75wRfu7QSm/zg6Rx29VLdy9eTr2t44sfTW7CxwAtQghZ4ZnqHk3/ogz7xao0QAgrkradbBzcqFPasw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/android-x64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.27.4.tgz",
+      "integrity": "sha512-PzPFnBNVF292sfpfhiyiXCGSn9HZg5BcAz+ivBuSsl6Rk4ga1oEXAamhOXRFyMcjwr2DVtm40G65N3GLeH1Lvw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-arm64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.27.4.tgz",
+      "integrity": "sha512-b7xaGIwdJlht8ZFCvMkpDN6uiSmnxxK56N2GDTMYPr2/gzvfdQN8rTfBsvVKmIVY/X7EM+/hJKEIbbHs9oA4tQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/darwin-x64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.27.4.tgz",
+      "integrity": "sha512-sR+OiKLwd15nmCdqpXMnuJ9W2kpy0KigzqScqHI3Hqwr7IXxBp3Yva+yJwoqh7rE8V77tdoheRYataNKL4QrPw==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/freebsd-arm64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.27.4.tgz",
+      "integrity": "sha512-jnfpKe+p79tCnm4GVav68A7tUFeKQwQyLgESwEAUzyxk/TJr4QdGog9sqWNcUbr/bZt/O/HXouspuQDd9JxFSw==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/freebsd-x64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.27.4.tgz",
+      "integrity": "sha512-2kb4ceA/CpfUrIcTUl1wrP/9ad9Atrp5J94Lq69w7UwOMolPIGrfLSvAKJp0RTvkPPyn6CIWrNy13kyLikZRZQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "freebsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-arm": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.27.4.tgz",
+      "integrity": "sha512-aBYgcIxX/wd5n2ys0yESGeYMGF+pv6g0DhZr3G1ZG4jMfruU9Tl1i2Z+Wnj9/KjGz1lTLCcorqE2viePZqj4Eg==",
+      "cpu": [
+        "arm"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-arm64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.27.4.tgz",
+      "integrity": "sha512-7nQOttdzVGth1iz57kxg9uCz57dxQLHWxopL6mYuYthohPKEK0vU0C3O21CcBK6KDlkYVcnDXY099HcCDXd9dA==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-ia32": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.27.4.tgz",
+      "integrity": "sha512-oPtixtAIzgvzYcKBQM/qZ3R+9TEUd1aNJQu0HhGyqtx6oS7qTpvjheIWBbes4+qu1bNlo2V4cbkISr8q6gRBFA==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-loong64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.27.4.tgz",
+      "integrity": "sha512-8mL/vh8qeCoRcFH2nM8wm5uJP+ZcVYGGayMavi8GmRJjuI3g1v6Z7Ni0JJKAJW+m0EtUuARb6Lmp4hMjzCBWzA==",
+      "cpu": [
+        "loong64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-mips64el": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.27.4.tgz",
+      "integrity": "sha512-1RdrWFFiiLIW7LQq9Q2NES+HiD4NyT8Itj9AUeCl0IVCA459WnPhREKgwrpaIfTOe+/2rdntisegiPWn/r/aAw==",
+      "cpu": [
+        "mips64el"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-ppc64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.27.4.tgz",
+      "integrity": "sha512-tLCwNG47l3sd9lpfyx9LAGEGItCUeRCWeAx6x2Jmbav65nAwoPXfewtAdtbtit/pJFLUWOhpv0FpS6GQAmPrHA==",
+      "cpu": [
+        "ppc64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-riscv64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.27.4.tgz",
+      "integrity": "sha512-BnASypppbUWyqjd1KIpU4AUBiIhVr6YlHx/cnPgqEkNoVOhHg+YiSVxM1RLfiy4t9cAulbRGTNCKOcqHrEQLIw==",
+      "cpu": [
+        "riscv64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-s390x": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.27.4.tgz",
+      "integrity": "sha512-+eUqgb/Z7vxVLezG8bVB9SfBie89gMueS+I0xYh2tJdw3vqA/0ImZJ2ROeWwVJN59ihBeZ7Tu92dF/5dy5FttA==",
+      "cpu": [
+        "s390x"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/linux-x64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.27.4.tgz",
+      "integrity": "sha512-S5qOXrKV8BQEzJPVxAwnryi2+Iq5pB40gTEIT69BQONqR7JH1EPIcQ/Uiv9mCnn05jff9umq/5nqzxlqTOg9NA==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-arm64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.27.4.tgz",
+      "integrity": "sha512-xHT8X4sb0GS8qTqiwzHqpY00C95DPAq7nAwX35Ie/s+LO9830hrMd3oX0ZMKLvy7vsonee73x0lmcdOVXFzd6Q==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/netbsd-x64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.27.4.tgz",
+      "integrity": "sha512-RugOvOdXfdyi5Tyv40kgQnI0byv66BFgAqjdgtAKqHoZTbTF2QqfQrFwa7cHEORJf6X2ht+l9ABLMP0dnKYsgg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "netbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-arm64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.27.4.tgz",
+      "integrity": "sha512-2MyL3IAaTX+1/qP0O1SwskwcwCoOI4kV2IBX1xYnDDqthmq5ArrW94qSIKCAuRraMgPOmG0RDTA74mzYNQA9ow==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openbsd-x64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.27.4.tgz",
+      "integrity": "sha512-u8fg/jQ5aQDfsnIV6+KwLOf1CmJnfu1ShpwqdwC0uA7ZPwFws55Ngc12vBdeUdnuWoQYx/SOQLGDcdlfXhYmXQ==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openbsd"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/openharmony-arm64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.27.4.tgz",
+      "integrity": "sha512-JkTZrl6VbyO8lDQO3yv26nNr2RM2yZzNrNHEsj9bm6dOwwu9OYN28CjzZkH57bh4w0I2F7IodpQvUAEd1mbWXg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "openharmony"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/sunos-x64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.27.4.tgz",
+      "integrity": "sha512-/gOzgaewZJfeJTlsWhvUEmUG4tWEY2Spp5M20INYRg2ZKl9QPO3QEEgPeRtLjEWSW8FilRNacPOg8R1uaYkA6g==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "sunos"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-arm64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.27.4.tgz",
+      "integrity": "sha512-Z9SExBg2y32smoDQdf1HRwHRt6vAHLXcxD2uGgO/v2jK7Y718Ix4ndsbNMU/+1Qiem9OiOdaqitioZwxivhXYg==",
+      "cpu": [
+        "arm64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-ia32": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.27.4.tgz",
+      "integrity": "sha512-DAyGLS0Jz5G5iixEbMHi5KdiApqHBWMGzTtMiJ72ZOLhbu/bzxgAe8Ue8CTS3n3HbIUHQz/L51yMdGMeoxXNJw==",
+      "cpu": [
+        "ia32"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@esbuild/win32-x64": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.27.4.tgz",
+      "integrity": "sha512-+knoa0BDoeXgkNvvV1vvbZX4+hizelrkwmGJBdT17t8FNPwG2lKemmuMZlmaNQ3ws3DKKCxpb4zRZEIp3UxFCg==",
+      "cpu": [
+        "x64"
+      ],
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@types/body-parser": {
+      "version": "1.19.6",
+      "resolved": "https://registry.npmjs.org/@types/body-parser/-/body-parser-1.19.6.tgz",
+      "integrity": "sha512-HLFeCYgz89uk22N5Qg3dvGvsv46B8GLvKKo1zKG4NybA8U2DiEO3w9lqGg29t/tfLRJpJ6iQxnVw4OnB7MoM9g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/connect": "*",
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/connect": {
+      "version": "3.4.38",
+      "resolved": "https://registry.npmjs.org/@types/connect/-/connect-3.4.38.tgz",
+      "integrity": "sha512-K6uROf1LD88uDQqJCktA4yzL1YYAK6NgfsI0v/mTgyPKWsX1CnJ0XPSDhViejru1GcRkLWb8RlzFYJRqGUbaug==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/cors": {
+      "version": "2.8.19",
+      "resolved": "https://registry.npmjs.org/@types/cors/-/cors-2.8.19.tgz",
+      "integrity": "sha512-mFNylyeyqN93lfe/9CSxOGREz8cpzAhH+E93xJ4xWQf62V8sQ/24reV2nyzUWM6H6Xji+GGHpkbLe7pVoUEskg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/express": {
+      "version": "5.0.6",
+      "resolved": "https://registry.npmjs.org/@types/express/-/express-5.0.6.tgz",
+      "integrity": "sha512-sKYVuV7Sv9fbPIt/442koC7+IIwK5olP1KWeD88e/idgoJqDm3JV/YUiPwkoKK92ylff2MGxSz1CSjsXelx0YA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/body-parser": "*",
+        "@types/express-serve-static-core": "^5.0.0",
+        "@types/serve-static": "^2"
+      }
+    },
+    "node_modules/@types/express-serve-static-core": {
+      "version": "5.1.1",
+      "resolved": "https://registry.npmjs.org/@types/express-serve-static-core/-/express-serve-static-core-5.1.1.tgz",
+      "integrity": "sha512-v4zIMr/cX7/d2BpAEX3KNKL/JrT1s43s96lLvvdTmza1oEvDudCqK9aF/djc/SWgy8Yh0h30TZx5VpzqFCxk5A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*",
+        "@types/qs": "*",
+        "@types/range-parser": "*",
+        "@types/send": "*"
+      }
+    },
+    "node_modules/@types/http-errors": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/@types/http-errors/-/http-errors-2.0.5.tgz",
+      "integrity": "sha512-r8Tayk8HJnX0FztbZN7oVqGccWgw98T/0neJphO91KkmOzug1KkofZURD4UaD5uH8AqcFLfdPErnBod0u71/qg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@types/multer": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/@types/multer/-/multer-2.1.0.tgz",
+      "integrity": "sha512-zYZb0+nJhOHtPpGDb3vqPjwpdeGlGC157VpkqNQL+UU2qwoacoQ7MpsAmUptI/0Oa127X32JzWDqQVEXp2RcIA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/express": "*"
+      }
+    },
+    "node_modules/@types/node": {
+      "version": "22.19.15",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-22.19.15.tgz",
+      "integrity": "sha512-F0R/h2+dsy5wJAUe3tAU6oqa2qbWY5TpNfL/RGmo1y38hiyO1w3x2jPtt76wmuaJI4DQnOBu21cNXQ2STIUUWg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "undici-types": "~6.21.0"
+      }
+    },
+    "node_modules/@types/pg": {
+      "version": "8.20.0",
+      "resolved": "https://registry.npmjs.org/@types/pg/-/pg-8.20.0.tgz",
+      "integrity": "sha512-bEPFOaMAHTEP1EzpvHTbmwR8UsFyHSKsRisLIHVMXnpNefSbGA1bD6CVy+qKjGSqmZqNqBDV2azOBo8TgkcVow==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*",
+        "pg-protocol": "*",
+        "pg-types": "^2.2.0"
+      }
+    },
+    "node_modules/@types/qs": {
+      "version": "6.15.0",
+      "resolved": "https://registry.npmjs.org/@types/qs/-/qs-6.15.0.tgz",
+      "integrity": "sha512-JawvT8iBVWpzTrz3EGw9BTQFg3BQNmwERdKE22vlTxawwtbyUSlMppvZYKLZzB5zgACXdXxbD3m1bXaMqP/9ow==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@types/range-parser": {
+      "version": "1.2.7",
+      "resolved": "https://registry.npmjs.org/@types/range-parser/-/range-parser-1.2.7.tgz",
+      "integrity": "sha512-hKormJbkJqzQGhziax5PItDUTMAM9uE2XXQmM37dyd4hVM+5aVl7oVxMVUiVQn2oCQFN/LKCZdvSM0pFRqbSmQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@types/send": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/@types/send/-/send-1.2.1.tgz",
+      "integrity": "sha512-arsCikDvlU99zl1g69TcAB3mzZPpxgw0UQnaHeC1Nwb015xp8bknZv5rIfri9xTOcMuaVgvabfIRA7PSZVuZIQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/serve-static": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/@types/serve-static/-/serve-static-2.2.0.tgz",
+      "integrity": "sha512-8mam4H1NHLtu7nmtalF7eyBH14QyOASmcxHhSfEoRyr0nP/YdoesEtU+uSRvMe96TW/HPTtkoKqQLl53N7UXMQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/http-errors": "*",
+        "@types/node": "*"
+      }
+    },
+    "node_modules/accepts": {
+      "version": "1.3.8",
+      "resolved": "https://registry.npmjs.org/accepts/-/accepts-1.3.8.tgz",
+      "integrity": "sha512-PYAthTa2m2VKxuvSD3DPC/Gy+U+sOA1LAuT8mkmRuvw+NACSaeXEQ+NHcVF7rONl6qcaxV3Uuemwawk+7+SJLw==",
+      "license": "MIT",
+      "dependencies": {
+        "mime-types": "~2.1.34",
+        "negotiator": "0.6.3"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/append-field": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/append-field/-/append-field-1.0.0.tgz",
+      "integrity": "sha512-klpgFSWLW1ZEs8svjfb7g4qWY0YS5imI82dTg+QahUvJ8YqAY0P10Uk8tTyh9ZGuYEZEMaeJYCF5BFuX552hsw==",
+      "license": "MIT"
+    },
+    "node_modules/array-flatten": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/array-flatten/-/array-flatten-1.1.1.tgz",
+      "integrity": "sha512-PCVAQswWemu6UdxsDFFX/+gVeYqKAod3D3UVm91jHwynguOwAvYPhx8nNlM++NqRcK6CxxpUafjmhIdKiHibqg==",
+      "license": "MIT"
+    },
+    "node_modules/body-parser": {
+      "version": "1.20.4",
+      "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-1.20.4.tgz",
+      "integrity": "sha512-ZTgYYLMOXY9qKU/57FAo8F+HA2dGX7bqGc71txDRC1rS4frdFI5R7NhluHxH6M0YItAP0sHB4uqAOcYKxO6uGA==",
+      "license": "MIT",
+      "dependencies": {
+        "bytes": "~3.1.2",
+        "content-type": "~1.0.5",
+        "debug": "2.6.9",
+        "depd": "2.0.0",
+        "destroy": "~1.2.0",
+        "http-errors": "~2.0.1",
+        "iconv-lite": "~0.4.24",
+        "on-finished": "~2.4.1",
+        "qs": "~6.14.0",
+        "raw-body": "~2.5.3",
+        "type-is": "~1.6.18",
+        "unpipe": "~1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.8",
+        "npm": "1.2.8000 || >= 1.4.16"
+      }
+    },
+    "node_modules/buffer-from": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.2.tgz",
+      "integrity": "sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==",
+      "license": "MIT"
+    },
+    "node_modules/busboy": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/busboy/-/busboy-1.6.0.tgz",
+      "integrity": "sha512-8SFQbg/0hQ9xy3UNTB0YEnsNBbWfhf7RtnzpL7TkBiTBRfrQ9Fxcnz7VJsleJpyp6rVLvXiuORqjlHi5q+PYuA==",
+      "dependencies": {
+        "streamsearch": "^1.1.0"
+      },
+      "engines": {
+        "node": ">=10.16.0"
+      }
+    },
+    "node_modules/bytes": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz",
+      "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/call-bind-apply-helpers": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
+      "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/call-bound": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/call-bound/-/call-bound-1.0.4.tgz",
+      "integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "get-intrinsic": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/concat-stream": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/concat-stream/-/concat-stream-2.0.0.tgz",
+      "integrity": "sha512-MWufYdFw53ccGjCA+Ol7XJYpAlW6/prSMzuPOTRnJGcGzuhLn4Scrz7qf6o8bROZ514ltazcIFJZevcfbo0x7A==",
+      "engines": [
+        "node >= 6.0"
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "buffer-from": "^1.0.0",
+        "inherits": "^2.0.3",
+        "readable-stream": "^3.0.2",
+        "typedarray": "^0.0.6"
+      }
+    },
+    "node_modules/content-disposition": {
+      "version": "0.5.4",
+      "resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-0.5.4.tgz",
+      "integrity": "sha512-FveZTNuGw04cxlAiWbzi6zTAL/lhehaWbTtgluJh4/E95DqMwTmha3KZN1aAWA8cFIhHzMZUvLevkw5Rqk+tSQ==",
+      "license": "MIT",
+      "dependencies": {
+        "safe-buffer": "5.2.1"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/content-type": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/content-type/-/content-type-1.0.5.tgz",
+      "integrity": "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/cookie": {
+      "version": "0.7.2",
+      "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.2.tgz",
+      "integrity": "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/cookie-signature": {
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.0.7.tgz",
+      "integrity": "sha512-NXdYc3dLr47pBkpUCHtKSwIOQXLVn8dZEuywboCOJY/osA0wFSLlSawr3KN8qXJEyX66FcONTH8EIlVuK0yyFA==",
+      "license": "MIT"
+    },
+    "node_modules/cors": {
+      "version": "2.8.6",
+      "resolved": "https://registry.npmjs.org/cors/-/cors-2.8.6.tgz",
+      "integrity": "sha512-tJtZBBHA6vjIAaF6EnIaq6laBBP9aq/Y3ouVJjEfoHbRBcHBAHYcMh/w8LDrk2PvIMMq8gmopa5D4V8RmbrxGw==",
+      "license": "MIT",
+      "dependencies": {
+        "object-assign": "^4",
+        "vary": "^1"
+      },
+      "engines": {
+        "node": ">= 0.10"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/debug": {
+      "version": "2.6.9",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
+      "integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
+      "license": "MIT",
+      "dependencies": {
+        "ms": "2.0.0"
+      }
+    },
+    "node_modules/depd": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz",
+      "integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/destroy": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/destroy/-/destroy-1.2.0.tgz",
+      "integrity": "sha512-2sJGJTaXIIaR1w4iJSNoN0hnMY7Gpc/n8D4qSCJw8QqFWXf7cuAgnEHxBpweaVcPevC2l3KpjYCx3NypQQgaJg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8",
+        "npm": "1.2.8000 || >= 1.4.16"
+      }
+    },
+    "node_modules/dotenv": {
+      "version": "16.6.1",
+      "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-16.6.1.tgz",
+      "integrity": "sha512-uBq4egWHTcTt33a72vpSG0z3HnPuIl6NqYcTrKEg2azoEyl2hpW0zqlxysq2pK9HlDIHyHyakeYaYnSAwd8bow==",
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://dotenvx.com"
+      }
+    },
+    "node_modules/dunder-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
+      "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "gopd": "^1.2.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/ee-first": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz",
+      "integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==",
+      "license": "MIT"
+    },
+    "node_modules/encodeurl": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz",
+      "integrity": "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/es-define-property": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
+      "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-errors": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
+      "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-object-atoms": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz",
+      "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/esbuild": {
+      "version": "0.27.4",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.27.4.tgz",
+      "integrity": "sha512-Rq4vbHnYkK5fws5NF7MYTU68FPRE1ajX7heQ/8QXXWqNgqqJ/GkmmyxIzUnf2Sr/bakf8l54716CcMGHYhMrrQ==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "bin": {
+        "esbuild": "bin/esbuild"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "optionalDependencies": {
+        "@esbuild/aix-ppc64": "0.27.4",
+        "@esbuild/android-arm": "0.27.4",
+        "@esbuild/android-arm64": "0.27.4",
+        "@esbuild/android-x64": "0.27.4",
+        "@esbuild/darwin-arm64": "0.27.4",
+        "@esbuild/darwin-x64": "0.27.4",
+        "@esbuild/freebsd-arm64": "0.27.4",
+        "@esbuild/freebsd-x64": "0.27.4",
+        "@esbuild/linux-arm": "0.27.4",
+        "@esbuild/linux-arm64": "0.27.4",
+        "@esbuild/linux-ia32": "0.27.4",
+        "@esbuild/linux-loong64": "0.27.4",
+        "@esbuild/linux-mips64el": "0.27.4",
+        "@esbuild/linux-ppc64": "0.27.4",
+        "@esbuild/linux-riscv64": "0.27.4",
+        "@esbuild/linux-s390x": "0.27.4",
+        "@esbuild/linux-x64": "0.27.4",
+        "@esbuild/netbsd-arm64": "0.27.4",
+        "@esbuild/netbsd-x64": "0.27.4",
+        "@esbuild/openbsd-arm64": "0.27.4",
+        "@esbuild/openbsd-x64": "0.27.4",
+        "@esbuild/openharmony-arm64": "0.27.4",
+        "@esbuild/sunos-x64": "0.27.4",
+        "@esbuild/win32-arm64": "0.27.4",
+        "@esbuild/win32-ia32": "0.27.4",
+        "@esbuild/win32-x64": "0.27.4"
+      }
+    },
+    "node_modules/escape-html": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz",
+      "integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==",
+      "license": "MIT"
+    },
+    "node_modules/etag": {
+      "version": "1.8.1",
+      "resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz",
+      "integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/express": {
+      "version": "4.22.1",
+      "resolved": "https://registry.npmjs.org/express/-/express-4.22.1.tgz",
+      "integrity": "sha512-F2X8g9P1X7uCPZMA3MVf9wcTqlyNp7IhH5qPCI0izhaOIYXaW9L535tGA3qmjRzpH+bZczqq7hVKxTR4NWnu+g==",
+      "license": "MIT",
+      "dependencies": {
+        "accepts": "~1.3.8",
+        "array-flatten": "1.1.1",
+        "body-parser": "~1.20.3",
+        "content-disposition": "~0.5.4",
+        "content-type": "~1.0.4",
+        "cookie": "~0.7.1",
+        "cookie-signature": "~1.0.6",
+        "debug": "2.6.9",
+        "depd": "2.0.0",
+        "encodeurl": "~2.0.0",
+        "escape-html": "~1.0.3",
+        "etag": "~1.8.1",
+        "finalhandler": "~1.3.1",
+        "fresh": "~0.5.2",
+        "http-errors": "~2.0.0",
+        "merge-descriptors": "1.0.3",
+        "methods": "~1.1.2",
+        "on-finished": "~2.4.1",
+        "parseurl": "~1.3.3",
+        "path-to-regexp": "~0.1.12",
+        "proxy-addr": "~2.0.7",
+        "qs": "~6.14.0",
+        "range-parser": "~1.2.1",
+        "safe-buffer": "5.2.1",
+        "send": "~0.19.0",
+        "serve-static": "~1.16.2",
+        "setprototypeof": "1.2.0",
+        "statuses": "~2.0.1",
+        "type-is": "~1.6.18",
+        "utils-merge": "1.0.1",
+        "vary": "~1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.10.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/finalhandler": {
+      "version": "1.3.2",
+      "resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-1.3.2.tgz",
+      "integrity": "sha512-aA4RyPcd3badbdABGDuTXCMTtOneUCAYH/gxoYRTZlIJdF0YPWuGqiAsIrhNnnqdXGswYk6dGujem4w80UJFhg==",
+      "license": "MIT",
+      "dependencies": {
+        "debug": "2.6.9",
+        "encodeurl": "~2.0.0",
+        "escape-html": "~1.0.3",
+        "on-finished": "~2.4.1",
+        "parseurl": "~1.3.3",
+        "statuses": "~2.0.2",
+        "unpipe": "~1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/forwarded": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz",
+      "integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/fresh": {
+      "version": "0.5.2",
+      "resolved": "https://registry.npmjs.org/fresh/-/fresh-0.5.2.tgz",
+      "integrity": "sha512-zJ2mQYM18rEFOudeV4GShTGIQ7RbzA7ozbU9I/XBpm7kqgMywgmylMwXHxZJmkVoYkna9d2pVXVXPdYTP9ej8Q==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/fsevents": {
+      "version": "2.3.3",
+      "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+      "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+      }
+    },
+    "node_modules/function-bind": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
+      "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/get-intrinsic": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
+      "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "es-define-property": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "es-object-atoms": "^1.1.1",
+        "function-bind": "^1.1.2",
+        "get-proto": "^1.0.1",
+        "gopd": "^1.2.0",
+        "has-symbols": "^1.1.0",
+        "hasown": "^2.0.2",
+        "math-intrinsics": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/get-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz",
+      "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
+      "license": "MIT",
+      "dependencies": {
+        "dunder-proto": "^1.0.1",
+        "es-object-atoms": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/get-tsconfig": {
+      "version": "4.13.7",
+      "resolved": "https://registry.npmjs.org/get-tsconfig/-/get-tsconfig-4.13.7.tgz",
+      "integrity": "sha512-7tN6rFgBlMgpBML5j8typ92BKFi2sFQvIdpAqLA2beia5avZDrMs0FLZiM5etShWq5irVyGcGMEA1jcDaK7A/Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "resolve-pkg-maps": "^1.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/privatenumber/get-tsconfig?sponsor=1"
+      }
+    },
+    "node_modules/gopd": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
+      "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/has-symbols": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
+      "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/hasown": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz",
+      "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==",
+      "license": "MIT",
+      "dependencies": {
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/http-errors": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.1.tgz",
+      "integrity": "sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ==",
+      "license": "MIT",
+      "dependencies": {
+        "depd": "~2.0.0",
+        "inherits": "~2.0.4",
+        "setprototypeof": "~1.2.0",
+        "statuses": "~2.0.2",
+        "toidentifier": "~1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/iconv-lite": {
+      "version": "0.4.24",
+      "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.24.tgz",
+      "integrity": "sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==",
+      "license": "MIT",
+      "dependencies": {
+        "safer-buffer": ">= 2.1.2 < 3"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/inherits": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
+      "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
+      "license": "ISC"
+    },
+    "node_modules/ipaddr.js": {
+      "version": "1.9.1",
+      "resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-1.9.1.tgz",
+      "integrity": "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
+    "node_modules/math-intrinsics": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
+      "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/media-typer": {
+      "version": "0.3.0",
+      "resolved": "https://registry.npmjs.org/media-typer/-/media-typer-0.3.0.tgz",
+      "integrity": "sha512-dq+qelQ9akHpcOl/gUVRTxVIOkAJ1wR3QAvb4RsVjS8oVoFjDGTc679wJYmUmknUF5HwMLOgb5O+a3KxfWapPQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/merge-descriptors": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-1.0.3.tgz",
+      "integrity": "sha512-gaNvAS7TZ897/rVaZ0nMtAyxNyi/pdbjbAwUpFQpN70GqnVfOiXpeUUMKRBmzXaSQ8DdTX4/0ms62r2K+hE6mQ==",
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/methods": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/methods/-/methods-1.1.2.tgz",
+      "integrity": "sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/mime": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/mime/-/mime-1.6.0.tgz",
+      "integrity": "sha512-x0Vn8spI+wuJ1O6S7gnbaQg8Pxh4NNHb7KSINmEWKiPE4RKOplvijn+NkmYmmRgP68mc70j2EbeTFRsrswaQeg==",
+      "license": "MIT",
+      "bin": {
+        "mime": "cli.js"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/mime-db": {
+      "version": "1.52.0",
+      "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz",
+      "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/mime-types": {
+      "version": "2.1.35",
+      "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz",
+      "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==",
+      "license": "MIT",
+      "dependencies": {
+        "mime-db": "1.52.0"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/ms": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
+      "integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
+      "license": "MIT"
+    },
+    "node_modules/multer": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/multer/-/multer-2.1.1.tgz",
+      "integrity": "sha512-mo+QTzKlx8R7E5ylSXxWzGoXoZbOsRMpyitcht8By2KHvMbf3tjwosZ/Mu/XYU6UuJ3VZnODIrak5ZrPiPyB6A==",
+      "license": "MIT",
+      "dependencies": {
+        "append-field": "^1.0.0",
+        "busboy": "^1.6.0",
+        "concat-stream": "^2.0.0",
+        "type-is": "^1.6.18"
+      },
+      "engines": {
+        "node": ">= 10.16.0"
+      },
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/express"
+      }
+    },
+    "node_modules/negotiator": {
+      "version": "0.6.3",
+      "resolved": "https://registry.npmjs.org/negotiator/-/negotiator-0.6.3.tgz",
+      "integrity": "sha512-+EUsqGPLsM+j/zdChZjsnX51g4XrHFOIXwfnCVPGlQk/k5giakcKsuxCObBRu6DSm9opw/O6slWbJdghQM4bBg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/object-assign": {
+      "version": "4.1.1",
+      "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz",
+      "integrity": "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/object-inspect": {
+      "version": "1.13.4",
+      "resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz",
+      "integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/on-finished": {
+      "version": "2.4.1",
+      "resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.4.1.tgz",
+      "integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==",
+      "license": "MIT",
+      "dependencies": {
+        "ee-first": "1.1.1"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/parseurl": {
+      "version": "1.3.3",
+      "resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz",
+      "integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/path-to-regexp": {
+      "version": "0.1.13",
+      "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-0.1.13.tgz",
+      "integrity": "sha512-A/AGNMFN3c8bOlvV9RreMdrv7jsmF9XIfDeCd87+I8RNg6s78BhJxMu69NEMHBSJFxKidViTEdruRwEk/WIKqA==",
+      "license": "MIT"
+    },
+    "node_modules/pg": {
+      "version": "8.20.0",
+      "resolved": "https://registry.npmjs.org/pg/-/pg-8.20.0.tgz",
+      "integrity": "sha512-ldhMxz2r8fl/6QkXnBD3CR9/xg694oT6DZQ2s6c/RI28OjtSOpxnPrUCGOBJ46RCUxcWdx3p6kw/xnDHjKvaRA==",
+      "license": "MIT",
+      "dependencies": {
+        "pg-connection-string": "^2.12.0",
+        "pg-pool": "^3.13.0",
+        "pg-protocol": "^1.13.0",
+        "pg-types": "2.2.0",
+        "pgpass": "1.0.5"
+      },
+      "engines": {
+        "node": ">= 16.0.0"
+      },
+      "optionalDependencies": {
+        "pg-cloudflare": "^1.3.0"
+      },
+      "peerDependencies": {
+        "pg-native": ">=3.0.1"
+      },
+      "peerDependenciesMeta": {
+        "pg-native": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/pg-cloudflare": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/pg-cloudflare/-/pg-cloudflare-1.3.0.tgz",
+      "integrity": "sha512-6lswVVSztmHiRtD6I8hw4qP/nDm1EJbKMRhf3HCYaqud7frGysPv7FYJ5noZQdhQtN2xJnimfMtvQq21pdbzyQ==",
+      "license": "MIT",
+      "optional": true
+    },
+    "node_modules/pg-connection-string": {
+      "version": "2.12.0",
+      "resolved": "https://registry.npmjs.org/pg-connection-string/-/pg-connection-string-2.12.0.tgz",
+      "integrity": "sha512-U7qg+bpswf3Cs5xLzRqbXbQl85ng0mfSV/J0nnA31MCLgvEaAo7CIhmeyrmJpOr7o+zm0rXK+hNnT5l9RHkCkQ==",
+      "license": "MIT"
+    },
+    "node_modules/pg-int8": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/pg-int8/-/pg-int8-1.0.1.tgz",
+      "integrity": "sha512-WCtabS6t3c8SkpDBUlb1kjOs7l66xsGdKpIPZsg4wR+B3+u9UAum2odSsF9tnvxg80h4ZxLWMy4pRjOsFIqQpw==",
+      "license": "ISC",
+      "engines": {
+        "node": ">=4.0.0"
+      }
+    },
+    "node_modules/pg-pool": {
+      "version": "3.13.0",
+      "resolved": "https://registry.npmjs.org/pg-pool/-/pg-pool-3.13.0.tgz",
+      "integrity": "sha512-gB+R+Xud1gLFuRD/QgOIgGOBE2KCQPaPwkzBBGC9oG69pHTkhQeIuejVIk3/cnDyX39av2AxomQiyPT13WKHQA==",
+      "license": "MIT",
+      "peerDependencies": {
+        "pg": ">=8.0"
+      }
+    },
+    "node_modules/pg-protocol": {
+      "version": "1.13.0",
+      "resolved": "https://registry.npmjs.org/pg-protocol/-/pg-protocol-1.13.0.tgz",
+      "integrity": "sha512-zzdvXfS6v89r6v7OcFCHfHlyG/wvry1ALxZo4LqgUoy7W9xhBDMaqOuMiF3qEV45VqsN6rdlcehHrfDtlCPc8w==",
+      "license": "MIT"
+    },
+    "node_modules/pg-types": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/pg-types/-/pg-types-2.2.0.tgz",
+      "integrity": "sha512-qTAAlrEsl8s4OiEQY69wDvcMIdQN6wdz5ojQiOy6YRMuynxenON0O5oCpJI6lshc6scgAY8qvJ2On/p+CXY0GA==",
+      "license": "MIT",
+      "dependencies": {
+        "pg-int8": "1.0.1",
+        "postgres-array": "~2.0.0",
+        "postgres-bytea": "~1.0.0",
+        "postgres-date": "~1.0.4",
+        "postgres-interval": "^1.1.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/pgpass": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/pgpass/-/pgpass-1.0.5.tgz",
+      "integrity": "sha512-FdW9r/jQZhSeohs1Z3sI1yxFQNFvMcnmfuj4WBMUTxOrAyLMaTcE1aAMBiTlbMNaXvBCQuVi0R7hd8udDSP7ug==",
+      "license": "MIT",
+      "dependencies": {
+        "split2": "^4.1.0"
+      }
+    },
+    "node_modules/postgres-array": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/postgres-array/-/postgres-array-2.0.0.tgz",
+      "integrity": "sha512-VpZrUqU5A69eQyW2c5CA1jtLecCsN2U/bD6VilrFDWq5+5UIEVO7nazS3TEcHf1zuPYO/sqGvUvW62g86RXZuA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/postgres-bytea": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/postgres-bytea/-/postgres-bytea-1.0.1.tgz",
+      "integrity": "sha512-5+5HqXnsZPE65IJZSMkZtURARZelel2oXUEO8rH83VS/hxH5vv1uHquPg5wZs8yMAfdv971IU+kcPUczi7NVBQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/postgres-date": {
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/postgres-date/-/postgres-date-1.0.7.tgz",
+      "integrity": "sha512-suDmjLVQg78nMK2UZ454hAG+OAW+HQPZ6n++TNDUX+L0+uUlLywnoxJKDou51Zm+zTCjrCl0Nq6J9C5hP9vK/Q==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/postgres-interval": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/postgres-interval/-/postgres-interval-1.2.0.tgz",
+      "integrity": "sha512-9ZhXKM/rw350N1ovuWHbGxnGh/SNJ4cnxHiM0rxE4VN41wsg8P8zWn9hv/buK00RP4WvlOyr/RBDiptyxVbkZQ==",
+      "license": "MIT",
+      "dependencies": {
+        "xtend": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/proxy-addr": {
+      "version": "2.0.7",
+      "resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz",
+      "integrity": "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==",
+      "license": "MIT",
+      "dependencies": {
+        "forwarded": "0.2.0",
+        "ipaddr.js": "1.9.1"
+      },
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
+    "node_modules/qs": {
+      "version": "6.14.2",
+      "resolved": "https://registry.npmjs.org/qs/-/qs-6.14.2.tgz",
+      "integrity": "sha512-V/yCWTTF7VJ9hIh18Ugr2zhJMP01MY7c5kh4J870L7imm6/DIzBsNLTXzMwUA3yZ5b/KBqLx8Kp3uRvd7xSe3Q==",
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "side-channel": "^1.1.0"
+      },
+      "engines": {
+        "node": ">=0.6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/range-parser": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.2.1.tgz",
+      "integrity": "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/raw-body": {
+      "version": "2.5.3",
+      "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-2.5.3.tgz",
+      "integrity": "sha512-s4VSOf6yN0rvbRZGxs8Om5CWj6seneMwK3oDb4lWDH0UPhWcxwOWw5+qk24bxq87szX1ydrwylIOp2uG1ojUpA==",
+      "license": "MIT",
+      "dependencies": {
+        "bytes": "~3.1.2",
+        "http-errors": "~2.0.1",
+        "iconv-lite": "~0.4.24",
+        "unpipe": "~1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/readable-stream": {
+      "version": "3.6.2",
+      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz",
+      "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==",
+      "license": "MIT",
+      "dependencies": {
+        "inherits": "^2.0.3",
+        "string_decoder": "^1.1.1",
+        "util-deprecate": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/resolve-pkg-maps": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/resolve-pkg-maps/-/resolve-pkg-maps-1.0.0.tgz",
+      "integrity": "sha512-seS2Tj26TBVOC2NIc2rOe2y2ZO7efxITtLZcGSOnHHNOQ7CkiUBfw0Iw2ck6xkIhPwLhKNLS8BO+hEpngQlqzw==",
+      "dev": true,
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/privatenumber/resolve-pkg-maps?sponsor=1"
+      }
+    },
+    "node_modules/safe-buffer": {
+      "version": "5.2.1",
+      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
+      "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/safer-buffer": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
+      "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==",
+      "license": "MIT"
+    },
+    "node_modules/send": {
+      "version": "0.19.2",
+      "resolved": "https://registry.npmjs.org/send/-/send-0.19.2.tgz",
+      "integrity": "sha512-VMbMxbDeehAxpOtWJXlcUS5E8iXh6QmN+BkRX1GARS3wRaXEEgzCcB10gTQazO42tpNIya8xIyNx8fll1OFPrg==",
+      "license": "MIT",
+      "dependencies": {
+        "debug": "2.6.9",
+        "depd": "2.0.0",
+        "destroy": "1.2.0",
+        "encodeurl": "~2.0.0",
+        "escape-html": "~1.0.3",
+        "etag": "~1.8.1",
+        "fresh": "~0.5.2",
+        "http-errors": "~2.0.1",
+        "mime": "1.6.0",
+        "ms": "2.1.3",
+        "on-finished": "~2.4.1",
+        "range-parser": "~1.2.1",
+        "statuses": "~2.0.2"
+      },
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/send/node_modules/ms": {
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
+      "license": "MIT"
+    },
+    "node_modules/serve-static": {
+      "version": "1.16.3",
+      "resolved": "https://registry.npmjs.org/serve-static/-/serve-static-1.16.3.tgz",
+      "integrity": "sha512-x0RTqQel6g5SY7Lg6ZreMmsOzncHFU7nhnRWkKgWuMTu5NN0DR5oruckMqRvacAN9d5w6ARnRBXl9xhDCgfMeA==",
+      "license": "MIT",
+      "dependencies": {
+        "encodeurl": "~2.0.0",
+        "escape-html": "~1.0.3",
+        "parseurl": "~1.3.3",
+        "send": "~0.19.1"
+      },
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/setprototypeof": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz",
+      "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==",
+      "license": "ISC"
+    },
+    "node_modules/side-channel": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.0.tgz",
+      "integrity": "sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "object-inspect": "^1.13.3",
+        "side-channel-list": "^1.0.0",
+        "side-channel-map": "^1.0.1",
+        "side-channel-weakmap": "^1.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-list": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.0.tgz",
+      "integrity": "sha512-FCLHtRD/gnpCiCHEiJLOwdmFP+wzCmDEkc9y7NsYxeF4u7Btsn1ZuwgwJGxImImHicJArLP4R0yX4c2KCrMrTA==",
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "object-inspect": "^1.13.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-map": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/side-channel-map/-/side-channel-map-1.0.1.tgz",
+      "integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.5",
+        "object-inspect": "^1.13.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/side-channel-weakmap": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz",
+      "integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==",
+      "license": "MIT",
+      "dependencies": {
+        "call-bound": "^1.0.2",
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.5",
+        "object-inspect": "^1.13.3",
+        "side-channel-map": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/split2": {
+      "version": "4.2.0",
+      "resolved": "https://registry.npmjs.org/split2/-/split2-4.2.0.tgz",
+      "integrity": "sha512-UcjcJOWknrNkF6PLX83qcHM6KHgVKNkV62Y8a5uYDVv9ydGQVwAHMKqHdJje1VTWpljG0WYpCDhrCdAOYH4TWg==",
+      "license": "ISC",
+      "engines": {
+        "node": ">= 10.x"
+      }
+    },
+    "node_modules/statuses": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.2.tgz",
+      "integrity": "sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/streamsearch": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/streamsearch/-/streamsearch-1.1.0.tgz",
+      "integrity": "sha512-Mcc5wHehp9aXz1ax6bZUyY5afg9u2rv5cqQI3mRrYkGC8rW2hM02jWuwjtL++LS5qinSyhj2QfLyNsuc+VsExg==",
+      "engines": {
+        "node": ">=10.0.0"
+      }
+    },
+    "node_modules/string_decoder": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz",
+      "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==",
+      "license": "MIT",
+      "dependencies": {
+        "safe-buffer": "~5.2.0"
+      }
+    },
+    "node_modules/toidentifier": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz",
+      "integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.6"
+      }
+    },
+    "node_modules/tsx": {
+      "version": "4.21.0",
+      "resolved": "https://registry.npmjs.org/tsx/-/tsx-4.21.0.tgz",
+      "integrity": "sha512-5C1sg4USs1lfG0GFb2RLXsdpXqBSEhAaA/0kPL01wxzpMqLILNxIxIOKiILz+cdg/pLnOUxFYOR5yhHU666wbw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "esbuild": "~0.27.0",
+        "get-tsconfig": "^4.7.5"
+      },
+      "bin": {
+        "tsx": "dist/cli.mjs"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      },
+      "optionalDependencies": {
+        "fsevents": "~2.3.3"
+      }
+    },
+    "node_modules/type-is": {
+      "version": "1.6.18",
+      "resolved": "https://registry.npmjs.org/type-is/-/type-is-1.6.18.tgz",
+      "integrity": "sha512-TkRKr9sUTxEH8MdfuCSP7VizJyzRNMjj2J2do2Jr3Kym598JVdEksuzPQCnlFPW4ky9Q+iA+ma9BGm06XQBy8g==",
+      "license": "MIT",
+      "dependencies": {
+        "media-typer": "0.3.0",
+        "mime-types": "~2.1.24"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/typedarray": {
+      "version": "0.0.6",
+      "resolved": "https://registry.npmjs.org/typedarray/-/typedarray-0.0.6.tgz",
+      "integrity": "sha512-/aCDEGatGvZ2BIk+HmLf4ifCJFwvKFNb9/JeZPMulfgFracn9QFcAf5GO8B/mweUjSoblS5In0cWhqpfs/5PQA==",
+      "license": "MIT"
+    },
+    "node_modules/typescript": {
+      "version": "5.9.3",
+      "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",
+      "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "bin": {
+        "tsc": "bin/tsc",
+        "tsserver": "bin/tsserver"
+      },
+      "engines": {
+        "node": ">=14.17"
+      }
+    },
+    "node_modules/undici-types": {
+      "version": "6.21.0",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz",
+      "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/unpipe": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz",
+      "integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/util-deprecate": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
+      "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==",
+      "license": "MIT"
+    },
+    "node_modules/utils-merge": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/utils-merge/-/utils-merge-1.0.1.tgz",
+      "integrity": "sha512-pMZTvIkT1d+TFGvDOqodOclx0QWkkgi6Tdoa8gC8ffGAAqz9pzPTZWAybbsHHoED/ztMtkv/VoYTYyShUn81hA==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4.0"
+      }
+    },
+    "node_modules/vary": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz",
+      "integrity": "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/xtend": {
+      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/xtend/-/xtend-4.0.2.tgz",
+      "integrity": "sha512-LKYU1iAXJXUgAXn9URjiu+MWhyUXHsvfp7mcuYm9dSUKK0/CjtrUwFAxD82/mCWbtLsGjFIad0wIsod4zrTAEQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.4"
+      }
+    }
+  }
+}

civic-platform/backend/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "civicpulse-backend",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "tsx watch src/server.ts",
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/server.js",
+    "db:init": "tsx src/scripts/init-db.ts",
+    "db:seed": "tsx src/scripts/seed-db.ts",
+    "smoke": "tsx src/scripts/smoke-test.ts"
+  },
+  "dependencies": {
+    "cors": "^2.8.5",
+    "dotenv": "^16.4.7",
+    "express": "^4.21.2",
+    "multer": "^2.1.1",
+    "pg": "^8.13.3"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.17",
+    "@types/express": "^5.0.1",
+    "@types/multer": "^2.1.0",
+    "@types/node": "^22.13.10",
+    "@types/pg": "^8.11.11",
+    "tsx": "^4.19.3",
+    "typescript": "^5.8.2"
+  }
+}

civic-platform/backend/sql/001_initial_schema.sql

@@ -0,0 +1,246 @@
+CREATE EXTENSION IF NOT EXISTS "pgcrypto";
+
+CREATE TABLE roles (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    name VARCHAR(50) NOT NULL UNIQUE,
+    description TEXT,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE TABLE departments (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    name VARCHAR(120) NOT NULL UNIQUE,
+    code VARCHAR(40) NOT NULL UNIQUE,
+    description TEXT,
+    is_emergency BOOLEAN NOT NULL DEFAULT FALSE,
+    is_active BOOLEAN NOT NULL DEFAULT TRUE,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE TABLE wards (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    name VARCHAR(120) NOT NULL,
+    code VARCHAR(40) NOT NULL UNIQUE,
+    city_name VARCHAR(120) NOT NULL,
+    state_name VARCHAR(120),
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE TABLE users (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    full_name VARCHAR(160) NOT NULL,
+    email VARCHAR(160) UNIQUE,
+    phone VARCHAR(20) UNIQUE,
+    password_hash TEXT,
+    role_id UUID NOT NULL REFERENCES roles(id),
+    department_id UUID REFERENCES departments(id),
+    ward_id UUID REFERENCES wards(id),
+    is_active BOOLEAN NOT NULL DEFAULT TRUE,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE TABLE domains (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    name VARCHAR(120) NOT NULL UNIQUE,
+    description TEXT,
+    is_emergency BOOLEAN NOT NULL DEFAULT FALSE,
+    is_active BOOLEAN NOT NULL DEFAULT TRUE,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE TABLE sub_problems (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    domain_id UUID NOT NULL REFERENCES domains(id) ON DELETE CASCADE,
+    name VARCHAR(120) NOT NULL,
+    description TEXT,
+    severity_hint VARCHAR(20),
+    is_active BOOLEAN NOT NULL DEFAULT TRUE,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    CONSTRAINT unique_sub_problem_per_domain UNIQUE (domain_id, name)
+);
+
+CREATE TABLE complaints (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    complaint_code VARCHAR(40) NOT NULL UNIQUE,
+    citizen_id UUID NOT NULL REFERENCES users(id),
+    domain_id UUID REFERENCES domains(id),
+    sub_problem_id UUID REFERENCES sub_problems(id),
+    title VARCHAR(220) NOT NULL,
+    description TEXT,
+    status VARCHAR(32) NOT NULL,
+    priority_level VARCHAR(2) NOT NULL,
+    is_emergency BOOLEAN NOT NULL DEFAULT FALSE,
+    department_id UUID REFERENCES departments(id),
+    ward_id UUID REFERENCES wards(id),
+    submitted_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    resolved_at TIMESTAMPTZ,
+    closed_at TIMESTAMPTZ,
+    reopened_count INTEGER NOT NULL DEFAULT 0,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    CONSTRAINT complaints_status_check CHECK (
+        status IN (
+            'submitted',
+            'validated',
+            'classified',
+            'prioritized',
+            'assigned',
+            'accepted',
+            'in_progress',
+            'resolved',
+            'citizen_verified',
+            'closed',
+            'escalated',
+            'reopened',
+            'duplicate',
+            'rejected',
+            'on_hold'
+        )
+    ),
+    CONSTRAINT complaints_priority_check CHECK (priority_level IN ('P1', 'P2', 'P3', 'P4'))
+);
+
+CREATE TABLE complaint_locations (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    complaint_id UUID NOT NULL UNIQUE REFERENCES complaints(id) ON DELETE CASCADE,
+    latitude NUMERIC(10, 7) NOT NULL,
+    longitude NUMERIC(10, 7) NOT NULL,
+    address_line TEXT,
+    landmark VARCHAR(220),
+    city_name VARCHAR(120),
+    state_name VARCHAR(120),
+    postal_code VARCHAR(20),
+    ward_id UUID REFERENCES wards(id),
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE TABLE complaint_media (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    complaint_id UUID NOT NULL REFERENCES complaints(id) ON DELETE CASCADE,
+    uploaded_by UUID REFERENCES users(id),
+    media_type VARCHAR(20) NOT NULL,
+    file_path TEXT NOT NULL,
+    file_url TEXT,
+    mime_type VARCHAR(120),
+    is_resolution_proof BOOLEAN NOT NULL DEFAULT FALSE,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    CONSTRAINT complaint_media_type_check CHECK (media_type IN ('image', 'video', 'audio'))
+);
+
+CREATE TABLE complaint_status_history (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    complaint_id UUID NOT NULL REFERENCES complaints(id) ON DELETE CASCADE,
+    old_status VARCHAR(32),
+    new_status VARCHAR(32) NOT NULL,
+    changed_by UUID REFERENCES users(id),
+    change_reason TEXT,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE TABLE assignments (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    complaint_id UUID NOT NULL REFERENCES complaints(id) ON DELETE CASCADE,
+    department_id UUID NOT NULL REFERENCES departments(id),
+    assigned_to_user_id UUID REFERENCES users(id),
+    assigned_by_user_id UUID REFERENCES users(id),
+    assignment_status VARCHAR(20) NOT NULL,
+    assigned_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    accepted_at TIMESTAMPTZ,
+    completed_at TIMESTAMPTZ,
+    notes TEXT,
+    CONSTRAINT assignments_status_check CHECK (
+        assignment_status IN ('assigned', 'accepted', 'in_progress', 'completed', 'reassigned')
+    )
+);
+
+CREATE TABLE routing_rules (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    domain_id UUID REFERENCES domains(id),
+    sub_problem_id UUID REFERENCES sub_problems(id),
+    ward_id UUID REFERENCES wards(id),
+    department_id UUID NOT NULL REFERENCES departments(id),
+    priority_override VARCHAR(2),
+    is_emergency_route BOOLEAN NOT NULL DEFAULT FALSE,
+    is_active BOOLEAN NOT NULL DEFAULT TRUE,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    CONSTRAINT routing_rules_priority_check CHECK (priority_override IS NULL OR priority_override IN ('P1', 'P2', 'P3', 'P4'))
+);
+
+CREATE TABLE priority_rules (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    domain_id UUID REFERENCES domains(id),
+    sub_problem_id UUID REFERENCES sub_problems(id),
+    base_priority VARCHAR(2) NOT NULL,
+    near_sensitive_zone_boost INTEGER NOT NULL DEFAULT 0,
+    repeat_complaint_boost INTEGER NOT NULL DEFAULT 0,
+    reopened_boost INTEGER NOT NULL DEFAULT 0,
+    sla_breach_boost INTEGER NOT NULL DEFAULT 0,
+    is_active BOOLEAN NOT NULL DEFAULT TRUE,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    CONSTRAINT priority_rules_base_check CHECK (base_priority IN ('P1', 'P2', 'P3', 'P4'))
+);
+
+CREATE TABLE complaint_notes (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    complaint_id UUID NOT NULL REFERENCES complaints(id) ON DELETE CASCADE,
+    author_id UUID REFERENCES users(id),
+    note_type VARCHAR(20) NOT NULL,
+    note_text TEXT NOT NULL,
+    is_internal BOOLEAN NOT NULL DEFAULT TRUE,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    CONSTRAINT complaint_notes_type_check CHECK (
+        note_type IN ('operator_note', 'field_note', 'citizen_note', 'system_note')
+    )
+);
+
+CREATE TABLE notifications (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    user_id UUID NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+    complaint_id UUID REFERENCES complaints(id) ON DELETE CASCADE,
+    title VARCHAR(220) NOT NULL,
+    message TEXT NOT NULL,
+    notification_type VARCHAR(50) NOT NULL,
+    is_read BOOLEAN NOT NULL DEFAULT FALSE,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE TABLE feedback (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    complaint_id UUID NOT NULL REFERENCES complaints(id) ON DELETE CASCADE,
+    citizen_id UUID NOT NULL REFERENCES users(id),
+    rating INTEGER CHECK (rating BETWEEN 1 AND 5),
+    comment TEXT,
+    reopen_requested BOOLEAN NOT NULL DEFAULT FALSE,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE TABLE audit_logs (
+    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+    actor_user_id UUID REFERENCES users(id),
+    entity_type VARCHAR(50) NOT NULL,
+    entity_id UUID,
+    action VARCHAR(120) NOT NULL,
+    details JSONB,
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE INDEX idx_users_role_id ON users(role_id);
+CREATE INDEX idx_users_department_id ON users(department_id);
+CREATE INDEX idx_users_ward_id ON users(ward_id);
+CREATE INDEX idx_sub_problems_domain_id ON sub_problems(domain_id);
+CREATE INDEX idx_complaints_citizen_id ON complaints(citizen_id);
+CREATE INDEX idx_complaints_domain_id ON complaints(domain_id);
+CREATE INDEX idx_complaints_department_id ON complaints(department_id);
+CREATE INDEX idx_complaints_ward_id ON complaints(ward_id);
+CREATE INDEX idx_complaints_status ON complaints(status);
+CREATE INDEX idx_complaints_priority_level ON complaints(priority_level);
+CREATE INDEX idx_complaints_submitted_at ON complaints(submitted_at);
+CREATE INDEX idx_complaint_media_complaint_id ON complaint_media(complaint_id);
+CREATE INDEX idx_complaint_status_history_complaint_id ON complaint_status_history(complaint_id);
+CREATE INDEX idx_assignments_complaint_id ON assignments(complaint_id);
+CREATE INDEX idx_assignments_department_id ON assignments(department_id);
+CREATE INDEX idx_routing_rules_department_id ON routing_rules(department_id);
+CREATE INDEX idx_notifications_user_id ON notifications(user_id);
+CREATE INDEX idx_feedback_complaint_id ON feedback(complaint_id);
+CREATE INDEX idx_audit_logs_actor_user_id ON audit_logs(actor_user_id);

civic-platform/backend/sql/002_seed_core_data.sql

@@ -0,0 +1,133 @@
+INSERT INTO roles (id, name, description)
+VALUES
+    ('10000000-0000-0000-0000-000000000001', 'citizen', 'Citizen user who reports and tracks complaints'),
+    ('10000000-0000-0000-0000-000000000002', 'department_operator', 'Department operator who validates and assigns complaints'),
+    ('10000000-0000-0000-0000-000000000003', 'municipal_admin', 'Municipal administrator with cross-department access'),
+    ('10000000-0000-0000-0000-000000000004', 'field_officer', 'Field officer who executes assigned work on the ground')
+ON CONFLICT (name) DO NOTHING;
+
+INSERT INTO departments (id, name, code, description, is_emergency)
+VALUES
+    ('20000000-0000-0000-0000-000000000001', 'Roads and Public Works', 'roads-public-works', 'Handles roads, potholes, and transport infrastructure issues', FALSE),
+    ('20000000-0000-0000-0000-000000000002', 'Sanitation and Solid Waste', 'sanitation-solid-waste', 'Handles waste collection, garbage overflow, and sanitation complaints', FALSE),
+    ('20000000-0000-0000-0000-000000000003', 'Water and Sewerage', 'water-sewerage', 'Handles water leakage, sewage, and drainage issues', FALSE),
+    ('20000000-0000-0000-0000-000000000004', 'Electrical and Street Lighting', 'electrical-street-lighting', 'Handles streetlight and public electrical complaints', FALSE),
+    ('20000000-0000-0000-0000-000000000005', 'Municipal Maintenance', 'municipal-maintenance', 'Handles open manholes and civic infrastructure maintenance', FALSE),
+    ('20000000-0000-0000-0000-000000000006', 'Disaster Management Authority', 'disaster-management', 'Handles flood, collapse, rescue, and emergency coordination', TRUE)
+ON CONFLICT (code) DO NOTHING;
+
+INSERT INTO wards (id, name, code, city_name, state_name)
+VALUES
+    ('30000000-0000-0000-0000-000000000001', 'Ward 4', 'ward-4', 'Sample City', 'Sample State'),
+    ('30000000-0000-0000-0000-000000000002', 'Ward 8', 'ward-8', 'Sample City', 'Sample State'),
+    ('30000000-0000-0000-0000-000000000003', 'Ward 12', 'ward-12', 'Sample City', 'Sample State')
+ON CONFLICT (code) DO NOTHING;
+
+INSERT INTO domains (id, name, description, is_emergency)
+VALUES
+    ('40000000-0000-0000-0000-000000000001', 'Roads and Transportation', 'Road safety, traffic support, and mobility complaints', FALSE),
+    ('40000000-0000-0000-0000-000000000002', 'Sanitation and Waste Management', 'Waste collection, cleanliness, and sanitation complaints', FALSE),
+    ('40000000-0000-0000-0000-000000000003', 'Water Supply, Sewerage, and Drainage', 'Water access, sewage, and drainage complaints', FALSE),
+    ('40000000-0000-0000-0000-000000000004', 'Street Lighting and Electrical Infrastructure', 'Public lighting and electrical safety complaints', FALSE),
+    ('40000000-0000-0000-0000-000000000005', 'Public Infrastructure and Amenities', 'Maintenance needs for public assets and shared facilities', FALSE),
+    ('40000000-0000-0000-0000-000000000006', 'Environment and Public Health', 'Public hygiene and environmental safety concerns', FALSE),
+    ('40000000-0000-0000-0000-000000000007', 'Fire Emergencies', 'Emergency fire and smoke incidents', TRUE),
+    ('40000000-0000-0000-0000-000000000008', 'Flood and Water Disaster', 'Critical flood and water disaster events', TRUE)
+ON CONFLICT (name) DO NOTHING;
+
+INSERT INTO users (id, full_name, email, phone, password_hash, role_id, department_id, ward_id)
+VALUES
+    (
+        '00000000-0000-0000-0000-000000000001',
+        'Sample Citizen',
+        'citizen@example.com',
+        '9000000001',
+        'dev-placeholder-hash',
+        '10000000-0000-0000-0000-000000000001',
+        NULL,
+        '30000000-0000-0000-0000-000000000003'
+    ),
+    (
+        '11111111-1111-1111-1111-111111111111',
+        'Sample Operator',
+        'operator@example.com',
+        '9000000002',
+        'dev-placeholder-hash',
+        '10000000-0000-0000-0000-000000000002',
+        '20000000-0000-0000-0000-000000000005',
+        '30000000-0000-0000-0000-000000000001'
+    ),
+    (
+        '22222222-2222-2222-2222-222222222222',
+        'Sample Field Officer',
+        'officer@example.com',
+        '9000000003',
+        'dev-placeholder-hash',
+        '10000000-0000-0000-0000-000000000004',
+        '20000000-0000-0000-0000-000000000005',
+        '30000000-0000-0000-0000-000000000001'
+    ),
+    (
+        '22222222-2222-2222-2222-222222222223',
+        'Road Field Officer',
+        'roads.officer@example.com',
+        '9000000004',
+        'dev-placeholder-hash',
+        '10000000-0000-0000-0000-000000000004',
+        '20000000-0000-0000-0000-000000000001',
+        '30000000-0000-0000-0000-000000000001'
+    ),
+    (
+        '22222222-2222-2222-2222-222222222224',
+        'Sanitation Field Officer',
+        'sanitation.officer@example.com',
+        '9000000005',
+        'dev-placeholder-hash',
+        '10000000-0000-0000-0000-000000000004',
+        '20000000-0000-0000-0000-000000000002',
+        '30000000-0000-0000-0000-000000000002'
+    ),
+    (
+        '22222222-2222-2222-2222-222222222225',
+        'Water Field Officer',
+        'water.officer@example.com',
+        '9000000006',
+        'dev-placeholder-hash',
+        '10000000-0000-0000-0000-000000000004',
+        '20000000-0000-0000-0000-000000000003',
+        '30000000-0000-0000-0000-000000000002'
+    ),
+    (
+        '22222222-2222-2222-2222-222222222226',
+        'Electrical Field Officer',
+        'electrical.officer@example.com',
+        '9000000007',
+        'dev-placeholder-hash',
+        '10000000-0000-0000-0000-000000000004',
+        '20000000-0000-0000-0000-000000000004',
+        '30000000-0000-0000-0000-000000000003'
+    )
+ON CONFLICT (email) DO NOTHING;
+
+INSERT INTO routing_rules (domain_id, sub_problem_id, ward_id, department_id, priority_override, is_emergency_route)
+VALUES
+    ('40000000-0000-0000-0000-000000000001', NULL, NULL, '20000000-0000-0000-0000-000000000001', NULL, FALSE),
+    ('40000000-0000-0000-0000-000000000002', NULL, NULL, '20000000-0000-0000-0000-000000000002', NULL, FALSE),
+    ('40000000-0000-0000-0000-000000000003', NULL, NULL, '20000000-0000-0000-0000-000000000003', NULL, FALSE),
+    ('40000000-0000-0000-0000-000000000004', NULL, NULL, '20000000-0000-0000-0000-000000000004', NULL, FALSE),
+    ('40000000-0000-0000-0000-000000000005', NULL, NULL, '20000000-0000-0000-0000-000000000005', 'P1', FALSE),
+    ('40000000-0000-0000-0000-000000000006', NULL, NULL, '20000000-0000-0000-0000-000000000002', NULL, FALSE),
+    ('40000000-0000-0000-0000-000000000007', NULL, NULL, '20000000-0000-0000-0000-000000000006', 'P1', TRUE),
+    ('40000000-0000-0000-0000-000000000008', NULL, NULL, '20000000-0000-0000-0000-000000000006', 'P1', TRUE);
+
+INSERT INTO priority_rules (domain_id, sub_problem_id, base_priority)
+VALUES
+    ('40000000-0000-0000-0000-000000000001', NULL, 'P3'),
+    ('40000000-0000-0000-0000-000000000002', NULL, 'P3'),
+    ('40000000-0000-0000-0000-000000000003', NULL, 'P2'),
+    ('40000000-0000-0000-0000-000000000004', NULL, 'P3'),
+    ('40000000-0000-0000-0000-000000000005', NULL, 'P2'),
+    ('40000000-0000-0000-0000-000000000006', NULL, 'P3'),
+    ('40000000-0000-0000-0000-000000000007', NULL, 'P1'),
+    ('40000000-0000-0000-0000-000000000008', NULL, 'P1')
+ON CONFLICT DO NOTHING;

civic-platform/backend/sql/003_performance_indexes.sql

@@ -0,0 +1,32 @@
+CREATE INDEX IF NOT EXISTS idx_complaints_status_submitted_at
+  ON complaints (status, submitted_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_complaints_department_status
+  ON complaints (department_id, status, submitted_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_complaints_domain_submitted_at
+  ON complaints (domain_id, submitted_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_complaints_priority_status
+  ON complaints (priority_level, status, submitted_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_assignments_assigned_to_status
+  ON assignments (assigned_to_user_id, assignment_status, assigned_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_assignments_complaint_assigned_at
+  ON assignments (complaint_id, assigned_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_notifications_user_read_created
+  ON notifications (user_id, is_read, created_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_status_history_complaint_created
+  ON complaint_status_history (complaint_id, created_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_feedback_complaint_created
+  ON feedback (complaint_id, created_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_notes_complaint_created
+  ON complaint_notes (complaint_id, created_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_locations_lat_lng
+  ON complaint_locations (latitude, longitude);

civic-platform/backend/sql/README.md

@@ -0,0 +1,22 @@
+# SQL Files
+
+## Current files
+
+- `001_initial_schema.sql`
+- `002_seed_core_data.sql`
+
+## Usage
+
+Apply the schema file to the `civicpulse` PostgreSQL database before running the complaint APIs.
+
+Recommended order:
+
+1. create database
+2. apply `001_initial_schema.sql`
+3. apply `002_seed_core_data.sql`
+4. start backend
+
+Future migrations should continue with:
+
+- `003_...`
+- `004_...`

civic-platform/backend/src/app.ts

@@ -0,0 +1,48 @@
+import fs from "node:fs";
+import path from "node:path";
+import cors from "cors";
+import express from "express";
+import { aiRouter } from "./modules/ai/ai.routes.js";
+import { authRouter } from "./modules/auth/auth.routes.js";
+import { env } from "./config/env.js";
+import { rateLimitMiddleware, securityHeaders } from "./lib/security.js";
+import { complaintRouter } from "./modules/complaints/complaint.routes.js";
+import { departmentRouter } from "./modules/departments/department.routes.js";
+import { domainRouter } from "./modules/domains/domain.routes.js";
+import { userRouter } from "./modules/users/user.routes.js";
+import { healthRouter } from "./routes/health.js";
+
+export function createApp() {
+  const app = express();
+  const uploadsDir = path.resolve(process.cwd(), "uploads");
+
+  fs.mkdirSync(path.join(uploadsDir, "complaints"), { recursive: true });
+
+  app.set("trust proxy", 1);
+  app.use(
+    cors({
+      origin: env.corsOrigins.split(",").map((value) => value.trim()),
+    }),
+  );
+  app.use(securityHeaders);
+  app.use(rateLimitMiddleware);
+  app.use(express.json({ limit: "10mb" }));
+  app.use("/uploads", express.static(uploadsDir));
+
+  app.get("/", (_req, res) => {
+    res.json({
+      name: "civicpulse-backend",
+      message: "CivicPulse backend is running",
+    });
+  });
+
+  app.use("/api/health", healthRouter);
+  app.use("/api/ai", aiRouter);
+  app.use("/api/auth", authRouter);
+  app.use("/api/departments", departmentRouter);
+  app.use("/api/domains", domainRouter);
+  app.use("/api/users", userRouter);
+  app.use("/api/complaints", complaintRouter);
+
+  return app;
+}

civic-platform/backend/src/config/env.ts

@@ -0,0 +1,28 @@
+import dotenv from "dotenv";
+
+dotenv.config();
+
+function requireEnv(name: string, fallback?: string): string {
+  const value = process.env[name] ?? fallback;
+
+  if (!value) {
+    throw new Error(`Missing required environment variable: ${name}`);
+  }
+
+  return value;
+}
+
+export const env = {
+  nodeEnv: requireEnv("NODE_ENV", "development"),
+  port: Number(requireEnv("PORT", "4000")),
+  corsOrigins: requireEnv("CORS_ORIGINS", "http://localhost:3000"),
+  dbHost: requireEnv("DB_HOST", "localhost"),
+  dbPort: Number(requireEnv("DB_PORT", "5432")),
+  dbName: requireEnv("DB_NAME", "civicpulse"),
+  dbUser: requireEnv("DB_USER", "postgres"),
+  dbPassword: requireEnv("DB_PASSWORD"),
+  dbSsl: requireEnv("DB_SSL", "false") === "true",
+  demoAuthPassword: requireEnv("DEMO_AUTH_PASSWORD", "civicpulse123"),
+  rateLimitWindowMs: Number(requireEnv("RATE_LIMIT_WINDOW_MS", "60000")),
+  rateLimitMaxRequests: Number(requireEnv("RATE_LIMIT_MAX_REQUESTS", "120")),
+};

civic-platform/backend/src/db/pool.ts

@@ -0,0 +1,11 @@
+import { Pool } from "pg";
+import { env } from "../config/env.js";
+
+export const db = new Pool({
+  host: env.dbHost,
+  port: env.dbPort,
+  database: env.dbName,
+  user: env.dbUser,
+  password: env.dbPassword,
+  ssl: env.dbSsl ? { rejectUnauthorized: false } : false,
+});

civic-platform/backend/src/lib/audit.ts

@@ -0,0 +1,29 @@
+import { db } from "../db/pool.js";
+
+export async function writeAuditLog(input: {
+  actorUserId?: string | null;
+  entityType: string;
+  entityId?: string | null;
+  action: string;
+  details?: Record<string, unknown>;
+}) {
+  await db.query(
+    `
+      INSERT INTO audit_logs (
+        actor_user_id,
+        entity_type,
+        entity_id,
+        action,
+        details
+      )
+      VALUES ($1, $2, $3, $4, $5::jsonb)
+    `,
+    [
+      input.actorUserId ?? null,
+      input.entityType,
+      input.entityId ?? null,
+      input.action,
+      JSON.stringify(input.details ?? {}),
+    ],
+  );
+}

civic-platform/backend/src/lib/cache.ts

@@ -0,0 +1,37 @@
+type CacheEntry<T> = {
+  value: T;
+  expiresAt: number;
+};
+
+const store = new Map<string, CacheEntry<unknown>>();
+
+export async function withCache<T>(key: string, ttlMs: number, producer: () => Promise<T>): Promise<T> {
+  const now = Date.now();
+  const existing = store.get(key);
+
+  if (existing && existing.expiresAt > now) {
+    return existing.value as T;
+  }
+
+  const value = await producer();
+  store.set(key, {
+    value,
+    expiresAt: now + ttlMs,
+  });
+
+  return value;
+}
+
+export function clearCache(keyPrefix?: string) {
+  if (!keyPrefix) {
+    store.clear();
+    return;
+  }
+
+  for (const key of store.keys()) {
+    if (key.startsWith(keyPrefix)) {
+      store.delete(key);
+    }
+  }
+}
+