# adrian294-ags/agri-kadua architecture

> Architecture diagram of the GitHub repository adrian294-ags/agri-kadua, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/adrian294-ags/agri-kadua
- Repository: https://github.com/adrian294-ags/agri-kadua

## Overview

Agri-Kadua is a Laravel cooperative-management application. Staff sign in, then use role- and branch-scoped workflows to manage farmer members, record harvest deliveries, approve storage into inventory, and handle payments. The repository also includes dashboard, employee, rate, audit, and stock-management areas. The excerpts show receiving orchestration and some model relationships; other connections below rely on the SOURCE INDEX references, so unsampled workflows are represented cautiously.

Main entry points: [`Agri-Kadua/app/Services/ReceivingService.php`](https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Services/ReceivingService.php) (Receiving service), [`Agri-Kadua/routes/web.php`](https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/routes/web.php) (Web routes), [`Agri-Kadua/app/Models/FarmerMember.php`](https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Models/FarmerMember.php) (Farmer members), [`Agri-Kadua/app/Http/Controllers/FarmerController.php`](https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Http/Controllers/FarmerController.php) (Farmer management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and oversight"]
  node_web["Web routes<br/>[web.php]"]
  node_login["Sign-in"]
  node_identity[("Users and roles<br/>[User.php]")]
  node_dashboard["Dashboard"]
  node_audit[("Audit records<br/>[AuditLog.php]")]
  node_seeddata["Co-op seed data<br/>[CoopSyncSeeder.php]"]
end

subgraph group_farmers["Farmer operations"]
  node_farmerctl["Farmer management"]
  node_members[("Farmer members<br/>[FarmerMember.php]")]
end

subgraph group_harvest["Receiving and inventory"]
  node_receivingctl["Receiving workflow"]
  node_receiving["Receiving service"]
  node_receipts[("Delivery receipts")]
  node_cropdata[("Crop varieties<br/>[CropVariety.php]")]
  node_schedule[("Delivery schedules")]
  node_inventory["Stock and storage<br/>[StockService.php]"]
end

subgraph group_finance["Payments and rates"]
  node_paymentctl["Payment management"]
  node_payments[("Payments<br/>[Payment.php]")]
  node_rates[("Crop rates<br/>[CropVariety.php]")]
end

node_staff(("Co-op staff"))

node_web -->|"routes to"| node_login
node_web -->|"routes to"| node_dashboard
node_web -->|"routes to"| node_farmerctl
node_web -->|"routes to"| node_receivingctl
node_web -->|"routes to"| node_paymentctl
node_staff -.->|"requests pages"| node_web
node_login -->|"authenticates users"| node_identity
node_farmerctl -->|"creates and reads"| node_members
node_farmerctl -->|"records changes"| node_audit
node_dashboard -->|"reads summaries"| node_members
node_receivingctl -->|"invokes"| node_receiving
node_receiving -->|"records and updates"| node_receipts
node_receiving -->|"validates member"| node_members
node_receiving -->|"checks variety"| node_cropdata
node_receiving -->|"updates schedule"| node_schedule
node_receiving -->|"writes stock"| node_inventory
node_receiving -->|"records actions"| node_audit
node_paymentctl -.->|"manages payments"| node_payments
node_payments -->|"references receipt"| node_receipts
node_rates -->|"rates varieties"| node_cropdata
node_seeddata -->|"populates records"| node_members

click node_web "https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/routes/web.php"
click node_login "https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Http/Controllers/Auth/LoginController.php"
click node_identity "https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Models/User.php"
click node_dashboard "https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Http/Controllers/DashboardController.php"
click node_audit "https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Models/AuditLog.php"
click node_farmerctl "https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Http/Controllers/FarmerController.php"
click node_members "https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Models/FarmerMember.php"
click node_receivingctl "https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Http/Controllers/ReceivingController.php"
click node_receiving "https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Services/ReceivingService.php"
click node_receipts "https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Models/DeliveryReceipt.php"
click node_cropdata "https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Models/CropVariety.php"
click node_schedule "https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Models/ScheduledDelivery.php"
click node_inventory "https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Services/StockService.php"
click node_paymentctl "https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Http/Controllers/PaymentController.php"
click node_payments "https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Models/Payment.php"
click node_rates "https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Models/CropVariety.php"
click node_seeddata "https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/database/seeders/CoopSyncSeeder.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_web,node_login,node_identity,node_dashboard,node_audit,node_seeddata toneBlue
class node_farmerctl,node_members toneAmber
class node_receivingctl,node_receiving,node_receipts,node_cropdata,node_schedule,node_inventory toneMint
class node_paymentctl,node_payments,node_rates toneRose
class node_staff toneIndigo
```

## Components

### Access and oversight

- [Web routes](https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/routes/web.php): `Agri-Kadua/routes/web.php`
- [Sign-in](https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Http/Controllers/Auth/LoginController.php): `Agri-Kadua/app/Http/Controllers/Auth/LoginController.php`
- [Users and roles](https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Models/User.php): `Agri-Kadua/app/Models/User.php`
- [Dashboard](https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Http/Controllers/DashboardController.php): `Agri-Kadua/app/Http/Controllers/DashboardController.php`
- [Audit records](https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Models/AuditLog.php): `Agri-Kadua/app/Models/AuditLog.php`
- [Co-op seed data](https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/database/seeders/CoopSyncSeeder.php): `Agri-Kadua/database/seeders/CoopSyncSeeder.php`

### Farmer operations

- [Farmer management](https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Http/Controllers/FarmerController.php): `Agri-Kadua/app/Http/Controllers/FarmerController.php`
- [Farmer members](https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Models/FarmerMember.php): `Agri-Kadua/app/Models/FarmerMember.php`

### Receiving and inventory

- [Receiving workflow](https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Http/Controllers/ReceivingController.php): `Agri-Kadua/app/Http/Controllers/ReceivingController.php`
- [Receiving service](https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Services/ReceivingService.php): `Agri-Kadua/app/Services/ReceivingService.php`
- [Delivery receipts](https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Models/DeliveryReceipt.php): `Agri-Kadua/app/Models/DeliveryReceipt.php`
- [Crop varieties](https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Models/CropVariety.php): `Agri-Kadua/app/Models/CropVariety.php`
- [Delivery schedules](https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Models/ScheduledDelivery.php): `Agri-Kadua/app/Models/ScheduledDelivery.php`
- [Stock and storage](https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Services/StockService.php): `Agri-Kadua/app/Services/StockService.php`

### Payments and rates

- [Payment management](https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Http/Controllers/PaymentController.php): `Agri-Kadua/app/Http/Controllers/PaymentController.php`
- [Payments](https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Models/Payment.php): `Agri-Kadua/app/Models/Payment.php`
- [Crop rates](https://github.com/adrian294-ags/agri-kadua/blob/main/Agri-Kadua/app/Models/CropVariety.php): `Agri-Kadua/app/Models/CropVariety.php`

### Other components

- **Co-op staff**

## Connections

- Web routes → Sign-in: routes to (evidence: `Agri-Kadua/routes/web.php`)
- Web routes → Dashboard: routes to (evidence: `Agri-Kadua/routes/web.php`)
- Web routes → Farmer management: routes to (evidence: `Agri-Kadua/routes/web.php`)
- Web routes → Receiving workflow: routes to (evidence: `Agri-Kadua/routes/web.php`)
- Web routes → Payment management: routes to (evidence: `Agri-Kadua/routes/web.php`)
- Co-op staff → Web routes: requests pages
- Sign-in → Users and roles: authenticates users (evidence: `Agri-Kadua/app/Http/Controllers/Auth/LoginController.php`)
- Farmer management → Farmer members: creates and reads (evidence: `Agri-Kadua/app/Http/Controllers/FarmerController.php`)
- Farmer management → Audit records: records changes (evidence: `Agri-Kadua/app/Http/Controllers/FarmerController.php`)
- Dashboard → Farmer members: reads summaries (evidence: `Agri-Kadua/app/Http/Controllers/DashboardController.php`)
- Receiving workflow → Receiving service: invokes (evidence: `Agri-Kadua/app/Http/Controllers/ReceivingController.php`)
- Receiving service → Delivery receipts: records and updates (evidence: `Agri-Kadua/app/Services/ReceivingService.php`)
- Receiving service → Farmer members: validates member (evidence: `Agri-Kadua/app/Services/ReceivingService.php`)
- Receiving service → Crop varieties: checks variety (evidence: `Agri-Kadua/app/Services/ReceivingService.php`)
- Receiving service → Delivery schedules: updates schedule (evidence: `Agri-Kadua/app/Services/ReceivingService.php`)
- Receiving service → Stock and storage: writes stock (evidence: `Agri-Kadua/app/Services/ReceivingService.php`)
- Receiving service → Audit records: records actions (evidence: `Agri-Kadua/app/Services/ReceivingService.php`)
- Payment management → Payments: manages payments
- Payments → Delivery receipts: references receipt (evidence: `Agri-Kadua/app/Models/Payment.php`)
- Crop rates → Crop varieties: rates varieties (evidence: `Agri-Kadua/app/Models/CropVariety.php`)
- Co-op seed data → Farmer members: populates records (evidence: `Agri-Kadua/database/seeders/CoopSyncSeeder.php`)
