Skip to content

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

ModuleKindRepo pathSummary
platform-auth-serviceServiceplatform-auth-serviceShared 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-serviceServiceplatform-ai-serviceProvider-agnostic AI boundary for the workspace, exposing a stable internal contract for text generation with pluggable providers.
platform-payments-serviceServiceplatform-payments-serviceProvider-agnostic CORE payment boundary for pricing catalog, checkout sessions, Stripe webhooks, purchase and subscription records, and normalized payment events to product backends.
platform-connectors-serviceServiceplatform-connectors-serviceShared datasource boundary used by product backends and MCP tools to reach Salesforce through source-based, service-to-service connector contracts.
platform-mcp-serviceServiceplatform-mcp-serviceCore 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-serviceServiceplatform-agent-serviceCore service for asynchronous agent execution requests, persisting execution state, orchestrating MCP tool calls around AI generations and delivering callbacks to source products.
platform-scraper-serviceServiceplatform-scraper-serviceCore 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

ModuleKindRepo pathSummary
funnel-ia-engineRepositoryfunnel-ia-engineExperience repository focused on funnels, messaging, automation, realtime product flows and agent-assisted outreach, implemented as a workspace with backend, worker and frontend.
funnel backendBackendfunnel-ia-engine/backendNestJS API that owns the public same-origin backend surface for FunnerAI, domain modules, queue orchestration, agent execution callbacks and realtime gateway integration.
funnel workerWorkerfunnel-ia-engine/backendDedicated worker process for asynchronous FunnerAI jobs, started from the backend workspace and backed by BullMQ queues on Redis.
funnel frontendFrontendfunnel-ia-engine/frontendReact and Vite frontend for FunnerAI, using same-origin APIs, hash routing, TanStack Query and shared auth/http clients.

SFDC

ModuleKindRepo pathSummary
sfdc-externalRepositorysfdc-externalSalesforce-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 backendBackendsfdc-external/backendNestJS BFF for External SFDC, acting as the public product boundary while orchestrating auth, datasource, metadata, reporting and visibility services.
sfdc frontendFrontendsfdc-external/frontendReact and Vite frontend for External SFDC, consuming only same-origin product APIs and shared route catalog helpers.
sfdc sharedPackagesfdc-external/sharedInternal package used by the External SFDC monorepo to share route catalog and type-level helpers between backend and frontend.

CS Portal

ModuleKindRepo pathSummary
cs-portalRepositorycs-portalCodestorm operations portal for HR, administration, documents, productivity integrations and Salesforce-backed operational workflows.
cs-portal backendBackendcs-portal/backendNestJS BFF for CS Portal, owning HR, administration, document and productivity workflows while delegating shared auth and Salesforce access to Core services.
cs-portal frontendFrontendcs-portal/frontendReact and Vite frontend for CS Portal, rendering HR, operations, administration, documents and lookup workflows through same-origin APIs.

CS Chat

ModuleKindRepo pathSummary
cs-chatRepositorycs-chatEnterprise chat experience with a dedicated NestJS BFF, React workspace, local shared contracts, conversation forks, MCP tools and dedicated PostgreSQL persistence.
cs-chat apiBackendcs-chat/apps/apiNestJS 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 webFrontendcs-chat/apps/webReact and Vite frontend for CS Chat, rendering multi-chat navigation, conversation composer, fork actions and MCP tool panels through same-origin APIs.
cs-chat sharedPackagecs-chat/packages/sharedLocal shared package for CS Chat contracts, exposing Zod schemas and TypeScript types consumed by the BFF and frontend.

CS Transaction

ModuleKindRepo pathSummary
cs-transacion-manageRepositorycs-transacion-manageTransaction 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 apiBackendcs-transacion-manage/apps/apiNestJS 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 webFrontendcs-transacion-manage/apps/webReact and Vite frontend for CS Transaction Manage, rendering the ledger workspace, onboarding, agenda, transactions, series and investments through same-origin APIs.
cs transaction sharedPackagecs-transacion-manage/packages/sharedLocal shared package for CS Transaction Manage contracts and TypeScript types consumed by the BFF and frontend.

Trasversale

Runtime locale e operazioni

ModuleKindRepo pathSummary
platform-local-stackWorkspaceplatform-local-stackSingle local bootstrap entrypoint for the workspace, centralizing host routing, infra provisioning, observability and start-stop lifecycle scripts.
platform-status-serviceServiceplatform-status-serviceOperational control plane that probes service health, exposes an aggregate status API and renders the status/operator dashboard.

Contratti condivisi

ModuleKindRepo pathSummary
platform-shared-packagesWorkspaceplatform-shared-packagesShared npm workspace that hosts contracts, frontend clients, observability helpers and UI primitives reused across Core and Experience repositories.
@platform/contracts-authPackageplatform-shared-packages/packages/contracts-authShared auth DTO and type contract reused by services and frontends to avoid duplicate auth shapes.
@platform/contracts-aiPackageplatform-shared-packages/packages/contracts-aiShared contract package for the internal AI generation API exposed by platform-ai-service.
@platform/contracts-paymentsPackageplatform-shared-packages/packages/contracts-paymentsShared payment contract package for provider descriptors, pricing items, checkout sessions, purchase and subscription records, tenant plan status, and normalized payment event delivery.
@platform/contracts-connectorsPackageplatform-shared-packages/packages/contracts-connectorsShared connector contract package for service-to-service datasource integrations and product-facing adapter layers.
@platform/contracts-agentPackageplatform-shared-packages/packages/contracts-agentShared type contract for asynchronous agent execution requests, MCP tool policy, tool trace, lifecycle statuses, usage data, callbacks and detail responses.
@platform/contracts-scraperPackageplatform-shared-packages/packages/contracts-scraperShared contract package for scraper crawl creation, crawl detail and callback payload shapes.

Client, osservabilita e UI

ModuleKindRepo pathSummary
@platform/auth-clientPackageplatform-shared-packages/packages/auth-clientThin auth client wrapper built on top of an injected apiFetch implementation and shared auth contracts.
@platform/http-clientPackageplatform-shared-packages/packages/http-clientCookie-aware HTTP client package intended for BFF-backed frontend applications in the workspace.
@platform/observabilityPackageplatform-shared-packages/packages/observabilityShared request-context and structured logging helpers used by platform services to emit consistent JSON logs and request ids.
@platform/uiPackageplatform-shared-packages/packages/uiInitial shared UI package intended to host design tokens and alignment primitives for cross-project frontend consistency.

Workspace reference: /Users/jeanpaul/projects/cs-repository