feat: Enhance provider components with detailed documentation and comments

- Added comprehensive comments and JSDoc-style documentation to NotificationProvider, ThemeProvider, UserProvider, and WebsiteThemeProvider for better clarity and maintainability.
- Improved type definitions in index.ts for better code understanding and usage.
- Introduced Docker support with Dockerfiles for various services including AI server, signaling server, and browser-use service.
- Created a docker-compose.yml file to orchestrate multiple services including PostgreSQL, AI, scraper, and frontend.
- Added a startup guide (startup.txt) for setting up the CRM environment on Ubuntu with Docker.
- Included a .dockerignore file to exclude unnecessary files from Docker builds.

src/app/api/bug-reports/[id]/route.ts

@@ -1,7 +1,15 @@
+// ── Bug Reports: Single Report ───────────────────────────────────────────────
+// PATCH /api/bug-reports/[id]  — Update bug report status, assignment, or notes
+//
+// Auth: admin/super_admin only
+// Supports partial updates for: status, assigned_to, resolution_notes
+
 import { NextRequest, NextResponse } from "next/server"
 import { query } from "@/lib/db"
 import { getSessionUser, setSessionContext } from "@/lib/auth"
 
+// ── PATCH ────────────────────────────────────────────────────────────────────
+
 export async function PATCH(request: NextRequest, { params: routeParams }: { params: Promise<{ id: string }> }) {
   try {
     const sessionUser = await getSessionUser()
@@ -27,11 +35,13 @@ export async function PATCH(request: NextRequest, { params: routeParams }: { par
       return NextResponse.json({ error: "Invalid status." }, { status: 400 })
     }
 
+    // Verify the bug report exists before updating
     const existing = await query("SELECT id, status FROM bug_reports WHERE id = $1", [id])
     if (existing.rows.length === 0) {
       return NextResponse.json({ error: "Bug report not found." }, { status: 404 })
     }
 
+    // Build dynamic SET clause for partial updates
     const updates: string[] = []
     const values: unknown[] = []
     let paramIndex = 1

src/app/api/bug-reports/route.ts

@@ -1,7 +1,16 @@
+// ── Bug Reports: Collection ──────────────────────────────────────────────────
+// POST /api/bug-reports  — Submit a new bug report (any authenticated user)
+// GET  /api/bug-reports  — List bug reports with filters (admin/super_admin only)
+//
+// Auth: POST = authenticated; GET = admin/super_admin
+// GET supports: status, severity, limit, offset
+
 import { NextRequest, NextResponse } from "next/server"
 import { query } from "@/lib/db"
 import { getSessionUser } from "@/lib/auth"
 
+// ── POST ─────────────────────────────────────────────────────────────────────
+
 export async function POST(request: NextRequest) {
   try {
     const sessionUser = await getSessionUser()
@@ -38,6 +47,8 @@ export async function POST(request: NextRequest) {
   }
 }
 
+// ── GET ──────────────────────────────────────────────────────────────────────
+
 export async function GET(request: NextRequest) {
   try {
     const sessionUser = await getSessionUser()
@@ -54,6 +65,7 @@ export async function GET(request: NextRequest) {
     const limit = parseInt(searchParams.get("limit") || "50", 10)
     const offset = parseInt(searchParams.get("offset") || "0", 10)
 
+    // Build dynamic SQL with optional status/severity filters
     let sql = `SELECT br.id, br.title, br.description, br.severity, br.page_url,
                       br.screenshot_url, br.status, br.resolution_notes,
                       br.created_at, br.updated_at,