How kainonsolucoes1-beep/o2-solution works
O2 Solution is a lead-management SaaS: users sign in, work leads through pipeline and campaign processes, and review operational and financial results. Its React application calls a FastAPI backend that applies role/team visibility rules and reads or writes PostgreSQL. The backend also syncs leads from Followize; the README documents a 30-minute sync cadence. The graph preserves documented product areas, but several route implementations and frontend pages were not excerpted, so some subsystem links are shown only where the index or README supports them.
Main entry points: App.tsx Application routes · main.py API application · index.ts API client · leads_routes.py Lead operations
Components 29
User experience
- Application routes
frontend/src/App.tsx - API client
frontend/src/api/index.ts - Theme state
frontend/src/ThemeContext.tsx
Lead operations
- Lead workspace
frontend/src/pages/LeadDetailPage.tsx - Pipeline view
frontend/src/pages/Pipeline.tsx - Campaign tools
frontend/src/pages/CampanhasFila.tsx - Lead operations
backend/app/api/leads_routes.py - Pipeline service
backend/app/api/pipeline_routes.py - Campaign service
backend/app/api/campanhas_routes.py
Analytics and finance
- Dashboard
frontend/src/pages/Dashboard.tsx - Commercial analytics
frontend/src/pages/GestaoComercial.tsx - KPI reporting
frontend/src/pages/KPIs.tsx - Finance workspace
frontend/src/pages/Financeiro.tsx - Dashboard metrics
backend/app/api/dashboard_routes.py - Commercial metrics
backend/app/api/gestao_comercial_routes.py - KPI service
backend/app/api/kpis_routes.py - Finance services
backend/app/api/financeiro_routes.py - Emissions
backend/app/api/emissao_routes.py
Backend platform
- API application
backend/app/main.py - Authentication
backend/app/api/auth_routes.py - Access policy
backend/app/security.py - Lead rules
backend/app/lead_utils.py - PostgreSQL
External integrations
- Followize sync
backend/app/sync_followize.py - Revenue sheets
backend/app/sheets_receita.py - Attachment storage
backend/app/storage_r2.py
Other components
- Business users
- Followize
- Cloud object storage
Connections 41
- Business users → Application routes: use
frontend/src/App.tsx - Application routes → Lead workspace: routes to
frontend/src/App.tsx - Application routes → Pipeline view: routes to
frontend/src/App.tsx - Application routes → Campaign tools: routes to
frontend/src/App.tsx - Application routes → Dashboard: routes to
frontend/src/App.tsx - Application routes → Commercial analytics: routes to
frontend/src/App.tsx - Application routes → KPI reporting: routes to
frontend/src/App.tsx - Application routes → Finance workspace: routes to
frontend/src/App.tsx - Application routes → Theme state: provides theme
frontend/src/App.tsx - Lead workspace → API client: requests data
frontend/src/api/index.ts - Pipeline view → API client: requests data
frontend/src/api/index.ts - Campaign tools → API client: requests data
- Dashboard → API client: requests data
- Commercial analytics → API client: requests data
frontend/src/pages/GestaoComercial.tsx - KPI reporting → API client: requests data
frontend/src/pages/KPIs.tsx - Finance workspace → API client: requests data
- API client → API application: calls API
- API application → Authentication: registers routes
backend/app/main.py - API application → Lead operations: registers routes
backend/app/main.py - API application → Pipeline service: registers routes
backend/app/main.py - API application → Campaign service: registers routes
backend/app/main.py - API application → Dashboard metrics: registers routes
backend/app/main.py - API application → Commercial metrics: registers routes
backend/app/main.py - API application → KPI service: registers routes
backend/app/main.py - Authentication → Access policy: checks access
backend/app/api/auth_routes.py - Authentication → PostgreSQL: reads users
backend/app/api/auth_routes.py - Lead operations → PostgreSQL: reads and writes
backend/app/api/leads_routes.py - Lead operations → Lead rules: uses rules
backend/app/api/leads_routes.py - Pipeline service → PostgreSQL: queries leads
backend/app/api/pipeline_routes.py - Campaign service → PostgreSQL: queries leads
backend/app/api/campanhas_routes.py - Dashboard metrics → PostgreSQL: queries metrics
backend/app/api/dashboard_routes.py - Commercial metrics → PostgreSQL: queries metrics
backend/app/api/gestao_comercial_routes.py - Commercial metrics → Lead rules: uses rules
backend/app/api/gestao_comercial_routes.py - KPI service → PostgreSQL: queries metrics
backend/app/api/kpis_routes.py - Finance services → PostgreSQL: reads and writes
- Emissions → PostgreSQL: reads and writes
- Followize sync → Followize: syncs leads
- Followize sync → PostgreSQL: updates leads
backend/app/sync_followize.py - Revenue sheets → PostgreSQL: syncs revenue
backend/app/sheets_receita.py - Lead operations → Attachment storage: handles attachments
backend/app/api/leads_routes.py - Attachment storage → Cloud object storage: stores files