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/notifications/route.ts

@@ -1,7 +1,16 @@
+// ── Notifications: Collection ────────────────────────────────────────────────
+// GET   /api/notifications  — List the current user's recent notifications
+// POST  /api/notifications  — Create a new notification (self or target user)
+// PATCH /api/notifications  — Mark all unread notifications as read
+//
+// Auth: authenticated
+
 import { NextRequest, NextResponse } from "next/server"
 import { getSessionUser } from "@/lib/auth"
 import { query } from "@/lib/db"
 
+// ── GET ──────────────────────────────────────────────────────────────────────
+
 export async function GET() {
   try {
     const user = await getSessionUser()
@@ -28,6 +37,7 @@ export async function GET() {
       contextType: r.context_type,
     }))
 
+    // Also return total unread count for badge display
     const unreadResult = await query(
       `SELECT COUNT(*) AS count FROM notifications WHERE user_id = $1 AND is_read = FALSE`,
       [user.id],
@@ -43,6 +53,8 @@ export async function GET() {
   }
 }
 
+// ── POST ─────────────────────────────────────────────────────────────────────
+
 export async function POST(request: NextRequest) {
   try {
     const user = await getSessionUser()
@@ -50,6 +62,7 @@ export async function POST(request: NextRequest) {
 
     const { type, title, description, link, userId } = await request.json()
     const isAdmin = user.role === "admin" || user.role === "super_admin"
+    // Only admins can create notifications for other users; otherwise self-only
     const targetUserId = (userId && isAdmin) ? userId : user.id
 
     const result = await query(
@@ -75,11 +88,14 @@ export async function POST(request: NextRequest) {
   }
 }
 
+// ── PATCH ────────────────────────────────────────────────────────────────────
+
 export async function PATCH() {
   try {
     const user = await getSessionUser()
     if (!user) return NextResponse.json({ error: "Unauthorized" }, { status: 401 })
 
+    // Mark all unread notifications as read for the current user
     await query(
       `UPDATE notifications SET is_read = TRUE WHERE user_id = $1 AND is_read = FALSE`,
       [user.id],