Catalogo moduli
Inventario completo dei moduli documentati nella wiki, con link alle rispettive specifiche. Le aree sono raggruppate per famiglia operativa: prodotti Experience, servizi Core e abilitatori trasversali.
Core
Core services
| Module | Kind | Repo path | Summary |
|---|---|---|---|
| platform-auth-service | Service | platform-auth-service | Shared auth and session service for the workspace, owning cookie sessions, provider configuration, local credentials, OIDC login and trusted identity routes for product backends. |
| platform-ai-service | Service | platform-ai-service | Provider-agnostic AI boundary for the workspace, exposing a stable internal contract for text generation with pluggable providers. |
| platform-payments-service | Service | platform-payments-service | Provider-agnostic CORE payment boundary for pricing catalog, checkout sessions, Stripe webhooks, purchase and subscription records, and normalized payment events to product backends. |
| platform-connectors-service | Service | platform-connectors-service | Shared datasource boundary used by product backends and MCP tools to reach Salesforce through source-based, service-to-service connector contracts. |
| platform-mcp-service | Service | platform-mcp-service | Core MCP boundary that exposes controlled platform tools for status, auth, AI, datasource diagnostics and scraper operations without moving product business logic into the MCP service. |
| platform-agent-service | Service | platform-agent-service | Core service for asynchronous agent execution requests, persisting execution state, orchestrating MCP tool calls around AI generations and delivering callbacks to source products. |
| platform-scraper-service | Service | platform-scraper-service | Core service-to-service crawler runtime that accepts crawl requests, renders pages with Playwright, stores crawl state in Redis and delivers results through callbacks. |
Experience
FunnelIA
| Module | Kind | Repo path | Summary |
|---|---|---|---|
| funnel-ia-engine | Repository | funnel-ia-engine | Experience repository focused on funnels, messaging, automation, realtime product flows and agent-assisted outreach, implemented as a workspace with backend, worker and frontend. |
| funnel backend | Backend | funnel-ia-engine/backend | NestJS API that owns the public same-origin backend surface for FunnerAI, domain modules, queue orchestration, agent execution callbacks and realtime gateway integration. |
| funnel worker | Worker | funnel-ia-engine/backend | Dedicated worker process for asynchronous FunnerAI jobs, started from the backend workspace and backed by BullMQ queues on Redis. |
| funnel frontend | Frontend | funnel-ia-engine/frontend | React and Vite frontend for FunnerAI, using same-origin APIs, hash routing, TanStack Query and shared auth/http clients. |
SFDC
| Module | Kind | Repo path | Summary |
|---|---|---|---|
| sfdc-external | Repository | sfdc-external | Salesforce-oriented product repository that keeps the backend as public BFF while delegating auth and connector runtime to shared Core services and owning metadata, reports and dashboard UX. |
| sfdc backend | Backend | sfdc-external/backend | NestJS BFF for External SFDC, acting as the public product boundary while orchestrating auth, datasource, metadata, reporting and visibility services. |
| sfdc frontend | Frontend | sfdc-external/frontend | React and Vite frontend for External SFDC, consuming only same-origin product APIs and shared route catalog helpers. |
| sfdc shared | Package | sfdc-external/shared | Internal package used by the External SFDC monorepo to share route catalog and type-level helpers between backend and frontend. |
CS Portal
| Module | Kind | Repo path | Summary |
|---|---|---|---|
| cs-portal | Repository | cs-portal | Codestorm operations portal for HR, administration, documents, productivity integrations and Salesforce-backed operational workflows. |
| cs-portal backend | Backend | cs-portal/backend | NestJS BFF for CS Portal, owning HR, administration, document and productivity workflows while delegating shared auth and Salesforce access to Core services. |
| cs-portal frontend | Frontend | cs-portal/frontend | React and Vite frontend for CS Portal, rendering HR, operations, administration, documents and lookup workflows through same-origin APIs. |
CS Chat
| Module | Kind | Repo path | Summary |
|---|---|---|---|
| cs-chat | Repository | cs-chat | Enterprise chat experience with a dedicated NestJS BFF, React workspace, local shared contracts, conversation forks, MCP tools and dedicated PostgreSQL persistence. |
| cs-chat api | Backend | cs-chat/apps/api | NestJS BFF for CS Chat, owning chat persistence and same-origin product APIs while delegating auth, direct AI generation, agentic MCP replies and manual MCP tool calls to Core services. |
| cs-chat web | Frontend | cs-chat/apps/web | React and Vite frontend for CS Chat, rendering multi-chat navigation, conversation composer, fork actions and MCP tool panels through same-origin APIs. |
| cs-chat shared | Package | cs-chat/packages/shared | Local shared package for CS Chat contracts, exposing Zod schemas and TypeScript types consumed by the BFF and frontend. |
CS Transaction
| Module | Kind | Repo path | Summary |
|---|---|---|---|
| cs-transacion-manage | Repository | cs-transacion-manage | Transaction management experience with a dedicated NestJS BFF, React frontend, local shared contracts, platform-auth roles, platform-payments subscription tiers and dedicated PostgreSQL persistence. |
| cs transaction api | Backend | cs-transacion-manage/apps/api | NestJS BFF for CS Transaction Manage, delegating auth/session/role flows to platform-auth-service and subscription status to platform-payments-service while owning onboarding, ledger, transaction, series, investment and agenda APIs. |
| cs transaction web | Frontend | cs-transacion-manage/apps/web | React and Vite frontend for CS Transaction Manage, rendering the ledger workspace, onboarding, agenda, transactions, series and investments through same-origin APIs. |
| cs transaction shared | Package | cs-transacion-manage/packages/shared | Local shared package for CS Transaction Manage contracts and TypeScript types consumed by the BFF and frontend. |
Trasversale
Runtime locale e operazioni
| Module | Kind | Repo path | Summary |
|---|---|---|---|
| platform-local-stack | Workspace | platform-local-stack | Single local bootstrap entrypoint for the workspace, centralizing host routing, infra provisioning, observability and start-stop lifecycle scripts. |
| platform-status-service | Service | platform-status-service | Operational control plane that probes service health, exposes an aggregate status API and renders the status/operator dashboard. |
Contratti condivisi
| Module | Kind | Repo path | Summary |
|---|---|---|---|
| platform-shared-packages | Workspace | platform-shared-packages | Shared npm workspace that hosts contracts, frontend clients, observability helpers and UI primitives reused across Core and Experience repositories. |
| @platform/contracts-auth | Package | platform-shared-packages/packages/contracts-auth | Shared auth DTO and type contract reused by services and frontends to avoid duplicate auth shapes. |
| @platform/contracts-ai | Package | platform-shared-packages/packages/contracts-ai | Shared contract package for the internal AI generation API exposed by platform-ai-service. |
| @platform/contracts-payments | Package | platform-shared-packages/packages/contracts-payments | Shared payment contract package for provider descriptors, pricing items, checkout sessions, purchase and subscription records, tenant plan status, and normalized payment event delivery. |
| @platform/contracts-connectors | Package | platform-shared-packages/packages/contracts-connectors | Shared connector contract package for service-to-service datasource integrations and product-facing adapter layers. |
| @platform/contracts-agent | Package | platform-shared-packages/packages/contracts-agent | Shared type contract for asynchronous agent execution requests, MCP tool policy, tool trace, lifecycle statuses, usage data, callbacks and detail responses. |
| @platform/contracts-scraper | Package | platform-shared-packages/packages/contracts-scraper | Shared contract package for scraper crawl creation, crawl detail and callback payload shapes. |
Client, osservabilita e UI
| Module | Kind | Repo path | Summary |
|---|---|---|---|
| @platform/auth-client | Package | platform-shared-packages/packages/auth-client | Thin auth client wrapper built on top of an injected apiFetch implementation and shared auth contracts. |
| @platform/http-client | Package | platform-shared-packages/packages/http-client | Cookie-aware HTTP client package intended for BFF-backed frontend applications in the workspace. |
| @platform/observability | Package | platform-shared-packages/packages/observability | Shared request-context and structured logging helpers used by platform services to emit consistent JSON logs and request ids. |
| @platform/ui | Package | platform-shared-packages/packages/ui | Initial shared UI package intended to host design tokens and alignment primitives for cross-project frontend consistency. |