# crrawl/root-repair-service architecture

> Architecture diagram of the GitHub repository crrawl/root-repair-service, 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/crrawl/root-repair-service
- Repository: https://github.com/crrawl/root-repair-service

## Overview

RootRepair is a workshop-management web app for repair requests, customer accounts and staff operations. Customers submit devices and follow repair progress; staff update repairs, while owners manage the workshop and review activity. The visible request handler parses routes, performs repair and user database operations, and renders views through a shared layout. The README describes the product at a high level; several capabilities are evident from the view tree, but their unsampled routing and call relationships are not asserted here.

Main entry points: [`web/public/index.php`](https://github.com/crrawl/root-repair-service/blob/main/web/public/index.php) (HTTP entry), [`web/src/bootstrap.php`](https://github.com/crrawl/root-repair-service/blob/main/web/src/bootstrap.php) (Application bootstrap), [`web/views/layout.php`](https://github.com/crrawl/root-repair-service/blob/main/web/views/layout.php) (Shared page layout), [`web/src/feature-routes.php`](https://github.com/crrawl/root-repair-service/blob/main/web/src/feature-routes.php) (Feature routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Web entry"]
  node_http["HTTP entry<br/>[index.php]"]
  node_feature_routes["Feature routes<br/>[feature-routes.php]"]
  node_bootstrap["Application bootstrap<br/>[bootstrap.php]"]
  node_layout["Shared page layout<br/>[layout.php]"]
end

subgraph group_customer["Customer services"]
  node_customer_views["Customer pages"]
  node_repair_intake["Repair requests<br/>[request.php]"]
  node_repair_status["Repair status<br/>[status.php]"]
  node_accounts["Accounts and profiles<br/>[profile.php]"]
end

subgraph group_workshop["Workshop operations"]
  node_workshop_views["Workshop dashboard<br/>[dashboard.php]"]
  node_admin["Owner administration<br/>[admin.php]"]
  node_diagnostics["Diagnostic imports<br/>[diagnostics.php]"]
  node_chat["Workshop chat<br/>[chat.php]"]
  node_repair_detail["Repair handling<br/>[repair.php]"]
  node_feature_helpers["Feature helpers<br/>[features.php]"]
end

subgraph group_data["Data layer"]
  node_database[("MySQL database<br/>[schema.sql]")]
end

node_visitor(("Customer or staff"))

node_visitor -->|"sends requests"| node_http
node_http -->|"loads"| node_bootstrap
node_http -->|"loads routes"| node_feature_routes
node_bootstrap -->|"loads helpers"| node_feature_helpers
node_bootstrap -->|"renders through"| node_layout
node_http -->|"reads and writes"| node_database
node_layout -->|"includes selected view"| node_customer_views

click node_http "https://github.com/crrawl/root-repair-service/blob/main/web/public/index.php"
click node_feature_routes "https://github.com/crrawl/root-repair-service/blob/main/web/src/feature-routes.php"
click node_bootstrap "https://github.com/crrawl/root-repair-service/blob/main/web/src/bootstrap.php"
click node_layout "https://github.com/crrawl/root-repair-service/blob/main/web/views/layout.php"
click node_customer_views "https://github.com/crrawl/root-repair-service/tree/main/web/views"
click node_repair_intake "https://github.com/crrawl/root-repair-service/blob/main/web/views/request.php"
click node_repair_status "https://github.com/crrawl/root-repair-service/blob/main/web/views/status.php"
click node_accounts "https://github.com/crrawl/root-repair-service/blob/main/web/views/profile.php"
click node_workshop_views "https://github.com/crrawl/root-repair-service/blob/main/web/views/dashboard.php"
click node_admin "https://github.com/crrawl/root-repair-service/blob/main/web/views/admin.php"
click node_diagnostics "https://github.com/crrawl/root-repair-service/blob/main/web/views/diagnostics.php"
click node_chat "https://github.com/crrawl/root-repair-service/blob/main/web/views/chat.php"
click node_repair_detail "https://github.com/crrawl/root-repair-service/blob/main/web/views/repair.php"
click node_feature_helpers "https://github.com/crrawl/root-repair-service/blob/main/web/src/features.php"
click node_database "https://github.com/crrawl/root-repair-service/blob/main/web/database/schema.sql"

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_http,node_feature_routes,node_bootstrap,node_layout toneBlue
class node_customer_views,node_repair_intake,node_repair_status,node_accounts toneAmber
class node_workshop_views,node_admin,node_diagnostics,node_chat,node_repair_detail,node_feature_helpers toneMint
class node_database toneRose
class node_visitor toneIndigo
```

## Components

### Web entry

- [HTTP entry](https://github.com/crrawl/root-repair-service/blob/main/web/public/index.php): `web/public/index.php`
- [Feature routes](https://github.com/crrawl/root-repair-service/blob/main/web/src/feature-routes.php): `web/src/feature-routes.php`
- [Application bootstrap](https://github.com/crrawl/root-repair-service/blob/main/web/src/bootstrap.php): `web/src/bootstrap.php`
- [Shared page layout](https://github.com/crrawl/root-repair-service/blob/main/web/views/layout.php): `web/views/layout.php`

### Customer services

- [Customer pages](https://github.com/crrawl/root-repair-service/tree/main/web/views): `web/views`
- [Repair requests](https://github.com/crrawl/root-repair-service/blob/main/web/views/request.php): `web/views/request.php`
- [Repair status](https://github.com/crrawl/root-repair-service/blob/main/web/views/status.php): `web/views/status.php`
- [Accounts and profiles](https://github.com/crrawl/root-repair-service/blob/main/web/views/profile.php): `web/views/profile.php`

### Workshop operations

- [Workshop dashboard](https://github.com/crrawl/root-repair-service/blob/main/web/views/dashboard.php): `web/views/dashboard.php`
- [Owner administration](https://github.com/crrawl/root-repair-service/blob/main/web/views/admin.php): `web/views/admin.php`
- [Diagnostic imports](https://github.com/crrawl/root-repair-service/blob/main/web/views/diagnostics.php): `web/views/diagnostics.php`
- [Workshop chat](https://github.com/crrawl/root-repair-service/blob/main/web/views/chat.php): `web/views/chat.php`
- [Repair handling](https://github.com/crrawl/root-repair-service/blob/main/web/views/repair.php): `web/views/repair.php`
- [Feature helpers](https://github.com/crrawl/root-repair-service/blob/main/web/src/features.php): `web/src/features.php`

### Data layer

- [MySQL database](https://github.com/crrawl/root-repair-service/blob/main/web/database/schema.sql): `web/database/schema.sql`

### Other components

- **Customer or staff**

## Connections

- Customer or staff → HTTP entry: sends requests (evidence: `README.md`)
- HTTP entry → Application bootstrap: loads (evidence: `web/public/index.php`)
- HTTP entry → Feature routes: loads routes (evidence: `web/public/index.php`)
- Application bootstrap → Feature helpers: loads helpers (evidence: `web/src/bootstrap.php`)
- Application bootstrap → Shared page layout: renders through (evidence: `web/src/bootstrap.php`)
- HTTP entry → MySQL database: reads and writes (evidence: `web/public/index.php`)
- Shared page layout → Customer pages: includes selected view (evidence: `web/views/layout.php`)
