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/(dashboard)/leads/new/page.tsx

@@ -1,3 +1,16 @@
+// ───────────────────────────────────────────────
+// Create Lead Page (/(dashboard)/leads/new)
+// ───────────────────────────────────────────────
+// Route: /leads/new
+// Purpose: Form to create a new lead. Uses
+//   react-hook-form + zod for validation.
+//   On success, fires a notification and
+//   redirects to the leads list.
+// Layout: Back link, heading, Card with form
+//   fields in a 2-col grid + textarea + user
+//   assignment select.
+// ───────────────────────────────────────────────
+
 "use client"
 
 import { useState, useEffect } from "react"
@@ -30,6 +43,7 @@ import { User } from "@/types"
 import { useNotifications } from "@/providers/notification-provider"
 import { LEAD_SOURCES, LEAD_STATUSES } from "@/lib/constants"
 
+/** Zod schema for lead creation form validation. */
 const leadFormSchema = z.object({
   companyName: z.string().min(1, "Company name is required"),
   contactName: z.string().min(1, "Contact name is required"),
@@ -43,12 +57,22 @@ const leadFormSchema = z.object({
 
 type LeadFormValues = z.infer<typeof leadFormSchema>
 
+/**
+ * CreateLeadPage
+ * ──────────────
+ * Zod-validated lead creation form. Fetches the
+ * user list for lead assignment on mount. On
+ * submit POSTs to /api/leads and navigates back.
+ *
+ * @returns Lead creation form layout.
+ */
 export default function CreateLeadPage() {
   const router = useRouter()
   const { addNotification } = useNotifications()
   const [saving, setSaving] = useState(false)
   const [users, setUsers] = useState<User[]>([])
 
+  // ── Fetch available users for assignment ──
   useEffect(() => {
     fetch("/api/users")
       .then((r) => r.json())
@@ -70,9 +94,11 @@ export default function CreateLeadPage() {
     },
   })
 
+  // ── Submit handler ──
   async function onSubmit(values: LeadFormValues) {
     setSaving(true)
     try {
+      // Transform "none" sentinel value to null
       const payload = {
         ...values,
         assignedUserId: values.assignedUserId === "none" ? null : (values.assignedUserId ?? null),
@@ -84,6 +110,7 @@ export default function CreateLeadPage() {
       })
       if (!res.ok) throw new Error("Failed to create lead")
       const data = await res.json()
+      // Notify other parts of the app
       addNotification("lead_created", "New Lead Created", `${values.companyName} — ${values.contactName}`, `/leads/${data.id}`)
       router.push("/leads")
     } catch (e) {
@@ -95,6 +122,7 @@ export default function CreateLeadPage() {
 
   return (
     <div className="space-y-6">
+      {/* ── Back navigation ── */}
       <Link
         href="/leads"
         className="inline-flex items-center gap-1 text-sm text-muted-foreground hover:text-foreground transition-colors"
@@ -108,6 +136,7 @@ export default function CreateLeadPage() {
         <p className="mt-1 text-sm text-muted-foreground">Fill in the details to add a new lead.</p>
       </div>
 
+      {/* ── Lead form ── */}
       <Card>
         <CardContent className="pt-6">
           <Form {...form}>
@@ -256,6 +285,7 @@ export default function CreateLeadPage() {
                   </FormItem>
                 )}
               />
+              {/* ── Submit / Cancel buttons ── */}
               <div className="flex items-center gap-3 pt-2">
                 <Button type="submit" disabled={saving}>
                   {saving ? "Saving..." : "Create Lead"}