# adm01-debug/brindes_sicoob_v2 architecture

> Architecture diagram of the GitHub repository adm01-debug/brindes_sicoob_v2, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/adm01-debug/brindes_sicoob_v2
- Repository: https://github.com/adm01-debug/brindes_sicoob_v2

## Overview

Brindes Sicoob V2 is a B2B promotional-goods portal. The main user journey runs from catalog discovery into price simulation and quote creation, with approval and fulfillment beyond that. The README also describes AI-assisted selling, kit building, mockup generation, BI, and voice features. The excerpts show app routing, authentication, catalog entry, and selected external-database operations; several product branches are documented but their runtime wiring was not sampled, so those links are omitted.

Main entry points: [`src/lib/external-db/index.ts`](https://github.com/adm01-debug/brindes_sicoob_v2/blob/main/src/lib/external-db/index.ts) (External DB bridge), [`src/App.tsx`](https://github.com/adm01-debug/brindes_sicoob_v2/blob/main/src/App.tsx) (App routing), [`src/integrations/supabase/client.ts`](https://github.com/adm01-debug/brindes_sicoob_v2/blob/main/src/integrations/supabase/client.ts) (Supabase client), [`src/components/admin/suppliers-manager/useSuppliersManager.ts`](https://github.com/adm01-debug/brindes_sicoob_v2/blob/main/src/components/admin/suppliers-manager/useSuppliersManager.ts) (Supplier management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application access"]
  node_app["App routing<br/>[App.tsx]"]
  node_auth["Authentication<br/>[AuthContext.tsx]"]
end

subgraph group_commerce["Product commerce"]
  node_catalog["Product catalog<br/>[Index.tsx]"]
  node_product_admin["Product management"]
  node_supplier_admin["Supplier management"]
  node_price_sim["Price simulation"]
  node_quotes["Quote creation"]
  node_quote_versions["Quote versioning"]
  node_fulfillment["Order fulfillment"]
end

subgraph group_assistance["Sales assistance"]
  node_ai_assistant["AI sales assistant"]
  node_kit_builder["Kit builder"]
  node_mockups["AI mockups"]
  node_bi["Sales intelligence"]
  node_voice["Voice agent"]
end

subgraph group_platform["Data and services"]
  node_supabase_client["Supabase client<br/>[client.ts]"]
  node_external_db["External DB bridge<br/>[index.ts]"]
  node_external_db_hook["External DB access"]
  node_crm_db["CRM data access<br/>[crm-db.ts]"]
  node_supabase[("Supabase services")]
  node_promobrind[("Promobrind database")]
  node_integrations["CRM and automation"]
end

node_buyer(("Portal user"))

node_buyer -.->|"opens portal"| node_app
node_app -->|"uses context"| node_auth
node_auth -->|"authenticates with"| node_supabase_client
node_supabase_client -->|"connects to"| node_supabase
node_app -->|"routes to"| node_catalog
node_catalog -->|"shows products"| node_buyer
node_product_admin -->|"reads and edits"| node_external_db
node_supplier_admin -->|"manages suppliers"| node_external_db
node_supplier_admin -->|"searches CRM"| node_crm_db
node_external_db_hook -->|"invokes bridge"| node_external_db
node_external_db -.->|"queries database"| node_promobrind
node_price_sim -->|"loads product data"| node_external_db
node_quotes -.->|"versions quotes"| node_quote_versions
node_quotes -.->|"requests approval"| node_buyer
node_fulfillment -->|"uses backend"| node_supabase_client
node_bi -->|"reads CRM records"| node_crm_db
node_ai_assistant -.->|"uses AI and CRM"| node_integrations
node_voice -.->|"uses speech services"| node_integrations
node_mockups -.->|"uses generative AI"| node_integrations

click node_app "https://github.com/adm01-debug/brindes_sicoob_v2/blob/main/src/App.tsx"
click node_auth "https://github.com/adm01-debug/brindes_sicoob_v2/blob/main/src/contexts/AuthContext.tsx"
click node_catalog "https://github.com/adm01-debug/brindes_sicoob_v2/blob/main/src/pages/Index.tsx"
click node_product_admin "https://github.com/adm01-debug/brindes_sicoob_v2/blob/main/src/components/admin/products/useProductsManager.ts"
click node_supplier_admin "https://github.com/adm01-debug/brindes_sicoob_v2/blob/main/src/components/admin/suppliers-manager/useSuppliersManager.ts"
click node_price_sim "https://github.com/adm01-debug/brindes_sicoob_v2/blob/main/src/hooks/simulator/useLivePricePreview.ts"
click node_quotes "https://github.com/adm01-debug/brindes_sicoob_v2/tree/main/src/components/quotes"
click node_quote_versions "https://github.com/adm01-debug/brindes_sicoob_v2/blob/main/src/services/quotes/quoteVersionService.ts"
click node_fulfillment "https://github.com/adm01-debug/brindes_sicoob_v2/blob/main/src/services/sicoob/fulfillmentService.ts"
click node_ai_assistant "https://github.com/adm01-debug/brindes_sicoob_v2/tree/main/src/components/ai"
click node_kit_builder "https://github.com/adm01-debug/brindes_sicoob_v2/tree/main/src/components/kit-builder"
click node_mockups "https://github.com/adm01-debug/brindes_sicoob_v2/tree/main/src/components/mockup"
click node_bi "https://github.com/adm01-debug/brindes_sicoob_v2/tree/main/src/hooks/bi"
click node_supabase_client "https://github.com/adm01-debug/brindes_sicoob_v2/blob/main/src/integrations/supabase/client.ts"
click node_external_db "https://github.com/adm01-debug/brindes_sicoob_v2/blob/main/src/lib/external-db/index.ts"
click node_external_db_hook "https://github.com/adm01-debug/brindes_sicoob_v2/blob/main/src/hooks/useExternalDatabase.ts"
click node_crm_db "https://github.com/adm01-debug/brindes_sicoob_v2/blob/main/src/lib/crm-db.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_auth,node_buyer toneBlue
class node_catalog,node_product_admin,node_supplier_admin,node_price_sim,node_quotes,node_quote_versions,node_fulfillment toneAmber
class node_ai_assistant,node_kit_builder,node_mockups,node_bi,node_voice toneMint
class node_supabase_client,node_external_db,node_external_db_hook,node_crm_db,node_supabase,node_promobrind,node_integrations toneRose
```

## Components

### Application access

- [App routing](https://github.com/adm01-debug/brindes_sicoob_v2/blob/main/src/App.tsx): `src/App.tsx`
- [Authentication](https://github.com/adm01-debug/brindes_sicoob_v2/blob/main/src/contexts/AuthContext.tsx): `src/contexts/AuthContext.tsx`

### Product commerce

- [Product catalog](https://github.com/adm01-debug/brindes_sicoob_v2/blob/main/src/pages/Index.tsx): `src/pages/Index.tsx`
- [Product management](https://github.com/adm01-debug/brindes_sicoob_v2/blob/main/src/components/admin/products/useProductsManager.ts): `src/components/admin/products/useProductsManager.ts`
- [Supplier management](https://github.com/adm01-debug/brindes_sicoob_v2/blob/main/src/components/admin/suppliers-manager/useSuppliersManager.ts): `src/components/admin/suppliers-manager/useSuppliersManager.ts`
- [Price simulation](https://github.com/adm01-debug/brindes_sicoob_v2/blob/main/src/hooks/simulator/useLivePricePreview.ts): `src/hooks/simulator/useLivePricePreview.ts`
- [Quote creation](https://github.com/adm01-debug/brindes_sicoob_v2/tree/main/src/components/quotes): `src/components/quotes`
- [Quote versioning](https://github.com/adm01-debug/brindes_sicoob_v2/blob/main/src/services/quotes/quoteVersionService.ts): `src/services/quotes/quoteVersionService.ts`
- [Order fulfillment](https://github.com/adm01-debug/brindes_sicoob_v2/blob/main/src/services/sicoob/fulfillmentService.ts): `src/services/sicoob/fulfillmentService.ts`

### Sales assistance

- [AI sales assistant](https://github.com/adm01-debug/brindes_sicoob_v2/tree/main/src/components/ai): `src/components/ai`
- [Kit builder](https://github.com/adm01-debug/brindes_sicoob_v2/tree/main/src/components/kit-builder): `src/components/kit-builder`
- [AI mockups](https://github.com/adm01-debug/brindes_sicoob_v2/tree/main/src/components/mockup): `src/components/mockup`
- [Sales intelligence](https://github.com/adm01-debug/brindes_sicoob_v2/tree/main/src/hooks/bi): `src/hooks/bi`
- **Voice agent**

### Data and services

- [Supabase client](https://github.com/adm01-debug/brindes_sicoob_v2/blob/main/src/integrations/supabase/client.ts): `src/integrations/supabase/client.ts`
- [External DB bridge](https://github.com/adm01-debug/brindes_sicoob_v2/blob/main/src/lib/external-db/index.ts): `src/lib/external-db/index.ts`
- [External DB access](https://github.com/adm01-debug/brindes_sicoob_v2/blob/main/src/hooks/useExternalDatabase.ts): `src/hooks/useExternalDatabase.ts`
- [CRM data access](https://github.com/adm01-debug/brindes_sicoob_v2/blob/main/src/lib/crm-db.ts): `src/lib/crm-db.ts`
- **Supabase services**
- **Promobrind database**
- **CRM and automation**

### Other components

- **Portal user**

## Connections

- Portal user → App routing: opens portal (evidence: `README.md`)
- App routing → Authentication: uses context (evidence: `src/App.tsx`)
- Authentication → Supabase client: authenticates with (evidence: `src/contexts/AuthContext.tsx`)
- Supabase client → Supabase services: connects to (evidence: `src/integrations/supabase/client.ts`)
- App routing → Product catalog: routes to (evidence: `src/App.tsx`)
- Product catalog → Portal user: shows products (evidence: `src/pages/Index.tsx`)
- Product management → External DB bridge: reads and edits (evidence: `src/components/admin/products/useProductsManager.ts`)
- Supplier management → External DB bridge: manages suppliers (evidence: `src/components/admin/suppliers-manager/useSuppliersManager.ts`)
- Supplier management → CRM data access: searches CRM (evidence: `src/components/admin/suppliers-manager/useSuppliersManager.ts`)
- External DB access → External DB bridge: invokes bridge (evidence: `src/hooks/useExternalDatabase.ts`)
- External DB bridge → Promobrind database: queries database (evidence: `README.md`)
- Price simulation → External DB bridge: loads product data (evidence: `src/hooks/simulator/useLivePricePreview.ts`)
- Quote creation → Quote versioning: versions quotes (evidence: `README.md`)
- Quote creation → Portal user: requests approval (evidence: `README.md`)
- Order fulfillment → Supabase client: uses backend (evidence: `src/services/sicoob/fulfillmentService.ts`)
- Sales intelligence → CRM data access: reads CRM records (evidence: `src/hooks/bi/useClientSeasonality.ts`)
- AI sales assistant → CRM and automation: uses AI and CRM (evidence: `README.md`)
- Voice agent → CRM and automation: uses speech services (evidence: `README.md`)
- AI mockups → CRM and automation: uses generative AI (evidence: `README.md`)
