# ctrliq/ascender architecture

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

- Interactive diagram: https://gitdiagram.com/ctrliq/ascender
- Repository: https://github.com/ctrliq/ascender

## Overview

Ascender is an Ansible automation platform with a web UI, REST API, and task engine. A user initiates work through the UI or API; the platform manages automation resources and schedules jobs, then runs them through its task/dispatch machinery. The graph preserves major documented product layers and domain stages. Several relationships are documented in the README or indexed source references; unsampled runtime wiring is omitted rather than inferred.

Main entry points: [`ascender/api/generics.py`](https://github.com/ctrliq/ascender/blob/main/ascender/api/generics.py) (REST API), [`ascender/main/models/jobs.py`](https://github.com/ctrliq/ascender/blob/main/ascender/main/models/jobs.py) (Jobs), [`ascender/main/scheduler/task_manager.py`](https://github.com/ctrliq/ascender/blob/main/ascender/main/scheduler/task_manager.py) (Task manager), [`ascender/api/views/webhooks.py`](https://github.com/ctrliq/ascender/blob/main/ascender/api/views/webhooks.py) (Webhook launch)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_ui["Web UI<br/>[App.tsx]"]
  node_ui_api["UI API client<br/>[Base.ts]"]
end

subgraph group_api["API and identity"]
  node_rest["REST API<br/>[generics.py]"]
  node_serializers["API serializers<br/>[base.py]"]
  node_permissions["Access control<br/>[access.py]"]
  node_sso["SSO authentication<br/>[common.py]"]
end

subgraph group_automation["Automation domain"]
  node_resources["Automation resources<br/>[inventory.py]"]
  node_jobs["Jobs<br/>[jobs.py]"]
  node_workflow["Workflow jobs<br/>[workflow.py]"]
  node_inventory["Inventory<br/>[inventory.py]"]
  node_project["Projects<br/>[projects.py]"]
  node_webhooks["Webhook launch<br/>[webhooks.py]"]
end

subgraph group_runtime["Execution runtime"]
  node_task_manager["Task manager<br/>[task_manager.py]"]
  node_workflow_dag["Workflow DAG<br/>[dag_workflow.py]"]
  node_dependency["Dependency graph"]
  node_dispatch["Task dispatch<br/>[control.py]"]
end

subgraph group_platform["Platform services"]
  node_settings["Typed settings<br/>[typed.py]"]
  node_registry["Resource registry<br/>[registry.py]"]
  node_database[("Database")]
  node_notifications["Notifications<br/>[base.py]"]
end

node_user(("User"))
node_ansible{{"Ansible"}}

node_user -->|"uses"| node_ui
node_ui -->|"requests data"| node_ui_api
node_ui_api -->|"calls API"| node_rest
node_user -->|"drives"| node_rest
node_rest -->|"uses"| node_serializers
node_rest -->|"checks access"| node_permissions
node_rest -->|"reads"| node_settings
node_rest -->|"integrates"| node_sso
node_rest -->|"handles"| node_jobs
node_rest -->|"handles"| node_inventory
node_rest -->|"handles"| node_workflow
node_webhooks -->|"launches"| node_jobs
node_webhooks -->|"syncs"| node_project
node_task_manager -->|"builds"| node_workflow_dag
node_task_manager -->|"updates"| node_dependency
node_task_manager -->|"manages"| node_jobs
node_task_manager -->|"schedules"| node_workflow
node_jobs -.->|"executes via"| node_dispatch
node_dispatch -->|"runs automation"| node_ansible
node_registry -->|"indexes"| node_resources
node_jobs -.->|"persists in"| node_database
node_settings -->|"configures"| node_rest
node_notifications -.->|"notifies"| node_user

click node_ui "https://github.com/ctrliq/ascender/blob/main/ascender/ui/src/App.tsx"
click node_ui_api "https://github.com/ctrliq/ascender/blob/main/ascender/ui/src/api/Base.ts"
click node_rest "https://github.com/ctrliq/ascender/blob/main/ascender/api/generics.py"
click node_serializers "https://github.com/ctrliq/ascender/blob/main/ascender/api/serializers/base.py"
click node_permissions "https://github.com/ctrliq/ascender/blob/main/ascender/main/access.py"
click node_sso "https://github.com/ctrliq/ascender/blob/main/ascender/sso/common.py"
click node_resources "https://github.com/ctrliq/ascender/blob/main/ascender/main/models/inventory.py"
click node_jobs "https://github.com/ctrliq/ascender/blob/main/ascender/main/models/jobs.py"
click node_workflow "https://github.com/ctrliq/ascender/blob/main/ascender/main/models/workflow.py"
click node_inventory "https://github.com/ctrliq/ascender/blob/main/ascender/main/models/inventory.py"
click node_project "https://github.com/ctrliq/ascender/blob/main/ascender/main/models/projects.py"
click node_webhooks "https://github.com/ctrliq/ascender/blob/main/ascender/api/views/webhooks.py"
click node_task_manager "https://github.com/ctrliq/ascender/blob/main/ascender/main/scheduler/task_manager.py"
click node_workflow_dag "https://github.com/ctrliq/ascender/blob/main/ascender/main/scheduler/dag_workflow.py"
click node_dependency "https://github.com/ctrliq/ascender/blob/main/ascender/main/scheduler/dependency_graph.py"
click node_dispatch "https://github.com/ctrliq/ascender/blob/main/ascender/main/dispatch/control.py"
click node_settings "https://github.com/ctrliq/ascender/blob/main/ascender/settings/typed.py"
click node_registry "https://github.com/ctrliq/ascender/blob/main/ascender/dab/resource_registry/registry.py"
click node_notifications "https://github.com/ctrliq/ascender/blob/main/ascender/main/notifications/base.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_ui_api,node_user toneBlue
class node_rest,node_serializers,node_permissions,node_sso toneAmber
class node_resources,node_jobs,node_workflow,node_inventory,node_project,node_webhooks toneMint
class node_task_manager,node_workflow_dag,node_dependency,node_dispatch toneRose
class node_settings,node_registry,node_database,node_notifications,node_ansible toneIndigo
```

## Components

### User experience

- [Web UI](https://github.com/ctrliq/ascender/blob/main/ascender/ui/src/App.tsx): `ascender/ui/src/App.tsx`
- [UI API client](https://github.com/ctrliq/ascender/blob/main/ascender/ui/src/api/Base.ts): `ascender/ui/src/api/Base.ts`

### API and identity

- [REST API](https://github.com/ctrliq/ascender/blob/main/ascender/api/generics.py): `ascender/api/generics.py`
- [API serializers](https://github.com/ctrliq/ascender/blob/main/ascender/api/serializers/base.py): `ascender/api/serializers/base.py`
- [Access control](https://github.com/ctrliq/ascender/blob/main/ascender/main/access.py): `ascender/main/access.py`
- [SSO authentication](https://github.com/ctrliq/ascender/blob/main/ascender/sso/common.py): `ascender/sso/common.py`

### Automation domain

- [Automation resources](https://github.com/ctrliq/ascender/blob/main/ascender/main/models/inventory.py): `ascender/main/models/inventory.py`
- [Jobs](https://github.com/ctrliq/ascender/blob/main/ascender/main/models/jobs.py): `ascender/main/models/jobs.py`
- [Workflow jobs](https://github.com/ctrliq/ascender/blob/main/ascender/main/models/workflow.py): `ascender/main/models/workflow.py`
- [Inventory](https://github.com/ctrliq/ascender/blob/main/ascender/main/models/inventory.py): `ascender/main/models/inventory.py`
- [Projects](https://github.com/ctrliq/ascender/blob/main/ascender/main/models/projects.py): `ascender/main/models/projects.py`
- [Webhook launch](https://github.com/ctrliq/ascender/blob/main/ascender/api/views/webhooks.py): `ascender/api/views/webhooks.py`

### Execution runtime

- [Task manager](https://github.com/ctrliq/ascender/blob/main/ascender/main/scheduler/task_manager.py): `ascender/main/scheduler/task_manager.py`
- [Workflow DAG](https://github.com/ctrliq/ascender/blob/main/ascender/main/scheduler/dag_workflow.py): `ascender/main/scheduler/dag_workflow.py`
- [Dependency graph](https://github.com/ctrliq/ascender/blob/main/ascender/main/scheduler/dependency_graph.py): `ascender/main/scheduler/dependency_graph.py`
- [Task dispatch](https://github.com/ctrliq/ascender/blob/main/ascender/main/dispatch/control.py): `ascender/main/dispatch/control.py`

### Platform services

- [Typed settings](https://github.com/ctrliq/ascender/blob/main/ascender/settings/typed.py): `ascender/settings/typed.py`
- [Resource registry](https://github.com/ctrliq/ascender/blob/main/ascender/dab/resource_registry/registry.py): `ascender/dab/resource_registry/registry.py`
- **Database**
- [Notifications](https://github.com/ctrliq/ascender/blob/main/ascender/main/notifications/base.py): `ascender/main/notifications/base.py`

### Other components

- **User**
- **Ansible**

## Connections

- User → Web UI: uses
- Web UI → UI API client: requests data
- UI API client → REST API: calls API
- User → REST API: drives
- REST API → API serializers: uses (evidence: `ascender/api/generics.py`)
- REST API → Access control: checks access (evidence: `ascender/api/generics.py`)
- REST API → Typed settings: reads (evidence: `ascender/api/generics.py`)
- REST API → SSO authentication: integrates (evidence: `ascender/api/generics.py`)
- REST API → Jobs: handles
- REST API → Inventory: handles
- REST API → Workflow jobs: handles
- Webhook launch → Jobs: launches (evidence: `ascender/api/views/webhooks.py`)
- Webhook launch → Projects: syncs (evidence: `ascender/api/views/webhooks.py`)
- Task manager → Workflow DAG: builds (evidence: `ascender/main/scheduler/task_manager.py`)
- Task manager → Dependency graph: updates (evidence: `ascender/main/scheduler/task_manager.py`)
- Task manager → Jobs: manages (evidence: `ascender/main/scheduler/task_manager.py`)
- Task manager → Workflow jobs: schedules (evidence: `ascender/main/scheduler/task_manager.py`)
- Jobs → Task dispatch: executes via
- Task dispatch → Ansible: runs automation
- Resource registry → Automation resources: indexes (evidence: `ascender/dab/resource_registry/registry.py`)
- Jobs → Database: persists in
- Typed settings → REST API: configures (evidence: `ascender/api/generics.py`)
- Notifications → User: notifies
