# pusilvija/your-planner architecture

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

- Interactive diagram: https://gitdiagram.com/pusilvija/your-planner
- Repository: https://github.com/pusilvija/your-planner

## Overview

Your Planner is a Django REST backend for a personal taskboard. The principal workflow is an authenticated client sending task requests through the API routes to task handlers, which validate/serialize data and read or update per-user tasks. Separate endpoints support registration, login and logout; taskboard status/order updates and an all-tasks view support the Kanban and CRUD experiences. The README documents PostgreSQL, token authentication and Django admin. The graph follows the sampled handlers and routing; database and admin links rely on documented or configuration evidence.

Main entry points: [`task_manager/models.py`](https://github.com/pusilvija/your-planner/blob/main/task_manager/models.py) (Task model), [`task_manager/views.py`](https://github.com/pusilvija/your-planner/blob/main/task_manager/views.py) (API handlers), [`task_manager/serializers.py`](https://github.com/pusilvija/your-planner/blob/main/task_manager/serializers.py) (Data serializers), [`task_manager/urls.py`](https://github.com/pusilvija/your-planner/blob/main/task_manager/urls.py) (API routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API routing"]
  node_routes["API routes<br/>[urls.py]"]
  node_handlers["API handlers<br/>[views.py]"]
end

subgraph group_workflows["User workflows"]
  node_auth["Token auth<br/>[views.py]"]
  node_taskboard["Kanban board<br/>[views.py]"]
  node_tasklist["Task list CRUD<br/>[views.py]"]
  node_taskdetail["Task detail CRUD<br/>[views.py]"]
end

subgraph group_domain["Task domain"]
  node_serializers["Data serializers<br/>[serializers.py]"]
  node_taskmodel["Task model<br/>[models.py]"]
  node_admin["Task admin<br/>[admin.py]"]
end

subgraph group_runtime["Runtime and persistence"]
  node_settings["Django settings<br/>[settings.py]"]
  node_postgres[("PostgreSQL")]
end

node_client(("Planner client"))

node_client -->|"sends requests"| node_routes
node_routes -->|"routes to"| node_handlers
node_handlers -->|"dispatches auth"| node_auth
node_handlers -->|"dispatches board"| node_taskboard
node_handlers -->|"dispatches list"| node_tasklist
node_handlers -->|"dispatches detail"| node_taskdetail
node_auth -->|"validates credentials"| node_serializers
node_auth -->|"queries tasks"| node_taskmodel
node_taskboard -->|"reads and updates"| node_taskmodel
node_taskboard -->|"serializes tasks"| node_serializers
node_tasklist -->|"reads and updates"| node_taskmodel
node_tasklist -->|"serializes tasks"| node_serializers
node_taskdetail -->|"queries tasks"| node_taskmodel
node_taskdetail -->|"uses serializer"| node_serializers
node_serializers -->|"serializes model"| node_taskmodel
node_admin -->|"registers model"| node_taskmodel
node_settings -->|"configures database"| node_postgres

click node_routes "https://github.com/pusilvija/your-planner/blob/main/task_manager/urls.py"
click node_handlers "https://github.com/pusilvija/your-planner/blob/main/task_manager/views.py"
click node_auth "https://github.com/pusilvija/your-planner/blob/main/task_manager/views.py"
click node_taskboard "https://github.com/pusilvija/your-planner/blob/main/task_manager/views.py"
click node_tasklist "https://github.com/pusilvija/your-planner/blob/main/task_manager/views.py"
click node_taskdetail "https://github.com/pusilvija/your-planner/blob/main/task_manager/views.py"
click node_serializers "https://github.com/pusilvija/your-planner/blob/main/task_manager/serializers.py"
click node_taskmodel "https://github.com/pusilvija/your-planner/blob/main/task_manager/models.py"
click node_admin "https://github.com/pusilvija/your-planner/blob/main/task_manager/admin.py"
click node_settings "https://github.com/pusilvija/your-planner/blob/main/mysite/settings.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_handlers,node_client toneBlue
class node_auth,node_taskboard,node_tasklist,node_taskdetail toneAmber
class node_serializers,node_taskmodel,node_admin toneMint
class node_settings,node_postgres toneRose
```

## Components

### API routing

- [API routes](https://github.com/pusilvija/your-planner/blob/main/task_manager/urls.py): `task_manager/urls.py`
- [API handlers](https://github.com/pusilvija/your-planner/blob/main/task_manager/views.py): `task_manager/views.py`

### User workflows

- [Token auth](https://github.com/pusilvija/your-planner/blob/main/task_manager/views.py): `task_manager/views.py`
- [Kanban board](https://github.com/pusilvija/your-planner/blob/main/task_manager/views.py): `task_manager/views.py`
- [Task list CRUD](https://github.com/pusilvija/your-planner/blob/main/task_manager/views.py): `task_manager/views.py`
- [Task detail CRUD](https://github.com/pusilvija/your-planner/blob/main/task_manager/views.py): `task_manager/views.py`

### Task domain

- [Data serializers](https://github.com/pusilvija/your-planner/blob/main/task_manager/serializers.py): `task_manager/serializers.py`
- [Task model](https://github.com/pusilvija/your-planner/blob/main/task_manager/models.py): `task_manager/models.py`
- [Task admin](https://github.com/pusilvija/your-planner/blob/main/task_manager/admin.py): `task_manager/admin.py`

### Runtime and persistence

- [Django settings](https://github.com/pusilvija/your-planner/blob/main/mysite/settings.py): `mysite/settings.py`
- **PostgreSQL**

### Other components

- **Planner client**

## Connections

- Planner client → API routes: sends requests (evidence: `README.md`)
- API routes → API handlers: routes to (evidence: `task_manager/urls.py`)
- API handlers → Token auth: dispatches auth (evidence: `task_manager/views.py`)
- API handlers → Kanban board: dispatches board (evidence: `task_manager/views.py`)
- API handlers → Task list CRUD: dispatches list (evidence: `task_manager/views.py`)
- API handlers → Task detail CRUD: dispatches detail (evidence: `task_manager/views.py`)
- Token auth → Data serializers: validates credentials (evidence: `task_manager/views.py`)
- Token auth → Task model: queries tasks (evidence: `task_manager/views.py`)
- Kanban board → Task model: reads and updates (evidence: `task_manager/views.py`)
- Kanban board → Data serializers: serializes tasks (evidence: `task_manager/views.py`)
- Task list CRUD → Task model: reads and updates (evidence: `task_manager/views.py`)
- Task list CRUD → Data serializers: serializes tasks (evidence: `task_manager/views.py`)
- Task detail CRUD → Task model: queries tasks (evidence: `task_manager/views.py`)
- Task detail CRUD → Data serializers: uses serializer (evidence: `task_manager/views.py`)
- Data serializers → Task model: serializes model (evidence: `task_manager/serializers.py`)
- Task admin → Task model: registers model (evidence: `task_manager/admin.py`)
- Django settings → PostgreSQL: configures database (evidence: `mysite/settings.py`)
