# yerald0108/uptcer architecture

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

- Interactive diagram: https://gitdiagram.com/yerald0108/uptcer
- Repository: https://github.com/yerald0108/uptcer

## Overview

UPTCER is a Django system for managing Cuban telecom-equipment import permits. The main workflow runs from a natural person’s F43 submission, through catalog-based routing and specialist/director review, to invoicing, payment and an issuable license. Requests retain status history, and transitions trigger internal and email notifications. The graph separates these domain stages from account management and equipment-catalog maintenance. Some subsystem links are supported by the README or source index; unsampled implementation details are not inferred.

Main entry points: [`apps/solicitudes/views.py`](https://github.com/yerald0108/uptcer/blob/master/apps/solicitudes/views.py) (F43 and review), [`apps/notificaciones/servicios.py`](https://github.com/yerald0108/uptcer/blob/master/apps/notificaciones/servicios.py) (Notification services), [`apps/licencias/views.py`](https://github.com/yerald0108/uptcer/blob/master/apps/licencias/views.py) (Billing and license views), [`apps/accounts/views.py`](https://github.com/yerald0108/uptcer/blob/master/apps/accounts/views.py) (Accounts and dashboards)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accounts["Accounts and roles"]
  node_account_views["Accounts and dashboards<br/>[views.py]"]
  node_account_forms["Account forms<br/>[forms.py]"]
  node_users[("Users and roles<br/>[models.py]")]
end

subgraph group_requests["Permit workflow"]
  node_request_views["F43 and review<br/>[views.py]"]
  node_request_forms["F43 forms<br/>[forms.py]"]
  node_requests_store[("Requests and history<br/>[models.py]")]
end

subgraph group_catalog["Equipment catalog"]
  node_equipment_store[("Equipment catalog<br/>[models.py]")]
  node_equipment_views["Catalog management<br/>[views.py]"]
end

subgraph group_finance["Invoices and licenses"]
  node_billing_services["Billing services<br/>[servicios.py]"]
  node_billing_store[("Invoices and licenses<br/>[models.py]")]
  node_billing_views["Billing and license views<br/>[views.py]"]
end

subgraph group_notifications["Notifications"]
  node_notification_services["Notification services<br/>[servicios.py]"]
  node_notification_store[("Internal notifications<br/>[models.py]")]
  node_email_sender["Email delivery<br/>[emails.py]"]
end

node_person(("Natural person"))
node_specialists(("Specialists"))
node_director(("Director"))

node_person -->|"submits F43"| node_request_views
node_request_views -->|"validates"| node_request_forms
node_request_views -->|"creates and updates"| node_requests_store
node_request_views -->|"routes by catalog"| node_equipment_store
node_request_views -->|"routes review"| node_specialists
node_specialists -->|"reviews requests"| node_request_views
node_request_views -->|"requests approval"| node_director
node_director -->|"approves or denies"| node_request_views
node_request_views -->|"generates invoice"| node_billing_services
node_billing_services -->|"creates invoice or license"| node_billing_store
node_billing_views -->|"reads and updates"| node_billing_store
node_director -->|"records payment"| node_billing_views
node_person -->|"views license"| node_billing_views
node_request_views -->|"notifies transitions"| node_notification_services
node_notification_services -->|"creates notifications"| node_notification_store
node_notification_services -->|"sends email"| node_email_sender
node_account_views -->|"manages accounts"| node_users
node_account_views -->|"uses forms"| node_account_forms
node_account_forms -->|"validates users"| node_users
node_equipment_views -->|"manages catalog"| node_equipment_store

click node_account_views "https://github.com/yerald0108/uptcer/blob/master/apps/accounts/views.py"
click node_account_forms "https://github.com/yerald0108/uptcer/blob/master/apps/accounts/forms.py"
click node_users "https://github.com/yerald0108/uptcer/blob/master/apps/accounts/models.py"
click node_request_views "https://github.com/yerald0108/uptcer/blob/master/apps/solicitudes/views.py"
click node_request_forms "https://github.com/yerald0108/uptcer/blob/master/apps/solicitudes/forms.py"
click node_requests_store "https://github.com/yerald0108/uptcer/blob/master/apps/solicitudes/models.py"
click node_equipment_store "https://github.com/yerald0108/uptcer/blob/master/apps/equipos/models.py"
click node_equipment_views "https://github.com/yerald0108/uptcer/blob/master/apps/equipos/views.py"
click node_billing_services "https://github.com/yerald0108/uptcer/blob/master/apps/licencias/servicios.py"
click node_billing_store "https://github.com/yerald0108/uptcer/blob/master/apps/licencias/models.py"
click node_billing_views "https://github.com/yerald0108/uptcer/blob/master/apps/licencias/views.py"
click node_notification_services "https://github.com/yerald0108/uptcer/blob/master/apps/notificaciones/servicios.py"
click node_notification_store "https://github.com/yerald0108/uptcer/blob/master/apps/notificaciones/models.py"
click node_email_sender "https://github.com/yerald0108/uptcer/blob/master/apps/notificaciones/emails.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_account_views,node_account_forms,node_users toneBlue
class node_request_views,node_request_forms,node_requests_store toneAmber
class node_equipment_store,node_equipment_views toneMint
class node_billing_services,node_billing_store,node_billing_views toneRose
class node_notification_services,node_notification_store,node_email_sender,node_person,node_specialists,node_director toneIndigo
```

## Components

### Accounts and roles

- [Accounts and dashboards](https://github.com/yerald0108/uptcer/blob/master/apps/accounts/views.py): `apps/accounts/views.py`
- [Account forms](https://github.com/yerald0108/uptcer/blob/master/apps/accounts/forms.py): `apps/accounts/forms.py`
- [Users and roles](https://github.com/yerald0108/uptcer/blob/master/apps/accounts/models.py): `apps/accounts/models.py`

### Permit workflow

- [F43 and review](https://github.com/yerald0108/uptcer/blob/master/apps/solicitudes/views.py): `apps/solicitudes/views.py`
- [F43 forms](https://github.com/yerald0108/uptcer/blob/master/apps/solicitudes/forms.py): `apps/solicitudes/forms.py`
- [Requests and history](https://github.com/yerald0108/uptcer/blob/master/apps/solicitudes/models.py): `apps/solicitudes/models.py`

### Equipment catalog

- [Equipment catalog](https://github.com/yerald0108/uptcer/blob/master/apps/equipos/models.py): `apps/equipos/models.py`
- [Catalog management](https://github.com/yerald0108/uptcer/blob/master/apps/equipos/views.py): `apps/equipos/views.py`

### Invoices and licenses

- [Billing services](https://github.com/yerald0108/uptcer/blob/master/apps/licencias/servicios.py): `apps/licencias/servicios.py`
- [Invoices and licenses](https://github.com/yerald0108/uptcer/blob/master/apps/licencias/models.py): `apps/licencias/models.py`
- [Billing and license views](https://github.com/yerald0108/uptcer/blob/master/apps/licencias/views.py): `apps/licencias/views.py`

### Notifications

- [Notification services](https://github.com/yerald0108/uptcer/blob/master/apps/notificaciones/servicios.py): `apps/notificaciones/servicios.py`
- [Internal notifications](https://github.com/yerald0108/uptcer/blob/master/apps/notificaciones/models.py): `apps/notificaciones/models.py`
- [Email delivery](https://github.com/yerald0108/uptcer/blob/master/apps/notificaciones/emails.py): `apps/notificaciones/emails.py`

### Other components

- **Natural person**
- **Specialists**
- **Director**

## Connections

- Natural person → F43 and review: submits F43
- F43 and review → F43 forms: validates (evidence: `apps/solicitudes/views.py`)
- F43 and review → Requests and history: creates and updates (evidence: `apps/solicitudes/views.py`)
- F43 and review → Equipment catalog: routes by catalog (evidence: `apps/solicitudes/views.py`)
- F43 and review → Specialists: routes review
- Specialists → F43 and review: reviews requests
- F43 and review → Director: requests approval
- Director → F43 and review: approves or denies
- F43 and review → Billing services: generates invoice (evidence: `apps/solicitudes/views.py`)
- Billing services → Invoices and licenses: creates invoice or license (evidence: `apps/licencias/servicios.py`)
- Billing and license views → Invoices and licenses: reads and updates (evidence: `apps/licencias/views.py`)
- Director → Billing and license views: records payment
- Natural person → Billing and license views: views license
- F43 and review → Notification services: notifies transitions (evidence: `apps/solicitudes/views.py`)
- Notification services → Internal notifications: creates notifications (evidence: `apps/notificaciones/servicios.py`)
- Notification services → Email delivery: sends email (evidence: `apps/notificaciones/servicios.py`)
- Accounts and dashboards → Users and roles: manages accounts (evidence: `apps/accounts/views.py`)
- Accounts and dashboards → Account forms: uses forms (evidence: `apps/accounts/views.py`)
- Account forms → Users and roles: validates users (evidence: `apps/accounts/forms.py`)
- Catalog management → Equipment catalog: manages catalog (evidence: `apps/equipos/views.py`)
