The CSuite Ecosystem
One-Sentence Definition (Board-safe)
CSuite is a Decision Operating System that converts reality into context, context into governed decisions, and decisions into institutional memory — continuously learning without losing control.
The CSuite ecosystem is about creating a Virtual C-Suite that supports decision-making for the 4 Certos (4 Rights) framework:
Core Purpose
Consolidate operational and financial applications with:
- Central authentication
- Gateway routing via Traefik
- Domain-specific services
- Policy-driven decision engine
The 4 Certos Framework
- Cliente Certo (Right Customer) - ML models for customer scoring and intent prediction
- Oferta Certa (Right Offer) - Product ranking and recommendation engine
- Hora Certa (Right Time) - Timing optimization for actions
- Jeito Certo (Right Way) - Policy compliance and governance
Key Components
- Policy Engine - Central decision-making system (csuite-executive)
- CSuite Memory - Institutional memory and governance system
- AI Agents - Virtual executives (CFO, CEO, COO, CMO, CAIO)
- Operational Apps - Customer decisions, sales manager, cashflow, operations
- Financial Analytics - TDABC costing, margin analysis, efficiency metrics
Infrastructure
- Microservices architecture with FastAPI
- MySQL databases per domain
- Docker Swarm orchestration
- Traefik for API gateway
- Grafana for dashboards
Ultimate Goal
Transform business decision-making by:
- Providing AI-driven recommendations
- Ensuring policy compliance
- Maintaining institutional memory
- Supporting executive decision processes
- Scaling decision capabilities across the organization
It's essentially a digital transformation platform that creates an intelligent, policy-driven decision support system for C-level executives.
App Documentation Summary
Core Apps
1. csuite-executive - Policy Engine & Governance Hub
- Central decision-making system (ALLOW/RECOMMEND/ESCALATE/DENY)
- Policy Guardian with AI agents
- CSuite Memory integration
- Institutional memory and governance loop
- Policy Radar API (27/12/2025): Governance endpoints for policy radar, attention status, proposed changes, and policy details
- Execution Evidence + Closure Discipline (27/12/2025 - Phase 1.7): Execution evidence (obrigatório para mark-executed), stalled proposals detection, auto-proposal on attention exceeded, charge-and-bridge endpoint
- Governance Health Metrics + Anti-Noise Hardening (27/12/2025 - Phase 1.8): Health snapshot metrics, cooldown anti-spam, closure automática, Governance Inbox endpoints (ready-to-execute, blocked steps, recent exceeded)
- Operational → OPS_* Mapping (27/12/2025): Server-side routing que mapeia automaticamente policy_ref="operational" para políticas OPS_* específicas baseado em payload_json, eliminando "operational" genérico do Radar
2. csuite-customer-decisions - 4C Integration Point
- Connects 4C app with csuite-executive
- Percepción → Conciência → Acción framework
- Feature service, scoring, decision APIs
- Uses MySQL, ClickHouse, Redis, Kafka
3. csuite-cashflow - Financial Management
- 180-day cash flow projection
- Container management for importers
- What-if simulation scenarios
- Alert system with configurable parameters
4. csuite-operations - Operational Bridge
- Connects 4C (client level) with Executive (org level)
- Operations dashboard and decision executor
- Workflow orchestrator
- Feedback collector for continuous improvement
5. csuite-sales-manager - B2B Sales Management
- Virtual sales manager for 6 sellers
- 1,500 resellers (250 per seller)
- Daily task prioritization
- 4C Lite integration (Customer/Offer/Way/Time)
Infrastructure Apps
6. csuite-auth-external - Authentication Service
- OAuth2/OIDC provider
- JWT tokens with refresh
- MFA support (TOTP)
- API keys and webhooks
7. csuite-gateway - API Gateway & Governance Portal
- Central portal listing all endpoints
- Health checks for services
- Links to Swagger/OpenAPI docs
- Modern responsive interface
- Policy Radar UI (27/12/2025): Executive governance dashboard with policy metrics, attention status, propose change workflow, and drill-down details
- Execution Evidence UI (27/12/2025 - Phase 1.7): Evidence section in execution modal, stalled proposals card, auto-proposal integration
- Governance Inbox UI (27/12/2025 - Phase 1.8): Governance Inbox com 4 listas (Stalled Approved, Ready to Execute, Blocked Steps, Auto-Proposals 7d), health metrics no dashboard
8. csuite-context - Context API
- Events API (short-term signals)
- Trends API (medium-term patterns)
- Jobs API for background tasks
- Detection and analysis capabilities
9. 4c - Commercial Cortex
- Minimal README (needs documentation)
- Core 4C implementation
- Feature/scoring/decision services
Each app follows microservices architecture with FastAPI, MySQL databases, and Docker deployment via Swarm.