# zara-te05/autozen architecture

> Architecture diagram of the GitHub repository zara-te05/autozen, 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/zara-te05/autozen
- Repository: https://github.com/zara-te05/autozen

## Overview

Autozen appears to be a workshop-operations system exposed through a .NET API; the README describes only a generic Flutter starter app, so the Flutter client workflow cannot be mapped from the available files. The visible backend workflow is authenticated requests to operational endpoints, with services applying business rules and querying PostgreSQL. The tree also indicates project, purchasing, inventory, user, and dashboard capabilities. Several controllers and services were not sampled, so their internal links are omitted rather than inferred.

Main entry points: [`backend/Data/DapperContext.cs`](https://github.com/zara-te05/autozen/blob/main/backend/Data/DapperContext.cs) (Database context), [`backend/Controllers`](https://github.com/zara-te05/autozen/tree/main/backend/Controllers) (HTTP endpoints), [`backend/Services/Usuarios/UsuarioAdminService.cs`](https://github.com/zara-te05/autozen/blob/main/backend/Services/Usuarios/UsuarioAdminService.cs) (User administration), [`backend/Services/App/ProyectosTallerService.cs`](https://github.com/zara-te05/autozen/blob/main/backend/Services/App/ProyectosTallerService.cs) (Projects and workshop)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and access"]
  node_http["HTTP endpoints"]
  node_auth["Authentication<br/>[AuthService.cs]"]
  node_users["User administration"]
  node_roles["Roles and areas<br/>[Roles.cs]"]
end

subgraph group_operations["Workshop operations"]
  node_projects["Projects and workshop"]
  node_warehouse["Warehouse and issue slips<br/>[AlmacenService.cs]"]
  node_dashboard["Operations dashboard<br/>[TableroService.cs]"]
  node_notifications["Notifications"]
end

subgraph group_procurement["Purchasing"]
  node_purchases["Purchase orders<br/>[CompraService.cs]"]
  node_purchasepdf["Order PDF"]
  node_purchaseworkflow["Purchase requests"]
end

subgraph group_platform["Data and shared services"]
  node_repositories["Repositories"]
  node_userrepo["User repository"]
  node_dbcontext["Database context<br/>[DapperContext.cs]"]
  node_postgres[("PostgreSQL")]
  node_program["API composition<br/>[Program.cs]"]
end

node_user(("API caller"))

node_user -.->|"sends requests"| node_http
node_http -->|"calls"| node_warehouse
node_http -->|"calls"| node_projects
node_http -->|"calls"| node_dashboard
node_http -->|"calls"| node_users
node_http -->|"calls"| node_purchases
node_http -->|"requests PDF"| node_purchasepdf
node_auth -->|"looks up users"| node_userrepo
node_users -->|"manages accounts"| node_userrepo
node_users -->|"validates roles"| node_roles
node_projects -->|"records alerts"| node_notifications
node_projects -->|"queries data"| node_dbcontext
node_warehouse -->|"queries data"| node_dbcontext
node_dashboard -->|"queries data"| node_dbcontext
node_notifications -->|"persists alerts"| node_dbcontext
node_purchases -->|"uses repositories"| node_repositories
node_purchases -->|"queries data"| node_dbcontext
node_purchaseworkflow -.->|"uses database"| node_dbcontext
node_userrepo -->|"runs queries"| node_dbcontext
node_repositories -.->|"uses context"| node_dbcontext
node_dbcontext -->|"opens connections"| node_postgres
node_program -->|"registers services"| node_repositories

click node_http "https://github.com/zara-te05/autozen/tree/main/backend/Controllers"
click node_auth "https://github.com/zara-te05/autozen/blob/main/backend/Services/Usuarios/AuthService.cs"
click node_users "https://github.com/zara-te05/autozen/blob/main/backend/Services/Usuarios/UsuarioAdminService.cs"
click node_roles "https://github.com/zara-te05/autozen/blob/main/backend/Security/Roles.cs"
click node_projects "https://github.com/zara-te05/autozen/blob/main/backend/Services/App/ProyectosTallerService.cs"
click node_warehouse "https://github.com/zara-te05/autozen/blob/main/backend/Services/App/AlmacenService.cs"
click node_dashboard "https://github.com/zara-te05/autozen/blob/main/backend/Services/App/TableroService.cs"
click node_notifications "https://github.com/zara-te05/autozen/blob/main/backend/Services/App/NotificacionService.cs"
click node_purchases "https://github.com/zara-te05/autozen/blob/main/backend/Services/Compras/CompraService.cs"
click node_purchasepdf "https://github.com/zara-te05/autozen/blob/main/backend/Services/Compras/CompraPdfService.cs"
click node_purchaseworkflow "https://github.com/zara-te05/autozen/blob/main/backend/Services/App/SolicitudesCompraService.cs"
click node_repositories "https://github.com/zara-te05/autozen/tree/main/backend/Repositories"
click node_userrepo "https://github.com/zara-te05/autozen/blob/main/backend/Repositories/UsuarioRepository.cs"
click node_dbcontext "https://github.com/zara-te05/autozen/blob/main/backend/Data/DapperContext.cs"
click node_program "https://github.com/zara-te05/autozen/blob/main/backend/Program.cs"

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_http,node_auth,node_users,node_roles toneBlue
class node_projects,node_warehouse,node_dashboard,node_notifications toneAmber
class node_purchases,node_purchasepdf,node_purchaseworkflow,node_user toneMint
class node_repositories,node_userrepo,node_dbcontext,node_postgres,node_program toneRose
```

## Components

### API and access

- [HTTP endpoints](https://github.com/zara-te05/autozen/tree/main/backend/Controllers): `backend/Controllers`
- [Authentication](https://github.com/zara-te05/autozen/blob/main/backend/Services/Usuarios/AuthService.cs): `backend/Services/Usuarios/AuthService.cs`
- [User administration](https://github.com/zara-te05/autozen/blob/main/backend/Services/Usuarios/UsuarioAdminService.cs): `backend/Services/Usuarios/UsuarioAdminService.cs`
- [Roles and areas](https://github.com/zara-te05/autozen/blob/main/backend/Security/Roles.cs): `backend/Security/Roles.cs`

### Workshop operations

- [Projects and workshop](https://github.com/zara-te05/autozen/blob/main/backend/Services/App/ProyectosTallerService.cs): `backend/Services/App/ProyectosTallerService.cs`
- [Warehouse and issue slips](https://github.com/zara-te05/autozen/blob/main/backend/Services/App/AlmacenService.cs): `backend/Services/App/AlmacenService.cs`
- [Operations dashboard](https://github.com/zara-te05/autozen/blob/main/backend/Services/App/TableroService.cs): `backend/Services/App/TableroService.cs`
- [Notifications](https://github.com/zara-te05/autozen/blob/main/backend/Services/App/NotificacionService.cs): `backend/Services/App/NotificacionService.cs`

### Purchasing

- [Purchase orders](https://github.com/zara-te05/autozen/blob/main/backend/Services/Compras/CompraService.cs): `backend/Services/Compras/CompraService.cs`
- [Order PDF](https://github.com/zara-te05/autozen/blob/main/backend/Services/Compras/CompraPdfService.cs): `backend/Services/Compras/CompraPdfService.cs`
- [Purchase requests](https://github.com/zara-te05/autozen/blob/main/backend/Services/App/SolicitudesCompraService.cs): `backend/Services/App/SolicitudesCompraService.cs`

### Data and shared services

- [Repositories](https://github.com/zara-te05/autozen/tree/main/backend/Repositories): `backend/Repositories`
- [User repository](https://github.com/zara-te05/autozen/blob/main/backend/Repositories/UsuarioRepository.cs): `backend/Repositories/UsuarioRepository.cs`
- [Database context](https://github.com/zara-te05/autozen/blob/main/backend/Data/DapperContext.cs): `backend/Data/DapperContext.cs`
- **PostgreSQL**
- [API composition](https://github.com/zara-te05/autozen/blob/main/backend/Program.cs): `backend/Program.cs`

### Other components

- **API caller**

## Connections

- API caller → HTTP endpoints: sends requests
- HTTP endpoints → Warehouse and issue slips: calls (evidence: `backend/Controllers/AlmacenController.cs`)
- HTTP endpoints → Projects and workshop: calls (evidence: `backend/Controllers/ProyectoController.cs`)
- HTTP endpoints → Operations dashboard: calls (evidence: `backend/Controllers/TableroController.cs`)
- HTTP endpoints → User administration: calls (evidence: `backend/Controllers/UsuarioController.cs`)
- HTTP endpoints → Purchase orders: calls (evidence: `backend/Controllers/CompraController.cs`)
- HTTP endpoints → Order PDF: requests PDF (evidence: `backend/Controllers/CompraController.cs`)
- Authentication → User repository: looks up users (evidence: `backend/Services/Usuarios/AuthService.cs`)
- User administration → User repository: manages accounts (evidence: `backend/Services/Usuarios/UsuarioAdminService.cs`)
- User administration → Roles and areas: validates roles (evidence: `backend/Services/Usuarios/UsuarioAdminService.cs`)
- Projects and workshop → Notifications: records alerts (evidence: `backend/Services/App/ProyectosTallerService.cs`)
- Projects and workshop → Database context: queries data (evidence: `backend/Services/App/ProyectosTallerService.cs`)
- Warehouse and issue slips → Database context: queries data (evidence: `backend/Services/App/AlmacenService.cs`)
- Operations dashboard → Database context: queries data (evidence: `backend/Services/App/TableroService.cs`)
- Notifications → Database context: persists alerts (evidence: `backend/Services/App/NotificacionService.cs`)
- Purchase orders → Repositories: uses repositories (evidence: `backend/Services/Compras/CompraService.cs`)
- Purchase orders → Database context: queries data (evidence: `backend/Services/Compras/CompraService.cs`)
- Purchase requests → Database context: uses database
- User repository → Database context: runs queries (evidence: `backend/Repositories/UsuarioRepository.cs`)
- Repositories → Database context: uses context (evidence: `backend/Repositories/UsuarioRepository.cs`)
- Database context → PostgreSQL: opens connections (evidence: `backend/Data/DapperContext.cs`)
- API composition → Repositories: registers services (evidence: `backend/Program.cs`)
