# ludwingh28/sistemarh architecture

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

- Interactive diagram: https://gitdiagram.com/ludwingh28/sistemarh
- Repository: https://github.com/ludwingh28/sistemarh

## Overview

Sistema RH · Canal DTS is a web application for managing DTS sales staff, contracts, attendance, turnover, documents, and user access. Users enter through the React app, authenticate, and use domain screens that call the FastAPI API; backend services apply business rules and access PostgreSQL, with optional BI data and shared contract folders. The README documents the major capabilities; some API routes and frontend screens were not sampled, so their detailed interactions are left unverified rather than inferred.

Main entry points: [`frontend/src/App.tsx`](https://github.com/ludwingh28/sistemarh/blob/main/frontend/src/App.tsx) (App shell), [`backend/app/main.py`](https://github.com/ludwingh28/sistemarh/blob/main/backend/app/main.py) (FastAPI application), [`backend/app/api/v1/vendedores.py`](https://github.com/ludwingh28/sistemarh/blob/main/backend/app/api/v1/vendedores.py) (Vendor API), [`frontend/src/api.ts`](https://github.com/ludwingh28/sistemarh/blob/main/frontend/src/api.ts) (HTTP client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["App shell<br/>[App.tsx]"]
  node_auth_ui["Session state<br/>[auth.tsx]"]
  node_api_client["HTTP client<br/>[api.ts]"]
  node_vendor_ui["Vendor management<br/>[Vendedores.tsx]"]
  node_attendance_ui["Attendance screen<br/>[Asistencia.tsx]"]
  node_turnover_ui["Turnover screen<br/>[Rotacion.tsx]"]
  node_users_ui["User administration<br/>[Usuarios.tsx]"]
  node_docs_ui["Documentation screen<br/>[Documentacion.tsx]"]
end

subgraph group_api["API and access"]
  node_auth_api["Authentication<br/>[auth.py]"]
  node_vendor_api["Vendor API<br/>[vendedores.py]"]
  node_attendance_api["Attendance API<br/>[asistencia.py]"]
  node_turnover_api["Turnover API<br/>[rotacion.py]"]
  node_document_api["Document APIs<br/>[documentos.py]"]
  node_permission_api["Permissions API<br/>[permisos.py]"]
  node_auth_deps["Auth dependencies<br/>[deps.py]"]
  node_app_server["FastAPI application<br/>[main.py]"]
end

subgraph group_people["People operations"]
  node_vendor_records[("Vendor and contracts<br/>[models.py]")]
  node_import_service["Vendor imports<br/>[importacion.py]"]
  node_contract_folders["Contract folders<br/>[carpetas.py]"]
end

subgraph group_insights["Workforce insights"]
  node_attendance_calc["Attendance rules<br/>[calculos.py]"]
end

subgraph group_data["Persistence and integrations"]
  node_bi_source["BI database<br/>[bi.py]"]
  node_app_database[("RH database<br/>[database.py]")]
  node_contract_store[("Shared contract files")]
end

node_user(("RH user"))

node_user -->|"uses"| node_app
node_app -->|"checks session"| node_auth_ui
node_auth_ui -->|"requests identity"| node_api_client
node_app -->|"routes to"| node_vendor_ui
node_app -->|"routes to"| node_attendance_ui
node_app -->|"routes to"| node_turnover_ui
node_app -->|"routes to"| node_users_ui
node_app -->|"routes to"| node_docs_ui
node_vendor_ui -->|"calls API"| node_api_client
node_attendance_ui -->|"calls API"| node_api_client
node_turnover_ui -->|"calls API"| node_api_client
node_users_ui -->|"calls API"| node_api_client
node_api_client -.->|"sends HTTP"| node_app_server
node_app_server -->|"registers routes"| node_auth_api
node_app_server -->|"registers routes"| node_vendor_api
node_app_server -->|"registers routes"| node_attendance_api
node_app_server -->|"registers routes"| node_turnover_api
node_app_server -->|"registers routes"| node_document_api
node_app_server -->|"registers routes"| node_permission_api
node_auth_api -->|"uses session checks"| node_auth_deps
node_auth_deps -->|"queries"| node_app_database
node_vendor_api -->|"reads and writes"| node_vendor_records
node_vendor_api -->|"delegates imports"| node_import_service
node_vendor_api -->|"uses folder service"| node_contract_folders
node_vendor_api -->|"uses calculations"| node_attendance_calc
node_attendance_api -->|"uses calculations"| node_attendance_calc
node_attendance_api -->|"reads BI data"| node_bi_source
node_attendance_api -->|"queries records"| node_vendor_records
node_vendor_api -->|"uses BI integration"| node_bi_source
node_app_database -->|"maps models"| node_vendor_records
node_contract_folders -.->|"manages files"| node_contract_store
node_document_api -.->|"serves documents"| node_contract_folders
node_turnover_api -.->|"analyzes workforce"| node_vendor_records
node_users_ui -.->|"manages access"| node_permission_api

click node_app "https://github.com/ludwingh28/sistemarh/blob/main/frontend/src/App.tsx"
click node_auth_ui "https://github.com/ludwingh28/sistemarh/blob/main/frontend/src/auth.tsx"
click node_api_client "https://github.com/ludwingh28/sistemarh/blob/main/frontend/src/api.ts"
click node_vendor_ui "https://github.com/ludwingh28/sistemarh/blob/main/frontend/src/pages/Vendedores.tsx"
click node_attendance_ui "https://github.com/ludwingh28/sistemarh/blob/main/frontend/src/pages/Asistencia.tsx"
click node_turnover_ui "https://github.com/ludwingh28/sistemarh/blob/main/frontend/src/pages/Rotacion.tsx"
click node_users_ui "https://github.com/ludwingh28/sistemarh/blob/main/frontend/src/pages/Usuarios.tsx"
click node_auth_api "https://github.com/ludwingh28/sistemarh/blob/main/backend/app/api/v1/auth.py"
click node_vendor_api "https://github.com/ludwingh28/sistemarh/blob/main/backend/app/api/v1/vendedores.py"
click node_attendance_api "https://github.com/ludwingh28/sistemarh/blob/main/backend/app/api/v1/asistencia.py"
click node_turnover_api "https://github.com/ludwingh28/sistemarh/blob/main/backend/app/api/v1/rotacion.py"
click node_document_api "https://github.com/ludwingh28/sistemarh/blob/main/backend/app/api/v1/documentos.py"
click node_permission_api "https://github.com/ludwingh28/sistemarh/blob/main/backend/app/api/v1/permisos.py"
click node_auth_deps "https://github.com/ludwingh28/sistemarh/blob/main/backend/app/api/deps.py"
click node_vendor_records "https://github.com/ludwingh28/sistemarh/blob/main/backend/app/models.py"
click node_import_service "https://github.com/ludwingh28/sistemarh/blob/main/backend/app/services/importacion.py"
click node_contract_folders "https://github.com/ludwingh28/sistemarh/blob/main/backend/app/services/carpetas.py"
click node_attendance_calc "https://github.com/ludwingh28/sistemarh/blob/main/backend/app/services/calculos.py"
click node_bi_source "https://github.com/ludwingh28/sistemarh/blob/main/backend/app/integrations/bi.py"
click node_app_database "https://github.com/ludwingh28/sistemarh/blob/main/backend/app/core/database.py"
click node_app_server "https://github.com/ludwingh28/sistemarh/blob/main/backend/app/main.py"
click node_docs_ui "https://github.com/ludwingh28/sistemarh/blob/main/frontend/src/pages/Documentacion.tsx"

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_ui,node_api_client,node_vendor_ui,node_attendance_ui,node_turnover_ui,node_users_ui,node_docs_ui,node_user toneBlue
class node_auth_api,node_vendor_api,node_attendance_api,node_turnover_api,node_document_api,node_permission_api,node_auth_deps,node_app_server toneAmber
class node_vendor_records,node_import_service,node_contract_folders toneMint
class node_attendance_calc toneRose
class node_bi_source,node_app_database,node_contract_store toneIndigo
```

## Components

### Web client

- [App shell](https://github.com/ludwingh28/sistemarh/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Session state](https://github.com/ludwingh28/sistemarh/blob/main/frontend/src/auth.tsx): `frontend/src/auth.tsx`
- [HTTP client](https://github.com/ludwingh28/sistemarh/blob/main/frontend/src/api.ts): `frontend/src/api.ts`
- [Vendor management](https://github.com/ludwingh28/sistemarh/blob/main/frontend/src/pages/Vendedores.tsx): `frontend/src/pages/Vendedores.tsx`
- [Attendance screen](https://github.com/ludwingh28/sistemarh/blob/main/frontend/src/pages/Asistencia.tsx): `frontend/src/pages/Asistencia.tsx`
- [Turnover screen](https://github.com/ludwingh28/sistemarh/blob/main/frontend/src/pages/Rotacion.tsx): `frontend/src/pages/Rotacion.tsx`
- [User administration](https://github.com/ludwingh28/sistemarh/blob/main/frontend/src/pages/Usuarios.tsx): `frontend/src/pages/Usuarios.tsx`
- [Documentation screen](https://github.com/ludwingh28/sistemarh/blob/main/frontend/src/pages/Documentacion.tsx): `frontend/src/pages/Documentacion.tsx`

### API and access

- [Authentication](https://github.com/ludwingh28/sistemarh/blob/main/backend/app/api/v1/auth.py): `backend/app/api/v1/auth.py`
- [Vendor API](https://github.com/ludwingh28/sistemarh/blob/main/backend/app/api/v1/vendedores.py): `backend/app/api/v1/vendedores.py`
- [Attendance API](https://github.com/ludwingh28/sistemarh/blob/main/backend/app/api/v1/asistencia.py): `backend/app/api/v1/asistencia.py`
- [Turnover API](https://github.com/ludwingh28/sistemarh/blob/main/backend/app/api/v1/rotacion.py): `backend/app/api/v1/rotacion.py`
- [Document APIs](https://github.com/ludwingh28/sistemarh/blob/main/backend/app/api/v1/documentos.py): `backend/app/api/v1/documentos.py`
- [Permissions API](https://github.com/ludwingh28/sistemarh/blob/main/backend/app/api/v1/permisos.py): `backend/app/api/v1/permisos.py`
- [Auth dependencies](https://github.com/ludwingh28/sistemarh/blob/main/backend/app/api/deps.py): `backend/app/api/deps.py`
- [FastAPI application](https://github.com/ludwingh28/sistemarh/blob/main/backend/app/main.py): `backend/app/main.py`

### People operations

- [Vendor and contracts](https://github.com/ludwingh28/sistemarh/blob/main/backend/app/models.py): `backend/app/models.py`
- [Vendor imports](https://github.com/ludwingh28/sistemarh/blob/main/backend/app/services/importacion.py): `backend/app/services/importacion.py`
- [Contract folders](https://github.com/ludwingh28/sistemarh/blob/main/backend/app/services/carpetas.py): `backend/app/services/carpetas.py`

### Workforce insights

- [Attendance rules](https://github.com/ludwingh28/sistemarh/blob/main/backend/app/services/calculos.py): `backend/app/services/calculos.py`

### Persistence and integrations

- [BI database](https://github.com/ludwingh28/sistemarh/blob/main/backend/app/integrations/bi.py): `backend/app/integrations/bi.py`
- [RH database](https://github.com/ludwingh28/sistemarh/blob/main/backend/app/core/database.py): `backend/app/core/database.py`
- **Shared contract files**

### Other components

- **RH user**

## Connections

- RH user → App shell: uses (evidence: `README.md`)
- App shell → Session state: checks session (evidence: `frontend/src/App.tsx`)
- Session state → HTTP client: requests identity (evidence: `frontend/src/auth.tsx`)
- App shell → Vendor management: routes to (evidence: `frontend/src/App.tsx`)
- App shell → Attendance screen: routes to (evidence: `frontend/src/App.tsx`)
- App shell → Turnover screen: routes to (evidence: `frontend/src/App.tsx`)
- App shell → User administration: routes to (evidence: `frontend/src/App.tsx`)
- App shell → Documentation screen: routes to (evidence: `frontend/src/App.tsx`)
- Vendor management → HTTP client: calls API
- Attendance screen → HTTP client: calls API (evidence: `frontend/src/pages/Asistencia.tsx`)
- Turnover screen → HTTP client: calls API (evidence: `frontend/src/pages/Rotacion.tsx`)
- User administration → HTTP client: calls API (evidence: `frontend/src/pages/Usuarios.tsx`)
- HTTP client → FastAPI application: sends HTTP
- FastAPI application → Authentication: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Vendor API: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Attendance API: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Turnover API: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Document APIs: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Permissions API: registers routes (evidence: `backend/app/main.py`)
- Authentication → Auth dependencies: uses session checks (evidence: `backend/app/api/v1/auth.py`)
- Auth dependencies → RH database: queries (evidence: `backend/app/api/deps.py`)
- Vendor API → Vendor and contracts: reads and writes (evidence: `backend/app/api/v1/vendedores.py`)
- Vendor API → Vendor imports: delegates imports (evidence: `backend/app/api/v1/vendedores.py`)
- Vendor API → Contract folders: uses folder service (evidence: `backend/app/api/v1/vendedores.py`)
- Vendor API → Attendance rules: uses calculations (evidence: `backend/app/api/v1/vendedores.py`)
- Attendance API → Attendance rules: uses calculations (evidence: `backend/app/api/v1/asistencia.py`)
- Attendance API → BI database: reads BI data (evidence: `backend/app/api/v1/asistencia.py`)
- Attendance API → Vendor and contracts: queries records (evidence: `backend/app/api/v1/asistencia.py`)
- Vendor API → BI database: uses BI integration (evidence: `backend/app/api/v1/vendedores.py`)
- RH database → Vendor and contracts: maps models (evidence: `backend/app/models.py`)
- Contract folders → Shared contract files: manages files
- Document APIs → Contract folders: serves documents
- Turnover API → Vendor and contracts: analyzes workforce
- User administration → Permissions API: manages access
