# joshuatayag/consumers_feedback_system architecture

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

- Interactive diagram: https://gitdiagram.com/joshuatayag/consumers_feedback_system
- Repository: https://github.com/joshuatayag/consumers_feedback_system

## Overview

This is a Laravel operations application for an electric utility, covering consumer and workforce administration, billing, service orders, meter changes, and warehouse requisitions. In the principal change-meter workflow, staff or contractor-facing clients act on requests; controllers use domain services and models to manage meter assignment, posting, and signatures. The tree also documents distinct membership, lifeline, electrician, AGMM, payments, and warehousing capabilities. Sampled files substantiate some change-meter and warehouse interactions; other branches are included from the file tree, with unverified connections omitted.

Main entry points: [`app/Http/Controllers/ChangeMeterRequestController.php`](https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Http/Controllers/ChangeMeterRequestController.php) (Change Requests), [`app/Services/ChangeMeterService.php`](https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Services/ChangeMeterService.php) (Metering Service), [`app/Models/ChangeMeterRequest.php`](https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Models/ChangeMeterRequest.php) (Change Requests), [`app/Models/KwhMeterRequestSerialNumber.php`](https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Models/KwhMeterRequestSerialNumber.php) (Meter Serials)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_change["Change Metering"]
  node_cm_web["Change Requests"]
  node_cm_api["Contractor API"]
  node_cm_service["Metering Service"]
  node_signatures["Signatures"]
  node_cm_records[("Change Requests")]
  node_meters[("Meter Inventory<br/>[Meter.php]")]
  node_kwh_requests[("KWh Requests")]
  node_serials[("Meter Serials")]
end

subgraph group_warehouse["Warehouse Operations"]
  node_mrf["Material Requisitions"]
  node_structures["Stock Structures"]
  node_stock[("Stock Catalog<br/>[StockedItem.php]")]
end

subgraph group_consumer["Consumer Services"]
  node_lifeline["Lifeline Programs"]
  node_membership["Membership"]
  node_service_orders["Service Orders"]
  node_payments["Payments"]
end

subgraph group_admin["Administration"]
  node_electricians["Electrician Registry"]
  node_identity["Users and Roles<br/>[UserController.php]"]
  node_user_model[("User Accounts<br/>[User.php]")]
  node_agm["AGMM and Raffles<br/>[AgmmController.php]"]
end

node_staff(("Staff / Contractors"))

node_staff -.->|"submits requests"| node_cm_web
node_staff -.->|"acts on requests"| node_cm_api
node_cm_web -->|"uses"| node_cm_service
node_cm_web -->|"reads and updates"| node_cm_records
node_cm_web -->|"queries"| node_kwh_requests
node_cm_web -->|"queries"| node_serials
node_cm_web -->|"queries"| node_meters
node_cm_api -->|"reads and updates"| node_cm_records
node_cm_api -->|"updates assignments"| node_meters
node_cm_service -->|"checks reservations"| node_cm_records
node_cm_service -->|"counts availability"| node_meters
node_cm_service -->|"checks reservations"| node_kwh_requests
node_cm_service -->|"counts assignments"| node_serials
node_cm_records -->|"relates requests"| node_serials
node_kwh_requests -->|"tracks serials"| node_serials
node_serials -->|"references meter"| node_meters
node_cm_web -->|"uses"| node_signatures
node_cm_api -->|"uses"| node_signatures
node_signatures -->|"stores signatures for"| node_cm_records
node_mrf -->|"queries items"| node_stock
node_mrf -->|"loads structures"| node_structures
node_structures -->|"uses stock items"| node_stock
node_identity -->|"uses accounts"| node_user_model

click node_cm_web "https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Http/Controllers/ChangeMeterRequestController.php"
click node_cm_api "https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Http/Controllers/API/ChangeMeterApiController.php"
click node_cm_service "https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Services/ChangeMeterService.php"
click node_signatures "https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Services/SignatureService.php"
click node_cm_records "https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Models/ChangeMeterRequest.php"
click node_meters "https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Models/Meter.php"
click node_kwh_requests "https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Models/KwhMeterRequest.php"
click node_serials "https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Models/KwhMeterRequestSerialNumber.php"
click node_mrf "https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Http/Controllers/PowerHouse/Warehousing/MaterialRequisitionFormController.php"
click node_structures "https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Http/Controllers/PowerHouse/DataManagement/Warehousing/StructureController.php"
click node_stock "https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Models/DataManagement/StockedItem.php"
click node_lifeline "https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Http/Controllers/LifelineController.php"
click node_membership "https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Http/Controllers/MembershipController.php"
click node_service_orders "https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Http/Controllers/ServiceConnectOrderController.php"
click node_payments "https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Http/Controllers/PaymentTransactionController.php"
click node_electricians "https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Http/Controllers/ElectricianController.php"
click node_identity "https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Http/Controllers/Auth/UserController.php"
click node_user_model "https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Models/User.php"
click node_agm "https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Http/Controllers/AgmmController.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_cm_web,node_cm_api,node_cm_service,node_signatures,node_cm_records,node_meters,node_kwh_requests,node_serials toneBlue
class node_mrf,node_structures,node_stock toneAmber
class node_lifeline,node_membership,node_service_orders,node_payments toneMint
class node_electricians,node_identity,node_user_model,node_agm toneRose
class node_staff toneIndigo
```

## Components

### Change Metering

- [Change Requests](https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Http/Controllers/ChangeMeterRequestController.php): `app/Http/Controllers/ChangeMeterRequestController.php`
- [Contractor API](https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Http/Controllers/API/ChangeMeterApiController.php): `app/Http/Controllers/API/ChangeMeterApiController.php`
- [Metering Service](https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Services/ChangeMeterService.php): `app/Services/ChangeMeterService.php`
- [Signatures](https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Services/SignatureService.php): `app/Services/SignatureService.php`
- [Change Requests](https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Models/ChangeMeterRequest.php): `app/Models/ChangeMeterRequest.php`
- [Meter Inventory](https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Models/Meter.php): `app/Models/Meter.php`
- [KWh Requests](https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Models/KwhMeterRequest.php): `app/Models/KwhMeterRequest.php`
- [Meter Serials](https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Models/KwhMeterRequestSerialNumber.php): `app/Models/KwhMeterRequestSerialNumber.php`

### Warehouse Operations

- [Material Requisitions](https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Http/Controllers/PowerHouse/Warehousing/MaterialRequisitionFormController.php): `app/Http/Controllers/PowerHouse/Warehousing/MaterialRequisitionFormController.php`
- [Stock Structures](https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Http/Controllers/PowerHouse/DataManagement/Warehousing/StructureController.php): `app/Http/Controllers/PowerHouse/DataManagement/Warehousing/StructureController.php`
- [Stock Catalog](https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Models/DataManagement/StockedItem.php): `app/Models/DataManagement/StockedItem.php`

### Consumer Services

- [Lifeline Programs](https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Http/Controllers/LifelineController.php): `app/Http/Controllers/LifelineController.php`
- [Membership](https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Http/Controllers/MembershipController.php): `app/Http/Controllers/MembershipController.php`
- [Service Orders](https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Http/Controllers/ServiceConnectOrderController.php): `app/Http/Controllers/ServiceConnectOrderController.php`
- [Payments](https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Http/Controllers/PaymentTransactionController.php): `app/Http/Controllers/PaymentTransactionController.php`

### Administration

- [Electrician Registry](https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Http/Controllers/ElectricianController.php): `app/Http/Controllers/ElectricianController.php`
- [Users and Roles](https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Http/Controllers/Auth/UserController.php): `app/Http/Controllers/Auth/UserController.php`
- [User Accounts](https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Models/User.php): `app/Models/User.php`
- [AGMM and Raffles](https://github.com/joshuatayag/consumers_feedback_system/blob/main/app/Http/Controllers/AgmmController.php): `app/Http/Controllers/AgmmController.php`

### Other components

- **Staff / Contractors**

## Connections

- Staff / Contractors → Change Requests: submits requests
- Staff / Contractors → Contractor API: acts on requests
- Change Requests → Metering Service: uses (evidence: `app/Http/Controllers/ChangeMeterRequestController.php`)
- Change Requests → Change Requests: reads and updates (evidence: `app/Http/Controllers/ChangeMeterRequestController.php`)
- Change Requests → KWh Requests: queries (evidence: `app/Http/Controllers/ChangeMeterRequestController.php`)
- Change Requests → Meter Serials: queries (evidence: `app/Http/Controllers/ChangeMeterRequestController.php`)
- Change Requests → Meter Inventory: queries (evidence: `app/Http/Controllers/ChangeMeterRequestController.php`)
- Contractor API → Change Requests: reads and updates (evidence: `app/Http/Controllers/API/ChangeMeterApiController.php`)
- Contractor API → Meter Inventory: updates assignments (evidence: `app/Http/Controllers/API/ChangeMeterApiController.php`)
- Metering Service → Change Requests: checks reservations (evidence: `app/Services/ChangeMeterService.php`)
- Metering Service → Meter Inventory: counts availability (evidence: `app/Services/ChangeMeterService.php`)
- Metering Service → KWh Requests: checks reservations (evidence: `app/Services/ChangeMeterService.php`)
- Metering Service → Meter Serials: counts assignments (evidence: `app/Services/ChangeMeterService.php`)
- Change Requests → Meter Serials: relates requests (evidence: `app/Models/ChangeMeterRequest.php`)
- KWh Requests → Meter Serials: tracks serials (evidence: `app/Models/KwhMeterRequest.php`)
- Meter Serials → Meter Inventory: references meter (evidence: `app/Models/KwhMeterRequestSerialNumber.php`)
- Change Requests → Signatures: uses (evidence: `app/Http/Controllers/ChangeMeterRequestController.php`)
- Contractor API → Signatures: uses (evidence: `app/Http/Controllers/API/ChangeMeterApiController.php`)
- Signatures → Change Requests: stores signatures for (evidence: `app/Services/SignatureService.php`)
- Material Requisitions → Stock Catalog: queries items (evidence: `app/Http/Controllers/PowerHouse/Warehousing/MaterialRequisitionFormController.php`)
- Material Requisitions → Stock Structures: loads structures (evidence: `app/Http/Controllers/PowerHouse/Warehousing/MaterialRequisitionFormController.php`)
- Stock Structures → Stock Catalog: uses stock items (evidence: `app/Http/Controllers/PowerHouse/DataManagement/Warehousing/StructureController.php`)
- Users and Roles → User Accounts: uses accounts (evidence: `app/Http/Controllers/Auth/UserController.php`)
