# totylabs/mymanage-rh architecture

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

- Interactive diagram: https://gitdiagram.com/totylabs/mymanage-rh
- Repository: https://github.com/totylabs/mymanage-rh

## Overview

Dircom Payroll is a payroll and HR platform for managing employee records and issuing electronically signed pay receipts. The main user journey spans company and employee access, employee-data import, receipt preparation, signature and verification, and notifications. The sampled import code shows parsing, schema discovery, normalization, validation, matching, and persistence; sampled signing code shows receipt-signature handling. The README is empty, and several API and UI modules were not sampled, so some product branches are represented without inferred call chains.

Main entry points: [`main.py`](https://github.com/totylabs/mymanage-rh/blob/main/main.py) (Application server), [`api/receipts.py`](https://github.com/totylabs/mymanage-rh/blob/main/api/receipts.py) (Receipt API), [`modules/digital_signature.py`](https://github.com/totylabs/mymanage-rh/blob/main/modules/digital_signature.py) (Signature engine), [`api/auth.py`](https://github.com/totylabs/mymanage-rh/blob/main/api/auth.py) (Authentication API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and UI"]
  node_ui["Web interface"]
  node_auth["Authentication API<br/>[auth.py]"]
end

subgraph group_workforce["Employee Records"]
  node_employee_api["Employee API<br/>[employees.py]"]
  node_legajo_api["Legajo API<br/>[legajo.py]"]
  node_import_service["Legajo import<br/>[import_service.py]"]
  node_ingestion["Employee ingestion<br/>[ingestion.py]"]
  node_schema["Schema discovery<br/>[schema_manager.py]"]
  node_normalizer["Data normalization<br/>[normalizer.py]"]
  node_mapping["Field mapping<br/>[mapping.py]"]
  node_canonical["Canonical fields<br/>[canonical.py]"]
end

subgraph group_payroll["Payroll Documents"]
  node_receipts_api["Receipt API<br/>[receipts.py]"]
  node_receipt_service["Receipt service<br/>[receipt_service.py]"]
  node_document_repository["Document repository"]
end

subgraph group_security["Signing and Security"]
  node_signature_engine["Signature engine"]
  node_signature_module["Signature module<br/>[signature.py]"]
  node_verification["Verification service"]
  node_encryption["File encryption"]
end

subgraph group_operations["Platform Services"]
  node_notifications["Notifications<br/>[service.py]"]
  node_email["Email delivery<br/>[email_service.py]"]
  node_payroll_core["Payroll core<br/>[payroll_core.py]"]
  node_models[("Database models<br/>[tables.py]")]
  node_metrics["Metrics registry<br/>[registry.py]"]
  node_main["Application server<br/>[main.py]"]
end

node_company(("Company user"))
node_employee(("Employee"))

node_company -.->|"uses"| node_ui
node_employee -.->|"uses"| node_ui
node_main -->|"serves"| node_ui
node_main -->|"registers routes"| node_auth
node_main -->|"registers routes"| node_receipts_api
node_main -->|"registers routes"| node_employee_api
node_main -.->|"registers routes"| node_legajo_api
node_import_service -->|"discovers schema"| node_schema
node_normalizer -->|"uses schema"| node_schema
node_normalizer -->|"uses mappings"| node_mapping
node_normalizer -->|"uses fields"| node_canonical
node_employee_api -.->|"uses models"| node_models
node_receipts_api -->|"uses"| node_payroll_core
node_receipts_api -->|"uses"| node_signature_engine
node_receipts_api -->|"uses"| node_signature_module
node_receipts_api -->|"uses"| node_document_repository
node_receipts_api -->|"uses"| node_models
node_receipt_service -->|"uses"| node_models
node_receipt_service -->|"notifies"| node_notifications
node_signature_engine -->|"uses"| node_document_repository
node_signature_engine -->|"uses"| node_signature_module
node_signature_engine -->|"uses"| node_verification
node_signature_engine -->|"uses"| node_email
node_signature_engine -->|"uses"| node_notifications
node_notifications -->|"fetches document"| node_document_repository
node_notifications -->|"sends email"| node_email
node_encryption -->|"uses"| node_payroll_core
node_auth -->|"uses"| node_verification
node_auth -->|"uses"| node_email
node_auth -->|"uses"| node_payroll_core
node_main -->|"configures"| node_metrics
node_payroll_core -.->|"uses"| node_models

click node_ui "https://github.com/totylabs/mymanage-rh/tree/main/ui"
click node_auth "https://github.com/totylabs/mymanage-rh/blob/main/api/auth.py"
click node_employee_api "https://github.com/totylabs/mymanage-rh/blob/main/api/employees.py"
click node_legajo_api "https://github.com/totylabs/mymanage-rh/blob/main/api/legajo.py"
click node_import_service "https://github.com/totylabs/mymanage-rh/blob/main/services/legajo/import_service.py"
click node_ingestion "https://github.com/totylabs/mymanage-rh/blob/main/services/legajo/ingestion.py"
click node_schema "https://github.com/totylabs/mymanage-rh/blob/main/services/legajo/schema_manager.py"
click node_normalizer "https://github.com/totylabs/mymanage-rh/blob/main/services/legajo/normalizer.py"
click node_mapping "https://github.com/totylabs/mymanage-rh/blob/main/services/legajo/mapping.py"
click node_canonical "https://github.com/totylabs/mymanage-rh/blob/main/services/legajo/canonical.py"
click node_receipts_api "https://github.com/totylabs/mymanage-rh/blob/main/api/receipts.py"
click node_receipt_service "https://github.com/totylabs/mymanage-rh/blob/main/services/receipt_service.py"
click node_document_repository "https://github.com/totylabs/mymanage-rh/blob/main/services/document_repository.py"
click node_signature_engine "https://github.com/totylabs/mymanage-rh/blob/main/modules/digital_signature.py"
click node_signature_module "https://github.com/totylabs/mymanage-rh/blob/main/modules/signature.py"
click node_verification "https://github.com/totylabs/mymanage-rh/blob/main/services/verification_service.py"
click node_encryption "https://github.com/totylabs/mymanage-rh/blob/main/services/encryption_service.py"
click node_notifications "https://github.com/totylabs/mymanage-rh/blob/main/notifications/service.py"
click node_email "https://github.com/totylabs/mymanage-rh/blob/main/services/email_service.py"
click node_payroll_core "https://github.com/totylabs/mymanage-rh/blob/main/payroll_core.py"
click node_models "https://github.com/totylabs/mymanage-rh/blob/main/models/tables.py"
click node_metrics "https://github.com/totylabs/mymanage-rh/blob/main/metrics/registry.py"
click node_main "https://github.com/totylabs/mymanage-rh/blob/main/main.py"

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_ui,node_auth,node_company toneBlue
class node_employee_api,node_legajo_api,node_import_service,node_ingestion,node_schema,node_normalizer,node_mapping,node_canonical toneAmber
class node_receipts_api,node_receipt_service,node_document_repository toneMint
class node_signature_engine,node_signature_module,node_verification,node_encryption toneRose
class node_notifications,node_email,node_payroll_core,node_models,node_metrics,node_main,node_employee toneIndigo
```

## Components

### Access and UI

- [Web interface](https://github.com/totylabs/mymanage-rh/tree/main/ui): `ui`
- [Authentication API](https://github.com/totylabs/mymanage-rh/blob/main/api/auth.py): `api/auth.py`

### Employee Records

- [Employee API](https://github.com/totylabs/mymanage-rh/blob/main/api/employees.py): `api/employees.py`
- [Legajo API](https://github.com/totylabs/mymanage-rh/blob/main/api/legajo.py): `api/legajo.py`
- [Legajo import](https://github.com/totylabs/mymanage-rh/blob/main/services/legajo/import_service.py): `services/legajo/import_service.py`
- [Employee ingestion](https://github.com/totylabs/mymanage-rh/blob/main/services/legajo/ingestion.py): `services/legajo/ingestion.py`
- [Schema discovery](https://github.com/totylabs/mymanage-rh/blob/main/services/legajo/schema_manager.py): `services/legajo/schema_manager.py`
- [Data normalization](https://github.com/totylabs/mymanage-rh/blob/main/services/legajo/normalizer.py): `services/legajo/normalizer.py`
- [Field mapping](https://github.com/totylabs/mymanage-rh/blob/main/services/legajo/mapping.py): `services/legajo/mapping.py`
- [Canonical fields](https://github.com/totylabs/mymanage-rh/blob/main/services/legajo/canonical.py): `services/legajo/canonical.py`

### Payroll Documents

- [Receipt API](https://github.com/totylabs/mymanage-rh/blob/main/api/receipts.py): `api/receipts.py`
- [Receipt service](https://github.com/totylabs/mymanage-rh/blob/main/services/receipt_service.py): `services/receipt_service.py`
- [Document repository](https://github.com/totylabs/mymanage-rh/blob/main/services/document_repository.py): `services/document_repository.py`

### Signing and Security

- [Signature engine](https://github.com/totylabs/mymanage-rh/blob/main/modules/digital_signature.py): `modules/digital_signature.py`
- [Signature module](https://github.com/totylabs/mymanage-rh/blob/main/modules/signature.py): `modules/signature.py`
- [Verification service](https://github.com/totylabs/mymanage-rh/blob/main/services/verification_service.py): `services/verification_service.py`
- [File encryption](https://github.com/totylabs/mymanage-rh/blob/main/services/encryption_service.py): `services/encryption_service.py`

### Platform Services

- [Notifications](https://github.com/totylabs/mymanage-rh/blob/main/notifications/service.py): `notifications/service.py`
- [Email delivery](https://github.com/totylabs/mymanage-rh/blob/main/services/email_service.py): `services/email_service.py`
- [Payroll core](https://github.com/totylabs/mymanage-rh/blob/main/payroll_core.py): `payroll_core.py`
- [Database models](https://github.com/totylabs/mymanage-rh/blob/main/models/tables.py): `models/tables.py`
- [Metrics registry](https://github.com/totylabs/mymanage-rh/blob/main/metrics/registry.py): `metrics/registry.py`
- [Application server](https://github.com/totylabs/mymanage-rh/blob/main/main.py): `main.py`

### Other components

- **Company user**
- **Employee**

## Connections

- Company user → Web interface: uses
- Employee → Web interface: uses
- Application server → Web interface: serves (evidence: `main.py`)
- Application server → Authentication API: registers routes (evidence: `main.py`)
- Application server → Receipt API: registers routes (evidence: `main.py`)
- Application server → Employee API: registers routes (evidence: `main.py`)
- Application server → Legajo API: registers routes (evidence: `main.py`)
- Legajo import → Schema discovery: discovers schema (evidence: `services/legajo/import_service.py`)
- Data normalization → Schema discovery: uses schema (evidence: `services/legajo/normalizer.py`)
- Data normalization → Field mapping: uses mappings (evidence: `services/legajo/normalizer.py`)
- Data normalization → Canonical fields: uses fields (evidence: `services/legajo/normalizer.py`)
- Employee API → Database models: uses models
- Receipt API → Payroll core: uses (evidence: `api/receipts.py`)
- Receipt API → Signature engine: uses (evidence: `api/receipts.py`)
- Receipt API → Signature module: uses (evidence: `api/receipts.py`)
- Receipt API → Document repository: uses (evidence: `api/receipts.py`)
- Receipt API → Database models: uses (evidence: `api/receipts.py`)
- Receipt service → Database models: uses (evidence: `services/receipt_service.py`)
- Receipt service → Notifications: notifies (evidence: `services/receipt_service.py`)
- Signature engine → Document repository: uses (evidence: `modules/digital_signature.py`)
- Signature engine → Signature module: uses (evidence: `modules/digital_signature.py`)
- Signature engine → Verification service: uses (evidence: `modules/digital_signature.py`)
- Signature engine → Email delivery: uses (evidence: `modules/digital_signature.py`)
- Signature engine → Notifications: uses (evidence: `modules/digital_signature.py`)
- Notifications → Document repository: fetches document (evidence: `notifications/service.py`)
- Notifications → Email delivery: sends email (evidence: `notifications/service.py`)
- File encryption → Payroll core: uses (evidence: `services/encryption_service.py`)
- Authentication API → Verification service: uses (evidence: `api/auth.py`)
- Authentication API → Email delivery: uses (evidence: `api/auth.py`)
- Authentication API → Payroll core: uses (evidence: `api/auth.py`)
- Application server → Metrics registry: configures (evidence: `main.py`)
- Payroll core → Database models: uses
