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

Auth e accesso

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.

AI e agenti

Module	Kind	Repo path	Summary
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-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.

Datasource e scraping

Module	Kind	Repo path	Summary
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-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.

Pagamenti

Module	Kind	Repo path	Summary
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.

MCP gateway

Module	Kind	Repo path	Summary
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.

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.