# vaultraider115/atlas architecture

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

## Overview

Atlas is a Rust HTTP API for user and organization management. The visible user workflow is an HTTP request routed to a handler, through the user service, to repository operations; the service encrypts email, signs it for lookup, hashes passwords, and verifies passwords for login. The README also describes tenant isolation, role-based authorization, PostgreSQL RLS, and auditing as design capabilities. Organization implementation details and those security controls were not sampled, so their internal connections are not inferred here.

Main entry points: [`src/main.rs`](https://github.com/vaultraider115/atlas/blob/main/src/main.rs) (API Server), [`src/user/service/user_service.rs`](https://github.com/vaultraider115/atlas/blob/main/src/user/service/user_service.rs) (User Service), [`docs/ARCHITECTURE.md`](https://github.com/vaultraider115/atlas/blob/main/docs/ARCHITECTURE.md) (Tenant Access Controls), [`src/user/routes/user_routes.rs`](https://github.com/vaultraider115/atlas/blob/main/src/user/routes/user_routes.rs) (User Routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_app["API Server<br/>[main.rs]"]
  node_health["Health Endpoint<br/>[health.rs]"]
  node_user_routes["User Routes<br/>[user_routes.rs]"]
  node_user_handlers["User Handlers<br/>[user_handler.rs]"]
end

subgraph group_user["User Management"]
  node_user_service["User Service<br/>[user_service.rs]"]
  node_user_model["User Models<br/>[user_model.rs]"]
end

subgraph group_data["Persistence"]
  node_user_repo["User Repository<br/>[user_repo.rs]"]
  node_common_service["Service Layer<br/>[service.rs]"]
  node_common_repo["Database Repository<br/>[repo.rs]"]
end

subgraph group_security["Security"]
  node_email_crypto["Email Encryption<br/>[aes.rs]"]
  node_password_security["Password Hashing<br/>[argon2id.rs]"]
  node_email_signing["Email Signing<br/>[hmac.rs]"]
end

subgraph group_platform["Platform and Tenancy"]
  node_configuration["Runtime Configuration<br/>[config_mod.rs]"]
  node_db_pool["Database Pool<br/>[db_config.rs]"]
  node_org_management["Organization Management"]
  node_tenant_controls["Tenant Access Controls<br/>[ARCHITECTURE.md]"]
  node_audit["Change Auditing<br/>[ARCHITECTURE.md]"]
end

node_client(("API Client"))
node_postgres[("PostgreSQL")]

node_client -->|"sends requests"| node_app
node_app -->|"loads settings"| node_configuration
node_app -->|"creates pool"| node_db_pool
node_app -->|"initializes"| node_common_repo
node_app -->|"mounts routes"| node_user_routes
node_app -->|"merges endpoint"| node_health
node_user_routes -->|"routes requests"| node_user_handlers
node_user_handlers -->|"calls service"| node_user_service
node_user_service -->|"calls repository"| node_user_repo
node_user_service -->|"uses layer"| node_common_service
node_user_service -->|"builds and reads"| node_user_model
node_user_service -->|"encrypts email"| node_email_crypto
node_user_service -->|"hashes passwords"| node_password_security
node_user_service -->|"signs email"| node_email_signing
node_app -.->|"serves database-backed API"| node_postgres
node_tenant_controls -->|"uses row security"| node_postgres
node_tenant_controls -->|"checks stored authorization"| node_postgres
node_audit -.->|"records changes"| node_postgres

click node_app "https://github.com/vaultraider115/atlas/blob/main/src/main.rs"
click node_health "https://github.com/vaultraider115/atlas/blob/main/src/health.rs"
click node_user_routes "https://github.com/vaultraider115/atlas/blob/main/src/user/routes/user_routes.rs"
click node_user_handlers "https://github.com/vaultraider115/atlas/blob/main/src/user/handler/user_handler.rs"
click node_user_service "https://github.com/vaultraider115/atlas/blob/main/src/user/service/user_service.rs"
click node_user_model "https://github.com/vaultraider115/atlas/blob/main/src/user/model/user_model.rs"
click node_user_repo "https://github.com/vaultraider115/atlas/blob/main/src/user/repo/user_repo.rs"
click node_common_service "https://github.com/vaultraider115/atlas/blob/main/src/common/service.rs"
click node_common_repo "https://github.com/vaultraider115/atlas/blob/main/src/common/repo.rs"
click node_configuration "https://github.com/vaultraider115/atlas/blob/main/src/config/config_mod.rs"
click node_db_pool "https://github.com/vaultraider115/atlas/blob/main/src/config/db_config.rs"
click node_org_management "https://github.com/vaultraider115/atlas/tree/main/src/organization"
click node_tenant_controls "https://github.com/vaultraider115/atlas/blob/main/docs/ARCHITECTURE.md"
click node_audit "https://github.com/vaultraider115/atlas/blob/main/docs/ARCHITECTURE.md"
click node_email_crypto "https://github.com/vaultraider115/atlas/blob/main/src/security/aes.rs"
click node_password_security "https://github.com/vaultraider115/atlas/blob/main/src/security/argon2id.rs"
click node_email_signing "https://github.com/vaultraider115/atlas/blob/main/src/security/hmac.rs"

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_health,node_user_routes,node_user_handlers,node_client toneBlue
class node_user_service,node_user_model,node_postgres toneAmber
class node_user_repo,node_common_service,node_common_repo toneMint
class node_email_crypto,node_password_security,node_email_signing toneRose
class node_configuration,node_db_pool,node_org_management,node_tenant_controls,node_audit toneIndigo
```

## Components

### HTTP API

- [API Server](https://github.com/vaultraider115/atlas/blob/main/src/main.rs): `src/main.rs`
- [Health Endpoint](https://github.com/vaultraider115/atlas/blob/main/src/health.rs): `src/health.rs`
- [User Routes](https://github.com/vaultraider115/atlas/blob/main/src/user/routes/user_routes.rs): `src/user/routes/user_routes.rs`
- [User Handlers](https://github.com/vaultraider115/atlas/blob/main/src/user/handler/user_handler.rs): `src/user/handler/user_handler.rs`

### User Management

- [User Service](https://github.com/vaultraider115/atlas/blob/main/src/user/service/user_service.rs): `src/user/service/user_service.rs`
- [User Models](https://github.com/vaultraider115/atlas/blob/main/src/user/model/user_model.rs): `src/user/model/user_model.rs`

### Persistence

- [User Repository](https://github.com/vaultraider115/atlas/blob/main/src/user/repo/user_repo.rs): `src/user/repo/user_repo.rs`
- [Service Layer](https://github.com/vaultraider115/atlas/blob/main/src/common/service.rs): `src/common/service.rs`
- [Database Repository](https://github.com/vaultraider115/atlas/blob/main/src/common/repo.rs): `src/common/repo.rs`

### Security

- [Email Encryption](https://github.com/vaultraider115/atlas/blob/main/src/security/aes.rs): `src/security/aes.rs`
- [Password Hashing](https://github.com/vaultraider115/atlas/blob/main/src/security/argon2id.rs): `src/security/argon2id.rs`
- [Email Signing](https://github.com/vaultraider115/atlas/blob/main/src/security/hmac.rs): `src/security/hmac.rs`

### Platform and Tenancy

- [Runtime Configuration](https://github.com/vaultraider115/atlas/blob/main/src/config/config_mod.rs): `src/config/config_mod.rs`
- [Database Pool](https://github.com/vaultraider115/atlas/blob/main/src/config/db_config.rs): `src/config/db_config.rs`
- [Organization Management](https://github.com/vaultraider115/atlas/tree/main/src/organization): `src/organization`
- [Tenant Access Controls](https://github.com/vaultraider115/atlas/blob/main/docs/ARCHITECTURE.md): `docs/ARCHITECTURE.md`
- [Change Auditing](https://github.com/vaultraider115/atlas/blob/main/docs/ARCHITECTURE.md): `docs/ARCHITECTURE.md`

### Other components

- **API Client**
- **PostgreSQL**

## Connections

- API Client → API Server: sends requests (evidence: `src/main.rs`)
- API Server → Runtime Configuration: loads settings (evidence: `src/main.rs`)
- API Server → Database Pool: creates pool (evidence: `src/main.rs`)
- API Server → Database Repository: initializes (evidence: `src/main.rs`)
- API Server → User Routes: mounts routes (evidence: `src/main.rs`)
- API Server → Health Endpoint: merges endpoint (evidence: `src/main.rs`)
- User Routes → User Handlers: routes requests (evidence: `src/user/routes/user_routes.rs`)
- User Handlers → User Service: calls service (evidence: `src/user/handler/user_handler.rs`)
- User Service → User Repository: calls repository (evidence: `src/user/service/user_service.rs`)
- User Service → Service Layer: uses layer (evidence: `src/user/service/user_service.rs`)
- User Service → User Models: builds and reads (evidence: `src/user/service/user_service.rs`)
- User Service → Email Encryption: encrypts email (evidence: `src/user/service/user_service.rs`)
- User Service → Password Hashing: hashes passwords (evidence: `src/user/service/user_service.rs`)
- User Service → Email Signing: signs email (evidence: `src/user/service/user_service.rs`)
- API Server → PostgreSQL: serves database-backed API
- Tenant Access Controls → PostgreSQL: uses row security (evidence: `README.md`)
- Tenant Access Controls → PostgreSQL: checks stored authorization (evidence: `README.md`)
- Change Auditing → PostgreSQL: records changes (evidence: `README.md`)
