🎓 LEMS System Process Flow Diagram
Learners Electronic Monitoring System - Admin & Teacher Workflows
graph TB
Start([LEMS System]) --> Auth{Authentication}
%% Authentication Branch
Auth -->|Admin Login| AdminPanel[Admin Panel
/admin/login]
Auth -->|Teacher Login| TeacherPanel[Teacher Panel
/teacher/login]
Auth -->|Public Access| PublicDash[Public Dashboard
/]
%% ADMIN WORKFLOW
AdminPanel --> AdminDash[Admin Dashboard
Overview Page]
AdminDash --> AdminOps{Admin Operations}
AdminOps -->|Manage| UserMgmt[User Management]
AdminOps -->|Configure| SystemConfig[System Configuration]
AdminOps -->|Reports| AdminReports[Reports]
AdminOps -->|Manage| DataMgmt[Data Management]
AdminOps -->|Manage| EventMgmt[Event Management]
%% User Management
UserMgmt --> CreateUser[Create Admin Users]
UserMgmt --> CreateTeacher[Create Teachers]
UserMgmt --> ImportTeachers[Import Teachers CSV]
UserMgmt --> AssignSchool[Assign School to User]
%% System Configuration
SystemConfig --> ManageBrgy[Manage Barangays]
SystemConfig --> ManageSchool[Manage Schools]
SystemConfig --> ManageProgram[Manage Programs]
SystemConfig --> ManageMunicipal[Manage Municipal]
SystemConfig --> ManageTools[Manage Assessment Tools
with Level Brackets]
%% Data Management by Admin
DataMgmt --> AdminLearners[Manage All Learners]
DataMgmt --> AdminAssess[View All Assessments]
DataMgmt --> AdminPPA[Manage PPAs]
%% PPA Management
AdminPPA --> PPAForm[Create / Edit PPA]
PPAForm --> PPAPhases[Add Implementation Phases
Quarter + Amount]
PPAForm --> PPAFunds[Add Source Funds
Fund Source + Amount]
PPAFunds --> PPAPublish[Publish PPA]
%% Event Management
EventMgmt --> CreateEvent[Create Event]
CreateEvent --> PublishEvent[Publish Event]
PublishEvent --> PublicEvents[Public Events Calendar
/events]
%% Admin Reports
AdminReports --> MunicipalRpt[Municipal Report
/admin/municipal-report]
MunicipalRpt --> ToolStats[Assessment Tool Stats
Drill-down + PDF]
AdminReports --> SchoolRpt[School Report
/admin/school-report]
SchoolRpt --> SchoolStatsPdf[School Stats PDF]
AdminReports --> BarangayRpt[Barangay Report
/admin/barangay-report]
BarangayRpt --> BrgyStatsPdf[Barangay Stats PDF]
AdminReports --> StrugglingRpt[Struggling Learners
/admin/struggling-learners]
%% TEACHER WORKFLOW
TeacherPanel --> TeacherDash[Teacher Dashboard
School-specific]
TeacherDash --> TeacherOps{Teacher Operations}
TeacherOps -->|Manage| LearnerMgmt[Learner Management]
TeacherOps -->|Create| AssessmentMgmt[Assessment Management]
TeacherOps -->|Generate| TeacherReports[School Reports]
TeacherOps -->|Update| ProfileMgmt[Profile Management]
%% Learner Management
LearnerMgmt --> AddLearner[Add Learners]
LearnerMgmt --> EditLearner[Edit Learner Info]
LearnerMgmt --> ImportLearner[Import Learners CSV]
LearnerMgmt --> ExportLearner[Export / Print Learners]
%% Assessment Flow
AssessmentMgmt --> CreateAssess[1. Create Assessment]
CreateAssess --> SelectTool[2. Select Assessment Tool
+ School Year]
SelectTool --> EnrollLearners[3. Enroll Learners]
EnrollLearners --> RecordPretest[4. Record Pre-test Scores
level + value]
RecordPretest --> Intervene[5. Teaching / Intervention]
Intervene --> RecordPosttest[6. Record Post-test Scores
post_level + post_value]
RecordPosttest --> AssessComplete[7. Assessment Complete]
%% Teacher Reports
TeacherReports --> SchoolStats[School Statistics]
TeacherReports --> LearnerProgress[Learner Progress]
TeacherReports --> AssessResults[Assessment Results
Pre vs Post comparison]
%% Profile Management
ProfileMgmt --> UpdateProfile[Update Personal Info]
ProfileMgmt --> UpdateEducation[Education Background]
ProfileMgmt --> UpdateService[Service History]
ProfileMgmt --> ChangePassword[Change Password]
%% DATA ANALYSIS
AssessComplete --> DataAnalysis[Data Analysis Engine]
AdminAssess --> DataAnalysis
DataAnalysis --> OverviewDash[Overview Dashboard Tabs]
OverviewDash --> SysOverview[System Overview Tab]
OverviewDash --> SchoolsTab[Schools Tab]
OverviewDash --> AnalyticsTab[Analytics Tab]
DataAnalysis --> LevelDist[Level Distribution Charts
Pre-test vs Post-test]
DataAnalysis --> ImprovementRate[Improvement Rate Metrics]
%% PUBLIC DASHBOARD
PublicDash --> PublicStats[System Statistics]
PublicStats --> TotalBrgy[Total Barangays]
PublicStats --> TotalSchools[Total Schools]
PublicStats --> TotalLearners[Total Learners]
PublicStats --> RecentAssess[Recent Assessments
Filter by SY and Tool]
PublicDash --> PublicEvents
%% Styling
classDef adminClass fill:#10b981,stroke:#059669,color:#fff
classDef teacherClass fill:#3b82f6,stroke:#2563eb,color:#fff
classDef publicClass fill:#8b5cf6,stroke:#7c3aed,color:#fff
classDef processClass fill:#f59e0b,stroke:#d97706,color:#fff
classDef dataClass fill:#06b6d4,stroke:#0891b2,color:#fff
classDef reportClass fill:#ef4444,stroke:#dc2626,color:#fff
classDef exportClass fill:#6366f1,stroke:#4f46e5,color:#fff
class AdminPanel,AdminDash,AdminOps,UserMgmt,SystemConfig,DataMgmt,EventMgmt adminClass
class TeacherPanel,TeacherDash,TeacherOps,LearnerMgmt,AssessmentMgmt,TeacherReports teacherClass
class PublicDash,PublicStats,PublicEvents publicClass
class CreateAssess,SelectTool,EnrollLearners,RecordPretest,RecordPosttest,AssessComplete processClass
class DataAnalysis,OverviewDash,SysOverview,SchoolsTab,AnalyticsTab,LevelDist,ImprovementRate dataClass
class AdminReports,MunicipalRpt,ToolStats,SchoolRpt,BarangayRpt,StrugglingRpt reportClass
class SchoolStatsPdf,BrgyStatsPdf,ExportLearner exportClass
System Roles & Access Levels
- Administrator (Admin Panel — /admin/login): Full system access — manages users,
schools, barangays, programs, municipal settings, assessment tools (with level brackets), PPAs, and
events
- Teacher (Teacher Panel — /teacher/login): School-specific access — manages learners
and assessments for their assigned school only; can update education background and service history
- Public Access (/): Read-only dashboard showing barangay/school/learner counts,
recent assessments (filterable by school year & tool), and public events calendar
Key Workflows
- Assessment Process: Create → Select tool + school year → Enroll learners → Record
pre-test (level + value) → Teaching/Intervention → Record post-test (post_level + post_value) →
Complete → Data analysis
- PPA Management: Create PPA → Add implementation phases (quarter + amount) → Add
source funds (fund + amount) → Set status/remarks → Publish; total amount auto-calculated on table
- Event Management: Admin creates event → Publishes event → Appears on public /events
calendar
- Data Flow: Assessment completion → Data analysis engine → Overview dashboard tabs
(System Overview, Schools, Analytics) + Report pages
Import & Export Capabilities
- Admin imports: Teachers via bulk CSV (name, email, employee_number, school_id,
contact)
- Teacher imports: Learners via bulk CSV (lrn, brgy, surname, gname, dob, gender +
optional fields); supports UTF-8 and Windows-1252 encoding
- Exports (auth-protected, rate-limited): Learners CSV/print, Barangay learners
CSV/print, Barangay Stats PDF, School Stats PDF, Assessment Tool Stats PDF
Admin Report Pages
- Municipal Report: System-wide per-tool assessment summary; filterable by school
year; drill-down to Assessment Tool Stats with PDF export
- School Report: Per-school breakdown tabbed by assessment subject; school year
filter; drill-down to School Stats PDF
- Barangay Report: Learner and assessment data by barangay; drill-down to Barangay
Stats PDF
- Struggling Learners: Identifies learners with low scores, no improvement, or
incomplete assessments — for intervention planning
- Assessment Tool Stats: Level distribution (pre-test vs post-test counts &
averages), improvement rate, school breakdown (top 10); PDF download
Color Legend
- Green — Admin
panel nodes
- Blue — Teacher
panel nodes
- Purple — Public
access nodes
- Amber —
Assessment process steps
- Cyan — Data
analysis & dashboard
- Red — Report
pages
- Indigo — Export
/ PDF nodes