# antoniocassian/ievv_patrimonio architecture

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

- Interactive diagram: https://gitdiagram.com/antoniocassian/ievv_patrimonio
- Repository: https://github.com/antoniocassian/ievv_patrimonio

## Overview

This is a church asset-management API. Requests enter the Express app and are dispatched through domain routes to controllers, which invoke services for asset records, usufruct/donation operations, loans, authentication, departments, notifications, settings, and dashboard data. Services use Prisma for persistence; asset handling also has an upload integration. The graph reflects documented or indexed relationships; unread route and dashboard/user implementation details are not inferred.

Main entry points: [`src/lib/prisma.ts`](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/lib/prisma.ts) (Prisma client), [`src/routes/index.ts`](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/routes/index.ts) (Route registry), [`src/routes/asset.routes.ts`](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/routes/asset.routes.ts) (Asset routes), [`src/routes/asset-operation.routes.ts`](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/routes/asset-operation.routes.ts) (Operation routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["API entry"]
  node_server["HTTP server<br/>[server.ts]"]
  node_app["Express app<br/>[app.ts]"]
  node_router["Route registry<br/>[index.ts]"]
  node_asset_routes["Asset routes<br/>[asset.routes.ts]"]
  node_operation_routes["Operation routes"]
  node_loan_routes["Loan routes<br/>[loan.routes.ts]"]
  node_notification_routes["Notification routes"]
end

subgraph group_assets["Asset management"]
  node_asset_controller["Asset controller<br/>[AssetController.ts]"]
  node_asset_service["Asset service<br/>[AssetService.ts]"]
  node_asset_schema["Asset validation<br/>[asset.schema.ts]"]
end

subgraph group_operations["Loans and operations"]
  node_operation_controller["Operation controller"]
  node_operation_service["Operation service"]
  node_operation_schema["Operation validation"]
  node_loan_controller["Loan controller<br/>[LoanController.ts]"]
  node_loan_service["Loan service<br/>[LoanService.ts]"]
  node_loan_schema["Loan validation<br/>[loan.schema.ts]"]
end

subgraph group_identity["Identity and administration"]
  node_auth_controller["Authentication controller<br/>[AuthController.ts]"]
  node_auth_service["Authentication service<br/>[AuthService.ts]"]
  node_department_controller["Department controller"]
  node_department_service["Department service"]
  node_user_controller["User controller<br/>[UserController.ts]"]
  node_user_service["User service<br/>[UserService.ts]"]
end

subgraph group_support["Insights and settings"]
  node_dashboard_controller["Dashboard controller"]
  node_dashboard_service["Dashboard service"]
  node_notification_controller["Notification controller"]
  node_notification_service["Notification service"]
  node_church_controller["Church settings controller"]
  node_church_service["Church settings service"]
end

subgraph group_data["Persistence and uploads"]
  node_prisma["Prisma client<br/>[prisma.ts]"]
  node_database[("PostgreSQL database")]
  node_upload["Asset upload<br/>[upload.ts]"]
  node_supabase["Supabase storage<br/>[supabase.ts]"]
  node_upload_middleware["Upload middleware"]
end

node_client(("API client"))

node_client -.->|"sends requests"| node_app
node_server -->|"starts"| node_app
node_app -->|"mounts"| node_router
node_router -->|"registers"| node_asset_routes
node_router -->|"registers"| node_operation_routes
node_router -->|"registers"| node_loan_routes
node_router -->|"registers"| node_notification_routes
node_asset_routes -->|"dispatches"| node_asset_controller
node_asset_routes -->|"validates with"| node_asset_schema
node_asset_routes -->|"uploads through"| node_upload_middleware
node_asset_controller -->|"calls"| node_asset_service
node_operation_routes -->|"dispatches"| node_operation_controller
node_operation_routes -->|"validates with"| node_operation_schema
node_operation_controller -->|"calls"| node_operation_service
node_loan_routes -->|"dispatches"| node_loan_controller
node_loan_routes -->|"validates with"| node_loan_schema
node_loan_controller -->|"calls"| node_loan_service
node_notification_routes -->|"dispatches"| node_notification_controller
node_notification_controller -->|"calls"| node_notification_service
node_auth_controller -->|"calls"| node_auth_service
node_department_controller -->|"calls"| node_department_service
node_church_controller -->|"calls"| node_church_service
node_asset_service -->|"queries"| node_prisma
node_operation_service -->|"queries"| node_prisma
node_loan_service -->|"queries"| node_prisma
node_auth_service -->|"queries"| node_prisma
node_department_service -->|"queries"| node_prisma
node_notification_service -->|"queries"| node_prisma
node_prisma -.->|"connects to"| node_database
node_asset_service -->|"uses"| node_upload
node_upload -->|"stores files"| node_supabase

click node_server "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/server.ts"
click node_app "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/app.ts"
click node_router "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/routes/index.ts"
click node_asset_routes "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/routes/asset.routes.ts"
click node_operation_routes "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/routes/asset-operation.routes.ts"
click node_loan_routes "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/routes/loan.routes.ts"
click node_notification_routes "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/routes/notifications.routes.ts"
click node_asset_controller "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/controller/AssetController.ts"
click node_asset_service "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/services/AssetService.ts"
click node_asset_schema "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/schema/asset.schema.ts"
click node_operation_controller "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/controller/AssetOperationController.ts"
click node_operation_service "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/services/AssetOperationService.ts"
click node_operation_schema "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/schema/asset-operation.schema.ts"
click node_loan_controller "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/controller/LoanController.ts"
click node_loan_service "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/services/LoanService.ts"
click node_loan_schema "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/schema/loan.schema.ts"
click node_auth_controller "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/controller/AuthController.ts"
click node_auth_service "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/services/AuthService.ts"
click node_department_controller "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/controller/DepartmentController.ts"
click node_department_service "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/services/DepartamentService.ts"
click node_user_controller "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/controller/UserController.ts"
click node_user_service "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/services/UserService.ts"
click node_dashboard_controller "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/controller/DashboardController.ts"
click node_dashboard_service "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/services/DashboardService.ts"
click node_notification_controller "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/controller/NotificationsController.ts"
click node_notification_service "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/services/NotificationsService.ts"
click node_church_controller "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/controller/ChurchSettingsController.ts"
click node_church_service "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/services/ChurchSettingsService.ts"
click node_prisma "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/lib/prisma.ts"
click node_upload "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/lib/upload.ts"
click node_supabase "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/lib/supabase.ts"
click node_upload_middleware "https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/middleware/upload.middleware.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_server,node_app,node_router,node_asset_routes,node_operation_routes,node_loan_routes,node_notification_routes,node_client toneBlue
class node_asset_controller,node_asset_service,node_asset_schema toneAmber
class node_operation_controller,node_operation_service,node_operation_schema,node_loan_controller,node_loan_service,node_loan_schema toneMint
class node_auth_controller,node_auth_service,node_department_controller,node_department_service,node_user_controller,node_user_service toneRose
class node_dashboard_controller,node_dashboard_service,node_notification_controller,node_notification_service,node_church_controller,node_church_service toneIndigo
class node_prisma,node_database,node_upload,node_supabase,node_upload_middleware toneTeal
```

## Components

### API entry

- [HTTP server](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/server.ts): `src/server.ts`
- [Express app](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/app.ts): `src/app.ts`
- [Route registry](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/routes/index.ts): `src/routes/index.ts`
- [Asset routes](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/routes/asset.routes.ts): `src/routes/asset.routes.ts`
- [Operation routes](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/routes/asset-operation.routes.ts): `src/routes/asset-operation.routes.ts`
- [Loan routes](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/routes/loan.routes.ts): `src/routes/loan.routes.ts`
- [Notification routes](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/routes/notifications.routes.ts): `src/routes/notifications.routes.ts`

### Asset management

- [Asset controller](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/controller/AssetController.ts): `src/controller/AssetController.ts`
- [Asset service](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/services/AssetService.ts): `src/services/AssetService.ts`
- [Asset validation](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/schema/asset.schema.ts): `src/schema/asset.schema.ts`

### Loans and operations

- [Operation controller](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/controller/AssetOperationController.ts): `src/controller/AssetOperationController.ts`
- [Operation service](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/services/AssetOperationService.ts): `src/services/AssetOperationService.ts`
- [Operation validation](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/schema/asset-operation.schema.ts): `src/schema/asset-operation.schema.ts`
- [Loan controller](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/controller/LoanController.ts): `src/controller/LoanController.ts`
- [Loan service](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/services/LoanService.ts): `src/services/LoanService.ts`
- [Loan validation](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/schema/loan.schema.ts): `src/schema/loan.schema.ts`

### Identity and administration

- [Authentication controller](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/controller/AuthController.ts): `src/controller/AuthController.ts`
- [Authentication service](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/services/AuthService.ts): `src/services/AuthService.ts`
- [Department controller](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/controller/DepartmentController.ts): `src/controller/DepartmentController.ts`
- [Department service](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/services/DepartamentService.ts): `src/services/DepartamentService.ts`
- [User controller](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/controller/UserController.ts): `src/controller/UserController.ts`
- [User service](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/services/UserService.ts): `src/services/UserService.ts`

### Insights and settings

- [Dashboard controller](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/controller/DashboardController.ts): `src/controller/DashboardController.ts`
- [Dashboard service](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/services/DashboardService.ts): `src/services/DashboardService.ts`
- [Notification controller](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/controller/NotificationsController.ts): `src/controller/NotificationsController.ts`
- [Notification service](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/services/NotificationsService.ts): `src/services/NotificationsService.ts`
- [Church settings controller](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/controller/ChurchSettingsController.ts): `src/controller/ChurchSettingsController.ts`
- [Church settings service](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/services/ChurchSettingsService.ts): `src/services/ChurchSettingsService.ts`

### Persistence and uploads

- [Prisma client](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/lib/prisma.ts): `src/lib/prisma.ts`
- **PostgreSQL database**
- [Asset upload](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/lib/upload.ts): `src/lib/upload.ts`
- [Supabase storage](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/lib/supabase.ts): `src/lib/supabase.ts`
- [Upload middleware](https://github.com/antoniocassian/ievv_patrimonio/blob/main/src/middleware/upload.middleware.ts): `src/middleware/upload.middleware.ts`

### Other components

- **API client**

## Connections

- API client → Express app: sends requests
- HTTP server → Express app: starts (evidence: `src/server.ts`)
- Express app → Route registry: mounts (evidence: `src/app.ts`)
- Route registry → Asset routes: registers (evidence: `src/routes/index.ts`)
- Route registry → Operation routes: registers (evidence: `src/routes/index.ts`)
- Route registry → Loan routes: registers (evidence: `src/routes/index.ts`)
- Route registry → Notification routes: registers (evidence: `src/routes/index.ts`)
- Asset routes → Asset controller: dispatches (evidence: `src/routes/asset.routes.ts`)
- Asset routes → Asset validation: validates with (evidence: `src/routes/asset.routes.ts`)
- Asset routes → Upload middleware: uploads through (evidence: `src/routes/asset.routes.ts`)
- Asset controller → Asset service: calls (evidence: `src/controller/AssetController.ts`)
- Operation routes → Operation controller: dispatches (evidence: `src/routes/asset-operation.routes.ts`)
- Operation routes → Operation validation: validates with (evidence: `src/routes/asset-operation.routes.ts`)
- Operation controller → Operation service: calls (evidence: `src/controller/AssetOperationController.ts`)
- Loan routes → Loan controller: dispatches (evidence: `src/routes/loan.routes.ts`)
- Loan routes → Loan validation: validates with (evidence: `src/routes/loan.routes.ts`)
- Loan controller → Loan service: calls (evidence: `src/controller/LoanController.ts`)
- Notification routes → Notification controller: dispatches (evidence: `src/routes/notifications.routes.ts`)
- Notification controller → Notification service: calls (evidence: `src/controller/NotificationsController.ts`)
- Authentication controller → Authentication service: calls (evidence: `src/controller/AuthController.ts`)
- Department controller → Department service: calls (evidence: `src/controller/DepartmentController.ts`)
- Church settings controller → Church settings service: calls (evidence: `src/controller/ChurchSettingsController.ts`)
- Asset service → Prisma client: queries (evidence: `src/services/AssetService.ts`)
- Operation service → Prisma client: queries (evidence: `src/services/AssetOperationService.ts`)
- Loan service → Prisma client: queries (evidence: `src/services/LoanService.ts`)
- Authentication service → Prisma client: queries (evidence: `src/services/AuthService.ts`)
- Department service → Prisma client: queries (evidence: `src/services/DepartamentService.ts`)
- Notification service → Prisma client: queries (evidence: `src/services/NotificationsService.ts`)
- Prisma client → PostgreSQL database: connects to
- Asset service → Asset upload: uses (evidence: `src/services/AssetService.ts`)
- Asset upload → Supabase storage: stores files (evidence: `src/lib/upload.ts`)
