How chadisk/ticketflow works
TicketFlow is a helpdesk ticket dashboard: users create and inspect requests, search/filter/sort the queue, and move tickets between workflow statuses. The React dashboard manages ticket state through an API hook and client, while Express routes delegate validation and business rules to a service that accesses PostgreSQL through a model and connection pool. The README also documents Swagger API docs and database migrations. Edges reflect explicit README or source-index references and excerpts; unsampled implementation details are omitted.
Main entry points: Dashboard.jsx Dashboard · TicketForm.jsx Ticket form · TicketDetailModal.jsx Ticket details · Card.jsx Card primitives
Components 22
Ticket Dashboard
- React app
frontend/src/App.jsx - Dashboard
frontend/src/pages/Dashboard.jsx - Ticket state
frontend/src/hooks/useTickets.js - API client
frontend/src/services/api.js - Kanban board
frontend/src/components/TicketKanban.jsx - Ticket cards
frontend/src/components/TicketCard.jsx - Ticket form
frontend/src/components/TicketForm.jsx - Ticket details
frontend/src/components/TicketDetailModal.jsx - Card primitives
frontend/src/components/Card.jsx - Button primitive
frontend/src/components/Button.jsx - Input primitive
frontend/src/components/Input.jsx - Translations
frontend/src/i18n.js
Ticket API
- Express app
backend/src/app.js - Ticket routes
backend/src/routes/tickets.js - Ticket rules
backend/src/services/ticketService.js - Swagger docs
backend/src/app.js
Ticket Data
- Ticket queries
backend/src/models/ticketModel.js - Postgres pool
backend/src/db.js - Ticket schema
backend/database/migrations/001_create_tickets.sql
Other components
- Support user
- Browser
- PostgreSQL
Connections 25
- Support user → Dashboard: uses
README.md - React app → Dashboard: renders
frontend/src/App.jsx - React app → Translations: loads language
frontend/src/App.jsx - Dashboard → Ticket state: loads ticket state
frontend/src/pages/Dashboard.jsx - Dashboard → Kanban board: renders board
frontend/src/pages/Dashboard.jsx - Dashboard → Ticket form: renders form
frontend/src/pages/Dashboard.jsx - Dashboard → Ticket details: renders details
frontend/src/pages/Dashboard.jsx - Ticket state → API client: calls API
frontend/src/hooks/useTickets.js - Ticket state → Express app: requests tickets
README.md - Kanban board → Ticket cards: renders cards
frontend/src/components/TicketKanban.jsx - Ticket cards → Card primitives: uses card
frontend/src/components/TicketCard.jsx - Kanban board → Card primitives: uses card
frontend/src/components/TicketKanban.jsx - Ticket form → Button primitive: uses button
frontend/src/components/TicketForm.jsx - Ticket form → Card primitives: uses card
frontend/src/components/TicketForm.jsx - Ticket form → Input primitive: uses input
frontend/src/components/TicketForm.jsx - Ticket details → Card primitives: uses card
frontend/src/components/TicketDetailModal.jsx - Ticket details → Button primitive: uses button
frontend/src/components/TicketDetailModal.jsx - Ticket details → Ticket cards: uses badge
frontend/src/components/TicketDetailModal.jsx - Ticket routes → Ticket rules: delegates
backend/src/routes/tickets.js - Express app → Ticket routes: mounts routes
backend/src/app.js - Express app → Swagger docs: mounts docs
README.md - Ticket rules → Ticket queries: calls queries
backend/src/services/ticketService.js - Ticket queries → Postgres pool: uses pool
backend/src/models/ticketModel.js - Postgres pool → PostgreSQL: connects
- Ticket schema → PostgreSQL: defines schema
README.md