# robsonissomoto/projeto-inventario-patrimonial-backend architecture

> Architecture diagram of the GitHub repository robsonissomoto/projeto-inventario-patrimonial-backend, 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/robsonissomoto/projeto-inventario-patrimonial-backend
- Repository: https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend

## Overview

This is a TypeScript/Express REST API for a mobile patrimony-inventory system. A mobile client sends requests through the versioned API and domain routes to controllers, which validate input and call services; services persist or query users, patrimonies, and movement history through MongoDB models. The documented domain work includes asset registration and maintenance, user records, and conference, location-update, and transfer history. The graph follows relationships visible in excerpts, the source index, or README; unsampled implementation details are not inferred.

Main entry points: [`src/routes/routes.ts`](https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/routes/routes.ts) (API router), [`src/modules/movimentacao/movimentacao.types.ts`](https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/movimentacao/movimentacao.types.ts) (Movement types), [`src/modules/patrimonio/patrimonio.types.ts`](https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/patrimonio/patrimonio.types.ts) (Patrimony types), [`src/modules/patrimonio/patrimonio.controller.ts`](https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/patrimonio/patrimonio.controller.ts) (Patrimony controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API entry"]
  node_app["Express app<br/>[app.ts]"]
  node_router["API router<br/>[routes.ts]"]
  node_server["Server startup<br/>[server.ts]"]
end

subgraph group_assets["Asset management"]
  node_patroutes["Patrimony routes"]
  node_patcontroller["Patrimony controller"]
  node_patservice["Patrimony service"]
  node_patmodel["Patrimony model"]
  node_pattypes["Patrimony types"]
end

subgraph group_records["Users and history"]
  node_useroutes["User routes<br/>[usuario.routes.ts]"]
  node_usercontroller["User controller"]
  node_userservice["User service<br/>[usuario.service.ts]"]
  node_usermodel["User model<br/>[usuario.model.ts]"]
  node_usertypes["User types<br/>[usuario.types.ts]"]
  node_movroutes["Movement routes"]
  node_movcontroller["Movement controller"]
  node_movservice["Movement service"]
  node_movmodel["Movement model"]
  node_movtypes["Movement types"]
end

subgraph group_storage["Persistence"]
  node_env["Environment config<br/>[env.ts]"]
  node_dbconn["Mongo connection<br/>[database.ts]"]
  node_mongodb[("MongoDB")]
end

node_mobile(("Mobile client"))

node_mobile -.->|"sends requests"| node_app
node_app -->|"mounts at /api/v1"| node_router
node_router -->|"mounts /patrimonios"| node_patroutes
node_router -->|"mounts /usuarios"| node_useroutes
node_router -->|"mounts /movimentacoes"| node_movroutes
node_server -->|"starts"| node_app
node_server -->|"connects database"| node_dbconn
node_dbconn -->|"reads URI"| node_env
node_dbconn -->|"connects"| node_mongodb
node_patroutes -->|"dispatches"| node_patcontroller
node_patcontroller -->|"calls"| node_patservice
node_patservice -->|"queries and persists"| node_patmodel
node_patcontroller -->|"uses DTOs"| node_pattypes
node_patservice -->|"uses types"| node_pattypes
node_patmodel -->|"implements schema"| node_pattypes
node_useroutes -->|"dispatches"| node_usercontroller
node_usercontroller -->|"calls"| node_userservice
node_userservice -->|"queries and persists"| node_usermodel
node_usercontroller -->|"uses DTOs"| node_usertypes
node_userservice -->|"uses types"| node_usertypes
node_usermodel -->|"implements schema"| node_usertypes
node_movroutes -->|"dispatches"| node_movcontroller
node_movcontroller -->|"calls"| node_movservice
node_movservice -->|"queries and persists"| node_movmodel
node_movcontroller -->|"uses DTOs"| node_movtypes
node_movservice -->|"uses types"| node_movtypes
node_movmodel -->|"implements schema"| node_movtypes
node_movtypes -->|"reuses asset enums"| node_pattypes

click node_app "https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/app.ts"
click node_router "https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/routes/routes.ts"
click node_server "https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/server.ts"
click node_env "https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/config/env.ts"
click node_dbconn "https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/config/database.ts"
click node_patroutes "https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/patrimonio/patrimonio.routes.ts"
click node_patcontroller "https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/patrimonio/patrimonio.controller.ts"
click node_patservice "https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/patrimonio/patrimonio.service.ts"
click node_patmodel "https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/patrimonio/patrimonio.model.ts"
click node_pattypes "https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/patrimonio/patrimonio.types.ts"
click node_useroutes "https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/usuario/usuario.routes.ts"
click node_usercontroller "https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/usuario/usuario.controller.ts"
click node_userservice "https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/usuario/usuario.service.ts"
click node_usermodel "https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/usuario/usuario.model.ts"
click node_usertypes "https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/usuario/usuario.types.ts"
click node_movroutes "https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/movimentacao/movimentacao.routes.ts"
click node_movcontroller "https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/movimentacao/movimentacao.controller.ts"
click node_movservice "https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/movimentacao/movimentacao.service.ts"
click node_movmodel "https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/movimentacao/movimentacao.model.ts"
click node_movtypes "https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/movimentacao/movimentacao.types.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_app,node_router,node_server,node_mobile toneBlue
class node_patroutes,node_patcontroller,node_patservice,node_patmodel,node_pattypes toneAmber
class node_useroutes,node_usercontroller,node_userservice,node_usermodel,node_usertypes,node_movroutes,node_movcontroller,node_movservice,node_movmodel,node_movtypes toneMint
class node_env,node_dbconn,node_mongodb toneRose
```

## Components

### API entry

- [Express app](https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/app.ts): `src/app.ts`
- [API router](https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/routes/routes.ts): `src/routes/routes.ts`
- [Server startup](https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/server.ts): `src/server.ts`

### Asset management

- [Patrimony routes](https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/patrimonio/patrimonio.routes.ts): `src/modules/patrimonio/patrimonio.routes.ts`
- [Patrimony controller](https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/patrimonio/patrimonio.controller.ts): `src/modules/patrimonio/patrimonio.controller.ts`
- [Patrimony service](https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/patrimonio/patrimonio.service.ts): `src/modules/patrimonio/patrimonio.service.ts`
- [Patrimony model](https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/patrimonio/patrimonio.model.ts): `src/modules/patrimonio/patrimonio.model.ts`
- [Patrimony types](https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/patrimonio/patrimonio.types.ts): `src/modules/patrimonio/patrimonio.types.ts`

### Users and history

- [User routes](https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/usuario/usuario.routes.ts): `src/modules/usuario/usuario.routes.ts`
- [User controller](https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/usuario/usuario.controller.ts): `src/modules/usuario/usuario.controller.ts`
- [User service](https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/usuario/usuario.service.ts): `src/modules/usuario/usuario.service.ts`
- [User model](https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/usuario/usuario.model.ts): `src/modules/usuario/usuario.model.ts`
- [User types](https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/usuario/usuario.types.ts): `src/modules/usuario/usuario.types.ts`
- [Movement routes](https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/movimentacao/movimentacao.routes.ts): `src/modules/movimentacao/movimentacao.routes.ts`
- [Movement controller](https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/movimentacao/movimentacao.controller.ts): `src/modules/movimentacao/movimentacao.controller.ts`
- [Movement service](https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/movimentacao/movimentacao.service.ts): `src/modules/movimentacao/movimentacao.service.ts`
- [Movement model](https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/movimentacao/movimentacao.model.ts): `src/modules/movimentacao/movimentacao.model.ts`
- [Movement types](https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/modules/movimentacao/movimentacao.types.ts): `src/modules/movimentacao/movimentacao.types.ts`

### Persistence

- [Environment config](https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/config/env.ts): `src/config/env.ts`
- [Mongo connection](https://github.com/robsonissomoto/projeto-inventario-patrimonial-backend/blob/main/src/config/database.ts): `src/config/database.ts`
- **MongoDB**

### Other components

- **Mobile client**

## Connections

- Mobile client → Express app: sends requests (evidence: `README.md`)
- Express app → API router: mounts at /api/v1 (evidence: `src/app.ts`)
- API router → Patrimony routes: mounts /patrimonios (evidence: `src/routes/routes.ts`)
- API router → User routes: mounts /usuarios (evidence: `src/routes/routes.ts`)
- API router → Movement routes: mounts /movimentacoes (evidence: `src/routes/routes.ts`)
- Server startup → Express app: starts (evidence: `src/server.ts`)
- Server startup → Mongo connection: connects database (evidence: `src/server.ts`)
- Mongo connection → Environment config: reads URI (evidence: `src/config/database.ts`)
- Mongo connection → MongoDB: connects (evidence: `src/config/database.ts`)
- Patrimony routes → Patrimony controller: dispatches (evidence: `src/modules/patrimonio/patrimonio.routes.ts`)
- Patrimony controller → Patrimony service: calls (evidence: `src/modules/patrimonio/patrimonio.controller.ts`)
- Patrimony service → Patrimony model: queries and persists (evidence: `src/modules/patrimonio/patrimonio.service.ts`)
- Patrimony controller → Patrimony types: uses DTOs (evidence: `src/modules/patrimonio/patrimonio.controller.ts`)
- Patrimony service → Patrimony types: uses types (evidence: `src/modules/patrimonio/patrimonio.service.ts`)
- Patrimony model → Patrimony types: implements schema (evidence: `src/modules/patrimonio/patrimonio.model.ts`)
- User routes → User controller: dispatches (evidence: `src/modules/usuario/usuario.routes.ts`)
- User controller → User service: calls (evidence: `src/modules/usuario/usuario.controller.ts`)
- User service → User model: queries and persists (evidence: `src/modules/usuario/usuario.service.ts`)
- User controller → User types: uses DTOs (evidence: `src/modules/usuario/usuario.controller.ts`)
- User service → User types: uses types (evidence: `src/modules/usuario/usuario.service.ts`)
- User model → User types: implements schema (evidence: `src/modules/usuario/usuario.model.ts`)
- Movement routes → Movement controller: dispatches (evidence: `src/modules/movimentacao/movimentacao.routes.ts`)
- Movement controller → Movement service: calls (evidence: `src/modules/movimentacao/movimentacao.controller.ts`)
- Movement service → Movement model: queries and persists (evidence: `src/modules/movimentacao/movimentacao.service.ts`)
- Movement controller → Movement types: uses DTOs (evidence: `src/modules/movimentacao/movimentacao.controller.ts`)
- Movement service → Movement types: uses types (evidence: `src/modules/movimentacao/movimentacao.service.ts`)
- Movement model → Movement types: implements schema (evidence: `src/modules/movimentacao/movimentacao.model.ts`)
- Movement types → Patrimony types: reuses asset enums (evidence: `src/modules/movimentacao/movimentacao.types.ts`)
