# fabiojr933/tcc_faculdade architecture

> Architecture diagram of the GitHub repository fabiojr933/tcc_faculdade, 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/fabiojr933/tcc_faculdade
- Repository: https://github.com/fabiojr933/tcc_faculdade

## Overview

This is a PHP service-order management system. Staff use its web interface to maintain customers, products and other reference records, open and manage service orders, and consult reports and charts. The sampled order flow shows a controller loading order data through services and a DAO, then rendering a view; common services and DAOs provide shared persistence. The README documents the major product areas, but report and chart implementation details were not sampled, so their internal links are left unspecified.

Main entry points: [`app/models/service/Service.php`](https://github.com/fabiojr933/tcc_faculdade/blob/master/app/models/service/Service.php) (Shared services), [`app/models/dao/OrdemServicoDao.php`](https://github.com/fabiojr933/tcc_faculdade/blob/master/app/models/dao/OrdemServicoDao.php) (Order data access), [`app/controllers/OrdemServicoController.php`](https://github.com/fabiojr933/tcc_faculdade/blob/master/app/controllers/OrdemServicoController.php) (Order management), [`app/models/service/OrdemServicoService.php`](https://github.com/fabiojr933/tcc_faculdade/blob/master/app/models/service/OrdemServicoService.php) (Order services)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_entry["PHP entry point<br/>[index.php]"]
  node_router["Request router<br/>[Core.php]"]
  node_controllers["Page controllers"]
  node_views["Web views"]
end

subgraph group_records["Reference records"]
  node_customers["Customer records"]
  node_products["Product records"]
  node_categories["Category records"]
  node_mechanics["Mechanic records"]
  node_salespeople["Salesperson records"]
  node_objects["Object records"]
end

subgraph group_orders["Service orders"]
  node_orders["Order management"]
  node_items["Order items<br/>[ItemController.php]"]
  node_reports["Reports"]
  node_charts["Charts"]
  node_order_service["Order services"]
  node_item_service["Item services<br/>[ItemService.php]"]
  node_dao["Order data access"]
end

subgraph group_shared["Shared infrastructure"]
  node_service["Shared services<br/>[Service.php]"]
  node_generic_dao["Generic data access<br/>[Dao.php]"]
  node_model["Database model<br/>[Model.php]"]
  node_flash["Session messages<br/>[Flash.php]"]
  node_validation["Input validation<br/>[Validacao.php]"]
  node_pdf["PDF generation<br/>[fpdf.php]"]
end

node_staff(("Staff user"))
node_database[("Application database")]

node_staff -.->|"uses"| node_entry
node_entry -->|"starts"| node_router
node_router -->|"dispatches"| node_controllers
node_controllers -->|"loads"| node_views
node_customers -->|"queries"| node_service
node_products -->|"queries"| node_service
node_orders -->|"requests"| node_order_service
node_orders -->|"queries"| node_service
node_orders -->|"closes bay"| node_dao
node_orders -->|"renders"| node_views
node_items -.->|"requests"| node_item_service
node_service -->|"delegates"| node_generic_dao
node_order_service -->|"calls"| node_dao
node_order_service -->|"saves through"| node_service
node_item_service -->|"calls"| node_dao
node_item_service -->|"updates through"| node_service
node_dao -->|"uses"| node_model
node_generic_dao -->|"extends"| node_model
node_dao -->|"queries"| node_database
node_service -->|"sets messages"| node_flash
node_validation -.->|"stores errors"| node_flash
node_reports -.->|"may generate"| node_pdf

click node_entry "https://github.com/fabiojr933/tcc_faculdade/blob/master/index.php"
click node_router "https://github.com/fabiojr933/tcc_faculdade/blob/master/app/core/Core.php"
click node_controllers "https://github.com/fabiojr933/tcc_faculdade/tree/master/app/controllers"
click node_views "https://github.com/fabiojr933/tcc_faculdade/tree/master/app/views"
click node_customers "https://github.com/fabiojr933/tcc_faculdade/blob/master/app/controllers/ClienteController.php"
click node_products "https://github.com/fabiojr933/tcc_faculdade/blob/master/app/controllers/ProdutoController.php"
click node_categories "https://github.com/fabiojr933/tcc_faculdade/blob/master/app/controllers/CategoriaController.php"
click node_mechanics "https://github.com/fabiojr933/tcc_faculdade/blob/master/app/controllers/MecanicoController.php"
click node_salespeople "https://github.com/fabiojr933/tcc_faculdade/blob/master/app/controllers/VendedorController.php"
click node_objects "https://github.com/fabiojr933/tcc_faculdade/blob/master/app/controllers/ObjetoController.php"
click node_orders "https://github.com/fabiojr933/tcc_faculdade/blob/master/app/controllers/OrdemServicoController.php"
click node_items "https://github.com/fabiojr933/tcc_faculdade/blob/master/app/controllers/ItemController.php"
click node_reports "https://github.com/fabiojr933/tcc_faculdade/blob/master/app/controllers/RelatorioController.php"
click node_charts "https://github.com/fabiojr933/tcc_faculdade/blob/master/app/controllers/GraficoController.php"
click node_service "https://github.com/fabiojr933/tcc_faculdade/blob/master/app/models/service/Service.php"
click node_order_service "https://github.com/fabiojr933/tcc_faculdade/blob/master/app/models/service/OrdemServicoService.php"
click node_item_service "https://github.com/fabiojr933/tcc_faculdade/blob/master/app/models/service/ItemService.php"
click node_dao "https://github.com/fabiojr933/tcc_faculdade/blob/master/app/models/dao/OrdemServicoDao.php"
click node_generic_dao "https://github.com/fabiojr933/tcc_faculdade/blob/master/app/models/dao/Dao.php"
click node_model "https://github.com/fabiojr933/tcc_faculdade/blob/master/app/core/Model.php"
click node_flash "https://github.com/fabiojr933/tcc_faculdade/blob/master/app/core/Flash.php"
click node_validation "https://github.com/fabiojr933/tcc_faculdade/blob/master/app/core/Validacao.php"
click node_pdf "https://github.com/fabiojr933/tcc_faculdade/blob/master/app/classes/pdf/fpdf.php"

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_router,node_controllers,node_views,node_staff toneBlue
class node_customers,node_products,node_categories,node_mechanics,node_salespeople,node_objects,node_database toneAmber
class node_orders,node_items,node_reports,node_charts,node_order_service,node_item_service,node_dao toneMint
class node_service,node_generic_dao,node_model,node_flash,node_validation,node_pdf toneRose
```

## Components

### Web application

- [PHP entry point](https://github.com/fabiojr933/tcc_faculdade/blob/master/index.php): `index.php`
- [Request router](https://github.com/fabiojr933/tcc_faculdade/blob/master/app/core/Core.php): `app/core/Core.php`
- [Page controllers](https://github.com/fabiojr933/tcc_faculdade/tree/master/app/controllers): `app/controllers`
- [Web views](https://github.com/fabiojr933/tcc_faculdade/tree/master/app/views): `app/views`

### Reference records

- [Customer records](https://github.com/fabiojr933/tcc_faculdade/blob/master/app/controllers/ClienteController.php): `app/controllers/ClienteController.php`
- [Product records](https://github.com/fabiojr933/tcc_faculdade/blob/master/app/controllers/ProdutoController.php): `app/controllers/ProdutoController.php`
- [Category records](https://github.com/fabiojr933/tcc_faculdade/blob/master/app/controllers/CategoriaController.php): `app/controllers/CategoriaController.php`
- [Mechanic records](https://github.com/fabiojr933/tcc_faculdade/blob/master/app/controllers/MecanicoController.php): `app/controllers/MecanicoController.php`
- [Salesperson records](https://github.com/fabiojr933/tcc_faculdade/blob/master/app/controllers/VendedorController.php): `app/controllers/VendedorController.php`
- [Object records](https://github.com/fabiojr933/tcc_faculdade/blob/master/app/controllers/ObjetoController.php): `app/controllers/ObjetoController.php`

### Service orders

- [Order management](https://github.com/fabiojr933/tcc_faculdade/blob/master/app/controllers/OrdemServicoController.php): `app/controllers/OrdemServicoController.php`
- [Order items](https://github.com/fabiojr933/tcc_faculdade/blob/master/app/controllers/ItemController.php): `app/controllers/ItemController.php`
- [Reports](https://github.com/fabiojr933/tcc_faculdade/blob/master/app/controllers/RelatorioController.php): `app/controllers/RelatorioController.php`
- [Charts](https://github.com/fabiojr933/tcc_faculdade/blob/master/app/controllers/GraficoController.php): `app/controllers/GraficoController.php`
- [Order services](https://github.com/fabiojr933/tcc_faculdade/blob/master/app/models/service/OrdemServicoService.php): `app/models/service/OrdemServicoService.php`
- [Item services](https://github.com/fabiojr933/tcc_faculdade/blob/master/app/models/service/ItemService.php): `app/models/service/ItemService.php`
- [Order data access](https://github.com/fabiojr933/tcc_faculdade/blob/master/app/models/dao/OrdemServicoDao.php): `app/models/dao/OrdemServicoDao.php`

### Shared infrastructure

- [Shared services](https://github.com/fabiojr933/tcc_faculdade/blob/master/app/models/service/Service.php): `app/models/service/Service.php`
- [Generic data access](https://github.com/fabiojr933/tcc_faculdade/blob/master/app/models/dao/Dao.php): `app/models/dao/Dao.php`
- [Database model](https://github.com/fabiojr933/tcc_faculdade/blob/master/app/core/Model.php): `app/core/Model.php`
- [Session messages](https://github.com/fabiojr933/tcc_faculdade/blob/master/app/core/Flash.php): `app/core/Flash.php`
- [Input validation](https://github.com/fabiojr933/tcc_faculdade/blob/master/app/core/Validacao.php): `app/core/Validacao.php`
- [PDF generation](https://github.com/fabiojr933/tcc_faculdade/blob/master/app/classes/pdf/fpdf.php): `app/classes/pdf/fpdf.php`

### Other components

- **Staff user**
- **Application database**

## Connections

- Staff user → PHP entry point: uses
- PHP entry point → Request router: starts (evidence: `index.php`)
- Request router → Page controllers: dispatches (evidence: `app/core/Core.php`)
- Page controllers → Web views: loads
- Customer records → Shared services: queries (evidence: `app/controllers/ClienteController.php`)
- Product records → Shared services: queries (evidence: `app/controllers/ProdutoController.php`)
- Order management → Order services: requests (evidence: `app/controllers/OrdemServicoController.php`)
- Order management → Shared services: queries (evidence: `app/controllers/OrdemServicoController.php`)
- Order management → Order data access: closes bay (evidence: `app/controllers/OrdemServicoController.php`)
- Order management → Web views: renders (evidence: `app/controllers/OrdemServicoController.php`)
- Order items → Item services: requests (evidence: `app/controllers/ItemController.php`)
- Shared services → Generic data access: delegates (evidence: `app/models/service/Service.php`)
- Order services → Order data access: calls (evidence: `app/models/service/OrdemServicoService.php`)
- Order services → Shared services: saves through (evidence: `app/models/service/OrdemServicoService.php`)
- Item services → Order data access: calls (evidence: `app/models/service/ItemService.php`)
- Item services → Shared services: updates through (evidence: `app/models/service/ItemService.php`)
- Order data access → Database model: uses (evidence: `app/models/dao/OrdemServicoDao.php`)
- Generic data access → Database model: extends (evidence: `app/models/dao/Dao.php`)
- Order data access → Application database: queries (evidence: `app/models/dao/OrdemServicoDao.php`)
- Shared services → Session messages: sets messages (evidence: `app/models/service/Service.php`)
- Input validation → Session messages: stores errors
- Reports → PDF generation: may generate
