How mlamine300/open-tickets works
OpenTickets is a claims-management platform for handling tickets between company agencies and internal services. Users enter through the React application, which exposes ticket creation, tracking, search and dashboards; API routes dispatch requests to domain controllers, which apply ticket and organization rules and persist data in MongoDB. Separate branches cover authentication, administration, custom forms, useful links, announcements and BI reporting. The README documents these capabilities; unsampled modules are represented by their exact tree paths, but their internal calls are not inferred.
Main entry points: app.ts Express application · App.tsx Application routes · ticketController.ts Ticket workflows · biController.ts BI reporting
Components 32
Web application
- Application routes
frontend/src/App.tsx - Dashboard
frontend/src/page/Dashboard.tsx - Ticket pages
frontend/src/page/tickets/TicketsPage.tsx - Form pages
frontend/src/page/forms/AddFormPage.tsx - Organisation pages
frontend/src/page/organisations/AddOrganisation.tsx - User administration
frontend/src/page/users/AddEditUserPage.tsx - Useful links pages
frontend/src/page/usefulLinks/AddUsefulLinkPage.tsx - Announcement page
frontend/src/page/alert/AlertPage.tsx - Ticket search
frontend/src/page/search/SearchPage.tsx
API and workflows
- Express application
backend/src/app.ts - Ticket routes
backend/src/routes/ticketRoutes.ts - Ticket workflows
backend/src/controllers/ticketController.ts - Custom forms
backend/src/controllers/formControllers.ts - Organisation management
backend/src/controllers/organisationController.ts - Ticket comments
backend/src/controllers/commentController.ts - Claim categories
backend/src/controllers/motifController.ts - Useful links
backend/src/controllers/useFulLinksController.ts - Announcements and info
backend/src/controllers/infoController.ts
Identity and access
- Authentication routes
backend/src/routes/authRoutes.ts - Authentication
backend/src/controllers/authController.ts - JWT access checks
backend/src/middlewares/authMiddleware.ts - User management
backend/src/controllers/userController.ts
Persistence and analytics
- MongoDB
backend/src/config/db.ts - Ticket records
backend/src/models/Ticket.ts - User records
backend/src/models/User.ts - Organisation records
backend/src/models/Organisation.ts - BI routes
backend/src/routes/biRoutes.ts - BI reporting
backend/src/controllers/biController.ts - Comment records
backend/src/models/Comment.ts - Useful-link records
backend/src/models/UsefulLinks.ts
Other components
- User
- Socket.IO clients
Connections 38
- User → Application routes: uses
frontend/src/App.tsx - Application routes → Dashboard: routes to
frontend/src/App.tsx - Application routes → Ticket pages: routes to
frontend/src/App.tsx - Application routes → Form pages: routes to
frontend/src/App.tsx - Application routes → Organisation pages: routes to
frontend/src/App.tsx - Application routes → User administration: routes to
frontend/src/App.tsx - Application routes → Useful links pages: routes to
frontend/src/App.tsx - Application routes → Announcement page: routes to
frontend/src/App.tsx - Application routes → Ticket search: routes to
frontend/src/App.tsx - Application routes → Socket.IO clients: listens for notifications
frontend/src/App.tsx - Express application → MongoDB: connects
backend/src/app.ts - Express application → Ticket routes: mounts
backend/src/app.ts - Ticket routes → Ticket workflows: dispatches
backend/src/routes/ticketRoutes.ts - Ticket workflows → Ticket records: queries
backend/src/controllers/ticketController.ts - Ticket workflows → Comment records: queries
backend/src/controllers/ticketController.ts - Ticket workflows → Organisation records: resolves organisations
backend/src/controllers/ticketController.ts - Ticket workflows → Custom forms: gets form fields
backend/src/controllers/ticketController.ts - Express application → Authentication routes: mounts
backend/src/app.ts - Authentication routes → Authentication: dispatches
backend/src/routes/authRoutes.ts - Authentication routes → JWT access checks: protects profile routes
backend/src/routes/authRoutes.ts - Authentication → User records: reads and updates
backend/src/controllers/authController.ts - Authentication → Organisation records: looks up organisation
backend/src/controllers/authController.ts - JWT access checks → User records: loads user
backend/src/middlewares/authMiddleware.ts - Express application → BI routes: mounts
backend/src/app.ts - BI routes → BI reporting: dispatches
backend/src/routes/biRoutes.ts - BI reporting → Ticket records: aggregates
backend/src/controllers/biController.ts - BI reporting → Organisation records: joins organisation data
backend/src/controllers/biController.ts - BI reporting → User records: joins user data
backend/src/controllers/biController.ts - BI reporting → Comment records: joins comment data
backend/src/controllers/biController.ts - Express application → Useful links: mounts links routes
backend/src/app.ts - Useful links → Useful-link records: reads and writes
backend/src/controllers/useFulLinksController.ts - Useful links → JWT access checks: admin checks
backend/src/routes/usefulLinksRoutes.ts - Express application → Organisation management: mounts organisation routes
backend/src/app.ts - Express application → Ticket comments: mounts comment routes
backend/src/app.ts - Express application → Claim categories: mounts motif routes
backend/src/app.ts - Express application → Announcements and info: mounts info routes
backend/src/app.ts - Express application → User management: mounts user routes
backend/src/app.ts - Express application → Socket.IO clients: accepts connections
backend/src/app.ts