# swathipoojary11/fixibly-project architecture

> Architecture diagram of the GitHub repository swathipoojary11/fixibly-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/swathipoojary11/fixibly-project
- Repository: https://github.com/swathipoojary11/fixibly-project

## Overview

Fixibly is a home-services booking and field-operations product: customers select services, place and track bookings, dispatchers manage assignment and status, technicians fulfill jobs, and administrators oversee users, performance, activity, and revenue. The tree contains a Next.js frontend and two parallel Express backends (JavaScript and TypeScript); the graph emphasizes the TypeScript backend’s documented route flow and the frontend’s distinct role workspaces. Source excerpts establish customer booking persistence and dispatcher notifications/audit; unsampled UI/API wiring is shown only where the evidence supports it.

Main entry points: [`typescript-backend/src/server.ts`](https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/server.ts) (API server), [`typescript-backend/src/controllers/customerController.ts`](https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/controllers/customerController.ts) (Customer workflows), [`typescript-backend/src/controllers/dispatcherController.ts`](https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/controllers/dispatcherController.ts) (Dispatch operations), [`BACKEND/src/config/supabase.js`](https://github.com/swathipoojary11/fixibly-project/blob/main/BACKEND/src/config/supabase.js) (Supabase database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Role workspaces"]
  node_customers["Customer portal<br/>[page.js]"]
  node_dispatchui["Dispatcher workspace<br/>[page.js]"]
  node_techui["Technician workspace<br/>[page.js]"]
  node_adminui["Admin workspace<br/>[page.js]"]
  node_frontendauth["Authentication context<br/>[AuthContext.js]"]
end

subgraph group_api["TypeScript API"]
  node_server["API server<br/>[server.ts]"]
  node_customerroutes["Customer routes<br/>[customerRoutes.ts]"]
  node_dispatchroutes["Dispatcher routes"]
  node_technicianroutes["Technician routes"]
  node_adminroutes["Admin routes<br/>[adminRoutes.ts]"]
end

subgraph group_domain["Operations services"]
  node_customercontroller["Customer workflows"]
  node_dispatchercontroller["Dispatch operations"]
  node_techniciancontroller["Technician jobs"]
  node_admincontroller["Admin analytics<br/>[adminController.ts]"]
  node_bookingservice["Booking service<br/>[bookingService.ts]"]
  node_techservice["Technician service"]
end

subgraph group_storage["Data access"]
  node_bookingrepo["Booking repository"]
  node_servicerepo["Service repository"]
  node_supabase[("Supabase database<br/>[supabase.js]")]
end

node_customer(("Customer"))
node_dispatcher(("Dispatcher"))
node_technician(("Technician"))
node_administrator(("Administrator"))

node_server -->|"mounts"| node_customerroutes
node_server -->|"mounts"| node_dispatchroutes
node_server -->|"mounts"| node_technicianroutes
node_server -->|"mounts"| node_adminroutes
node_customerroutes -->|"routes requests"| node_customercontroller
node_dispatchroutes -->|"routes requests"| node_dispatchercontroller
node_technicianroutes -->|"routes requests"| node_techniciancontroller
node_adminroutes -->|"routes requests"| node_admincontroller
node_customercontroller -->|"uses"| node_bookingservice
node_customercontroller -->|"uses"| node_bookingrepo
node_customercontroller -->|"uses"| node_servicerepo
node_dispatchercontroller -->|"reads/writes"| node_supabase
node_dispatchercontroller -->|"notifies via"| node_supabase
node_dispatchercontroller -->|"audits via"| node_supabase
node_techniciancontroller -->|"uses"| node_techservice
node_bookingservice -->|"delegates to"| node_bookingrepo
node_bookingservice -->|"delegates to"| node_servicerepo
node_bookingrepo -->|"queries"| node_supabase
node_customer -.->|"books and tracks"| node_customers
node_dispatcher -.->|"coordinates jobs"| node_dispatchui
node_technician -.->|"fulfills jobs"| node_techui
node_administrator -.->|"monitors operations"| node_adminui
node_customers -.->|"API requests"| node_server
node_dispatchui -.->|"API requests"| node_server
node_techui -.->|"API requests"| node_server
node_adminui -.->|"API requests"| node_server

click node_customers "https://github.com/swathipoojary11/fixibly-project/blob/main/fixibly/app/customer/booking/page.js"
click node_dispatchui "https://github.com/swathipoojary11/fixibly-project/blob/main/fixibly/app/dispatcher/DispatcherApp/page.js"
click node_techui "https://github.com/swathipoojary11/fixibly-project/blob/main/fixibly/app/technician/dashboard/page.js"
click node_adminui "https://github.com/swathipoojary11/fixibly-project/blob/main/fixibly/app/admin/AdminApp/page.js"
click node_frontendauth "https://github.com/swathipoojary11/fixibly-project/blob/main/fixibly/app/context/AuthContext.js"
click node_server "https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/server.ts"
click node_customerroutes "https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/routes/customerRoutes.ts"
click node_dispatchroutes "https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/routes/dispatcherRoutes.ts"
click node_technicianroutes "https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/routes/technicianRoutes.ts"
click node_adminroutes "https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/routes/adminRoutes.ts"
click node_customercontroller "https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/controllers/customerController.ts"
click node_dispatchercontroller "https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/controllers/dispatcherController.ts"
click node_techniciancontroller "https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/controllers/technicianController.ts"
click node_admincontroller "https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/controllers/adminController.ts"
click node_bookingservice "https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/services/bookingService.ts"
click node_techservice "https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/services/technicianService.ts"
click node_bookingrepo "https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/repositories/bookingRepository.ts"
click node_servicerepo "https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/repositories/serviceRepository.ts"
click node_supabase "https://github.com/swathipoojary11/fixibly-project/blob/main/BACKEND/src/config/supabase.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_customers,node_dispatchui,node_techui,node_adminui,node_frontendauth toneBlue
class node_server,node_customerroutes,node_dispatchroutes,node_technicianroutes,node_adminroutes toneAmber
class node_customercontroller,node_dispatchercontroller,node_techniciancontroller,node_admincontroller,node_bookingservice,node_techservice toneMint
class node_bookingrepo,node_servicerepo,node_supabase toneRose
class node_customer,node_dispatcher,node_technician,node_administrator toneIndigo
```

## Components

### Role workspaces

- [Customer portal](https://github.com/swathipoojary11/fixibly-project/blob/main/fixibly/app/customer/booking/page.js): `fixibly/app/customer/booking/page.js`
- [Dispatcher workspace](https://github.com/swathipoojary11/fixibly-project/blob/main/fixibly/app/dispatcher/DispatcherApp/page.js): `fixibly/app/dispatcher/DispatcherApp/page.js`
- [Technician workspace](https://github.com/swathipoojary11/fixibly-project/blob/main/fixibly/app/technician/dashboard/page.js): `fixibly/app/technician/dashboard/page.js`
- [Admin workspace](https://github.com/swathipoojary11/fixibly-project/blob/main/fixibly/app/admin/AdminApp/page.js): `fixibly/app/admin/AdminApp/page.js`
- [Authentication context](https://github.com/swathipoojary11/fixibly-project/blob/main/fixibly/app/context/AuthContext.js): `fixibly/app/context/AuthContext.js`

### TypeScript API

- [API server](https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/server.ts): `typescript-backend/src/server.ts`
- [Customer routes](https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/routes/customerRoutes.ts): `typescript-backend/src/routes/customerRoutes.ts`
- [Dispatcher routes](https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/routes/dispatcherRoutes.ts): `typescript-backend/src/routes/dispatcherRoutes.ts`
- [Technician routes](https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/routes/technicianRoutes.ts): `typescript-backend/src/routes/technicianRoutes.ts`
- [Admin routes](https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/routes/adminRoutes.ts): `typescript-backend/src/routes/adminRoutes.ts`

### Operations services

- [Customer workflows](https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/controllers/customerController.ts): `typescript-backend/src/controllers/customerController.ts`
- [Dispatch operations](https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/controllers/dispatcherController.ts): `typescript-backend/src/controllers/dispatcherController.ts`
- [Technician jobs](https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/controllers/technicianController.ts): `typescript-backend/src/controllers/technicianController.ts`
- [Admin analytics](https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/controllers/adminController.ts): `typescript-backend/src/controllers/adminController.ts`
- [Booking service](https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/services/bookingService.ts): `typescript-backend/src/services/bookingService.ts`
- [Technician service](https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/services/technicianService.ts): `typescript-backend/src/services/technicianService.ts`

### Data access

- [Booking repository](https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/repositories/bookingRepository.ts): `typescript-backend/src/repositories/bookingRepository.ts`
- [Service repository](https://github.com/swathipoojary11/fixibly-project/blob/main/typescript-backend/src/repositories/serviceRepository.ts): `typescript-backend/src/repositories/serviceRepository.ts`
- [Supabase database](https://github.com/swathipoojary11/fixibly-project/blob/main/BACKEND/src/config/supabase.js): `BACKEND/src/config/supabase.js`

### Other components

- **Customer**
- **Dispatcher**
- **Technician**
- **Administrator**

## Connections

- API server → Customer routes: mounts (evidence: `typescript-backend/src/server.ts`)
- API server → Dispatcher routes: mounts (evidence: `typescript-backend/src/server.ts`)
- API server → Technician routes: mounts (evidence: `typescript-backend/src/server.ts`)
- API server → Admin routes: mounts (evidence: `typescript-backend/src/server.ts`)
- Customer routes → Customer workflows: routes requests (evidence: `typescript-backend/src/routes/customerRoutes.ts`)
- Dispatcher routes → Dispatch operations: routes requests (evidence: `typescript-backend/src/routes/dispatcherRoutes.ts`)
- Technician routes → Technician jobs: routes requests (evidence: `typescript-backend/src/routes/technicianRoutes.ts`)
- Admin routes → Admin analytics: routes requests (evidence: `typescript-backend/src/routes/adminRoutes.ts`)
- Customer workflows → Booking service: uses (evidence: `typescript-backend/src/controllers/customerController.ts`)
- Customer workflows → Booking repository: uses (evidence: `typescript-backend/src/controllers/customerController.ts`)
- Customer workflows → Service repository: uses (evidence: `typescript-backend/src/controllers/customerController.ts`)
- Dispatch operations → Supabase database: reads/writes (evidence: `typescript-backend/src/controllers/dispatcherController.ts`)
- Dispatch operations → Supabase database: notifies via (evidence: `typescript-backend/src/controllers/dispatcherController.ts`)
- Dispatch operations → Supabase database: audits via (evidence: `typescript-backend/src/controllers/dispatcherController.ts`)
- Technician jobs → Technician service: uses (evidence: `typescript-backend/src/controllers/technicianController.ts`)
- Booking service → Booking repository: delegates to (evidence: `typescript-backend/src/services/bookingService.ts`)
- Booking service → Service repository: delegates to (evidence: `typescript-backend/src/services/bookingService.ts`)
- Booking repository → Supabase database: queries (evidence: `typescript-backend/src/repositories/bookingRepository.ts`)
- Customer → Customer portal: books and tracks
- Dispatcher → Dispatcher workspace: coordinates jobs
- Technician → Technician workspace: fulfills jobs
- Administrator → Admin workspace: monitors operations
- Customer portal → API server: API requests
- Dispatcher workspace → API server: API requests
- Technician workspace → API server: API requests
- Admin workspace → API server: API requests
