How b4f-cohort8-salamiyah/b4f-board-final works
B4F Board is a project-management application: users authenticate, organize work in workspaces and projects, manage issues through boards and sprints, and collaborate with comments, activity history, and notifications. The Next.js interface reaches NestJS through Server Actions and a typed server-only API client; the backend persists domain data with Prisma and PostgreSQL. The graph preserves README-described capabilities even where their source was not sampled. Arrows are limited to explicit README statements or shown calls/import references in the source index and excerpts.
Main entry points: src Nest API · prisma.service.ts Prisma service · issues.service.ts Issues and board · comments.service.ts Comments and mentions
Components 18
Web experience
- App routes
web/src/app - Domain UI
web/src/components
Server API bridge
- Server Actions
web/src/lib/actions - Typed API client
web/src/lib/api - Nest API
api/src
Identity and spaces
- Authentication
api/src/auth/auth.service.ts - Workspaces
api/src/workspaces/workspaces.service.ts - Workspace access
api/src/workspaces/workspace-access.service.ts - Users and profile
api/src/users/users.service.ts
Work planning
- Projects
api/src/projects/projects.service.ts - Issues and board
api/src/issues/issues.service.ts - Sprints and backlog
api/src/sprints/sprints.service.ts
Collaboration and platform
- Comments and mentions
api/src/comments/comments.service.ts - Activity history
api/src/activity/activity.service.ts - Notifications
api/src/notifications/notifications.service.ts - Prisma service
api/src/prisma/prisma.service.ts
Other components
- User
- PostgreSQL
Connections 32
- User → App routes: uses
README.md - App routes → Domain UI: renders
- App routes → Server Actions: invokes
- Server Actions → Typed API client: calls
README.md - Typed API client → Nest API: requests
README.md - Nest API → Authentication: routes to
api/src/auth/auth.controller.ts - Nest API → Workspaces: routes to
api/src/workspaces/workspaces.controller.ts - Nest API → Projects: routes to
api/src/projects/projects.controller.ts - Nest API → Issues and board: routes to
api/src/issues/issues.controller.ts - Nest API → Sprints and backlog: routes to
api/src/sprints/sprints.controller.ts - Nest API → Users and profile: routes to
api/src/users/users.controller.ts - Nest API → Notifications: routes to
api/src/notifications/notifications.controller.ts - Nest API → Comments and mentions: routes to
api/src/comments/comments.controller.ts - Workspaces → Activity history: records
api/src/workspaces/workspaces.service.ts - Comments and mentions → Activity history: records
api/src/comments/comments.service.ts - Comments and mentions → Notifications: notifies
api/src/comments/comments.service.ts - Issues and board → Activity history: records
api/src/issues/issues.service.ts - Issues and board → Notifications: notifies
api/src/issues/issues.service.ts - Sprints and backlog → Notifications: notifies
api/src/sprints/sprints.service.ts - Comments and mentions → Workspace access: checks access
api/src/comments/comments.service.ts - Issues and board → Workspace access: checks access
api/src/issues/issues.service.ts - Sprints and backlog → Workspace access: checks access
api/src/sprints/sprints.service.ts - Workspaces → Workspace access: uses
api/src/workspaces/workspaces.service.ts - Authentication → Prisma service: reads and writes
api/src/auth/auth.service.ts - Workspaces → Prisma service: reads and writes
api/src/workspaces/workspaces.service.ts - Projects → Prisma service: reads and writes
- Issues and board → Prisma service: reads and writes
api/src/issues/issues.service.ts - Sprints and backlog → Prisma service: reads and writes
api/src/sprints/sprints.service.ts - Comments and mentions → Prisma service: reads and writes
api/src/comments/comments.service.ts - Notifications → Prisma service: reads and writes
api/src/notifications/notifications.service.ts - Activity history → Prisma service: reads and writes
- Prisma service → PostgreSQL: persists data
README.md