# codebymarvel/fundix architecture

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

- Interactive diagram: https://gitdiagram.com/codebymarvel/fundix
- Repository: https://github.com/codebymarvel/fundix

## Overview

Fundix appears to be a vehicle-service marketplace backend: customers create service requests, fund escrow, and track job completion; mechanics apply, accept funded jobs, and perform work; administrators manage participants, zones, requests, and escrow. The visible implementation is an Express/Supabase backend, alongside Flutter platform wrapper files; no Flutter feature source is present in the supplied tree. The README describes only a starter Flutter project, so marketplace capabilities come from the sampled backend. Some subsystems are represented by directory paths because their implementation files were not excerpted.

Main entry points: [`backend/index.js`](https://github.com/codebymarvel/fundix/blob/main/backend/index.js) (Backend entry), [`backend/firebase/firebaseConfig.js`](https://github.com/codebymarvel/fundix/blob/main/backend/firebase/firebaseConfig.js) (Supabase data store), [`backend/middleware/authMiddleware.js`](https://github.com/codebymarvel/fundix/blob/main/backend/middleware/authMiddleware.js) (Token middleware), [`backend/services/requestService.js`](https://github.com/codebymarvel/fundix/blob/main/backend/services/requestService.js) (Request and inspection logic)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and identity"]
  node_entry["Backend entry<br/>[index.js]"]
  node_auth_routes["Auth routes<br/>[authRoutes.js]"]
  node_auth_controller["Auth controller<br/>[authController.js]"]
  node_auth_logic["Login and signup"]
  node_auth_middleware["Token middleware<br/>[authMiddleware.js]"]
  node_token_service["Token verifier<br/>[tokenService.js]"]
end

subgraph group_jobs["Service jobs"]
  node_request_routes["Request routes<br/>[requestRoutes.js]"]
  node_request_controller["Request controller"]
  node_request_service["Request and inspection logic<br/>[requestService.js]"]
  node_diagnosis["Diagnosis API"]
  node_llm["AI diagnosis support"]
  node_mechanic_routes["Mechanic routes<br/>[mechanicRoutes.js]"]
  node_mechanic_controller["Mechanic controller"]
  node_mechanic_service["Mechanic operations<br/>[mechanicService.js]"]
  node_customer_api["Customer API"]
end

subgraph group_money["Payments and escrow"]
  node_payment_routes["Payment routes<br/>[paymentRoutes.js]"]
  node_payment_controller["Payment controller"]
  node_mpesa_service["M-Pesa integration<br/>[mpesaService.js]"]
  node_escrow_service["Escrow release"]
end

subgraph group_operations["Marketplace operations"]
  node_zone_service["Service zones<br/>[zoneService.js]"]
  node_admin_routes["Admin routes<br/>[adminRoutes.js]"]
  node_admin_controller["Admin controller<br/>[adminController.js]"]
  node_admin_service["Admin operations<br/>[adminService.js]"]
  node_store[("Supabase data store<br/>[firebaseConfig.js]")]
end

node_customer(("Customer"))
node_mechanic(("Mechanic"))
node_administrator(("Administrator"))
node_safaricom["Safaricom M-Pesa"]

node_entry -->|"mounts"| node_auth_routes
node_entry -->|"mounts"| node_request_routes
node_entry -->|"mounts"| node_payment_routes
node_entry -->|"mounts"| node_mechanic_routes
node_entry -->|"mounts"| node_admin_routes
node_auth_routes -->|"routes to"| node_auth_controller
node_auth_controller -->|"delegates to"| node_auth_logic
node_request_routes -->|"routes to"| node_request_controller
node_request_routes -->|"verifies"| node_auth_middleware
node_auth_middleware -->|"verifies token"| node_token_service
node_token_service -->|"reads profile"| node_store
node_request_controller -->|"creates and fetches"| node_request_service
node_request_service -->|"reads and writes"| node_store
node_request_service -->|"uses diagnosis support"| node_llm
node_request_service -->|"uses zone logic"| node_zone_service
node_request_controller -->|"gets release buffer"| node_escrow_service
node_entry -->|"mounts diagnosis routes"| node_diagnosis
node_diagnosis -->|"uses"| node_auth_middleware
node_mechanic_routes -->|"routes to"| node_mechanic_controller
node_mechanic_routes -->|"verifies"| node_auth_middleware
node_mechanic_controller -->|"delegates to"| node_mechanic_service
node_mechanic_service -->|"reads and writes"| node_store
node_customer -->|"submits requests"| node_request_routes
node_mechanic -->|"manages availability and jobs"| node_mechanic_routes
node_customer -->|"initiates payment"| node_payment_routes
node_payment_routes -->|"routes to"| node_payment_controller
node_payment_controller -->|"initiates payments"| node_mpesa_service
node_payment_controller -->|"initializes and funds escrow"| node_store
node_mpesa_service -->|"calls payment API"| node_safaricom
node_safaricom -->|"posts callbacks"| node_payment_controller
node_entry -->|"loads release service"| node_escrow_service
node_administrator -->|"manages marketplace"| node_admin_routes
node_admin_routes -->|"routes to"| node_admin_controller
node_admin_routes -->|"verifies token"| node_auth_middleware
node_admin_controller -->|"delegates to"| node_admin_service
node_admin_service -->|"manages marketplace data"| node_store
node_admin_service -->|"uses payout functions"| node_mpesa_service
node_customer -.->|"uses customer functions"| node_customer_api
node_escrow_service -.->|"processes escrow releases"| node_store

click node_entry "https://github.com/codebymarvel/fundix/blob/main/backend/index.js"
click node_auth_routes "https://github.com/codebymarvel/fundix/blob/main/backend/routes/authRoutes.js"
click node_auth_controller "https://github.com/codebymarvel/fundix/blob/main/backend/controllers/authController.js"
click node_auth_logic "https://github.com/codebymarvel/fundix/tree/main/backend/auth"
click node_auth_middleware "https://github.com/codebymarvel/fundix/blob/main/backend/middleware/authMiddleware.js"
click node_token_service "https://github.com/codebymarvel/fundix/blob/main/backend/auth/tokenService.js"
click node_request_routes "https://github.com/codebymarvel/fundix/blob/main/backend/routes/requestRoutes.js"
click node_request_controller "https://github.com/codebymarvel/fundix/blob/main/backend/controllers/requestController.js"
click node_request_service "https://github.com/codebymarvel/fundix/blob/main/backend/services/requestService.js"
click node_diagnosis "https://github.com/codebymarvel/fundix/blob/main/backend/controllers/diagnosisController.js"
click node_llm "https://github.com/codebymarvel/fundix/tree/main/backend/llm"
click node_zone_service "https://github.com/codebymarvel/fundix/blob/main/backend/services/zoneService.js"
click node_mechanic_routes "https://github.com/codebymarvel/fundix/blob/main/backend/routes/mechanicRoutes.js"
click node_mechanic_controller "https://github.com/codebymarvel/fundix/blob/main/backend/controllers/mechanicController.js"
click node_mechanic_service "https://github.com/codebymarvel/fundix/blob/main/backend/services/mechanicService.js"
click node_customer_api "https://github.com/codebymarvel/fundix/blob/main/backend/controllers/customerController.js"
click node_payment_routes "https://github.com/codebymarvel/fundix/blob/main/backend/routes/paymentRoutes.js"
click node_payment_controller "https://github.com/codebymarvel/fundix/blob/main/backend/controllers/paymentController.js"
click node_mpesa_service "https://github.com/codebymarvel/fundix/blob/main/backend/services/mpesaService.js"
click node_escrow_service "https://github.com/codebymarvel/fundix/blob/main/backend/services/escrowReleaseService.js"
click node_admin_routes "https://github.com/codebymarvel/fundix/blob/main/backend/routes/adminRoutes.js"
click node_admin_controller "https://github.com/codebymarvel/fundix/blob/main/backend/controllers/adminController.js"
click node_admin_service "https://github.com/codebymarvel/fundix/blob/main/backend/services/adminService.js"
click node_store "https://github.com/codebymarvel/fundix/blob/main/backend/firebase/firebaseConfig.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_entry,node_auth_routes,node_auth_controller,node_auth_logic,node_auth_middleware,node_token_service toneBlue
class node_request_routes,node_request_controller,node_request_service,node_diagnosis,node_llm,node_mechanic_routes,node_mechanic_controller,node_mechanic_service,node_customer_api toneAmber
class node_payment_routes,node_payment_controller,node_mpesa_service,node_escrow_service toneMint
class node_zone_service,node_admin_routes,node_admin_controller,node_admin_service,node_store toneRose
class node_customer,node_mechanic,node_administrator,node_safaricom toneIndigo
```

## Components

### API and identity

- [Backend entry](https://github.com/codebymarvel/fundix/blob/main/backend/index.js): `backend/index.js`
- [Auth routes](https://github.com/codebymarvel/fundix/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [Auth controller](https://github.com/codebymarvel/fundix/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [Login and signup](https://github.com/codebymarvel/fundix/tree/main/backend/auth): `backend/auth`
- [Token middleware](https://github.com/codebymarvel/fundix/blob/main/backend/middleware/authMiddleware.js): `backend/middleware/authMiddleware.js`
- [Token verifier](https://github.com/codebymarvel/fundix/blob/main/backend/auth/tokenService.js): `backend/auth/tokenService.js`

### Service jobs

- [Request routes](https://github.com/codebymarvel/fundix/blob/main/backend/routes/requestRoutes.js): `backend/routes/requestRoutes.js`
- [Request controller](https://github.com/codebymarvel/fundix/blob/main/backend/controllers/requestController.js): `backend/controllers/requestController.js`
- [Request and inspection logic](https://github.com/codebymarvel/fundix/blob/main/backend/services/requestService.js): `backend/services/requestService.js`
- [Diagnosis API](https://github.com/codebymarvel/fundix/blob/main/backend/controllers/diagnosisController.js): `backend/controllers/diagnosisController.js`
- [AI diagnosis support](https://github.com/codebymarvel/fundix/tree/main/backend/llm): `backend/llm`
- [Mechanic routes](https://github.com/codebymarvel/fundix/blob/main/backend/routes/mechanicRoutes.js): `backend/routes/mechanicRoutes.js`
- [Mechanic controller](https://github.com/codebymarvel/fundix/blob/main/backend/controllers/mechanicController.js): `backend/controllers/mechanicController.js`
- [Mechanic operations](https://github.com/codebymarvel/fundix/blob/main/backend/services/mechanicService.js): `backend/services/mechanicService.js`
- [Customer API](https://github.com/codebymarvel/fundix/blob/main/backend/controllers/customerController.js): `backend/controllers/customerController.js`

### Payments and escrow

- [Payment routes](https://github.com/codebymarvel/fundix/blob/main/backend/routes/paymentRoutes.js): `backend/routes/paymentRoutes.js`
- [Payment controller](https://github.com/codebymarvel/fundix/blob/main/backend/controllers/paymentController.js): `backend/controllers/paymentController.js`
- [M-Pesa integration](https://github.com/codebymarvel/fundix/blob/main/backend/services/mpesaService.js): `backend/services/mpesaService.js`
- [Escrow release](https://github.com/codebymarvel/fundix/blob/main/backend/services/escrowReleaseService.js): `backend/services/escrowReleaseService.js`

### Marketplace operations

- [Service zones](https://github.com/codebymarvel/fundix/blob/main/backend/services/zoneService.js): `backend/services/zoneService.js`
- [Admin routes](https://github.com/codebymarvel/fundix/blob/main/backend/routes/adminRoutes.js): `backend/routes/adminRoutes.js`
- [Admin controller](https://github.com/codebymarvel/fundix/blob/main/backend/controllers/adminController.js): `backend/controllers/adminController.js`
- [Admin operations](https://github.com/codebymarvel/fundix/blob/main/backend/services/adminService.js): `backend/services/adminService.js`
- [Supabase data store](https://github.com/codebymarvel/fundix/blob/main/backend/firebase/firebaseConfig.js): `backend/firebase/firebaseConfig.js`

### Other components

- **Customer**
- **Mechanic**
- **Administrator**
- **Safaricom M-Pesa**

## Connections

- Backend entry → Auth routes: mounts (evidence: `backend/index.js`)
- Backend entry → Request routes: mounts (evidence: `backend/index.js`)
- Backend entry → Payment routes: mounts (evidence: `backend/index.js`)
- Backend entry → Mechanic routes: mounts (evidence: `backend/index.js`)
- Backend entry → Admin routes: mounts (evidence: `backend/index.js`)
- Auth routes → Auth controller: routes to (evidence: `backend/routes/authRoutes.js`)
- Auth controller → Login and signup: delegates to (evidence: `backend/controllers/authController.js`)
- Request routes → Request controller: routes to (evidence: `backend/routes/requestRoutes.js`)
- Request routes → Token middleware: verifies (evidence: `backend/routes/requestRoutes.js`)
- Token middleware → Token verifier: verifies token (evidence: `backend/middleware/authMiddleware.js`)
- Token verifier → Supabase data store: reads profile (evidence: `backend/auth/tokenService.js`)
- Request controller → Request and inspection logic: creates and fetches (evidence: `backend/controllers/requestController.js`)
- Request and inspection logic → Supabase data store: reads and writes (evidence: `backend/services/requestService.js`)
- Request and inspection logic → AI diagnosis support: uses diagnosis support (evidence: `backend/services/requestService.js`)
- Request and inspection logic → Service zones: uses zone logic (evidence: `backend/services/requestService.js`)
- Request controller → Escrow release: gets release buffer (evidence: `backend/controllers/requestController.js`)
- Backend entry → Diagnosis API: mounts diagnosis routes (evidence: `backend/index.js`)
- Diagnosis API → Token middleware: uses (evidence: `backend/routes/diagnosisRoutes.js`)
- Mechanic routes → Mechanic controller: routes to (evidence: `backend/routes/mechanicRoutes.js`)
- Mechanic routes → Token middleware: verifies (evidence: `backend/routes/mechanicRoutes.js`)
- Mechanic controller → Mechanic operations: delegates to (evidence: `backend/controllers/mechanicController.js`)
- Mechanic operations → Supabase data store: reads and writes (evidence: `backend/services/mechanicService.js`)
- Customer → Request routes: submits requests (evidence: `backend/routes/requestRoutes.js`)
- Mechanic → Mechanic routes: manages availability and jobs (evidence: `backend/routes/mechanicRoutes.js`)
- Customer → Payment routes: initiates payment
- Payment routes → Payment controller: routes to (evidence: `backend/routes/paymentRoutes.js`)
- Payment controller → M-Pesa integration: initiates payments (evidence: `backend/controllers/paymentController.js`)
- Payment controller → Supabase data store: initializes and funds escrow (evidence: `backend/controllers/paymentController.js`)
- M-Pesa integration → Safaricom M-Pesa: calls payment API (evidence: `backend/services/mpesaService.js`)
- Safaricom M-Pesa → Payment controller: posts callbacks
- Backend entry → Escrow release: loads release service (evidence: `backend/index.js`)
- Administrator → Admin routes: manages marketplace (evidence: `backend/routes/adminRoutes.js`)
- Admin routes → Admin controller: routes to (evidence: `backend/routes/adminRoutes.js`)
- Admin routes → Token middleware: verifies token (evidence: `backend/routes/adminRoutes.js`)
- Admin controller → Admin operations: delegates to (evidence: `backend/controllers/adminController.js`)
- Admin operations → Supabase data store: manages marketplace data (evidence: `backend/services/adminService.js`)
- Admin operations → M-Pesa integration: uses payout functions (evidence: `backend/services/adminService.js`)
- Customer → Customer API: uses customer functions
- Escrow release → Supabase data store: processes escrow releases (evidence: `backend/services/escrowReleaseService.js`)
