# yopeman/vector_front_desk__designer_erp architecture

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

- Interactive diagram: https://gitdiagram.com/yopeman/vector_front_desk__designer_erp
- Repository: https://github.com/yopeman/vector_front_desk__designer_erp

## Overview

This repository is a suite of ERP-oriented web applications rather than one single runtime: creative/HR workflows, finance, front-desk and client operations, marketing, machine operations, and an AI service. Users enter through each app’s routed interface and work in its domain modules; the sampled front-desk client page, for example, combines client details, self-service updates, orders, and feedback. The graph preserves major routed capabilities while consolidating related screens. Source evidence is uneven: unsampled modules are represented from the file tree and route references, and their internal calls are not inferred.

Main entry points: [`front-desk-app/src/App.jsx`](https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/front-desk-app/src/App.jsx) (Front-desk app routes), [`creative/src/App.jsx`](https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/creative/src/App.jsx) (Creative app routes), [`finance/finance-app/src/App.jsx`](https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/finance/finance-app/src/App.jsx) (Finance app routes), [`marketing-app/src/App.tsx`](https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/marketing-app/src/App.tsx) (Marketing app routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_creative["Creative Portal"]
  node_creative_app["Creative app routes<br/>[App.jsx]"]
  node_creative_work["Creative workflows"]
  node_creative_reports["Creative reports<br/>[ReportsTab.jsx]"]
  node_creative_auth["Creative authentication"]
  node_creative_messages["Creative messaging<br/>[CreativeChat.jsx]"]
  node_creative_db[("Creative Supabase<br/>[supabaseClient.js]")]
end

subgraph group_finance["Finance"]
  node_finance_app["Finance app routes<br/>[App.jsx]"]
  node_finance_operations["Accounting operations"]
  node_finance_reports["Finance reports<br/>[Reports.tsx]"]
  node_finance_auth["Finance authentication<br/>[useAuth.tsx]"]
  node_finance_sync["Cross-system sync<br/>[syncService.ts]"]
  node_finance_db[("Finance data clients<br/>[supabaseClients.ts]")]
end

subgraph group_frontdesk["Front Desk"]
  node_frontdesk_app["Front-desk app routes<br/>[App.jsx]"]
  node_frontdesk_roles["Role routing<br/>[RoleRouter.jsx]"]
  node_frontdesk_operations["Desk operations<br/>[FrontDeskPage.jsx]"]
  node_frontdesk_client["Client portal<br/>[ClientPage.jsx]"]
  node_frontdesk_reports["Front-desk reports<br/>[ReportPage.jsx]"]
  node_frontdesk_auth["Front-desk auth<br/>[auth.jsx]"]
  node_frontdesk_db[("Front-desk Supabase<br/>[supabase.js]")]
end

subgraph group_marketing["Marketing"]
  node_marketing_app["Marketing app routes<br/>[App.tsx]"]
  node_marketing_modules["Marketing modules"]
  node_marketing_analysis["Marketing analysis"]
  node_marketing_api["Marketing data APIs"]
  node_marketing_db[("Marketing Supabase<br/>[client.ts]")]
end

subgraph group_ai["AI Service"]
  node_ai_routes["AI service routes<br/>[routes.py]"]
  node_ai_engine["AI orchestration<br/>[ai.py]"]
  node_ai_tools["ERP tools<br/>[tools.py]"]
  node_ai_db[("AI session data<br/>[db.py]")]
end

subgraph group_machine["Machine Operations"]
end

node_creative_user(("Creative user"))
node_finance_user(("Finance user"))
node_frontdesk_user(("Staff or client"))
node_marketing_user(("Marketing user"))
node_ai_client(("ERP assistant user"))
node_machine_operator(("Machine operator"))

node_creative_user -->|"uses"| node_creative_app
node_creative_app -->|"renders"| node_creative_work
node_creative_app -->|"routes to"| node_creative_reports
node_creative_app -->|"provides auth"| node_creative_auth
node_creative_app -->|"renders"| node_creative_messages
node_creative_auth -->|"reads and writes"| node_creative_db
node_creative_work -->|"uses data"| node_creative_db
node_creative_messages -->|"uses data"| node_creative_db
node_finance_user -->|"uses"| node_finance_app
node_finance_app -->|"routes to"| node_finance_operations
node_finance_app -->|"routes to"| node_finance_reports
node_finance_app -->|"provides auth"| node_finance_auth
node_finance_auth -->|"authenticates with"| node_finance_db
node_finance_operations -->|"loads finance data"| node_finance_db
node_finance_sync -->|"syncs through"| node_finance_db
node_frontdesk_user -->|"uses"| node_frontdesk_app
node_frontdesk_app -->|"routes through"| node_frontdesk_roles
node_frontdesk_app -->|"routes to"| node_frontdesk_operations
node_frontdesk_app -->|"routes to"| node_frontdesk_client
node_frontdesk_app -->|"routes to"| node_frontdesk_reports
node_frontdesk_app -->|"provides auth"| node_frontdesk_auth
node_frontdesk_client -->|"loads client data"| node_frontdesk_db
node_frontdesk_auth -->|"authenticates with"| node_frontdesk_db
node_marketing_user -->|"uses"| node_marketing_app
node_marketing_app -->|"routes to"| node_marketing_modules
node_marketing_app -->|"routes to"| node_marketing_analysis
node_marketing_modules -.->|"data access"| node_marketing_api
node_marketing_api -.->|"queries"| node_marketing_db
node_ai_client -.->|"submits requests"| node_ai_routes
node_ai_routes -->|"invokes"| node_ai_engine
node_ai_routes -->|"reads and writes"| node_ai_db
node_ai_engine -->|"uses tools"| node_ai_tools
node_ai_engine -->|"uses storage"| node_ai_db
node_machine_operator -.->|"operates alongside"| node_frontdesk_user

click node_creative_app "https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/creative/src/App.jsx"
click node_creative_work "https://github.com/yopeman/vector_front_desk__designer_erp/tree/main/creative/src/components"
click node_creative_reports "https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/creative/src/components/ReportsTab.jsx"
click node_creative_auth "https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/creative/src/contexts/CreativeAuthContext.jsx"
click node_creative_messages "https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/creative/src/components/CreativeChat.jsx"
click node_creative_db "https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/creative/src/lib/supabaseClient.js"
click node_finance_app "https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/finance/finance-app/src/App.jsx"
click node_finance_operations "https://github.com/yopeman/vector_front_desk__designer_erp/tree/main/finance/finance-app/src/pages"
click node_finance_reports "https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/finance/finance-app/src/pages/Reports.tsx"
click node_finance_auth "https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/finance/finance-app/src/hooks/useAuth.tsx"
click node_finance_sync "https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/finance/finance-app/src/services/syncService.ts"
click node_finance_db "https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/finance/finance-app/src/services/supabaseClients.ts"
click node_frontdesk_app "https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/front-desk-app/src/App.jsx"
click node_frontdesk_roles "https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/front-desk-app/src/components/RoleRouter.jsx"
click node_frontdesk_operations "https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/front-desk-app/src/pages/front-desk/FrontDeskPage.jsx"
click node_frontdesk_client "https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/front-desk-app/src/pages/ClientPage.jsx"
click node_frontdesk_reports "https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/front-desk-app/src/pages/front-desk/components/ReportPage.jsx"
click node_frontdesk_auth "https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/front-desk-app/src/lib/auth.jsx"
click node_frontdesk_db "https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/front-desk-app/src/lib/supabase.js"
click node_marketing_app "https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/marketing-app/src/App.tsx"
click node_marketing_modules "https://github.com/yopeman/vector_front_desk__designer_erp/tree/main/marketing-app/src/pages"
click node_marketing_analysis "https://github.com/yopeman/vector_front_desk__designer_erp/tree/main/marketing-app/src/pages/Analysis"
click node_marketing_api "https://github.com/yopeman/vector_front_desk__designer_erp/tree/main/marketing-app/src/lib/api"
click node_marketing_db "https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/marketing-app/src/lib/supabase/client.ts"
click node_ai_routes "https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/ai-ms-app/app/routes.py"
click node_ai_engine "https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/ai-ms-app/app/ai.py"
click node_ai_tools "https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/ai-ms-app/app/tools.py"
click node_ai_db "https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/ai-ms-app/app/db.py"

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_creative_app,node_creative_work,node_creative_reports,node_creative_auth,node_creative_messages,node_creative_db,node_creative_user,node_finance_user,node_frontdesk_user,node_marketing_user,node_ai_client toneBlue
class node_finance_app,node_finance_operations,node_finance_reports,node_finance_auth,node_finance_sync,node_finance_db toneAmber
class node_frontdesk_app,node_frontdesk_roles,node_frontdesk_operations,node_frontdesk_client,node_frontdesk_reports,node_frontdesk_auth,node_frontdesk_db toneMint
class node_marketing_app,node_marketing_modules,node_marketing_analysis,node_marketing_api,node_marketing_db toneRose
class node_ai_routes,node_ai_engine,node_ai_tools,node_ai_db,node_machine_operator toneIndigo
```

## Components

### Creative Portal

- [Creative app routes](https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/creative/src/App.jsx): `creative/src/App.jsx`
- [Creative workflows](https://github.com/yopeman/vector_front_desk__designer_erp/tree/main/creative/src/components): `creative/src/components`
- [Creative reports](https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/creative/src/components/ReportsTab.jsx): `creative/src/components/ReportsTab.jsx`
- [Creative authentication](https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/creative/src/contexts/CreativeAuthContext.jsx): `creative/src/contexts/CreativeAuthContext.jsx`
- [Creative messaging](https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/creative/src/components/CreativeChat.jsx): `creative/src/components/CreativeChat.jsx`
- [Creative Supabase](https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/creative/src/lib/supabaseClient.js): `creative/src/lib/supabaseClient.js`

### Finance

- [Finance app routes](https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/finance/finance-app/src/App.jsx): `finance/finance-app/src/App.jsx`
- [Accounting operations](https://github.com/yopeman/vector_front_desk__designer_erp/tree/main/finance/finance-app/src/pages): `finance/finance-app/src/pages`
- [Finance reports](https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/finance/finance-app/src/pages/Reports.tsx): `finance/finance-app/src/pages/Reports.tsx`
- [Finance authentication](https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/finance/finance-app/src/hooks/useAuth.tsx): `finance/finance-app/src/hooks/useAuth.tsx`
- [Cross-system sync](https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/finance/finance-app/src/services/syncService.ts): `finance/finance-app/src/services/syncService.ts`
- [Finance data clients](https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/finance/finance-app/src/services/supabaseClients.ts): `finance/finance-app/src/services/supabaseClients.ts`

### Front Desk

- [Front-desk app routes](https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/front-desk-app/src/App.jsx): `front-desk-app/src/App.jsx`
- [Role routing](https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/front-desk-app/src/components/RoleRouter.jsx): `front-desk-app/src/components/RoleRouter.jsx`
- [Desk operations](https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/front-desk-app/src/pages/front-desk/FrontDeskPage.jsx): `front-desk-app/src/pages/front-desk/FrontDeskPage.jsx`
- [Client portal](https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/front-desk-app/src/pages/ClientPage.jsx): `front-desk-app/src/pages/ClientPage.jsx`
- [Front-desk reports](https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/front-desk-app/src/pages/front-desk/components/ReportPage.jsx): `front-desk-app/src/pages/front-desk/components/ReportPage.jsx`
- [Front-desk auth](https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/front-desk-app/src/lib/auth.jsx): `front-desk-app/src/lib/auth.jsx`
- [Front-desk Supabase](https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/front-desk-app/src/lib/supabase.js): `front-desk-app/src/lib/supabase.js`

### Marketing

- [Marketing app routes](https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/marketing-app/src/App.tsx): `marketing-app/src/App.tsx`
- [Marketing modules](https://github.com/yopeman/vector_front_desk__designer_erp/tree/main/marketing-app/src/pages): `marketing-app/src/pages`
- [Marketing analysis](https://github.com/yopeman/vector_front_desk__designer_erp/tree/main/marketing-app/src/pages/Analysis): `marketing-app/src/pages/Analysis`
- [Marketing data APIs](https://github.com/yopeman/vector_front_desk__designer_erp/tree/main/marketing-app/src/lib/api): `marketing-app/src/lib/api`
- [Marketing Supabase](https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/marketing-app/src/lib/supabase/client.ts): `marketing-app/src/lib/supabase/client.ts`

### AI Service

- [AI service routes](https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/ai-ms-app/app/routes.py): `ai-ms-app/app/routes.py`
- [AI orchestration](https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/ai-ms-app/app/ai.py): `ai-ms-app/app/ai.py`
- [ERP tools](https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/ai-ms-app/app/tools.py): `ai-ms-app/app/tools.py`
- [AI session data](https://github.com/yopeman/vector_front_desk__designer_erp/blob/main/ai-ms-app/app/db.py): `ai-ms-app/app/db.py`

### Other components

- **Creative user**
- **Finance user**
- **Staff or client**
- **Marketing user**
- **ERP assistant user**
- **Machine operator**

## Connections

- Creative user → Creative app routes: uses (evidence: `creative/src/App.jsx`)
- Creative app routes → Creative workflows: renders (evidence: `creative/src/App.jsx`)
- Creative app routes → Creative reports: routes to (evidence: `creative/src/App.jsx`)
- Creative app routes → Creative authentication: provides auth (evidence: `creative/src/App.jsx`)
- Creative app routes → Creative messaging: renders (evidence: `creative/src/App.jsx`)
- Creative authentication → Creative Supabase: reads and writes (evidence: `creative/src/contexts/CreativeAuthContext.jsx`)
- Creative workflows → Creative Supabase: uses data (evidence: `creative/src/components/DesignTab.jsx`)
- Creative messaging → Creative Supabase: uses data (evidence: `creative/src/components/CreativeChat.jsx`)
- Finance user → Finance app routes: uses (evidence: `finance/finance-app/src/App.jsx`)
- Finance app routes → Accounting operations: routes to (evidence: `finance/finance-app/src/App.jsx`)
- Finance app routes → Finance reports: routes to (evidence: `finance/finance-app/src/App.jsx`)
- Finance app routes → Finance authentication: provides auth (evidence: `finance/finance-app/src/App.jsx`)
- Finance authentication → Finance data clients: authenticates with (evidence: `finance/finance-app/src/hooks/useAuth.tsx`)
- Accounting operations → Finance data clients: loads finance data
- Cross-system sync → Finance data clients: syncs through (evidence: `finance/finance-app/src/services/syncService.ts`)
- Staff or client → Front-desk app routes: uses (evidence: `front-desk-app/src/App.jsx`)
- Front-desk app routes → Role routing: routes through (evidence: `front-desk-app/src/App.jsx`)
- Front-desk app routes → Desk operations: routes to (evidence: `front-desk-app/src/App.jsx`)
- Front-desk app routes → Client portal: routes to (evidence: `front-desk-app/src/App.jsx`)
- Front-desk app routes → Front-desk reports: routes to (evidence: `front-desk-app/src/App.jsx`)
- Front-desk app routes → Front-desk auth: provides auth (evidence: `front-desk-app/src/App.jsx`)
- Client portal → Front-desk Supabase: loads client data (evidence: `front-desk-app/src/pages/ClientPage.jsx`)
- Front-desk auth → Front-desk Supabase: authenticates with (evidence: `front-desk-app/src/lib/auth.jsx`)
- Marketing user → Marketing app routes: uses (evidence: `marketing-app/src/App.tsx`)
- Marketing app routes → Marketing modules: routes to (evidence: `marketing-app/src/App.tsx`)
- Marketing app routes → Marketing analysis: routes to (evidence: `marketing-app/src/App.tsx`)
- Marketing modules → Marketing data APIs: data access
- Marketing data APIs → Marketing Supabase: queries
- ERP assistant user → AI service routes: submits requests
- AI service routes → AI orchestration: invokes (evidence: `ai-ms-app/app/routes.py`)
- AI service routes → AI session data: reads and writes (evidence: `ai-ms-app/app/routes.py`)
- AI orchestration → ERP tools: uses tools (evidence: `ai-ms-app/app/ai.py`)
- AI orchestration → AI session data: uses storage (evidence: `ai-ms-app/app/ai.py`)
- Machine operator → Staff or client: operates alongside