# rafonsky/sistema-o.s.-garage-1240 architecture

> Architecture diagram of the GitHub repository rafonsky/sistema-o.s.-garage-1240, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rafonsky/sistema-o.s.-garage-1240
- Repository: https://github.com/rafonsky/sistema-o.s.-garage-1240

## Overview

Garage 1240 is an internal service-order application for managing customers, equipment, repairs, billing, and customer-facing PDF reports. The main workflow is: a staff member signs in, searches or selects a customer and device, manages a service order through its repair stages, records payment and history, and generates a report. The graph includes documented dashboard and data-conference capabilities. Some view and domain connections rely on SOURCE INDEX references or README statements; unsampled implementation details are not inferred.

Main entry points: [`src/data/store.js`](https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/data/store.js) (Live data store), [`src/main.js`](https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/main.js) (App router), [`src/views/servico.js`](https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/views/servico.js) (Service orders), [`src/data/repo.js`](https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/data/repo.js) (Firestore repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Access and navigation"]
  node_login["Sign-in screen<br/>[login.js]"]
  node_auth["Authentication<br/>[auth.js]"]
  node_app["App router<br/>[main.js]"]
end

subgraph group_records["Customer and service records"]
  node_home["Dashboard<br/>[home.js]"]
  node_customers["Customer records<br/>[clientes.js]"]
  node_equipment["Equipment records<br/>[equipamentos.js]"]
  node_service["Service orders<br/>[servico.js]"]
  node_service_list["Service list<br/>[servicos.js]"]
end

subgraph group_rules["Domain rules"]
  node_checklist["Intake checklist<br/>[checklist.js]"]
  node_status["Service stages<br/>[status.js]"]
  node_finance["Billing rules<br/>[finance.js]"]
  node_panel_rules["Dashboard summaries<br/>[painel.js]"]
  node_inconsistencies["Data checks<br/>[inconsistencias.js]"]
end

subgraph group_platform["Data and integrations"]
  node_store["Live data store<br/>[store.js]"]
  node_repo["Firestore repository<br/>[repo.js]"]
  node_firebase["Firebase setup<br/>[firebase.js]"]
  node_firestore[("Cloud Firestore")]
  node_photos["Service photos<br/>[fotos.js]"]
  node_storage[("Firebase Storage")]
end

subgraph group_reporting["Reports and oversight"]
  node_data_check["Data conference<br/>[conferencia.js]"]
  node_pdf["Report assembly<br/>[relatorio.js]"]
  node_pdf_model["Report content model<br/>[modelo.js]"]
  node_pdf_render["PDF rendering<br/>[render.js]"]
end

node_staff(("Staff member"))

node_staff -->|"signs in"| node_login
node_login -->|"submits credentials"| node_auth
node_auth -->|"uses services"| node_firebase
node_auth -->|"notifies user"| node_app
node_app -->|"subscribes to data"| node_store
node_app -->|"routes to screens"| node_home
node_app -->|"routes to screens"| node_customers
node_app -->|"routes to screens"| node_equipment
node_app -->|"routes to screens"| node_service
node_app -->|"routes to screens"| node_service_list
node_app -->|"routes to screens"| node_data_check
node_home -->|"builds summary"| node_panel_rules
node_home -->|"reads records"| node_store
node_customers -->|"reads records"| node_store
node_customers -->|"saves customer"| node_repo
node_equipment -->|"reads records"| node_store
node_equipment -->|"saves equipment"| node_repo
node_service -->|"reads records"| node_store
node_service -->|"saves order"| node_repo
node_service -->|"uses checklist"| node_checklist
node_service -->|"uses stages"| node_status
node_service -->|"calculates billing"| node_finance
node_service -->|"manages photos"| node_photos
node_service -->|"generates report"| node_pdf
node_data_check -->|"checks records"| node_store
node_data_check -->|"finds anomalies"| node_inconsistencies
node_store -->|"connects to"| node_firebase
node_store -->|"creates repository"| node_repo
node_store -->|"subscribes and reads"| node_firestore
node_repo -->|"reads and writes"| node_firestore
node_firebase -->|"configures client"| node_firestore
node_photos -->|"uses services"| node_firebase
node_photos -->|"stores files"| node_storage
node_pdf -->|"loads order data"| node_store
node_pdf -->|"builds content"| node_pdf_model
node_pdf -->|"renders report"| node_pdf_render
node_panel_rules -->|"uses stage rules"| node_status
node_panel_rules -->|"calculates receivables"| node_finance

click node_login "https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/views/login.js"
click node_auth "https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/auth.js"
click node_app "https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/main.js"
click node_home "https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/views/home.js"
click node_customers "https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/views/clientes.js"
click node_equipment "https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/views/equipamentos.js"
click node_service "https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/views/servico.js"
click node_service_list "https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/views/servicos.js"
click node_data_check "https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/views/conferencia.js"
click node_checklist "https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/domain/checklist.js"
click node_status "https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/domain/status.js"
click node_finance "https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/domain/finance.js"
click node_panel_rules "https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/domain/painel.js"
click node_inconsistencies "https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/domain/inconsistencias.js"
click node_store "https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/data/store.js"
click node_repo "https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/data/repo.js"
click node_firebase "https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/firebase.js"
click node_photos "https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/data/fotos.js"
click node_pdf "https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/pdf/relatorio.js"
click node_pdf_model "https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/pdf/modelo.js"
click node_pdf_render "https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/pdf/render.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_login,node_auth,node_app toneBlue
class node_home,node_customers,node_equipment,node_service,node_service_list toneAmber
class node_checklist,node_status,node_finance,node_panel_rules,node_inconsistencies toneMint
class node_store,node_repo,node_firebase,node_firestore,node_photos,node_storage toneRose
class node_data_check,node_pdf,node_pdf_model,node_pdf_render,node_staff toneIndigo
```

## Components

### Access and navigation

- [Sign-in screen](https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/views/login.js): `src/views/login.js`
- [Authentication](https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/auth.js): `src/auth.js`
- [App router](https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/main.js): `src/main.js`

### Customer and service records

- [Dashboard](https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/views/home.js): `src/views/home.js`
- [Customer records](https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/views/clientes.js): `src/views/clientes.js`
- [Equipment records](https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/views/equipamentos.js): `src/views/equipamentos.js`
- [Service orders](https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/views/servico.js): `src/views/servico.js`
- [Service list](https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/views/servicos.js): `src/views/servicos.js`

### Domain rules

- [Intake checklist](https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/domain/checklist.js): `src/domain/checklist.js`
- [Service stages](https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/domain/status.js): `src/domain/status.js`
- [Billing rules](https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/domain/finance.js): `src/domain/finance.js`
- [Dashboard summaries](https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/domain/painel.js): `src/domain/painel.js`
- [Data checks](https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/domain/inconsistencias.js): `src/domain/inconsistencias.js`

### Data and integrations

- [Live data store](https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/data/store.js): `src/data/store.js`
- [Firestore repository](https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/data/repo.js): `src/data/repo.js`
- [Firebase setup](https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/firebase.js): `src/firebase.js`
- **Cloud Firestore**
- [Service photos](https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/data/fotos.js): `src/data/fotos.js`
- **Firebase Storage**

### Reports and oversight

- [Data conference](https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/views/conferencia.js): `src/views/conferencia.js`
- [Report assembly](https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/pdf/relatorio.js): `src/pdf/relatorio.js`
- [Report content model](https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/pdf/modelo.js): `src/pdf/modelo.js`
- [PDF rendering](https://github.com/rafonsky/sistema-o.s.-garage-1240/blob/main/src/pdf/render.js): `src/pdf/render.js`

### Other components

- **Staff member**

## Connections

- Staff member → Sign-in screen: signs in (evidence: `README.md`)
- Sign-in screen → Authentication: submits credentials (evidence: `src/views/login.js`)
- Authentication → Firebase setup: uses services (evidence: `src/auth.js`)
- Authentication → App router: notifies user (evidence: `src/main.js`)
- App router → Live data store: subscribes to data (evidence: `src/main.js`)
- App router → Dashboard: routes to screens (evidence: `README.md`)
- App router → Customer records: routes to screens (evidence: `README.md`)
- App router → Equipment records: routes to screens (evidence: `README.md`)
- App router → Service orders: routes to screens (evidence: `README.md`)
- App router → Service list: routes to screens (evidence: `README.md`)
- App router → Data conference: routes to screens (evidence: `README.md`)
- Dashboard → Dashboard summaries: builds summary (evidence: `src/views/home.js`)
- Dashboard → Live data store: reads records (evidence: `src/views/home.js`)
- Customer records → Live data store: reads records (evidence: `src/views/clientes.js`)
- Customer records → Firestore repository: saves customer (evidence: `src/views/clientes.js`)
- Equipment records → Live data store: reads records (evidence: `src/views/equipamentos.js`)
- Equipment records → Firestore repository: saves equipment (evidence: `src/views/equipamentos.js`)
- Service orders → Live data store: reads records (evidence: `src/views/servico.js`)
- Service orders → Firestore repository: saves order (evidence: `src/views/servico.js`)
- Service orders → Intake checklist: uses checklist (evidence: `src/views/servico.js`)
- Service orders → Service stages: uses stages (evidence: `src/views/servico.js`)
- Service orders → Billing rules: calculates billing (evidence: `src/views/servico.js`)
- Service orders → Service photos: manages photos (evidence: `src/views/servico.js`)
- Service orders → Report assembly: generates report (evidence: `src/views/servico.js`)
- Data conference → Live data store: checks records (evidence: `src/views/conferencia.js`)
- Data conference → Data checks: finds anomalies (evidence: `src/views/conferencia.js`)
- Live data store → Firebase setup: connects to (evidence: `src/data/store.js`)
- Live data store → Firestore repository: creates repository (evidence: `src/data/store.js`)
- Live data store → Cloud Firestore: subscribes and reads (evidence: `src/data/store.js`)
- Firestore repository → Cloud Firestore: reads and writes (evidence: `src/data/repo.js`)
- Firebase setup → Cloud Firestore: configures client (evidence: `src/firebase.js`)
- Service photos → Firebase setup: uses services (evidence: `src/data/fotos.js`)
- Service photos → Firebase Storage: stores files (evidence: `src/data/fotos.js`)
- Report assembly → Live data store: loads order data (evidence: `src/pdf/relatorio.js`)
- Report assembly → Report content model: builds content (evidence: `src/pdf/relatorio.js`)
- Report assembly → PDF rendering: renders report (evidence: `src/pdf/relatorio.js`)
- Dashboard summaries → Service stages: uses stage rules (evidence: `src/domain/painel.js`)
- Dashboard summaries → Billing rules: calculates receivables (evidence: `src/domain/painel.js`)
