# diegofelippe/project-management- architecture

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

- Interactive diagram: https://gitdiagram.com/diegofelippe/project-management-
- Repository: https://github.com/diegofelippe/project-management-

## Overview

IXC Consult is a multi-company consulting-project management platform with role-scoped access. Users sign in or recover/set passwords, then enter role-authorized areas to manage consultancies, teams, people, and integrations. The documented integration branch connects consultancy-owned AI, SMTP, and Google accounts; secrets remain in Supabase Vault. The graph uses sampled imports/calls and README capabilities; several page and function implementations were not sampled, so those links are documented or left unasserted.

Main entry points: [`src/rotas.jsx`](https://github.com/diegofelippe/project-management-/blob/main/src/rotas.jsx) (Protected routes), [`src/pages/Usuarios.jsx`](https://github.com/diegofelippe/project-management-/blob/main/src/pages/Usuarios.jsx) (People and access), [`src/lib/supabase.js`](https://github.com/diegofelippe/project-management-/blob/main/src/lib/supabase.js) (Supabase client), [`src/pages/Integracoes.jsx`](https://github.com/diegofelippe/project-management-/blob/main/src/pages/Integracoes.jsx) (Integration settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and navigation"]
  node_routes["Protected routes<br/>[rotas.jsx]"]
  node_auth["Session and profile<br/>[AuthProvider.jsx]"]
  node_login["Sign-in and recovery<br/>[Entrar.jsx]"]
end

subgraph group_management["Consultancy management"]
  node_consultancy["Consultancy administration<br/>[Consultorias.jsx]"]
  node_teams["Team management<br/>[Times.jsx]"]
  node_team_detail["Team workspace<br/>[Time.jsx]"]
  node_people["People and access<br/>[Usuarios.jsx]"]
end

subgraph group_data["Data and services"]
  node_user_data["People data<br/>[usuarios.js]"]
  node_team_data["Team data<br/>[times.js]"]
  node_consultancy_data["Consultancy data<br/>[consultorias.js]"]
  node_supabase_client["Supabase client<br/>[supabase.js]"]
  node_database[("Supabase database")]
  node_edge_access["Access functions<br/>[index.ts]"]
  node_edge_consultancy["Consultancy functions<br/>[index.ts]"]
end

subgraph group_integrations["Integrations"]
  node_edge_integrations["Integration functions<br/>[index.ts]"]
  node_google_flow["Google OAuth function<br/>[index.ts]"]
  node_integration_page["Integration settings<br/>[Integracoes.jsx]"]
  node_integration_data["Integration data access<br/>[integracoes.js]"]
  node_shared_integration["Integration handling<br/>[integracoes.ts]"]
  node_vault[("Supabase Vault")]
end

subgraph group_experience["App experience"]
  node_pwa["Installable app<br/>[useInstalar.js]"]
end

node_actors(("Platform roles"))

node_actors -->|"signs in"| node_login
node_login -.->|"uses auth"| node_auth
node_auth -->|"reads session"| node_supabase_client
node_routes -->|"protects routes"| node_auth
node_routes -->|"routes to"| node_login
node_actors -->|"opens app"| node_routes
node_routes -->|"routes to"| node_consultancy
node_routes -->|"routes to"| node_teams
node_routes -->|"routes to"| node_team_detail
node_routes -->|"routes to"| node_people
node_routes -->|"routes to"| node_integration_page
node_people -->|"manages access"| node_user_data
node_people -->|"assigns members"| node_team_data
node_people -.->|"creates access"| node_edge_access
node_consultancy -.->|"creates consultancy"| node_edge_consultancy
node_user_data -->|"uses client"| node_supabase_client
node_team_data -->|"uses client"| node_supabase_client
node_supabase_client -.->|"queries"| node_database
node_integration_page -->|"calls"| node_integration_data
node_integration_data -.->|"invokes"| node_edge_integrations
node_integration_page -.->|"starts OAuth"| node_google_flow
node_edge_integrations -->|"uses handlers"| node_shared_integration
node_google_flow -->|"uses handlers"| node_shared_integration
node_shared_integration -.->|"stores secrets"| node_vault
node_actors -->|"installs app"| node_pwa

click node_routes "https://github.com/diegofelippe/project-management-/blob/main/src/rotas.jsx"
click node_auth "https://github.com/diegofelippe/project-management-/blob/main/src/auth/AuthProvider.jsx"
click node_login "https://github.com/diegofelippe/project-management-/blob/main/src/pages/Entrar.jsx"
click node_consultancy "https://github.com/diegofelippe/project-management-/blob/main/src/pages/Consultorias.jsx"
click node_teams "https://github.com/diegofelippe/project-management-/blob/main/src/pages/Times.jsx"
click node_team_detail "https://github.com/diegofelippe/project-management-/blob/main/src/pages/Time.jsx"
click node_people "https://github.com/diegofelippe/project-management-/blob/main/src/pages/Usuarios.jsx"
click node_user_data "https://github.com/diegofelippe/project-management-/blob/main/src/data/usuarios.js"
click node_team_data "https://github.com/diegofelippe/project-management-/blob/main/src/data/times.js"
click node_consultancy_data "https://github.com/diegofelippe/project-management-/blob/main/src/data/consultorias.js"
click node_supabase_client "https://github.com/diegofelippe/project-management-/blob/main/src/lib/supabase.js"
click node_edge_access "https://github.com/diegofelippe/project-management-/blob/main/supabase/functions/criar-acesso/index.ts"
click node_edge_consultancy "https://github.com/diegofelippe/project-management-/blob/main/supabase/functions/criar-consultoria/index.ts"
click node_edge_integrations "https://github.com/diegofelippe/project-management-/blob/main/supabase/functions/integracoes/index.ts"
click node_google_flow "https://github.com/diegofelippe/project-management-/blob/main/supabase/functions/integracoes-google/index.ts"
click node_integration_page "https://github.com/diegofelippe/project-management-/blob/main/src/pages/Integracoes.jsx"
click node_integration_data "https://github.com/diegofelippe/project-management-/blob/main/src/data/integracoes.js"
click node_shared_integration "https://github.com/diegofelippe/project-management-/blob/main/supabase/functions/_shared/integracoes.ts"
click node_pwa "https://github.com/diegofelippe/project-management-/blob/main/src/pwa/useInstalar.js"

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_routes,node_auth,node_login toneBlue
class node_consultancy,node_teams,node_team_detail,node_people toneAmber
class node_user_data,node_team_data,node_consultancy_data,node_supabase_client,node_database,node_edge_access,node_edge_consultancy toneMint
class node_edge_integrations,node_google_flow,node_integration_page,node_integration_data,node_shared_integration,node_vault toneRose
class node_pwa,node_actors toneIndigo
```

## Components

### Access and navigation

- [Protected routes](https://github.com/diegofelippe/project-management-/blob/main/src/rotas.jsx): `src/rotas.jsx`
- [Session and profile](https://github.com/diegofelippe/project-management-/blob/main/src/auth/AuthProvider.jsx): `src/auth/AuthProvider.jsx`
- [Sign-in and recovery](https://github.com/diegofelippe/project-management-/blob/main/src/pages/Entrar.jsx): `src/pages/Entrar.jsx`

### Consultancy management

- [Consultancy administration](https://github.com/diegofelippe/project-management-/blob/main/src/pages/Consultorias.jsx): `src/pages/Consultorias.jsx`
- [Team management](https://github.com/diegofelippe/project-management-/blob/main/src/pages/Times.jsx): `src/pages/Times.jsx`
- [Team workspace](https://github.com/diegofelippe/project-management-/blob/main/src/pages/Time.jsx): `src/pages/Time.jsx`
- [People and access](https://github.com/diegofelippe/project-management-/blob/main/src/pages/Usuarios.jsx): `src/pages/Usuarios.jsx`

### Data and services

- [People data](https://github.com/diegofelippe/project-management-/blob/main/src/data/usuarios.js): `src/data/usuarios.js`
- [Team data](https://github.com/diegofelippe/project-management-/blob/main/src/data/times.js): `src/data/times.js`
- [Consultancy data](https://github.com/diegofelippe/project-management-/blob/main/src/data/consultorias.js): `src/data/consultorias.js`
- [Supabase client](https://github.com/diegofelippe/project-management-/blob/main/src/lib/supabase.js): `src/lib/supabase.js`
- **Supabase database**
- [Access functions](https://github.com/diegofelippe/project-management-/blob/main/supabase/functions/criar-acesso/index.ts): `supabase/functions/criar-acesso/index.ts`
- [Consultancy functions](https://github.com/diegofelippe/project-management-/blob/main/supabase/functions/criar-consultoria/index.ts): `supabase/functions/criar-consultoria/index.ts`

### Integrations

- [Integration functions](https://github.com/diegofelippe/project-management-/blob/main/supabase/functions/integracoes/index.ts): `supabase/functions/integracoes/index.ts`
- [Google OAuth function](https://github.com/diegofelippe/project-management-/blob/main/supabase/functions/integracoes-google/index.ts): `supabase/functions/integracoes-google/index.ts`
- [Integration settings](https://github.com/diegofelippe/project-management-/blob/main/src/pages/Integracoes.jsx): `src/pages/Integracoes.jsx`
- [Integration data access](https://github.com/diegofelippe/project-management-/blob/main/src/data/integracoes.js): `src/data/integracoes.js`
- [Integration handling](https://github.com/diegofelippe/project-management-/blob/main/supabase/functions/_shared/integracoes.ts): `supabase/functions/_shared/integracoes.ts`
- **Supabase Vault**

### App experience

- [Installable app](https://github.com/diegofelippe/project-management-/blob/main/src/pwa/useInstalar.js): `src/pwa/useInstalar.js`

### Other components

- **Platform roles**

## Connections

- Platform roles → Sign-in and recovery: signs in (evidence: `README.md`)
- Sign-in and recovery → Session and profile: uses auth
- Session and profile → Supabase client: reads session (evidence: `src/auth/AuthProvider.jsx`)
- Protected routes → Session and profile: protects routes (evidence: `src/rotas.jsx`)
- Protected routes → Sign-in and recovery: routes to (evidence: `src/rotas.jsx`)
- Platform roles → Protected routes: opens app (evidence: `README.md`)
- Protected routes → Consultancy administration: routes to (evidence: `src/rotas.jsx`)
- Protected routes → Team management: routes to (evidence: `src/rotas.jsx`)
- Protected routes → Team workspace: routes to (evidence: `src/rotas.jsx`)
- Protected routes → People and access: routes to (evidence: `src/rotas.jsx`)
- Protected routes → Integration settings: routes to (evidence: `src/rotas.jsx`)
- People and access → People data: manages access (evidence: `src/pages/Usuarios.jsx`)
- People and access → Team data: assigns members (evidence: `src/pages/Usuarios.jsx`)
- People and access → Access functions: creates access
- Consultancy administration → Consultancy functions: creates consultancy
- People data → Supabase client: uses client (evidence: `src/data/usuarios.js`)
- Team data → Supabase client: uses client (evidence: `src/data/times.js`)
- Supabase client → Supabase database: queries
- Integration settings → Integration data access: calls (evidence: `src/pages/Integracoes.jsx`)
- Integration data access → Integration functions: invokes
- Integration settings → Google OAuth function: starts OAuth (evidence: `README.md`)
- Integration functions → Integration handling: uses handlers (evidence: `supabase/functions/integracoes/index.ts`)
- Google OAuth function → Integration handling: uses handlers (evidence: `supabase/functions/integracoes-google/index.ts`)
- Integration handling → Supabase Vault: stores secrets (evidence: `README.md`)
- Platform roles → Installable app: installs app (evidence: `README.md`)
