Modali Platform Architecture & Site Organization
A Mutually Exclusive, Collectively Exhaustive (MECE) Structural Framework
This document defines the structural engineering, functional taxonomy, and page organization of the Modali platform. It articulates the separation between the unauthenticated Public Presentation Frontend and the 4 Dedicated Authenticated Dashboards, ensuring operational clarity for platform administrators, educational leaders, teachers, and learners.
1. The MECE Design Philosophy
Traditional educational software frequently collapses into a single cluttered interface where technical database tasks, institutional compliance, classroom lesson design, and student learning are entangled. Modali solves this through strict MECE (Mutually Exclusive, Collectively Exhaustive) partitioning.
Mutually Exclusive (ME)
No dashboard duplicates or interferes with another. A Classroom Teacher never sees database schema migrations or FTP sync buttons; a Student never sees peer cohort data; a School Administrator focuses on school-wide aggregation rather than manual class rostering.
Collectively Exhaustive (CE)
Every operational necessity across the educational lifecycle is fully accounted for: public visitor exploration, platform devops, institutional accreditation evidence, homeroom grouping, and learner self-advocacy.
2. Ecosystem Structural Blueprint
Visualizing how visitors transition between public presentation pages and the 4 authenticated portals.
Public Presentation Frontend
No Authentication Required
Designed for prospective school partners, accreditation evaluators, curriculum directors, and educators exploring Modali's empirical foundation.
/
/about
/contact
/udl-framework
/udl-principles-structure
/unified-model
/methodology
/udl-catalog
/curriculum-alignment
/international-schools-workflow
/international-accreditation-evidence
/philippines-framework
/learning-for-all-pedagogy
/ontario-student-profile-form
/ontario-class-profile-form
/references
/class-profile-matrix-synthesis
/learning-styles-vs-preferences
/student-profile-information-acquisition
4 Authenticated Portals
Role-Protected Access
Users sign in via Google OAuth or Demo credentials and are routed instantly by the DashboardDispatcherAction to their dedicated workspace.
Server telemetry, 1-click FTP codebase/database deployment, live 9-table schema metrics, SQL dumps, and user authorization controls.
School-wide diagnostic participation rates, grade-level cohort radar averages, Tier 2/3 multidisciplinary PLC referrals, and question bank calibration.
Classroom creation, student invite links (/join), Appendix A multi-student radar matrix, and algorithmic DI grouping engine with 62 UDL strategies.
1-click class enrollment, 15-minute diagnostic inventory, personal 8-Pillar radar visualization, dominant sensory/cognitive pathways, and personalized study playbook.
3. Comparative Functional Taxonomy across the 4 Portals
Detailed comparison illustrating the mutually exclusive capabilities and dedicated target audiences.
| Dimension | 🛠️ Technical Backend | 🏛️ School Admin | 🧑🏫 Teacher | 🎓 Student |
|---|---|---|---|---|
| Target Role | Platform Owner / DevOps (maa001@gmail.com) |
Principal, Academic Head, SENCO | Classroom Educator, Subject Specialist | K–12 Learner / Diagnostic Taker |
| Primary Route | /backend | /school-admin | /my-classes | /student-profile |
| Core Mission | Infrastructure stability, binary deployment, database integrity, user authorizations | Institutional diagnostic completion, cohort equity, PLC Tier 2/3 referrals | Class rosters, student enrollment, multi-student matrix, algorithmic DI grouping | Taking the 15-minute diagnostic, viewing 8-Pillar radar, adopting personalized study tips |
| Deployment Control | Full 1-Click FTP Deploy | Excluded | Excluded | Excluded |
| Database Inspector | 9 Core Tables & SQL Dumps | Excluded | Excluded | Excluded |
| Class & Roster Setup | Global Read / Manage | School Directory Audit | Create & Manage Own Classes | Excluded |
| Appendix A Matrix | Global Access | Grade-level Aggregations | Live Class Radar Matrix | Excluded (Individual Only) |
| Grouping & DI Engine | Available | Audit Mode | Algorithmic 3-Tier Grouping | Excluded |
| User Approvals | Approve / Promote Any Role | Excluded | Excluded | Excluded |
| View-As Switcher | Master Switcher [4 Roles] | Switch to Student | Switch to Student | Locked to Student |
4. Two-Tier Navigation Bar Architecture (Option A)
To keep the interface clean while supporting enterprise educational operations, Modali implements a dual-tier navigation system:
Always visible at the top of every page. Contains the brand identity, dynamic role context badge, Framework & Docs dropdown (accessing all 10 pedagogical guides), About Us, Contact Us, Take Diagnostic CTA, and the user profile / Superadmin master view switcher.
Renders exclusively for authenticated staff (superadmin, admin, teacher). Dynamically filters its tabs:
5. The 9 Core Relational Tables
The database schema is engineered for strict referential integrity and zero synchronization drift between Local Development (psy_dia01) and Live Production (ixzizote_mod01).
Google SSO identities, roles (superadmin, admin, teacher, student), approval status.
Learner demographics, student IDs, grade level, school affiliation, and birth records.
Class cohorts, subject, teacher ID, grade level, and unique invitation join codes (MOD-...).
Junction table managing student enrollment into teacher classes.
Calibrated psychometric items covering the 8 Developmental Pillars and 13 Subscales.
Grade-level diagnostic configurations (Kindergarten, Primary, Junior, Senior).
Computed assessment results, raw answers JSON, pillar scores, and radar coordinates.
Classroom-level tiered accommodations assigned from the 62-item UDL catalog.
Tier 2/3 multidisciplinary Professional Learning Community (PLC) referral logs.
6. Security, Authentication & Deployment Pipeline
How Modali maintains enterprise-grade security and automated continuous deployment:
ModSecurity-Immune Google SSO
Integrated with Google Identity Services (GSI) using client-side JWT tokens and tokenized OAuth states to eliminate 406 Not Acceptable ModSecurity web application firewall false positives.
Superadmin Governance
Superadmin privileges are hard-coded to maa001@gmail.com. Teacher and Administrator accounts require approval before entering protected workspaces, while students enjoy instant enrollment.
1-Click Full Stack Deployment
The CLI deployment engine (deploy_all_cli.php) serializes the codebase into an optimized zip archive, pushes via passive FTP, extracts via a secure tokenized bridge, and synchronizes the MySQL database in under 15 seconds.
Explore the Live Modali Portals
Test any role workspace with 1-click instant demo sign-in.