How viveksyal/kanban-board works
Kanban-Board is a backend API for user accounts and managing boards, lists, and cards. The main workflow is an authenticated client request routed through validation and authentication middleware to a domain controller, then a service that reads or changes persisted data and returns a response. The graph shows those layers and the ordering features exposed for lists and cards. Source excerpts and the SOURCE INDEX support the links shown; the README itself provides no further capability details, and unsampled implementation details are not inferred.
Main entry points: app.ts Express app · auth.routes.ts Auth routes · board.routes.ts Board routes · list.routes.ts List routes
Components 26
API entry and routing
- Express app
backend/src/app.ts - Auth routes
backend/src/routes/auth.routes.ts - Board routes
backend/src/routes/board.routes.ts - List routes
backend/src/routes/list.routes.ts - Card routes
backend/src/routes/card.routes.ts
Kanban domain
- Auth controller
backend/src/controllers/auth.controller.ts - Board controller
backend/src/controllers/board.controller.ts - List controller
backend/src/controllers/list.controller.ts - Card controller
backend/src/controllers/card.controller.ts - Auth service
backend/src/services/auth.service.ts - Board service
backend/src/services/board.service.ts - List service
backend/src/services/list.service.ts - Card service
backend/src/services/card.service.ts
Identity and request checks
- Authentication
backend/src/middlewares/auth.middleware.ts - Request validation
backend/src/middlewares/validate.middleware.ts - Auth schemas
backend/src/validators/auth.validator.ts - Board schemas
backend/src/validators/board.validator.ts - List schemas
backend/src/validators/list.validator.ts - Card schemas
backend/src/validators/card.validator.ts - Error handler
backend/src/middlewares/error.middleware.ts
Persistence and utilities
- Prisma client
backend/src/lib/prisma.ts - PostgreSQL
- Password hashing
backend/src/utils/hash.utils.ts - JWT utilities
backend/src/utils/jwt.utils.ts - App errors
backend/src/utils/error.utils.ts
Other components
- API client
Connections 39
- API client → Express app: sends requests
backend/src/app.ts - Express app → Auth routes: mounts routes
backend/src/app.ts - Express app → Board routes: mounts routes
backend/src/app.ts - Express app → List routes: mounts routes
backend/src/app.ts - Express app → Card routes: mounts routes
backend/src/app.ts - Express app → Error handler: handles errors
backend/src/app.ts - Auth routes → Auth controller: dispatches to
backend/src/routes/auth.routes.ts - Board routes → Board controller: dispatches to
backend/src/routes/board.routes.ts - List routes → List controller: dispatches to
backend/src/routes/list.routes.ts - Card routes → Card controller: dispatches to
backend/src/routes/card.routes.ts - Auth routes → Request validation: validates with
backend/src/routes/auth.routes.ts - Board routes → Request validation: validates with
backend/src/routes/board.routes.ts - List routes → Request validation: validates with
backend/src/routes/list.routes.ts - Card routes → Request validation: validates with
backend/src/routes/card.routes.ts - Auth routes → Auth schemas: uses schemas
backend/src/routes/auth.routes.ts - Board routes → Board schemas: uses schemas
backend/src/routes/board.routes.ts - List routes → List schemas: uses schemas
backend/src/routes/list.routes.ts - Card routes → Card schemas: uses schemas
backend/src/routes/card.routes.ts - Auth routes → Authentication: protects endpoints
backend/src/routes/auth.routes.ts - Board routes → Authentication: protects endpoints
backend/src/routes/board.routes.ts - List routes → Authentication: protects endpoints
backend/src/routes/list.routes.ts - Card routes → Authentication: protects endpoints
backend/src/routes/card.routes.ts - Auth controller → Auth service: calls
backend/src/controllers/auth.controller.ts - Board controller → Board service: calls
backend/src/controllers/board.controller.ts - List controller → List service: calls
backend/src/controllers/list.controller.ts - Card controller → Card service: calls
backend/src/controllers/card.controller.ts - Auth service → Prisma client: queries data
backend/src/services/auth.service.ts - Board service → Prisma client: queries data
backend/src/services/board.service.ts - List service → Prisma client: queries data
backend/src/services/list.service.ts - Card service → Prisma client: queries data
backend/src/services/card.service.ts - Prisma client → PostgreSQL: connects to
backend/src/lib/prisma.ts - Auth service → Password hashing: hashes passwords
backend/src/services/auth.service.ts - Auth service → JWT utilities: signs tokens
backend/src/services/auth.service.ts - Authentication → JWT utilities: verifies tokens
backend/src/middlewares/auth.middleware.ts - Auth service → App errors: creates errors
backend/src/services/auth.service.ts - Board service → App errors: creates errors
backend/src/services/board.service.ts - List service → App errors: creates errors
backend/src/services/list.service.ts - Card service → App errors: creates errors
backend/src/services/card.service.ts - Error handler → App errors: handles app errors
backend/src/middlewares/error.middleware.ts