# nofusscomputing/centurion_erp architecture

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

- Interactive diagram: https://gitdiagram.com/nofusscomputing/centurion_erp
- Repository: https://github.com/nofusscomputing/centurion_erp

## Overview

Centurion ERP is a Django-based enterprise IT management and service-management application. Its principal workflow is an authenticated, tenant-scoped API request that reaches a domain endpoint, validates or serializes records, and operates on application models; the supplied excerpts show parts of that layering but not the complete request dispatch. Major product areas visible in the tree include ticketing, IT asset inventory, IT infrastructure and services, access and tenancy, configuration management, assistance, projects, and developer integrations. Edges are limited to relationships visible in excerpts or SOURCE INDEX references; dashed links mark likely runtime connections not established by the supplied evidence.

Main entry points: [`app/itim/serializers/service.py`](https://github.com/nofusscomputing/centurion_erp/blob/development/app/itim/serializers/service.py) (Service validation), [`app/api/urls_v2.py`](https://github.com/nofusscomputing/centurion_erp/blob/development/app/api/urls_v2.py) (API endpoints), [`app/api/serializers/common.py`](https://github.com/nofusscomputing/centurion_erp/blob/development/app/api/serializers/common.py) (API serializers), [`app/access/serializers/organization.py`](https://github.com/nofusscomputing/centurion_erp/blob/development/app/access/serializers/organization.py) (Organizations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api_access["API and access"]
  node_api["API endpoints<br/>[urls_v2.py]"]
  node_api_common["API serializers<br/>[common.py]"]
  node_tenancy["Tenant access<br/>[tenancy.py]"]
  node_tenant["Organizations<br/>[organization.py]"]
  node_access_models[("Users and roles<br/>[centurion_user.py]")]
end

subgraph group_service_desk["Service desk"]
  node_tickets[("Tickets and comments<br/>[ticket.py]")]
  node_ticket_api["Ticket endpoints<br/>[ticket.py]"]
  node_assistance[("Knowledge base<br/>[knowledge_base.py]")]
  node_projects[("Projects<br/>[projects.py]")]
end

subgraph group_asset_ops["Asset operations"]
  node_devices[("Device inventory<br/>[device.py]")]
  node_software[("Software inventory<br/>[software.py]")]
  node_assets[("Asset records<br/>[asset_base.py]")]
  node_config[("Configuration groups<br/>[groups.py]")]
end

subgraph group_infrastructure["Infrastructure operations"]
  node_services[("IT services<br/>[services.py]")]
  node_clusters[("Clusters and ports<br/>[clusters.py]")]
  node_service_serializer["Service validation<br/>[service.py]"]
  node_hr[("Employees<br/>[employee.py]")]
end

subgraph group_platform_ext["Platform and extensions"]
  node_git[("Git repositories<br/>[base.py]")]
  node_feature_flags["Feature flags<br/>[feature_flag.py]"]
  node_notes[("Model notes<br/>[centurion_notes.py]")]
  node_core_model["Shared model layer<br/>[centurion.py]"]
end

node_user(("User"))
node_external_git{{"Git providers"}}

node_user -.->|"requests"| node_api
node_api -.->|"scopes requests"| node_tenancy
node_tenancy -.->|"uses serializers"| node_api_common
node_api_common -->|"uses tenant fields"| node_tenant
node_ticket_api -.->|"accesses tickets"| node_tickets
node_api -.->|"routes requests"| node_ticket_api
node_devices -->|"reads groups"| node_config
node_devices -->|"references services"| node_services
node_service_serializer -->|"validates records"| node_services
node_service_serializer -->|"uses tenant serializer"| node_tenant
node_service_serializer -->|"uses common serializers"| node_api_common
node_service_serializer -->|"uses cluster serializer"| node_clusters
node_service_serializer -->|"uses device serializer"| node_devices
node_service_serializer -->|"used by endpoint"| node_tenancy
node_core_model -->|"uses tenancy model"| node_access_models
node_core_model -.->|"inherits shared fields"| node_tenant
node_notes -->|"uses common serializer"| node_api_common
node_notes -->|"uses tenant serializer"| node_tenant
node_git -.->|"integrates providers"| node_external_git
node_feature_flags -.->|"gates routes"| node_api

click node_api "https://github.com/nofusscomputing/centurion_erp/blob/development/app/api/urls_v2.py"
click node_api_common "https://github.com/nofusscomputing/centurion_erp/blob/development/app/api/serializers/common.py"
click node_tenancy "https://github.com/nofusscomputing/centurion_erp/blob/development/app/api/viewsets/common/tenancy.py"
click node_tenant "https://github.com/nofusscomputing/centurion_erp/blob/development/app/access/serializers/organization.py"
click node_access_models "https://github.com/nofusscomputing/centurion_erp/blob/development/app/access/models/centurion_user.py"
click node_tickets "https://github.com/nofusscomputing/centurion_erp/blob/development/app/core/models/ticket/ticket.py"
click node_ticket_api "https://github.com/nofusscomputing/centurion_erp/blob/development/app/core/viewsets/ticket.py"
click node_assistance "https://github.com/nofusscomputing/centurion_erp/blob/development/app/assistance/models/knowledge_base.py"
click node_projects "https://github.com/nofusscomputing/centurion_erp/blob/development/app/project_management/models/projects.py"
click node_devices "https://github.com/nofusscomputing/centurion_erp/blob/development/app/itam/models/device.py"
click node_software "https://github.com/nofusscomputing/centurion_erp/blob/development/app/itam/models/software.py"
click node_assets "https://github.com/nofusscomputing/centurion_erp/blob/development/app/accounting/models/asset_base.py"
click node_config "https://github.com/nofusscomputing/centurion_erp/blob/development/app/config_management/models/groups.py"
click node_services "https://github.com/nofusscomputing/centurion_erp/blob/development/app/itim/models/services.py"
click node_clusters "https://github.com/nofusscomputing/centurion_erp/blob/development/app/itim/models/clusters.py"
click node_service_serializer "https://github.com/nofusscomputing/centurion_erp/blob/development/app/itim/serializers/service.py"
click node_hr "https://github.com/nofusscomputing/centurion_erp/blob/development/app/human_resources/models/employee.py"
click node_git "https://github.com/nofusscomputing/centurion_erp/blob/development/app/devops/models/git_repository/base.py"
click node_feature_flags "https://github.com/nofusscomputing/centurion_erp/blob/development/app/centurion_feature_flag/lib/feature_flag.py"
click node_notes "https://github.com/nofusscomputing/centurion_erp/blob/development/app/core/models/centurion_notes.py"
click node_core_model "https://github.com/nofusscomputing/centurion_erp/blob/development/app/core/models/centurion.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_api,node_api_common,node_tenancy,node_tenant,node_access_models,node_user toneBlue
class node_tickets,node_ticket_api,node_assistance,node_projects toneAmber
class node_devices,node_software,node_assets,node_config toneMint
class node_services,node_clusters,node_service_serializer,node_hr toneRose
class node_git,node_feature_flags,node_notes,node_core_model,node_external_git toneIndigo
```

## Components

### API and access

- [API endpoints](https://github.com/nofusscomputing/centurion_erp/blob/development/app/api/urls_v2.py): `app/api/urls_v2.py`
- [API serializers](https://github.com/nofusscomputing/centurion_erp/blob/development/app/api/serializers/common.py): `app/api/serializers/common.py`
- [Tenant access](https://github.com/nofusscomputing/centurion_erp/blob/development/app/api/viewsets/common/tenancy.py): `app/api/viewsets/common/tenancy.py`
- [Organizations](https://github.com/nofusscomputing/centurion_erp/blob/development/app/access/serializers/organization.py): `app/access/serializers/organization.py`
- [Users and roles](https://github.com/nofusscomputing/centurion_erp/blob/development/app/access/models/centurion_user.py): `app/access/models/centurion_user.py`

### Service desk

- [Tickets and comments](https://github.com/nofusscomputing/centurion_erp/blob/development/app/core/models/ticket/ticket.py): `app/core/models/ticket/ticket.py`
- [Ticket endpoints](https://github.com/nofusscomputing/centurion_erp/blob/development/app/core/viewsets/ticket.py): `app/core/viewsets/ticket.py`
- [Knowledge base](https://github.com/nofusscomputing/centurion_erp/blob/development/app/assistance/models/knowledge_base.py): `app/assistance/models/knowledge_base.py`
- [Projects](https://github.com/nofusscomputing/centurion_erp/blob/development/app/project_management/models/projects.py): `app/project_management/models/projects.py`

### Asset operations

- [Device inventory](https://github.com/nofusscomputing/centurion_erp/blob/development/app/itam/models/device.py): `app/itam/models/device.py`
- [Software inventory](https://github.com/nofusscomputing/centurion_erp/blob/development/app/itam/models/software.py): `app/itam/models/software.py`
- [Asset records](https://github.com/nofusscomputing/centurion_erp/blob/development/app/accounting/models/asset_base.py): `app/accounting/models/asset_base.py`
- [Configuration groups](https://github.com/nofusscomputing/centurion_erp/blob/development/app/config_management/models/groups.py): `app/config_management/models/groups.py`

### Infrastructure operations

- [IT services](https://github.com/nofusscomputing/centurion_erp/blob/development/app/itim/models/services.py): `app/itim/models/services.py`
- [Clusters and ports](https://github.com/nofusscomputing/centurion_erp/blob/development/app/itim/models/clusters.py): `app/itim/models/clusters.py`
- [Service validation](https://github.com/nofusscomputing/centurion_erp/blob/development/app/itim/serializers/service.py): `app/itim/serializers/service.py`
- [Employees](https://github.com/nofusscomputing/centurion_erp/blob/development/app/human_resources/models/employee.py): `app/human_resources/models/employee.py`

### Platform and extensions

- [Git repositories](https://github.com/nofusscomputing/centurion_erp/blob/development/app/devops/models/git_repository/base.py): `app/devops/models/git_repository/base.py`
- [Feature flags](https://github.com/nofusscomputing/centurion_erp/blob/development/app/centurion_feature_flag/lib/feature_flag.py): `app/centurion_feature_flag/lib/feature_flag.py`
- [Model notes](https://github.com/nofusscomputing/centurion_erp/blob/development/app/core/models/centurion_notes.py): `app/core/models/centurion_notes.py`
- [Shared model layer](https://github.com/nofusscomputing/centurion_erp/blob/development/app/core/models/centurion.py): `app/core/models/centurion.py`

### Other components

- **User**
- **Git providers**

## Connections

- User → API endpoints: requests
- API endpoints → Tenant access: scopes requests
- Tenant access → API serializers: uses serializers
- API serializers → Organizations: uses tenant fields (evidence: `app/api/serializers/common.py`)
- Ticket endpoints → Tickets and comments: accesses tickets
- API endpoints → Ticket endpoints: routes requests
- Device inventory → Configuration groups: reads groups (evidence: `app/itam/models/device.py`)
- Device inventory → IT services: references services (evidence: `app/itam/models/device.py`)
- Service validation → IT services: validates records (evidence: `app/itim/serializers/service.py`)
- Service validation → Organizations: uses tenant serializer (evidence: `app/itim/serializers/service.py`)
- Service validation → API serializers: uses common serializers (evidence: `app/itim/serializers/service.py`)
- Service validation → Clusters and ports: uses cluster serializer (evidence: `app/itim/serializers/service.py`)
- Service validation → Device inventory: uses device serializer (evidence: `app/itim/serializers/service.py`)
- Service validation → Tenant access: used by endpoint (evidence: `app/itim/viewsets/service.py`)
- Shared model layer → Users and roles: uses tenancy model (evidence: `app/core/models/centurion.py`)
- Shared model layer → Organizations: inherits shared fields
- Model notes → API serializers: uses common serializer (evidence: `app/core/serializers/centurionmodelnote.py`)
- Model notes → Organizations: uses tenant serializer (evidence: `app/core/serializers/centurionmodelnote.py`)
- Git repositories → Git providers: integrates providers
- Feature flags → API endpoints: gates routes
