How fresh-mc/tracker works
Tracker KPR is a team project-management platform. Users authenticate, enter protected dashboards, and work with teams, projects, and assigned tasks; the API persists application data and supports analytics, AI reports, GitHub integration, and team chat. Groups distinguish the React experience, Express API, domain operations, and persistence/integrations. Edges reflect excerpts, the SOURCE INDEX, or README statements; unsampled implementations are represented only where the documented capability and tree support them.
Main entry points: App.jsx React application · server.js API application · aiController.js AI and report operations · aiService.js AI insights service
Components 34
React application
- React application
frontend/src/App.jsx - Authentication state
frontend/src/context/AuthContext.jsx - Login and OAuth callback
frontend/src/pages/AnimatedLogin.jsx - Team dashboard
frontend/src/pages/TeamDashboard.jsx - Project planning
frontend/src/pages/ProjectPlan.jsx - Team chat
frontend/src/pages/Chat.jsx - Analytics dashboards
frontend/src/pages/AnalyticsDashboard.jsx - Project analytics
frontend/src/pages/ProjectAnalytics.jsx - Team analytics
frontend/src/pages/TeamAnalytics.jsx - AI insights
frontend/src/pages/AIInsights.jsx - Realtime socket client
frontend/src/hooks/useSocket.js
Express API
- API application
server/src/server.js - Authentication routes
server/src/routes/authRoutes.js - Project routes
server/src/routes/projectRoutes.js - Team routes
server/src/routes/teamRoutes.js - Task routes
server/src/routes/taskRoutes.js - AI and report routes
server/src/routes/aiRoutes.js
Domain services
- Authentication operations
server/src/controllers/authController.js - Project operations
server/src/controllers/projectController.js - Team operations
server/src/controllers/teamController.js - Task operations
server/src/controllers/taskController.js - Analytics operations
server/src/controllers/analyticsController.js - AI and report operations
server/src/controllers/aiController.js - AI insights service
server/src/services/aiService.js - Report generation
server/src/services/reportService.js
Persistence and integrations
- Project and team records
server/src/models/Project.js - Task records
server/src/models/Task.js - User records
server/src/models/User.js - Report cache
server/src/models/ReportCache.js - MongoDB
- Google Gemini
- GitHub
- Socket.IO chat service
Other components
- User
Connections 37
- User → React application: uses
README.md - React application → Login and OAuth callback: routes to
frontend/src/App.jsx - React application → Team dashboard: routes to
frontend/src/App.jsx - React application → Project planning: routes to
frontend/src/App.jsx - React application → Team chat: routes to
frontend/src/App.jsx - React application → Analytics dashboards: routes to
frontend/src/App.jsx - React application → Project analytics: routes to
frontend/src/App.jsx - React application → Team analytics: routes to
frontend/src/App.jsx - React application → AI insights: routes to
frontend/src/App.jsx - Login and OAuth callback → Authentication state: uses
frontend/src/pages/AnimatedLogin.jsx - Authentication state → Authentication routes: authenticates through
- React application → API application: uses REST API
README.md - API application → Authentication routes: mounts
server/src/server.js - API application → Project routes: mounts
server/src/server.js - API application → Team routes: mounts
server/src/server.js - API application → Task routes: mounts
server/src/server.js - API application → AI and report routes: mounts
server/src/server.js - Authentication routes → Authentication operations: dispatches
- Project routes → Project operations: dispatches
server/src/routes/projectRoutes.js - Team routes → Team operations: dispatches
server/src/routes/teamRoutes.js - Task routes → Task operations: dispatches
- AI and report routes → AI and report operations: dispatches
server/src/routes/aiRoutes.js - Project operations → Project and team records: reads and writes
server/src/controllers/projectController.js - Team operations → Project and team records: reads and writes
server/src/controllers/teamController.js - Team operations → User records: updates members
server/src/controllers/teamController.js - Task operations → Task records: reads and writes
- Analytics operations → Project and team records: analyzes
- AI and report operations → AI insights service: requests insights
server/src/controllers/aiController.js - AI and report operations → Report generation: generates reports
server/src/controllers/aiController.js - AI and report operations → Report cache: caches reports
server/src/controllers/aiController.js - AI insights service → Google Gemini: generates content
server/src/services/aiService.js - AI insights service → User records: reads user data
server/src/services/aiService.js - AI insights service → Project and team records: reads projects
server/src/services/aiService.js - API application → MongoDB: connects to
server/src/server.js - React application → Socket.IO chat service: connects for chat
README.md - Realtime socket client → User: delivers live updates
frontend/src/hooks/useSocket.js - React application → GitHub: syncs GitHub data