Saltar al contenido principal

Project Map

This map classifies every top-level folder in the workspace. Use it to decide what to read first, which project owns a behavior, and how risky a change is.

Production Core​

FolderRoleWhy it matters
uiAngular dashboardUser-facing app for GTM setup, CRM, analytics, offline conversions, billing, and Copilot entry points.
node-apiControl-plane APIOwns users, workspaces, GTMs, domains, CRM, billing, Copilot backend routes, PostgreSQL, ClickHouse access, and internal service contracts.
gtm-proxyPublic edge proxyReceives tracking traffic, handles dynamic SSL/SNI, custom loader, GA4 bypass, async Pub/Sub publish, sync preview, and /api/* routing.
gtm-fabricData-plane workerOrchestrates GTM Docker containers, consumes Pub/Sub events, forwards to GTM, enriches/parses events, writes ClickHouse, and reports state to node-api.
crimoo-inspectorDebug inspectorPreact Shadow DOM tool injected into customer sites for event inspection and CRM rule creation.

Supporting Applications​

FolderRoleNotes
CrimooCopilot-BackendStandalone Copilot backendAI/GTM automation service using Express, TypeScript, Gemini, Google APIs, and PostgreSQL. Some Copilot logic is also documented through node-api flows.
CrimooCopilot-frontStandalone Copilot frontendReact/Vite UI for the Copilot assistant and iframe overlay behavior.
pluginsCustomer platform pluginsWordPress and Shopify plugin experiments/integrations for script injection and ecommerce dataLayer support.
deploy-serviceDeployment placeholderCurrently minimal from repo evidence; document as low-confidence until implementation appears.

Docs Apps​

FolderRoleNotes
crimoo-internal-docsInternal Docusaurus docsArchitecture, service, flow, and learning docs for developers. This study pack lives here.
crimoo-docsPublic/user docsUser-facing Docusaurus docs for installation, verification, CRM, and capture concepts.

Test Suites​

FolderRoleNotes
e2ePlaywright E2E suiteBrowser-level tests with fixtures, page objects, reports, and screenshots/videos.
EndToEndTests-e2eSecond Playwright E2E suiteSimilar shape to e2e; treat as duplicate or migration candidate until ownership is clarified.

Legacy or Experimental Context​

FolderRoleCurrent interpretation
gatewayGo router/gatewayExisting internal docs say this service exists but is not part of the production tagging path; current production edge path is gtm-proxy.
agentGo worker/agentEarlier architecture for distributed worker nodes; overlaps conceptually with gtm-fabric. Useful for historical context and possible future edge design.
dudamelJava VM managerVM provisioning manager for GCP experiments. Useful for infrastructure ideas, not documented as current production runtime.
jira-likeReact/Vite planning appSeparate project/task board app, not part of GTM runtime.
jira-like oldOlder copy of planning appLegacy copy; avoid using as a source of current product truth unless comparing migrations.

Ownership by Behavior​

BehaviorPrimary ownerSecondary projects
Login, register, Google OAuthnode-apiui
Workspace selection and permissionsnode-apiui
GTM creation and lifecyclenode-apigtm-fabric, ui
Docker GTM containersgtm-fabricnode-api
Public tracking requestsgtm-proxygtm-fabric
Preview/debug requestsgtm-proxygtm-fabric, GTM container
Dynamic SSL certificatesgtm-proxygtm-fabric, node-api, Cloudflare, Let's Encrypt
ClickHouse analytics writesgtm-fabricnode-api
Analytics queries/widgetsnode-apiui
CRM contacts and dealsnode-apiui, gtm-fabric, crimoo-inspector
CRM capture rulesnode-api and gtm-fabricui, crimoo-inspector
Offline conversionsnode-apiui
Billing and subscriptionsnode-apiui, Stripe
Copilot sessions and AInode-api or CrimooCopilot-Backend depending pathui, CrimooCopilot-front
Browser E2E confidencee2eEndToEndTests-e2e

Reading Order​

For production mastery:

  1. ui
  2. node-api
  3. gtm-proxy
  4. gtm-fabric
  5. crimoo-inspector
  6. e2e

For whole-workspace awareness:

  1. Core production projects.
  2. Copilot projects.
  3. Plugins.
  4. Docs apps.
  5. Legacy/experimental services.
  6. Duplicate/old app folders.