# vincent-ctrlv/cefpms architecture

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

- Interactive diagram: https://gitdiagram.com/vincent-ctrlv/cefpms
- Repository: https://github.com/vincent-ctrlv/cefpms

## Overview

CEPFMS is a local-government feedback platform with a public citizen portal and a secure staff/admin portal. The public workflow lets a citizen submit feedback, complaints, or proposals, receive a reference, and track progress; staff authenticate with a password and OTP, then review and manage cases, issue responses, and use dashboards and analytics. The graph preserves the documented moderation, audit, staff, chatbot, and notification capabilities. Some API and page implementations were not sampled, so those subsystem links reflect README-documented capabilities rather than inspected call chains.

Main entry points: [`app/controllers/api/submissions/create.php`](https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/api/submissions/create.php) (Submission intake), [`app/controllers/citizen/submit.php`](https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/citizen/submit.php) (Citizen pages), [`app/controllers/api/auth/login.php`](https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/api/auth/login.php) (Staff sign-in), [`app/controllers/admin/dashboard.php`](https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/admin/dashboard.php) (Admin dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_citizen["Citizen portal"]
  node_citizen_pages["Citizen pages<br/>[submit.php]"]
  node_submission_api["Submission intake<br/>[create.php]"]
  node_tracking["Case tracking<br/>[track.php]"]
end

subgraph group_staff["Staff portal"]
  node_sign_in["Staff sign-in<br/>[login.php]"]
  node_admin_dashboard["Admin dashboard<br/>[dashboard.php]"]
  node_case_management["Submission management<br/>[submissions.php]"]
  node_complaints["Complaint handling<br/>[complaints.php]"]
  node_proposals["Proposal handling<br/>[proposals.php]"]
  node_moderation["Moderation<br/>[moderation.php]"]
  node_responses["Official responses<br/>[responses.php]"]
  node_staff_admin["Staff administration<br/>[staff.php]"]
  node_audit["Audit log<br/>[audit-log.php]"]
end

subgraph group_casework["Casework services"]
  node_case_data[("Submission model<br/>[Submissions.php]")]
  node_classifier["AI classification<br/>[AIClassifier.php]"]
  node_spam["Spam screening<br/>[SpamService.php]"]
  node_uploads["Photo uploads"]
  node_email["Email and OTP<br/>[EmailService.php]"]
end

subgraph group_insight["Insights and support"]
  node_analytics["Analytics<br/>[summary.php]"]
  node_chat["Chat assistant<br/>[chatbot.php]"]
  node_notifications["Notifications<br/>[recent.php]"]
end

node_citizen_actor(("Citizen"))
node_staff_actor(("Staff"))

node_citizen_actor -->|"submits feedback"| node_citizen_pages
node_citizen_pages -.->|"posts submission"| node_submission_api
node_submission_api -->|"classifies content"| node_classifier
node_submission_api -->|"screens spam"| node_spam
node_submission_api -->|"handles photos"| node_uploads
node_submission_api -->|"sends confirmation"| node_email
node_submission_api -.->|"creates case"| node_case_data
node_citizen_actor -->|"tracks reference"| node_tracking
node_staff_actor -->|"signs in"| node_sign_in
node_sign_in -->|"delivers OTP"| node_email
node_staff_actor -->|"manages cases"| node_admin_dashboard
node_staff_actor -->|"reviews cases"| node_case_management
node_staff_actor -->|"handles complaints"| node_complaints
node_staff_actor -->|"reviews proposals"| node_proposals
node_staff_actor -->|"moderates submissions"| node_moderation
node_staff_actor -->|"issues responses"| node_responses
node_staff_actor -->|"manages staff"| node_staff_admin
node_staff_actor -->|"reviews audit log"| node_audit
node_staff_actor -->|"views analytics"| node_analytics
node_citizen_actor -.->|"asks questions"| node_chat
node_admin_dashboard -.->|"polls updates"| node_notifications

click node_citizen_pages "https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/citizen/submit.php"
click node_submission_api "https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/api/submissions/create.php"
click node_tracking "https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/citizen/track.php"
click node_case_data "https://github.com/vincent-ctrlv/cefpms/blob/main/app/models/Submissions.php"
click node_sign_in "https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/api/auth/login.php"
click node_admin_dashboard "https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/admin/dashboard.php"
click node_case_management "https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/admin/submissions.php"
click node_complaints "https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/admin/complaints.php"
click node_proposals "https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/admin/proposals.php"
click node_moderation "https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/admin/moderation.php"
click node_responses "https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/admin/responses.php"
click node_staff_admin "https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/admin/staff.php"
click node_audit "https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/admin/audit-log.php"
click node_analytics "https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/api/analytics/summary.php"
click node_chat "https://github.com/vincent-ctrlv/cefpms/blob/main/app/partials/chatbot.php"
click node_notifications "https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/api/notifications/recent.php"
click node_classifier "https://github.com/vincent-ctrlv/cefpms/blob/main/app/services/AIClassifier.php"
click node_spam "https://github.com/vincent-ctrlv/cefpms/blob/main/app/services/SpamService.php"
click node_uploads "https://github.com/vincent-ctrlv/cefpms/blob/main/app/services/FileUploadService.php"
click node_email "https://github.com/vincent-ctrlv/cefpms/blob/main/app/services/EmailService.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_citizen_pages,node_submission_api,node_tracking toneBlue
class node_sign_in,node_admin_dashboard,node_case_management,node_complaints,node_proposals,node_moderation,node_responses,node_staff_admin,node_audit toneAmber
class node_case_data,node_classifier,node_spam,node_uploads,node_email toneMint
class node_analytics,node_chat,node_notifications toneRose
class node_citizen_actor,node_staff_actor toneIndigo
```

## Components

### Citizen portal

- [Citizen pages](https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/citizen/submit.php): `app/controllers/citizen/submit.php`
- [Submission intake](https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/api/submissions/create.php): `app/controllers/api/submissions/create.php`
- [Case tracking](https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/citizen/track.php): `app/controllers/citizen/track.php`

### Staff portal

- [Staff sign-in](https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/api/auth/login.php): `app/controllers/api/auth/login.php`
- [Admin dashboard](https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/admin/dashboard.php): `app/controllers/admin/dashboard.php`
- [Submission management](https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/admin/submissions.php): `app/controllers/admin/submissions.php`
- [Complaint handling](https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/admin/complaints.php): `app/controllers/admin/complaints.php`
- [Proposal handling](https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/admin/proposals.php): `app/controllers/admin/proposals.php`
- [Moderation](https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/admin/moderation.php): `app/controllers/admin/moderation.php`
- [Official responses](https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/admin/responses.php): `app/controllers/admin/responses.php`
- [Staff administration](https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/admin/staff.php): `app/controllers/admin/staff.php`
- [Audit log](https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/admin/audit-log.php): `app/controllers/admin/audit-log.php`

### Casework services

- [Submission model](https://github.com/vincent-ctrlv/cefpms/blob/main/app/models/Submissions.php): `app/models/Submissions.php`
- [AI classification](https://github.com/vincent-ctrlv/cefpms/blob/main/app/services/AIClassifier.php): `app/services/AIClassifier.php`
- [Spam screening](https://github.com/vincent-ctrlv/cefpms/blob/main/app/services/SpamService.php): `app/services/SpamService.php`
- [Photo uploads](https://github.com/vincent-ctrlv/cefpms/blob/main/app/services/FileUploadService.php): `app/services/FileUploadService.php`
- [Email and OTP](https://github.com/vincent-ctrlv/cefpms/blob/main/app/services/EmailService.php): `app/services/EmailService.php`

### Insights and support

- [Analytics](https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/api/analytics/summary.php): `app/controllers/api/analytics/summary.php`
- [Chat assistant](https://github.com/vincent-ctrlv/cefpms/blob/main/app/partials/chatbot.php): `app/partials/chatbot.php`
- [Notifications](https://github.com/vincent-ctrlv/cefpms/blob/main/app/controllers/api/notifications/recent.php): `app/controllers/api/notifications/recent.php`

### Other components

- **Citizen**
- **Staff**

## Connections

- Citizen → Citizen pages: submits feedback
- Citizen pages → Submission intake: posts submission
- Submission intake → AI classification: classifies content (evidence: `app/controllers/api/submissions/create.php`)
- Submission intake → Spam screening: screens spam (evidence: `app/controllers/api/submissions/create.php`)
- Submission intake → Photo uploads: handles photos (evidence: `app/controllers/api/submissions/create.php`)
- Submission intake → Email and OTP: sends confirmation (evidence: `app/controllers/api/submissions/create.php`)
- Submission intake → Submission model: creates case
- Citizen → Case tracking: tracks reference
- Staff → Staff sign-in: signs in
- Staff sign-in → Email and OTP: delivers OTP (evidence: `app/controllers/api/auth/login.php`)
- Staff → Admin dashboard: manages cases
- Staff → Submission management: reviews cases
- Staff → Complaint handling: handles complaints
- Staff → Proposal handling: reviews proposals
- Staff → Moderation: moderates submissions
- Staff → Official responses: issues responses
- Staff → Staff administration: manages staff
- Staff → Audit log: reviews audit log
- Staff → Analytics: views analytics
- Citizen → Chat assistant: asks questions
- Admin dashboard → Notifications: polls updates
