How suongranet/fixflow works
FixFlow is an IT support ticket management system. Users authenticate, create and track tickets, and support staff manage assignments and status; tickets can carry comments and attachments, with notifications and dashboard reporting alongside that workflow. The frontend routes these experiences and makes API requests, while the Express backend mounts domain routes and separates controllers from services. The tree and excerpts establish several frontend and backend links; storage and some domain-service wiring are unsampled, so uncertain connections are omitted or dashed.
Main entry points: app.ts API route mounting · router.tsx App routes · ticket.controller.ts Ticket management · ticketAttachment.controller.ts Ticket attachments
Components 26
Frontend
- Web application
frontend/src/main.tsx - App routes
frontend/src/App/router.tsx - Sign-in pages
frontend/src/features/auth/pages/LoginPage.tsx - Ticket views
frontend/src/features/tickets/pages/TicketsPage.tsx - Ticket detail
frontend/src/features/tickets/pages/TicketDetailPage.tsx - Dashboard view
frontend/src/features/dashboard/pages/DashboardPage.tsx - Notification view
frontend/src/features/notifications/pages/NotificationsPage.tsx - User administration
frontend/src/features/users/pages/UsersPage.tsx - API request hook
frontend/src/hooks/useApiRequest.ts - HTTP client
frontend/src/lib/axios.ts - Auth state
frontend/src/stores/auth.store.ts
Identity and users
- Authentication
backend/src/modules/auth/auth.controller.ts - User management
backend/src/modules/user/user.controller.ts
Ticket operations
- Ticket management
backend/src/modules/tickets/ticket.controller.ts - Ticket comments
backend/src/modules/tickets_comments/ticket-comment.controller.ts - Ticket attachments
backend/src/modules/ticket-attachment/ticketAttachment.controller.ts
Support features
- Categories
backend/src/modules/category/category.controller.ts - Departments
backend/src/modules/department/department.controller.ts - Notifications
backend/src/modules/notification/notification.controller.ts - Dashboard reporting
backend/src/modules/Dashboard/admin.controller.ts
Backend platform
- API route mounting
backend/src/app.ts - Authentication middleware
backend/src/middleware/auth.middleware.ts - Realtime events
backend/src/realtime/broadcast.ts - Database connection
backend/src/config/db.ts
Other components
- User
- Cloudinary storage
Connections 34
- User → Web application: uses
README.md - Web application → App routes: mounts
frontend/src/main.tsx - App routes → Sign-in pages: routes to
frontend/src/App/router.tsx - App routes → Ticket views: routes to
frontend/src/App/router.tsx - App routes → Ticket detail: routes to
frontend/src/App/router.tsx - App routes → Dashboard view: routes to
frontend/src/App/router.tsx - App routes → Notification view: routes to
frontend/src/App/router.tsx - App routes → User administration: routes to
frontend/src/App/router.tsx - Ticket views → API request hook: uses
frontend/src/features/tickets/pages/TicketsPage.tsx - Ticket views → Ticket detail: opens
- Dashboard view → API request hook: uses
frontend/src/features/dashboard/pages/DashboardPage.tsx - User administration → API request hook: uses
frontend/src/features/users/pages/UsersPage.tsx - API request hook → HTTP client: calls
frontend/src/hooks/useApiRequest.ts - Sign-in pages → Auth state: updates
- HTTP client → API route mounting: requests
- API route mounting → Authentication: mounts
backend/src/app.ts - API route mounting → User management: mounts
backend/src/app.ts - API route mounting → Ticket management: mounts
backend/src/app.ts - API route mounting → Ticket comments: mounts
backend/src/app.ts - API route mounting → Ticket attachments: mounts
backend/src/app.ts - API route mounting → Notifications: mounts
backend/src/app.ts - API route mounting → Dashboard reporting: mounts
backend/src/app.ts - API route mounting → Categories: mounts
backend/src/app.ts - API route mounting → Departments: mounts
backend/src/app.ts - Ticket management → Database connection: accesses
- Ticket management → Ticket attachments: supports attachments
- Ticket attachments → Cloudinary storage: uploads to
- Authentication → Database connection: accesses
- Ticket comments → Realtime events: broadcasts via
- Ticket management → Ticket management: delegates to service
backend/src/modules/tickets/ticket.controller.ts - Authentication → Authentication: delegates to service
backend/src/modules/auth/auth.controller.ts - Notifications → Notifications: delegates to service
backend/src/modules/notification/notification.controller.ts - Ticket attachments → Ticket attachments: delegates to service
backend/src/modules/ticket-attachment/ticketAttachment.controller.ts - Dashboard reporting → Dashboard reporting: delegates to service
backend/src/modules/Dashboard/admin.controller.ts