# itsmethien/23674831_nguyenquocthien_cabsystem architecture

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

- Interactive diagram: https://gitdiagram.com/itsmethien/23674831_nguyenquocthien_cabsystem
- Repository: https://github.com/itsmethien/23674831_nguyenquocthien_cabsystem

## Overview

This repository describes a ride-hailing API, with contracts for identity, drivers and vehicles, trips, payments, ratings, notifications, and administration. The principal user-facing workflow is booking and matching, followed by trip management and payment; rating and notification are additional documented capabilities. The tree and test-case names identify these domains, but no API contents or implementation source were available, so the graph shows only actor-to-contract requests and does not infer internal sequencing or service integrations.

Main entry points: [`api/01-auth.yaml`](https://github.com/itsmethien/23674831_nguyenquocthien_cabsystem/blob/main/api/01-auth.yaml) (Auth API), [`api/05-trips.yaml`](https://github.com/itsmethien/23674831_nguyenquocthien_cabsystem/blob/main/api/05-trips.yaml) (Trips API), [`api/02-users.yaml`](https://github.com/itsmethien/23674831_nguyenquocthien_cabsystem/blob/main/api/02-users.yaml) (Users API), [`api/03-drivers.yaml`](https://github.com/itsmethien/23674831_nguyenquocthien_cabsystem/blob/main/api/03-drivers.yaml) (Drivers API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity"]
  node_auth["Auth API<br/>[01-auth.yaml]"]
  node_users["Users API<br/>[02-users.yaml]"]
end

subgraph group_ride["Ride lifecycle"]
  node_drivers["Drivers API<br/>[03-drivers.yaml]"]
  node_vehicles["Vehicles API<br/>[04-vehicles.yaml]"]
  node_trips["Trips API<br/>[05-trips.yaml]"]
  node_payments["Payments API<br/>[06-payments.yaml]"]
end

subgraph group_engagement["Engagement"]
  node_ratings["Ratings API<br/>[07-ratings.yaml]"]
  node_notifications["Notifications API"]
end

subgraph group_operations["Operations"]
  node_adminapi["Admin API<br/>[09-admin.yaml]"]
  node_components["API Components<br/>[10-components.yaml]"]
end

node_rider(("Rider"))
node_driver(("Driver"))
node_admin(("Administrator"))

node_rider -->|"authenticates"| node_auth
node_rider -->|"manages account"| node_users
node_rider -->|"books trip"| node_trips
node_rider -->|"pays fare"| node_payments
node_rider -->|"rates trip"| node_ratings
node_driver -->|"authenticates"| node_auth
node_driver -->|"manages profile"| node_drivers
node_driver -->|"manages vehicle"| node_vehicles
node_driver -->|"manages trip"| node_trips
node_admin -->|"operates service"| node_adminapi

click node_auth "https://github.com/itsmethien/23674831_nguyenquocthien_cabsystem/blob/main/api/01-auth.yaml"
click node_users "https://github.com/itsmethien/23674831_nguyenquocthien_cabsystem/blob/main/api/02-users.yaml"
click node_drivers "https://github.com/itsmethien/23674831_nguyenquocthien_cabsystem/blob/main/api/03-drivers.yaml"
click node_vehicles "https://github.com/itsmethien/23674831_nguyenquocthien_cabsystem/blob/main/api/04-vehicles.yaml"
click node_trips "https://github.com/itsmethien/23674831_nguyenquocthien_cabsystem/blob/main/api/05-trips.yaml"
click node_payments "https://github.com/itsmethien/23674831_nguyenquocthien_cabsystem/blob/main/api/06-payments.yaml"
click node_ratings "https://github.com/itsmethien/23674831_nguyenquocthien_cabsystem/blob/main/api/07-ratings.yaml"
click node_notifications "https://github.com/itsmethien/23674831_nguyenquocthien_cabsystem/blob/main/api/08-notifications.yaml"
click node_adminapi "https://github.com/itsmethien/23674831_nguyenquocthien_cabsystem/blob/main/api/09-admin.yaml"
click node_components "https://github.com/itsmethien/23674831_nguyenquocthien_cabsystem/blob/main/api/10-components.yaml"

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_auth,node_users toneBlue
class node_drivers,node_vehicles,node_trips,node_payments toneAmber
class node_ratings,node_notifications toneMint
class node_adminapi,node_components toneRose
class node_rider,node_driver,node_admin toneIndigo
```

## Components

### Identity

- [Auth API](https://github.com/itsmethien/23674831_nguyenquocthien_cabsystem/blob/main/api/01-auth.yaml): `api/01-auth.yaml`
- [Users API](https://github.com/itsmethien/23674831_nguyenquocthien_cabsystem/blob/main/api/02-users.yaml): `api/02-users.yaml`

### Ride lifecycle

- [Drivers API](https://github.com/itsmethien/23674831_nguyenquocthien_cabsystem/blob/main/api/03-drivers.yaml): `api/03-drivers.yaml`
- [Vehicles API](https://github.com/itsmethien/23674831_nguyenquocthien_cabsystem/blob/main/api/04-vehicles.yaml): `api/04-vehicles.yaml`
- [Trips API](https://github.com/itsmethien/23674831_nguyenquocthien_cabsystem/blob/main/api/05-trips.yaml): `api/05-trips.yaml`
- [Payments API](https://github.com/itsmethien/23674831_nguyenquocthien_cabsystem/blob/main/api/06-payments.yaml): `api/06-payments.yaml`

### Engagement

- [Ratings API](https://github.com/itsmethien/23674831_nguyenquocthien_cabsystem/blob/main/api/07-ratings.yaml): `api/07-ratings.yaml`
- [Notifications API](https://github.com/itsmethien/23674831_nguyenquocthien_cabsystem/blob/main/api/08-notifications.yaml): `api/08-notifications.yaml`

### Operations

- [Admin API](https://github.com/itsmethien/23674831_nguyenquocthien_cabsystem/blob/main/api/09-admin.yaml): `api/09-admin.yaml`
- [API Components](https://github.com/itsmethien/23674831_nguyenquocthien_cabsystem/blob/main/api/10-components.yaml): `api/10-components.yaml`

### Other components

- **Rider**
- **Driver**
- **Administrator**

## Connections

- Rider → Auth API: authenticates
- Rider → Users API: manages account
- Rider → Trips API: books trip
- Rider → Payments API: pays fare
- Rider → Ratings API: rates trip
- Driver → Auth API: authenticates
- Driver → Drivers API: manages profile
- Driver → Vehicles API: manages vehicle
- Driver → Trips API: manages trip
- Administrator → Admin API: operates service