How krisna-codes37/devtrace works
DevTrace is a debugging-journal web application. A developer signs in, creates and searches a debugging session, records hypotheses and experiments with evidence, then captures root cause, solution, and lessons; session details present the journey as a timeline and can request AI analysis. The client uses React Query hooks and Axios to call an Express API, which validates and authorizes requests before operating on MongoDB-backed records. Dashboard statistics and Gemini analysis are additional capabilities. Some client and backend modules were not sampled; those links are included only where the README or SOURCE INDEX supports them.
Main entry points: app.js Express API · App.jsx App routes · ai.controller.js Analysis controller · DebugSession.js Debug sessions
Components 31
Client experience
- App routes
client/src/App.jsx - Auth screens
client/src/pages/LoginPage.jsx - Session browser
client/src/pages/SessionsPage.jsx - Session form
client/src/components/SessionForm.jsx - Session details
client/src/pages/SessionDetailsPage.jsx - Journey timeline
client/src/hooks/useJourneyTimeline.js - Hypothesis section
client/src/components/HypothesisSection.jsx - Session queries
client/src/hooks/useSessions.js - API client
client/src/api/client.js - Session API
client/src/api/sessions.js
Investigation records
- Debug sessions
server/src/models/DebugSession.js - Hypotheses
server/src/models/Hypothesis.js - Experiments
server/src/models/Experiment.js - Session operations
server/src/controllers/session.controller.js - Hypothesis operations
server/src/controllers/hypothesis.controller.js - Experiment operations
server/src/controllers/experiment.controller.js
Identity and API
- Express API
server/src/app.js - Session routes
server/src/routes/session.routes.js - Hypothesis routes
server/src/routes/hypothesis.routes.js - Experiment routes
server/src/routes/experiment.routes.js - Auth routes
server/src/routes/auth.routes.js - Account operations
server/src/controllers/auth.controller.js - JWT authorization
server/src/middleware/auth.js - User records
server/src/models/User.js - Request validation
server/src/middleware/validate.js
Insights and integrations
- Dashboard statistics
server/src/controllers/dashboard.controller.js - AI analysis action
client/src/api/ai.js - Analysis controller
server/src/controllers/ai.controller.js - Gemini service
server/src/services/ai/gemini.js - Gemini API
Other components
- Developer
Connections 44
- Developer → App routes: uses
README.md - App routes → Auth screens: routes to
client/src/App.jsx - App routes → Session browser: routes to
client/src/App.jsx - App routes → Session form: routes to
client/src/App.jsx - App routes → Session details: routes to
client/src/App.jsx - Session browser → Session queries: queries
client/src/pages/SessionsPage.jsx - Session queries → Session API: calls
client/src/hooks/useSessions.js - Session form → Session API: submits
README.md - Session details → Journey timeline: loads
client/src/pages/SessionDetailsPage.jsx - Session details → Hypothesis section: renders
client/src/pages/SessionDetailsPage.jsx - API client → Express API: sends JSON
README.md - Session API → API client: uses
client/src/api/sessions.js - Express API → Session routes: mounts
server/src/app.js - Express API → Hypothesis routes: mounts
server/src/app.js - Express API → Experiment routes: mounts
server/src/app.js - Express API → Auth routes: mounts
server/src/app.js - Session routes → Session operations: dispatches
server/src/routes/session.routes.js - Hypothesis routes → Hypothesis operations: dispatches
server/src/routes/hypothesis.routes.js - Experiment routes → Experiment operations: dispatches
server/src/routes/experiment.routes.js - Auth routes → Account operations: dispatches
server/src/routes/auth.routes.js - Session routes → Request validation: validates
server/src/routes/session.routes.js - Hypothesis routes → Request validation: validates
server/src/routes/hypothesis.routes.js - Experiment routes → Request validation: validates
server/src/routes/experiment.routes.js - Session routes → JWT authorization: requires
server/src/routes/session.routes.js - Auth routes → JWT authorization: requires
server/src/routes/auth.routes.js - JWT authorization → User records: loads user
server/src/middleware/auth.js - Account operations → User records: manages
server/src/controllers/auth.controller.js - Session operations → Debug sessions: queries
server/src/controllers/session.controller.js - Session operations → Experiments: deletes children
server/src/controllers/session.controller.js - Session operations → Hypotheses: deletes children
server/src/controllers/session.controller.js - Hypothesis operations → Debug sessions: checks ownership
server/src/controllers/hypothesis.controller.js - Hypothesis operations → Hypotheses: manages
server/src/controllers/hypothesis.controller.js - Experiment operations → Hypotheses: checks parent
server/src/controllers/experiment.controller.js - Experiment operations → Debug sessions: checks ownership
server/src/controllers/experiment.controller.js - Experiment operations → Experiments: manages
server/src/controllers/experiment.controller.js - Dashboard statistics → Debug sessions: aggregates
README.md - Session details → AI analysis action: requests analysis
client/src/pages/SessionDetailsPage.jsx - AI analysis action → Express API: posts analysis
README.md - Express API → Analysis controller: routes analysis
server/src/app.js - Analysis controller → Debug sessions: reads investigation
server/src/controllers/ai.controller.js - Analysis controller → Hypotheses: reads investigation
server/src/controllers/ai.controller.js - Analysis controller → Experiments: reads investigation
server/src/controllers/ai.controller.js - Analysis controller → Gemini service: requests insights
server/src/controllers/ai.controller.js - Gemini service → Gemini API: calls
README.md