# anujpatel7181/task-management-ror architecture

> Architecture diagram of the GitHub repository anujpatel7181/task-management-ror, 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/anujpatel7181/task-management-ror
- Repository: https://github.com/anujpatel7181/task-management-ror

## Overview

Rails API Learning Hub is an API-only project and work-management reference app. A client obtains an OAuth2 bearer token, then calls versioned endpoints to manage users, profiles, projects, tasks, comments, and attachments; controllers authorize requests and return serialized JSON. The documented product also includes role-based access, task hierarchies, and multi-file storage. The graph uses README-documented relationships where controller excerpts are unavailable; it does not infer unshown controller-to-model calls.

Main entry points: [`app/models/user.rb`](https://github.com/anujpatel7181/task-management-ror/blob/main/app/models/user.rb) (User Identity), [`app/models/task.rb`](https://github.com/anujpatel7181/task-management-ror/blob/main/app/models/task.rb) (Task Hierarchy), [`app/controllers/application_controller.rb`](https://github.com/anujpatel7181/task-management-ror/blob/main/app/controllers/application_controller.rb) (API Base Controller), [`app/models/project.rb`](https://github.com/anujpatel7181/task-management-ror/blob/main/app/models/project.rb) (Project)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access Control"]
  node_oauth["OAuth2 Token API<br/>[routes.rb]"]
  node_base["API Base Controller"]
  node_ability["RBAC Rules<br/>[ability.rb]"]
end

subgraph group_api["REST API"]
  node_users_api["Users API"]
  node_profiles_api["Profiles API"]
  node_projects_api["Projects API"]
  node_tasks_api["Tasks API"]
  node_comments_api["Comments API"]
  node_avatars_api["Avatar Uploads"]
  node_documents_api["Task Documents"]
end

subgraph group_domain["Work Domain"]
  node_user["User Identity<br/>[user.rb]"]
  node_profile["User Profile<br/>[profile.rb]"]
  node_project["Project<br/>[project.rb]"]
  node_task["Task Hierarchy<br/>[task.rb]"]
  node_comment["Polymorphic Comments<br/>[comment.rb]"]
  node_serializers["JSON Serializers"]
end

subgraph group_persistence["Persistence and Files"]
  node_postgres[("PostgreSQL")]
  node_active_storage[("Active Storage")]
end

node_client(("API Client"))
node_file_service["File Storage Service"]

node_client -->|"requests token"| node_oauth
node_oauth -->|"returns bearer token"| node_client
node_client -->|"sends API requests"| node_users_api
node_client -->|"sends API requests"| node_profiles_api
node_client -->|"sends API requests"| node_projects_api
node_client -->|"sends API requests"| node_tasks_api
node_client -->|"sends API requests"| node_comments_api
node_client -->|"uploads files"| node_avatars_api
node_client -->|"uploads files"| node_documents_api
node_users_api -->|"inherits from"| node_base
node_projects_api -->|"inherits from"| node_base
node_tasks_api -->|"inherits from"| node_base
node_avatars_api -->|"inherits from"| node_base
node_documents_api -->|"inherits from"| node_base
node_users_api -->|"serializes user"| node_user
node_projects_api -->|"serializes projects"| node_serializers
node_tasks_api -->|"serializes tasks"| node_serializers
node_base -->|"checks authorization"| node_ability
node_user -->|"has one"| node_profile
node_user -->|"owns projects"| node_project
node_project -->|"has tasks"| node_task
node_task -->|"has subtasks"| node_task
node_user -->|"assigned tasks"| node_task
node_user -->|"authors comments"| node_comment
node_project -->|"has comments"| node_comment
node_task -->|"has comments"| node_comment
node_user -->|"persists records"| node_postgres
node_profile -->|"persists records"| node_postgres
node_project -->|"persists records"| node_postgres
node_task -->|"persists records"| node_postgres
node_comment -->|"persists records"| node_postgres
node_avatars_api -->|"attaches avatars"| node_active_storage
node_documents_api -->|"attaches documents"| node_active_storage
node_active_storage -->|"stores files"| node_file_service

click node_oauth "https://github.com/anujpatel7181/task-management-ror/blob/main/config/routes.rb"
click node_base "https://github.com/anujpatel7181/task-management-ror/blob/main/app/controllers/application_controller.rb"
click node_ability "https://github.com/anujpatel7181/task-management-ror/blob/main/app/models/ability.rb"
click node_users_api "https://github.com/anujpatel7181/task-management-ror/blob/main/app/controllers/api/v1/users_controller.rb"
click node_profiles_api "https://github.com/anujpatel7181/task-management-ror/blob/main/app/controllers/api/v1/profiles_controller.rb"
click node_projects_api "https://github.com/anujpatel7181/task-management-ror/blob/main/app/controllers/api/v1/projects_controller.rb"
click node_tasks_api "https://github.com/anujpatel7181/task-management-ror/blob/main/app/controllers/api/v1/tasks_controller.rb"
click node_comments_api "https://github.com/anujpatel7181/task-management-ror/blob/main/app/controllers/api/v1/comments_controller.rb"
click node_avatars_api "https://github.com/anujpatel7181/task-management-ror/blob/main/app/controllers/api/v1/attachments/avatars_controller.rb"
click node_documents_api "https://github.com/anujpatel7181/task-management-ror/blob/main/app/controllers/api/v1/attachments/task_documents_controller.rb"
click node_user "https://github.com/anujpatel7181/task-management-ror/blob/main/app/models/user.rb"
click node_profile "https://github.com/anujpatel7181/task-management-ror/blob/main/app/models/profile.rb"
click node_project "https://github.com/anujpatel7181/task-management-ror/blob/main/app/models/project.rb"
click node_task "https://github.com/anujpatel7181/task-management-ror/blob/main/app/models/task.rb"
click node_comment "https://github.com/anujpatel7181/task-management-ror/blob/main/app/models/comment.rb"
click node_serializers "https://github.com/anujpatel7181/task-management-ror/tree/main/app/serializers"
click node_active_storage "https://github.com/anujpatel7181/task-management-ror/blob/main/db/migrate/20260928051100_create_active_storage_tables.active_storage.rb"

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_oauth,node_base,node_ability,node_client toneBlue
class node_users_api,node_profiles_api,node_projects_api,node_tasks_api,node_comments_api,node_avatars_api,node_documents_api,node_file_service toneAmber
class node_user,node_profile,node_project,node_task,node_comment,node_serializers toneMint
class node_postgres,node_active_storage toneRose
```

## Components

### Access Control

- [OAuth2 Token API](https://github.com/anujpatel7181/task-management-ror/blob/main/config/routes.rb): `config/routes.rb`
- [API Base Controller](https://github.com/anujpatel7181/task-management-ror/blob/main/app/controllers/application_controller.rb): `app/controllers/application_controller.rb`
- [RBAC Rules](https://github.com/anujpatel7181/task-management-ror/blob/main/app/models/ability.rb): `app/models/ability.rb`

### REST API

- [Users API](https://github.com/anujpatel7181/task-management-ror/blob/main/app/controllers/api/v1/users_controller.rb): `app/controllers/api/v1/users_controller.rb`
- [Profiles API](https://github.com/anujpatel7181/task-management-ror/blob/main/app/controllers/api/v1/profiles_controller.rb): `app/controllers/api/v1/profiles_controller.rb`
- [Projects API](https://github.com/anujpatel7181/task-management-ror/blob/main/app/controllers/api/v1/projects_controller.rb): `app/controllers/api/v1/projects_controller.rb`
- [Tasks API](https://github.com/anujpatel7181/task-management-ror/blob/main/app/controllers/api/v1/tasks_controller.rb): `app/controllers/api/v1/tasks_controller.rb`
- [Comments API](https://github.com/anujpatel7181/task-management-ror/blob/main/app/controllers/api/v1/comments_controller.rb): `app/controllers/api/v1/comments_controller.rb`
- [Avatar Uploads](https://github.com/anujpatel7181/task-management-ror/blob/main/app/controllers/api/v1/attachments/avatars_controller.rb): `app/controllers/api/v1/attachments/avatars_controller.rb`
- [Task Documents](https://github.com/anujpatel7181/task-management-ror/blob/main/app/controllers/api/v1/attachments/task_documents_controller.rb): `app/controllers/api/v1/attachments/task_documents_controller.rb`

### Work Domain

- [User Identity](https://github.com/anujpatel7181/task-management-ror/blob/main/app/models/user.rb): `app/models/user.rb`
- [User Profile](https://github.com/anujpatel7181/task-management-ror/blob/main/app/models/profile.rb): `app/models/profile.rb`
- [Project](https://github.com/anujpatel7181/task-management-ror/blob/main/app/models/project.rb): `app/models/project.rb`
- [Task Hierarchy](https://github.com/anujpatel7181/task-management-ror/blob/main/app/models/task.rb): `app/models/task.rb`
- [Polymorphic Comments](https://github.com/anujpatel7181/task-management-ror/blob/main/app/models/comment.rb): `app/models/comment.rb`
- [JSON Serializers](https://github.com/anujpatel7181/task-management-ror/tree/main/app/serializers): `app/serializers`

### Persistence and Files

- **PostgreSQL**
- [Active Storage](https://github.com/anujpatel7181/task-management-ror/blob/main/db/migrate/20260928051100_create_active_storage_tables.active_storage.rb): `db/migrate/20260928051100_create_active_storage_tables.active_storage.rb`

### Other components

- **API Client**
- **File Storage Service**

## Connections

- API Client → OAuth2 Token API: requests token
- OAuth2 Token API → API Client: returns bearer token
- API Client → Users API: sends API requests
- API Client → Profiles API: sends API requests
- API Client → Projects API: sends API requests
- API Client → Tasks API: sends API requests
- API Client → Comments API: sends API requests
- API Client → Avatar Uploads: uploads files (evidence: `app/controllers/api/v1/attachments/avatars_controller.rb`)
- API Client → Task Documents: uploads files (evidence: `app/controllers/api/v1/attachments/task_documents_controller.rb`)
- Users API → API Base Controller: inherits from (evidence: `app/controllers/api/v1/users_controller.rb`)
- Projects API → API Base Controller: inherits from (evidence: `app/controllers/api/v1/projects_controller.rb`)
- Tasks API → API Base Controller: inherits from (evidence: `app/controllers/api/v1/tasks_controller.rb`)
- Avatar Uploads → API Base Controller: inherits from (evidence: `app/controllers/api/v1/attachments/avatars_controller.rb`)
- Task Documents → API Base Controller: inherits from (evidence: `app/controllers/api/v1/attachments/task_documents_controller.rb`)
- Users API → User Identity: serializes user (evidence: `app/controllers/api/v1/users_controller.rb`)
- Projects API → JSON Serializers: serializes projects (evidence: `app/controllers/api/v1/projects_controller.rb`)
- Tasks API → JSON Serializers: serializes tasks (evidence: `app/controllers/api/v1/tasks_controller.rb`)
- API Base Controller → RBAC Rules: checks authorization (evidence: `app/controllers/application_controller.rb`)
- User Identity → User Profile: has one
- User Identity → Project: owns projects
- Project → Task Hierarchy: has tasks
- Task Hierarchy → Task Hierarchy: has subtasks (evidence: `app/models/task.rb`)
- User Identity → Task Hierarchy: assigned tasks
- User Identity → Polymorphic Comments: authors comments
- Project → Polymorphic Comments: has comments
- Task Hierarchy → Polymorphic Comments: has comments
- User Identity → PostgreSQL: persists records
- User Profile → PostgreSQL: persists records
- Project → PostgreSQL: persists records
- Task Hierarchy → PostgreSQL: persists records
- Polymorphic Comments → PostgreSQL: persists records
- Avatar Uploads → Active Storage: attaches avatars (evidence: `app/controllers/api/v1/attachments/avatars_controller.rb`)
- Task Documents → Active Storage: attaches documents (evidence: `app/controllers/api/v1/attachments/task_documents_controller.rb`)
- Active Storage → File Storage Service: stores files
