How somaiyassine/tasks-api works
tasks-api is an Express REST API for accounts, project ownership, and task tracking. Clients register or log in, then use a JWT to access protected project and task operations; role and ownership checks govern visibility and changes. Controllers implement CRUD, filtering, assignment, and project-deletion cleanup over MongoDB models, with shared query helpers for search and sorting. The README documents the full route capabilities; some controllers and database wiring were not excerpted, so only documented or indexed relationships are shown.
Main entry points: app.js Express application · taskController.js Task operations · authRoutes.js Auth routes · taskRoutes.js Task routes
Components 17
HTTP API
- Express application
src/app.js - Auth routes
src/routes/authRoutes.js - Project routes
src/routes/projectRoutes.js - Task routes
src/routes/taskRoutes.js - Error handling
src/middlewares/errorHandler.js - Server startup
src/server.js
Identity and Access
- Account operations
src/controllers/authController.js - JWT authentication
src/middlewares/auth.js - Role access
src/middlewares/roles.js - User records
src/models/User.js
Project Management
- Project operations
src/controllers/projectController.js - Project records
src/models/Project.js
Task Management
- Task operations
src/controllers/taskController.js - Task records
src/models/Task.js
Persistence and Query
- Search and sorting
src/utils/query.js - MongoDB connection
src/config/db.js
Other components
- API client
Connections 24
- API client → Express application: sends requests
src/app.js - Express application → Auth routes: mounts routes
src/app.js - Express application → Project routes: mounts routes
src/app.js - Express application → Task routes: mounts routes
src/app.js - Express application → Error handling: forwards errors
src/app.js - Auth routes → Account operations: dispatches requests
src/routes/authRoutes.js - Project routes → Project operations: dispatches requests
src/routes/projectRoutes.js - Task routes → Task operations: dispatches requests
src/routes/taskRoutes.js - Auth routes → JWT authentication: protects profile
src/routes/authRoutes.js - Project routes → JWT authentication: protects routes
src/routes/projectRoutes.js - Task routes → JWT authentication: protects routes
src/routes/taskRoutes.js - Auth routes → Role access: restricts users
src/routes/authRoutes.js - Task routes → Role access: restricts assignment
src/routes/taskRoutes.js - Account operations → User records: reads and writes
src/controllers/authController.js - JWT authentication → User records: loads identity
src/middlewares/auth.js - Project operations → Project records: reads and writes
src/controllers/projectController.js - Project operations → Task records: deletes project tasks
src/controllers/projectController.js - Project operations → Search and sorting: builds list queries
src/controllers/projectController.js - Task operations → Task records: reads and writes
src/controllers/taskController.js - Task operations → Project records: checks project access
src/controllers/taskController.js - Task operations → User records: checks assignees
src/controllers/taskController.js - Task operations → Search and sorting: builds list queries
src/controllers/taskController.js - Server startup → Express application: starts app
src/server.js - Server startup → MongoDB connection: connects database
src/server.js