How samarvishwakarma2006/bug-life works
BugLife is a real-time, multi-tenant bug tracker for collaborative teams. Users authenticate, work in projects, move bugs through a permission-checked lifecycle, and collaborate through comments, notifications, and live updates; resolving bugs can award XP and achievements. The client also provides analytics, team connections, attachments, and a public feedback landing page. The graph combines sampled calls, the source index, and documented capabilities; unsampled feature links are shown only where the README supports them.
Main entry points: App.tsx Application routes · bugService.ts Bug lifecycle · db.ts PostgreSQL database · Connections.tsx Connections view
Components 24
Web client
- Application routes
client/src/App.tsx - Authentication UI
client/src/pages/AuthPage.tsx - Projects workspace
client/src/pages/Project.tsx - Kanban board
client/src/components/board/Board.tsx - Bug details
client/src/pages/BugDetail.tsx - Connections view
client/src/pages/Connections.tsx - Landing feedback
client/src/components/landing/PostcardForm.tsx
API and domain
- Authentication routes
server/src/routes/auth.ts - Authentication handlers
server/src/controllers/authController.ts - Account authentication
server/src/services/authService.ts - Project management
server/src/routes/projects.ts - Project domain
server/src/services/projectService.ts - Bug endpoints
server/src/controllers/bugController.ts - Bug lifecycle
server/src/services/bugService.ts - PostgreSQL database
server/src/config/db.ts - File attachments
server/src/routes/attachments.ts - Feedback endpoint
server/src/routes/feedback.ts
Collaboration and rewards
- Live event transport
server/src/sockets/index.ts - Notifications
server/src/services/notificationService.ts - XP and achievements
server/src/services/xpService.ts
Insights and engagement
- Connections graph data
server/src/services/connectionsService.ts - Analytics dashboard
server/src/services/dashboardService.ts - Leaderboard
client/src/pages/Leaderboard.tsx
Other components
- Team member
Connections 28
- Team member → Application routes: uses
client/src/App.tsx - Application routes → Authentication UI: routes to
client/src/App.tsx - Application routes → Projects workspace: routes to
client/src/App.tsx - Application routes → Kanban board: hosts
- Application routes → Bug details: routes to
client/src/App.tsx - Application routes → Connections view: routes to
client/src/App.tsx - Team member → Authentication routes: authenticates
README.md - Authentication routes → Authentication handlers: dispatches
server/src/routes/auth.ts - Authentication handlers → Account authentication: calls
server/src/controllers/authController.ts - Account authentication → PostgreSQL database: reads and writes
server/src/services/authService.ts - Projects workspace → Project management: manages projects
- Project management → Project domain: dispatches
- Project domain → PostgreSQL database: reads and writes
server/src/services/projectService.ts - Kanban board → Bug endpoints: moves bugs
README.md - Bug details → Bug endpoints: manages bug details
- Bug endpoints → Bug lifecycle: calls
server/src/controllers/bugController.ts - Bug lifecycle → PostgreSQL database: updates lifecycle
server/src/services/bugService.ts - Bug lifecycle → Notifications: notifies members
server/src/services/bugService.ts - Bug lifecycle → XP and achievements: awards XP
server/src/services/bugService.ts - Bug lifecycle → Live event transport: queues events
server/src/services/bugService.ts - Bug lifecycle → File attachments: supports uploads
- Team member → Landing feedback: submits feedback
README.md - Landing feedback → Feedback endpoint: posts feedback
README.md - Connections view → Connections graph data: loads graph
README.md - Connections graph data → PostgreSQL database: queries scoped data
server/src/services/connectionsService.ts - Team member → Analytics dashboard: views metrics
- Team member → Leaderboard: views rankings
- Live event transport → Connections view: updates fixes
README.md