How anujpatel7181/task-management-ror works
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: user.rb User Identity · task.rb Task Hierarchy · application_controller.rb API Base Controller · project.rb Project
Components 20
Access Control
- OAuth2 Token API
config/routes.rb - API Base Controller
app/controllers/application_controller.rb - RBAC Rules
app/models/ability.rb
REST API
- Users API
app/controllers/api/v1/users_controller.rb - Profiles API
app/controllers/api/v1/profiles_controller.rb - Projects API
app/controllers/api/v1/projects_controller.rb - Tasks API
app/controllers/api/v1/tasks_controller.rb - Comments API
app/controllers/api/v1/comments_controller.rb - Avatar Uploads
app/controllers/api/v1/attachments/avatars_controller.rb - Task Documents
app/controllers/api/v1/attachments/task_documents_controller.rb
Work Domain
- User Identity
app/models/user.rb - User Profile
app/models/profile.rb - Project
app/models/project.rb - Task Hierarchy
app/models/task.rb - Polymorphic Comments
app/models/comment.rb - JSON Serializers
app/serializers
Persistence and Files
- PostgreSQL
- Active Storage
db/migrate/20260928051100_create_active_storage_tables.active_storage.rb
Other components
- API Client
- File Storage Service
Connections 34
- 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
app/controllers/api/v1/attachments/avatars_controller.rb - API Client → Task Documents: uploads files
app/controllers/api/v1/attachments/task_documents_controller.rb - Users API → API Base Controller: inherits from
app/controllers/api/v1/users_controller.rb - Projects API → API Base Controller: inherits from
app/controllers/api/v1/projects_controller.rb - Tasks API → API Base Controller: inherits from
app/controllers/api/v1/tasks_controller.rb - Avatar Uploads → API Base Controller: inherits from
app/controllers/api/v1/attachments/avatars_controller.rb - Task Documents → API Base Controller: inherits from
app/controllers/api/v1/attachments/task_documents_controller.rb - Users API → User Identity: serializes user
app/controllers/api/v1/users_controller.rb - Projects API → JSON Serializers: serializes projects
app/controllers/api/v1/projects_controller.rb - Tasks API → JSON Serializers: serializes tasks
app/controllers/api/v1/tasks_controller.rb - API Base Controller → RBAC Rules: checks authorization
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
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
app/controllers/api/v1/attachments/avatars_controller.rb - Task Documents → Active Storage: attaches documents
app/controllers/api/v1/attachments/task_documents_controller.rb - Active Storage → File Storage Service: stores files