How b4f-cohort8-salamiyah/b4f-cohort8-salamiyah-next-nest-bootcamp-2026 works
B4F Board is a Jira-style project-management application with a Next.js interface and a separate NestJS API. The user-facing workflow covers account registration/login, workspace setup and membership, project and issue management, and issue comments; the API also exposes activity, notifications, and user search. The sampled controllers show their service calls, while the README and application module identify the frontend/API split and PostgreSQL/Prisma direction. Some frontend-to-API wiring and unsampled domain implementations are not shown, so those links are omitted or documented only where supported.
Main entry points: main.ts NestJS API · auth.controller.ts Auth endpoints · app Next.js interface · auth.service.ts Authentication
Components 24
Web application
- Next.js interface
web/src/app - Registration page
web/src/app/register/page.tsx - Registration form
web/src/app/register/RegisterForm.tsx - Login page
web/src/app/login/page.tsx - Workspace screens
web/src/app/(app)/workspaces - Issue screens
web/src/app/(app)/workspaces/[id]/projects/[projectId]/issues/[issueId]/page.tsx
Identity and access
- Auth endpoints
api/src/auth/auth.controller.ts - Authentication
api/src/auth/auth.service.ts - User accounts
api/src/users/users.service.ts
Workspace and planning
- Workspace endpoints
api/src/workspaces/workspaces.controller.ts - Workspace management
api/src/workspaces/workspaces.service.ts - Member management
api/src/workspace-members/workspace-members.service.ts - Project endpoints
api/src/projects/projects.controller.ts - Project management
api/src/projects/projects.service.ts - Issue endpoints
api/src/issues/issues.controller.ts - Issue management
api/src/issues/issues.service.ts
Collaboration
- Comment endpoints
api/src/comments/comments.controller.ts - Issue comments
api/src/comments/comments.service.ts - Activity feed
api/src/activity/activity.service.ts - Notification endpoints
api/src/notifications/notifications.controller.ts - Notifications
api/src/notifications/notifications.service.ts
Other components
- Board user
- NestJS API
api/src/main.ts - PostgreSQL store
api/src/prisma/prisma.service.ts
Connections 15
- Board user → Next.js interface: uses
- Next.js interface → NestJS API: calls API
README.md - Registration page → Registration form: renders
web/src/app/register/page.tsx - NestJS API → Auth endpoints: routes
- Auth endpoints → Authentication: delegates to
api/src/auth/auth.controller.ts - Authentication → User accounts: uses
api/src/auth/auth.service.ts - Auth endpoints → User accounts: looks up user
api/src/auth/auth.controller.ts - Workspace screens → NestJS API: uses API
- Issue screens → NestJS API: uses API
- Workspace endpoints → Workspace management: delegates to
api/src/workspaces/workspaces.controller.ts - Project endpoints → Project management: delegates to
api/src/projects/projects.controller.ts - Issue endpoints → Issue management: delegates to
api/src/issues/issues.controller.ts - Comment endpoints → Issue comments: delegates to
api/src/comments/comments.controller.ts - Notification endpoints → Notifications: delegates to
api/src/notifications/notifications.controller.ts - NestJS API → PostgreSQL store: uses Prisma