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.

scripts/lib/ts-error-parser.ts

@@ -2,6 +2,7 @@
 // Parses `tsc --noEmit` or `npm run build` output to extract
 // "Module not found: Can't resolve '@/path/to/module'" errors.
 // Returns actionable missing module info for the generator.
+// Used by both setup.mjs (self-heal) and code-repair-agent.mjs.
 
 export interface MissingModule {
   /** The import path that failed, e.g. "@/data/stickers" */
@@ -20,7 +21,7 @@ export interface MissingModule {
   internalPath?: string;
 }
 
-/** Parse TypeScript compiler output for missing module errors */
+/** Parse TypeScript compiler output for missing module errors (TS2307 + webpack-style "Can't resolve"). */
 export function parseMissingModules(tscOutput: string): MissingModule[] {
   const results: MissingModule[] = [];
 
@@ -74,12 +75,12 @@ export function parseMissingModules(tscOutput: string): MissingModule[] {
   });
 }
 
-/** Filter to only internal (@/...) modules we can auto-generate */
+/** Filter to only internal (@/... or ~/...) modules we can auto-generate from templates. */
 export function filterGeneratable(modules: MissingModule[]): MissingModule[] {
   return modules.filter((m) => m.isInternal && m.internalPath);
 }
 
-/** Group missing modules by internal path */
+/** Group missing modules by their normalized internal path (deduplicates same module imported from multiple files). */
 export function groupByInternalPath(modules: MissingModule[]): Map<string, MissingModule[]> {
   const groups = new Map<string, MissingModule[]>();
   for (const m of modules) {