How vincent-ctrlv/cefpms works
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: create.php Submission intake · submit.php Citizen pages · login.php Staff sign-in · dashboard.php Admin dashboard
Components 22
Citizen portal
- Citizen pages
app/controllers/citizen/submit.php - Submission intake
app/controllers/api/submissions/create.php - Case tracking
app/controllers/citizen/track.php
Staff portal
- Staff sign-in
app/controllers/api/auth/login.php - Admin dashboard
app/controllers/admin/dashboard.php - Submission management
app/controllers/admin/submissions.php - Complaint handling
app/controllers/admin/complaints.php - Proposal handling
app/controllers/admin/proposals.php - Moderation
app/controllers/admin/moderation.php - Official responses
app/controllers/admin/responses.php - Staff administration
app/controllers/admin/staff.php - Audit log
app/controllers/admin/audit-log.php
Casework services
- Submission model
app/models/Submissions.php - AI classification
app/services/AIClassifier.php - Spam screening
app/services/SpamService.php - Photo uploads
app/services/FileUploadService.php - Email and OTP
app/services/EmailService.php
Insights and support
- Analytics
app/controllers/api/analytics/summary.php - Chat assistant
app/partials/chatbot.php - Notifications
app/controllers/api/notifications/recent.php
Other components
- Citizen
- Staff
Connections 21
- Citizen → Citizen pages: submits feedback
- Citizen pages → Submission intake: posts submission
- Submission intake → AI classification: classifies content
app/controllers/api/submissions/create.php - Submission intake → Spam screening: screens spam
app/controllers/api/submissions/create.php - Submission intake → Photo uploads: handles photos
app/controllers/api/submissions/create.php - Submission intake → Email and OTP: sends confirmation
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
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