# iath-dev/task-manager-rpy architecture

> Architecture diagram of the GitHub repository iath-dev/task-manager-rpy, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/iath-dev/task-manager-rpy
- Repository: https://github.com/iath-dev/task-manager-rpy

## Overview

##### Project Type and Purpose
- This is a monorepo full-stack task-management application.
- Backend: RESTful API built with FastAPI, uses Alembic for migrations, exposes endpoints under `/api/v1`.
- Frontend: React+TypeScript single-page app (SPA) built with Vite, served (in production) behind Nginx.
- Containerized via Docker Compose for easy local/dev deployment.

##### High-Level Architecture Components
a. Docker-Compose Services
- frontend (React app served by Nginx)
- backend (FastAPI app)
- database (e.g. Postgres or SQLite; `backend/test.db` for local dev)
- optional: reverse-proxy or load-balancer in front of Nginx for scale
b. Frontend Logical Layers
- UI Components (Tasks, Comments, Users)
- State Management (Zustand stores: authStore, taskStore, sidebarStore)
- Data Layer (services: `api.ts`, `taskService`, `commentService`, `userService`)
- Routing & Layout (React Router loaders, protected/public routes, AppLayout)
c. Backend Logical Layers
- API Layer (routers in `app/api/routes`, grouped by domain: auth, users, tasks, comments, seed, health)
- Service Layer (business logic in `app/services`)
- Data Layer (SQLAlchemy models in `app/db/models`, session management in `app/db/session`)
- Core/Infrastructure (configuration, security, logging under `app/core`)
- Migrations (`alembic/` Dir)
d. Database
- Entities: User, Task, Comment
- Relationships: one-to-many (User→Task, Task→Comment, User→Comment)
- Seed endpoint to prepopulate roles/users

##### Relationships & Data Flows
- Browser → (HTTP/HTTPS) → Nginx (serves built React assets)
- React SPA → (AJAX/fetch) → FastAPI `/api/v1/*` endpoints
- FastAPI → (ORM) → Database
- FastAPI → (Alembic) → Database schema migrations
- Cypress Tests → Frontend (component & E2E) or Backend (pytest)

##### Architectural Patterns & Principles
- Layered architecture (Presentation → Application → Domain → Infrastructure)
- Separation of concerns: API routers vs business services vs data models
- Containerized microservice style (each service in its own container, communicates over HTTP)
- Hexagonal touches: dependency injection via FastAPI `deps.py`

1. Sketch three primary blocks: Frontend, Backend, Database.
2. Inside Frontend, subdivide:
- UI Components
- Data Layer (services + hooks)
- State Store
3. Inside Backend, subdivide:
- API Routers (`/routes/*.py`)
- Service Layer (`services/*.py`)
- ORM Layer (`db/models`, `db/session`)
- Config & Security (`core/`)
- User’s Browser → Frontend (HTTP)
- Frontend → Backend (HTTP with JSON payloads)
- Backend → Database (ORM/SQL)
- (Side) Alembic migrations → Database

## Diagram (Mermaid)

```mermaid
graph TB
    %% External Entity
    Browser(["User's Browser"]):::external

    %% Containers
    subgraph "Frontend Container (frontend)" 
        direction TB
        Fnginx["Nginx"]:::infra
        subgraph "React SPA"
            direction TB
            subgraph "UI Components" 
                direction TB
                TaskList["TaskList"]:::presentation
                TaskForm["TaskForm"]:::presentation
                Comments["Comments"]:::presentation
                Users["Users"]:::presentation
                SharedUI["Shared UI"]:::presentation
            end
            subgraph "State Management (Zustand)" 
                direction TB
                AuthStore["authStore"]:::logic
                TaskStore["taskStore"]:::logic
                SidebarStore["sidebarStore"]:::logic
            end
            subgraph "Data Layer (Services)" 
                direction TB
                APIclient["api.ts"]:::logic
                TaskService["taskService.ts"]:::logic
                CommentService["commentService.ts"]:::logic
                UserService["userService.ts"]:::logic
            end
            subgraph "Routing & Layout" 
                direction TB
                RoutesIndex["index.tsx"]:::logic
                Loaders["loaders.ts"]:::logic
                ProtectedRoute["protected.tsx"]:::logic
                PublicRoute["public.tsx"]:::logic
                AppLayout["AppLayout.tsx"]:::logic
                PagesDir["pages"]:::presentation
            end
        end
    end

    subgraph "Backend Container (backend)"
        direction TB
        subgraph "API Layer (Routers)" 
            direction TB
            APIv1["api.py"]:::logic
            AuthRouter["auth.py"]:::logic
            HealthRouter["health.py"]:::logic
            SeedRouter["seed.py"]:::logic
            TaskRouter["task.py"]:::logic
            UserRouter["user.py"]:::logic
        end
        subgraph "Service Layer" 
            direction TB
            AuthService["auth_service.py"]:::logic
            TaskServiceB["task_service.py"]:::logic
            CommentServiceB["comment_service.py"]:::logic
            UserServiceB["user_service.py"]:::logic
        end
        subgraph "Data Layer (ORM)" 
            direction TB
            UserModel["user.py"]:::storage
            TaskModel["task.py"]:::storage
            CommentModel["comment.py"]:::storage
            Session["session.py"]:::storage
            BaseMeta["base.py"]:::storage
        end
        subgraph "Core/Infrastructure" 
            direction TB
            Config["config.py"]:::infra
            Security["security.py"]:::infra
            Logging["logging.py"]:::infra
        end
    end

    subgraph "Database Container"
        direction TB
        DatabaseDb["Postgres/SQLite"]:::storage
    end

    subgraph "Migrations (Alembic)"
        direction TB
        AlembicIni["alembic.ini"]:::infra
        EnvPy["env.py"]:::infra
        Versions["versions/"]:::infra
    end

    %% Connections
    Browser -->|"HTTP GET /"| Fnginx
    Fnginx -->|serves React build| TaskList
    TaskList -->|renders| TaskForm
    Comments & Users & SharedUI -->|UI| UserService
    TaskList -->|uses| TaskService
    APIclient -->|calls| APIv1
    ProtectedRoute -->|renders| AppLayout
    AppLayout -->|wraps| PagesDir

    APIv1 -->|"calls routers"| AuthRouter & HealthRouter & SeedRouter & TaskRouter & UserRouter
    AuthRouter -->|uses| AuthService
    TaskRouter -->|uses| TaskServiceB
    CommentServiceB -->|used by| TaskRouter
    UserRouter -->|uses| UserServiceB

    AuthService & TaskServiceB & CommentServiceB & UserServiceB -->|ORM| UserModel & TaskModel & CommentModel
    Session & BaseMeta -->|context| UserModel & TaskModel & CommentModel

    APIv1 -->|depends on| Config & Security & Logging

    CommentModel & TaskModel & UserModel -->|SQL| DatabaseDb
    AlembicIni & EnvPy & Versions -->|migrate schema| DatabaseDb

    %% Styling
    classDef presentation fill:#cfe2f3,stroke:#084a8f,color:#084a8f
    classDef logic fill:#d9ead3,stroke:#38761d,color:#274e13
    classDef storage fill:#fce5cd,stroke:#bb4603,color:#782e0f
    classDef infra fill:#ececec,stroke:#6d6d6d,color:#333333
    classDef external fill:#f0f0f0,stroke:#999999,color:#333333

    %% Click Events
    click Fnginx "https://github.com/iath-dev/task-manager-rpy/blob/main/frontend/nginx.conf"
    click TaskList "https://github.com/iath-dev/task-manager-rpy/tree/main/frontend/src/components/TaskList"
    click TaskForm "https://github.com/iath-dev/task-manager-rpy/tree/main/frontend/src/components/TaskForm"
    click Comments "https://github.com/iath-dev/task-manager-rpy/tree/main/frontend/src/components/Comments"
    click Users "https://github.com/iath-dev/task-manager-rpy/tree/main/frontend/src/components/Users"
    click SharedUI "https://github.com/iath-dev/task-manager-rpy/tree/main/frontend/src/components/ui"
    click AuthStore "https://github.com/iath-dev/task-manager-rpy/blob/main/frontend/src/store/authStore.ts"
    click TaskStore "https://github.com/iath-dev/task-manager-rpy/blob/main/frontend/src/store/taskStore.ts"
    click SidebarStore "https://github.com/iath-dev/task-manager-rpy/blob/main/frontend/src/store/sidebarStore.ts"
    click APIclient "https://github.com/iath-dev/task-manager-rpy/blob/main/frontend/src/services/api.ts"
    click TaskService "https://github.com/iath-dev/task-manager-rpy/blob/main/frontend/src/services/taskService.ts"
    click CommentService "https://github.com/iath-dev/task-manager-rpy/blob/main/frontend/src/services/commentService.ts"
    click UserService "https://github.com/iath-dev/task-manager-rpy/blob/main/frontend/src/services/userService.ts"
    click RoutesIndex "https://github.com/iath-dev/task-manager-rpy/blob/main/frontend/src/routes/index.tsx"
    click Loaders "https://github.com/iath-dev/task-manager-rpy/blob/main/frontend/src/routes/loaders.ts"
    click ProtectedRoute "https://github.com/iath-dev/task-manager-rpy/blob/main/frontend/src/routes/protected.tsx"
    click PublicRoute "https://github.com/iath-dev/task-manager-rpy/blob/main/frontend/src/routes/public.tsx"
    click AppLayout "https://github.com/iath-dev/task-manager-rpy/blob/main/frontend/src/layouts/AppLayout.tsx"
    click PagesDir "https://github.com/iath-dev/task-manager-rpy/tree/main/frontend/src/pages"
    click APIv1 "https://github.com/iath-dev/task-manager-rpy/blob/main/backend/app/api/v1/api.py"
    click AuthRouter "https://github.com/iath-dev/task-manager-rpy/blob/main/backend/app/api/routes/auth.py"
    click HealthRouter "https://github.com/iath-dev/task-manager-rpy/blob/main/backend/app/api/routes/health.py"
    click SeedRouter "https://github.com/iath-dev/task-manager-rpy/blob/main/backend/app/api/routes/seed.py"
    click TaskRouter "https://github.com/iath-dev/task-manager-rpy/blob/main/backend/app/api/routes/task.py"
    click UserRouter "https://github.com/iath-dev/task-manager-rpy/blob/main/backend/app/api/routes/user.py"
    click AuthService "https://github.com/iath-dev/task-manager-rpy/blob/main/backend/app/services/auth_service.py"
    click TaskServiceB "https://github.com/iath-dev/task-manager-rpy/blob/main/backend/app/services/task_service.py"
    click CommentServiceB "https://github.com/iath-dev/task-manager-rpy/blob/main/backend/app/services/comment_service.py"
    click UserServiceB "https://github.com/iath-dev/task-manager-rpy/blob/main/backend/app/services/user_service.py"
    click UserModel "https://github.com/iath-dev/task-manager-rpy/blob/main/backend/app/db/models/user.py"
    click TaskModel "https://github.com/iath-dev/task-manager-rpy/blob/main/backend/app/db/models/task.py"
    click CommentModel "https://github.com/iath-dev/task-manager-rpy/blob/main/backend/app/db/models/comment.py"
    click Session "https://github.com/iath-dev/task-manager-rpy/blob/main/backend/app/db/session.py"
    click BaseMeta "https://github.com/iath-dev/task-manager-rpy/blob/main/backend/app/db/base.py"
    click Config "https://github.com/iath-dev/task-manager-rpy/blob/main/backend/app/core/config.py"
    click Security "https://github.com/iath-dev/task-manager-rpy/blob/main/backend/app/core/security.py"
    click Logging "https://github.com/iath-dev/task-manager-rpy/blob/main/backend/app/core/logging.py"
    click AlembicIni "https://github.com/iath-dev/task-manager-rpy/blob/main/backend/alembic.ini"
    click EnvPy "https://github.com/iath-dev/task-manager-rpy/blob/main/backend/alembic/env.py"
    click Versions "https://github.com/iath-dev/task-manager-rpy/tree/main/backend/alembic/versions/"
    click DatabaseDb "https://github.com/iath-dev/task-manager-rpy/blob/main/backend/test.db"
    click dockerCompose "https://github.com/iath-dev/task-manager-rpy/blob/main/docker-compose.yml"
    click FrontendDockerfile "https://github.com/iath-dev/task-manager-rpy/tree/main/frontend/Dockerfile"
    click BackendDockerfile "https://github.com/iath-dev/task-manager-rpy/tree/main/backend/Dockerfile"
```
