# itsruyyu/sikomando_final architecture

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

- Interactive diagram: https://gitdiagram.com/itsruyyu/sikomando_final
- Repository: https://github.com/itsruyyu/sikomando_final

## Overview

SIKOMANDO is a provincial-grant governance platform spanning applicant and organization registration through proposal review, approval, disbursement, accountability, and public transparency. The graph reflects the 12-phase lifecycle and the README’s documented assignment, notifications, QR verification, complaints, and audit capabilities. It shows the React entry point and Laravel API boundary, but does not infer controller-to-service wiring from unsampled source; service-level links are limited to explicit README capabilities or sampled behavior.

Main entry points: [`routes/api.php`](https://github.com/itsruyyu/sikomando_final/blob/main/routes/api.php) (Laravel API), [`src/App.jsx`](https://github.com/itsruyyu/sikomando_final/blob/main/src/App.jsx) (React application), [`app/Services/Workflow/SkService.php`](https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Workflow/SkService.php) (Digital decree and QR), [`app/Services/Integration/IntegrationManager.php`](https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Integration/IntegrationManager.php) (Government integrations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["User applications"]
  node_react["React application<br/>[App.jsx]"]
  node_api["Laravel API<br/>[api.php]"]
end

subgraph group_intake["Registration and proposals"]
  node_auth["Authentication<br/>[AuthService.php]"]
  node_org["Organization records"]
  node_case["Grant case"]
  node_program["Grant programs"]
end

subgraph group_review["Review and approval"]
  node_assign["Task assignments"]
  node_verify["Administrative verification"]
  node_evaluate["Technical evaluation"]
  node_survey["Field survey<br/>[SurveyService.php]"]
  node_ranking["Ranking and recommendation<br/>[RankingService.php]"]
  node_approval["Definitive approval"]
end

subgraph group_delivery["Funds and accountability"]
  node_sk["Digital decree and QR<br/>[SkService.php]"]
  node_nphd["Grant agreement<br/>[NphdService.php]"]
  node_disburse["Disbursement"]
  node_lpj["Spending accountability<br/>[LpjService.php]"]
  node_reconcile["Reconciliation and returns"]
  node_monitor["Post-award monitoring"]
  node_integrations["Government integrations"]
end

subgraph group_oversight["Transparency and governance"]
  node_publicdata["Public projections"]
  node_publication["Transparency publication"]
  node_complaint["Public complaints"]
  node_audit[("Audit trail<br/>[AuditLog.php]")]
  node_policy["Policy rules"]
  node_notifications["Notifications"]
end

node_applicant(("Applicant"))
node_staff(("Internal staff"))
node_public(("Public visitor"))

node_applicant -->|"uses portal"| node_react
node_staff -->|"uses workspace"| node_react
node_public -->|"views portal"| node_react
node_react -->|"sends requests"| node_api
node_api -->|"dispatches auth"| node_auth
node_api -->|"dispatches organization"| node_org
node_api -->|"dispatches cases"| node_case
node_api -->|"dispatches programs"| node_program
node_api -->|"dispatches assignments"| node_assign
node_api -->|"dispatches verification"| node_verify
node_api -->|"dispatches evaluation"| node_evaluate
node_api -->|"dispatches surveys"| node_survey
node_api -->|"dispatches ranking"| node_ranking
node_api -->|"dispatches approvals"| node_approval
node_api -->|"dispatches decrees"| node_sk
node_api -->|"dispatches agreements"| node_nphd
node_api -->|"dispatches disbursement"| node_disburse
node_api -->|"dispatches LPJ"| node_lpj
node_api -->|"dispatches reconciliation"| node_reconcile
node_api -->|"dispatches monitoring"| node_monitor
node_api -->|"dispatches transparency"| node_publicdata
node_api -->|"dispatches publication"| node_publication
node_api -->|"dispatches complaints"| node_complaint
node_api -->|"exposes audit records"| node_audit
node_api -->|"dispatches policy management"| node_policy
node_api -->|"dispatches notifications"| node_notifications
node_disburse -.->|"requests financial service"| node_integrations
node_survey -.->|"requests geocoding"| node_integrations
node_sk -.->|"requests signature"| node_integrations
node_public -->|"submits complaint"| node_complaint
node_public -->|"views projections"| node_publicdata
node_public -->|"verifies QR"| node_sk

click node_react "https://github.com/itsruyyu/sikomando_final/blob/main/src/App.jsx"
click node_api "https://github.com/itsruyyu/sikomando_final/blob/main/routes/api.php"
click node_auth "https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Auth/AuthService.php"
click node_org "https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Organization/OrganizationService.php"
click node_case "https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Case/GrantCaseService.php"
click node_program "https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Program/GrantProgramService.php"
click node_assign "https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Workflow/AssignmentService.php"
click node_verify "https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Workflow/VerificationService.php"
click node_evaluate "https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Workflow/EvaluationService.php"
click node_survey "https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Workflow/SurveyService.php"
click node_ranking "https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Workflow/RankingService.php"
click node_approval "https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Workflow/ApprovalService.php"
click node_sk "https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Workflow/SkService.php"
click node_nphd "https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Workflow/NphdService.php"
click node_disburse "https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Workflow/DisbursementService.php"
click node_lpj "https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Workflow/LpjService.php"
click node_reconcile "https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Workflow/ReconciliationService.php"
click node_monitor "https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Workflow/MonitoringService.php"
click node_publicdata "https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Transparency/PublicProjectionService.php"
click node_publication "https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Transparency/PublicationService.php"
click node_complaint "https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Complaint/ComplaintService.php"
click node_audit "https://github.com/itsruyyu/sikomando_final/blob/main/app/Models/AuditLog.php"
click node_policy "https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Policy/PolicyEngineService.php"
click node_integrations "https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Integration/IntegrationManager.php"
click node_notifications "https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Notification/NotificationService.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_react,node_api toneBlue
class node_auth,node_org,node_case,node_program toneAmber
class node_assign,node_verify,node_evaluate,node_survey,node_ranking,node_approval toneMint
class node_sk,node_nphd,node_disburse,node_lpj,node_reconcile,node_monitor,node_integrations toneRose
class node_publicdata,node_publication,node_complaint,node_audit,node_policy,node_notifications,node_applicant,node_staff,node_public toneIndigo
```

## Components

### User applications

- [React application](https://github.com/itsruyyu/sikomando_final/blob/main/src/App.jsx): `src/App.jsx`
- [Laravel API](https://github.com/itsruyyu/sikomando_final/blob/main/routes/api.php): `routes/api.php`

### Registration and proposals

- [Authentication](https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Auth/AuthService.php): `app/Services/Auth/AuthService.php`
- [Organization records](https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Organization/OrganizationService.php): `app/Services/Organization/OrganizationService.php`
- [Grant case](https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Case/GrantCaseService.php): `app/Services/Case/GrantCaseService.php`
- [Grant programs](https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Program/GrantProgramService.php): `app/Services/Program/GrantProgramService.php`

### Review and approval

- [Task assignments](https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Workflow/AssignmentService.php): `app/Services/Workflow/AssignmentService.php`
- [Administrative verification](https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Workflow/VerificationService.php): `app/Services/Workflow/VerificationService.php`
- [Technical evaluation](https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Workflow/EvaluationService.php): `app/Services/Workflow/EvaluationService.php`
- [Field survey](https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Workflow/SurveyService.php): `app/Services/Workflow/SurveyService.php`
- [Ranking and recommendation](https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Workflow/RankingService.php): `app/Services/Workflow/RankingService.php`
- [Definitive approval](https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Workflow/ApprovalService.php): `app/Services/Workflow/ApprovalService.php`

### Funds and accountability

- [Digital decree and QR](https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Workflow/SkService.php): `app/Services/Workflow/SkService.php`
- [Grant agreement](https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Workflow/NphdService.php): `app/Services/Workflow/NphdService.php`
- [Disbursement](https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Workflow/DisbursementService.php): `app/Services/Workflow/DisbursementService.php`
- [Spending accountability](https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Workflow/LpjService.php): `app/Services/Workflow/LpjService.php`
- [Reconciliation and returns](https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Workflow/ReconciliationService.php): `app/Services/Workflow/ReconciliationService.php`
- [Post-award monitoring](https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Workflow/MonitoringService.php): `app/Services/Workflow/MonitoringService.php`
- [Government integrations](https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Integration/IntegrationManager.php): `app/Services/Integration/IntegrationManager.php`

### Transparency and governance

- [Public projections](https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Transparency/PublicProjectionService.php): `app/Services/Transparency/PublicProjectionService.php`
- [Transparency publication](https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Transparency/PublicationService.php): `app/Services/Transparency/PublicationService.php`
- [Public complaints](https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Complaint/ComplaintService.php): `app/Services/Complaint/ComplaintService.php`
- [Audit trail](https://github.com/itsruyyu/sikomando_final/blob/main/app/Models/AuditLog.php): `app/Models/AuditLog.php`
- [Policy rules](https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Policy/PolicyEngineService.php): `app/Services/Policy/PolicyEngineService.php`
- [Notifications](https://github.com/itsruyyu/sikomando_final/blob/main/app/Services/Notification/NotificationService.php): `app/Services/Notification/NotificationService.php`

### Other components

- **Applicant**
- **Internal staff**
- **Public visitor**

## Connections

- Applicant → React application: uses portal
- Internal staff → React application: uses workspace
- Public visitor → React application: views portal
- React application → Laravel API: sends requests
- Laravel API → Authentication: dispatches auth
- Laravel API → Organization records: dispatches organization
- Laravel API → Grant case: dispatches cases
- Laravel API → Grant programs: dispatches programs
- Laravel API → Task assignments: dispatches assignments
- Laravel API → Administrative verification: dispatches verification
- Laravel API → Technical evaluation: dispatches evaluation
- Laravel API → Field survey: dispatches surveys
- Laravel API → Ranking and recommendation: dispatches ranking
- Laravel API → Definitive approval: dispatches approvals
- Laravel API → Digital decree and QR: dispatches decrees
- Laravel API → Grant agreement: dispatches agreements
- Laravel API → Disbursement: dispatches disbursement
- Laravel API → Spending accountability: dispatches LPJ
- Laravel API → Reconciliation and returns: dispatches reconciliation
- Laravel API → Post-award monitoring: dispatches monitoring
- Laravel API → Public projections: dispatches transparency
- Laravel API → Transparency publication: dispatches publication
- Laravel API → Public complaints: dispatches complaints
- Laravel API → Audit trail: exposes audit records
- Laravel API → Policy rules: dispatches policy management
- Laravel API → Notifications: dispatches notifications
- Disbursement → Government integrations: requests financial service
- Field survey → Government integrations: requests geocoding
- Digital decree and QR → Government integrations: requests signature
- Public visitor → Public complaints: submits complaint
- Public visitor → Public projections: views projections
- Public visitor → Digital decree and QR: verifies QR