# chhavi-lohani-14/devtrack architecture

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

- Interactive diagram: https://gitdiagram.com/chhavi-lohani-14/devtrack
- Repository: https://github.com/chhavi-lohani-14/devtrack

## Overview

DevTrack is a FastAPI task-management API. Its principal workflow authenticates a user, then lets that user create and manage only their own tasks; an admin can list all tasks. The main module owns HTTP routes and orchestration, using Pydantic schemas, authentication helpers, SQLAlchemy models, and a SQLite-backed session layer. The README also documents registration, password hashing, JWT authentication, ownership enforcement, and admin access. The sampled source shows these runtime relationships; tests and CI are excluded.

Main entry points: [`app/main.py`](https://github.com/chhavi-lohani-14/devtrack/blob/main/app/main.py) (Registration and login), [`app/database.py`](https://github.com/chhavi-lohani-14/devtrack/blob/main/app/database.py) (Database sessions), [`app/models.py`](https://github.com/chhavi-lohani-14/devtrack/blob/main/app/models.py) (User and task models), [`app/schemas.py`](https://github.com/chhavi-lohani-14/devtrack/blob/main/app/schemas.py) (Response schemas)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API workflows"]
  node_routes["API routes<br/>[main.py]"]
  node_task_ops["Task operations<br/>[main.py]"]
  node_admin_view["Admin task listing<br/>[main.py]"]
  node_request_schemas["Request validation<br/>[schemas.py]"]
  node_response_schemas["Response schemas<br/>[schemas.py]"]
end

subgraph group_identity["Identity and access"]
  node_identity_routes["Registration and login<br/>[main.py]"]
  node_access_control["Token and role checks<br/>[main.py]"]
  node_auth_helpers["Password and JWT helpers<br/>[auth.py]"]
end

subgraph group_persistence["Persistence and data"]
  node_orm_models["User and task models<br/>[models.py]"]
  node_db_sessions["Database sessions<br/>[database.py]"]
  node_sqlite[("SQLite database<br/>[database.py]")]
end

node_client(("API client"))

node_client -->|"sends requests"| node_routes
node_routes -->|"dispatches auth"| node_identity_routes
node_routes -->|"dispatches tasks"| node_task_ops
node_routes -->|"dispatches admin"| node_admin_view
node_identity_routes -->|"validates input"| node_request_schemas
node_task_ops -->|"validates input"| node_request_schemas
node_identity_routes -->|"hashes and verifies"| node_auth_helpers
node_identity_routes -->|"creates tokens"| node_auth_helpers
node_access_control -->|"decodes tokens"| node_auth_helpers
node_task_ops -->|"requires user"| node_access_control
node_admin_view -->|"requires admin"| node_access_control
node_identity_routes -->|"queries and writes"| node_db_sessions
node_access_control -->|"looks up user"| node_db_sessions
node_task_ops -->|"queries and writes"| node_db_sessions
node_admin_view -->|"queries tasks"| node_db_sessions
node_db_sessions -->|"opens sessions"| node_sqlite
node_identity_routes -->|"creates user"| node_orm_models
node_access_control -->|"queries user"| node_orm_models
node_task_ops -->|"queries and mutates"| node_orm_models
node_admin_view -->|"queries tasks"| node_orm_models
node_orm_models -->|"uses base"| node_db_sessions
node_identity_routes -->|"returns user or token"| node_response_schemas
node_task_ops -->|"returns task data"| node_response_schemas
node_admin_view -->|"returns task list"| node_response_schemas

click node_routes "https://github.com/chhavi-lohani-14/devtrack/blob/main/app/main.py"
click node_task_ops "https://github.com/chhavi-lohani-14/devtrack/blob/main/app/main.py"
click node_admin_view "https://github.com/chhavi-lohani-14/devtrack/blob/main/app/main.py"
click node_request_schemas "https://github.com/chhavi-lohani-14/devtrack/blob/main/app/schemas.py"
click node_response_schemas "https://github.com/chhavi-lohani-14/devtrack/blob/main/app/schemas.py"
click node_identity_routes "https://github.com/chhavi-lohani-14/devtrack/blob/main/app/main.py"
click node_access_control "https://github.com/chhavi-lohani-14/devtrack/blob/main/app/main.py"
click node_auth_helpers "https://github.com/chhavi-lohani-14/devtrack/blob/main/app/auth.py"
click node_orm_models "https://github.com/chhavi-lohani-14/devtrack/blob/main/app/models.py"
click node_db_sessions "https://github.com/chhavi-lohani-14/devtrack/blob/main/app/database.py"
click node_sqlite "https://github.com/chhavi-lohani-14/devtrack/blob/main/app/database.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_routes,node_task_ops,node_admin_view,node_request_schemas,node_response_schemas,node_client toneBlue
class node_identity_routes,node_access_control,node_auth_helpers toneAmber
class node_orm_models,node_db_sessions,node_sqlite toneMint
```

## Components

### API workflows

- [API routes](https://github.com/chhavi-lohani-14/devtrack/blob/main/app/main.py): `app/main.py`
- [Task operations](https://github.com/chhavi-lohani-14/devtrack/blob/main/app/main.py): `app/main.py`
- [Admin task listing](https://github.com/chhavi-lohani-14/devtrack/blob/main/app/main.py): `app/main.py`
- [Request validation](https://github.com/chhavi-lohani-14/devtrack/blob/main/app/schemas.py): `app/schemas.py`
- [Response schemas](https://github.com/chhavi-lohani-14/devtrack/blob/main/app/schemas.py): `app/schemas.py`

### Identity and access

- [Registration and login](https://github.com/chhavi-lohani-14/devtrack/blob/main/app/main.py): `app/main.py`
- [Token and role checks](https://github.com/chhavi-lohani-14/devtrack/blob/main/app/main.py): `app/main.py`
- [Password and JWT helpers](https://github.com/chhavi-lohani-14/devtrack/blob/main/app/auth.py): `app/auth.py`

### Persistence and data

- [User and task models](https://github.com/chhavi-lohani-14/devtrack/blob/main/app/models.py): `app/models.py`
- [Database sessions](https://github.com/chhavi-lohani-14/devtrack/blob/main/app/database.py): `app/database.py`
- [SQLite database](https://github.com/chhavi-lohani-14/devtrack/blob/main/app/database.py): `app/database.py`

### Other components

- **API client**

## Connections

- API client → API routes: sends requests (evidence: `app/main.py`)
- API routes → Registration and login: dispatches auth (evidence: `app/main.py`)
- API routes → Task operations: dispatches tasks (evidence: `app/main.py`)
- API routes → Admin task listing: dispatches admin (evidence: `app/main.py`)
- Registration and login → Request validation: validates input (evidence: `app/main.py`)
- Task operations → Request validation: validates input (evidence: `app/main.py`)
- Registration and login → Password and JWT helpers: hashes and verifies (evidence: `app/main.py`)
- Registration and login → Password and JWT helpers: creates tokens (evidence: `app/main.py`)
- Token and role checks → Password and JWT helpers: decodes tokens (evidence: `app/main.py`)
- Task operations → Token and role checks: requires user (evidence: `app/main.py`)
- Admin task listing → Token and role checks: requires admin (evidence: `app/main.py`)
- Registration and login → Database sessions: queries and writes (evidence: `app/main.py`)
- Token and role checks → Database sessions: looks up user (evidence: `app/main.py`)
- Task operations → Database sessions: queries and writes (evidence: `app/main.py`)
- Admin task listing → Database sessions: queries tasks (evidence: `app/main.py`)
- Database sessions → SQLite database: opens sessions (evidence: `app/database.py`)
- Registration and login → User and task models: creates user (evidence: `app/main.py`)
- Token and role checks → User and task models: queries user (evidence: `app/main.py`)
- Task operations → User and task models: queries and mutates (evidence: `app/main.py`)
- Admin task listing → User and task models: queries tasks (evidence: `app/main.py`)
- User and task models → Database sessions: uses base (evidence: `app/models.py`)
- Registration and login → Response schemas: returns user or token (evidence: `app/main.py`)
- Task operations → Response schemas: returns task data (evidence: `app/main.py`)
- Admin task listing → Response schemas: returns task list (evidence: `app/main.py`)
