schulos/docs/TODO_VISUAL.md

SchulOS PRD Implementation Todo — Visual Roadmap

Current Status: 30% Complete (Week 1)

COMPLETED THIS WEEK (Week 1):
✅ Calendar Consolidation (88% code reduction)
✅ Grading Consolidation (81% code reduction)
✅ Navigation Updates

---

Critical Path: 8 Weeks to PRD Compliance

WEEK 1 (This Week) — Foundation

[✅] Consolidate Calendar & Grading
[  ] API Response Standardization
[  ] useApi Hook Universal Implementation
[  ] Complete Module A: Academics Core
[  ] Complete Module K: Identity & Admin

Blockers: Everything else depends on these

---

WEEK 2-3 — Legal & Core

[  ] Module L: GDPR/DSGVO Engine (CRITICAL FOR GERMANY)
[  ] Database: Add 39 missing tables
[  ] Module A: Complete Academics (Reports, Mastery Levels)
[  ] Module C: Escalation Policy Engine
[  ] Module I: Calendar (Complete, test business-day logic)

Blockers: Module L must complete before any school go-live

---

WEEK 4 — Exam & Messaging

[  ] Module F: Exam Mode Browser Lockdown
[  ] Module C: Finish Escalation (with Module I integration)
[  ] Module H: Notifications Hub

Blockers: Exams need lockdown for use-case viability

---

WEEK 5-6 — Extended Core

[  ] Module D: Learning Hub (Search, Progress)
[  ] Module G: Digital Notebook (Stylus Support)
[  ] Module B: Signage System

Blockers: None (after previous weeks)

---

WEEK 7-8 — Polish & Extras

[  ] Module J: Dashboard Widgets
[  ] Module E: AI Tutor (Full Integration)
[  ] Testing & Hardening
[  ] Deployment Documentation

Blockers: None

---

Module Implementation Status

#	Module	Status	Size	Tests	Priority
A	Academics Core	40% 🟡	8K LOC	None	🔴 CRITICAL
B	Signage	5% 🔴	2K LOC	None	🟢 Low
C	Communication	30% 🟡	6K LOC	None	🔴 CRITICAL
D	Learning Hub	20% 🔴	4K LOC	None	🟢 Low
E	AI Tutor	20% 🔴	3K LOC	None	🟢 Low
F	Exam Mode	35% 🟡	5K LOC	None	🔴 CRITICAL
G	Digital Notebook	10% 🔴	3K LOC	None	🟢 Low
H	Notifications	0% 🔴	4K LOC	None	🟡 HIGH
I	Calendar	70% 🟢	2K LOC	Basic	🟡 HIGH
J	Dashboard	40% 🟡	3K LOC	None	🟢 Low
K	Identity & Admin	50% 🟡	6K LOC	None	🔴 CRITICAL
L	Legal/GDPR	0% 🔴	5K LOC	None	🔴 LEGAL REQUIREMENT
TOTAL	12 Modules	30%	51K LOC	<5%	70% To Do

---

Missing Database Tables (39 Required)

Priority 1: Add This Week

Module L (GDPR):
[ ] DataRetentionPolicy
[ ] ConsentRecord  
[ ] AccessLog
[ ] DataExportRequest
[ ] BreachNotification

Module A (Academics):
[ ] MasteryLevelDefinition
[ ] ClassCompetencyAssignment

Priority 2: Add Week 2

Module C (Communication):
[ ] EscalationPolicy
[ ] EscalationRequest
[ ] ClassMessagingLock

Module H (Notifications):
[ ] Notification
[ ] NotificationTemplate
[ ] NotificationDeliveryLog

Module I (Calendar):
[ ] SchoolCalendar
[ ] ClassPeriod
[ ] RecurrencePattern

Priority 3: Add Week 3-4

Remaining 22 tables for Modules B, D, E, F, G, J

---

Code Quality Metrics

Current State

Components:        72 (HIGH DUPLICATION)
API Routes:        264 (INCONSISTENT)
LOC Total:         ~200K
Test Coverage:     <50%
Bundle Size:       ~2.5MB

Target State (Week 8)

Components:        45 (consolidated)
API Routes:        80 (standardized)
LOC Total:         ~140K
Test Coverage:     70%+
Bundle Size:       ~1.8MB

Reductions Needed

Components:        -27 (consolidate)
API Routes:        -184 (standardize)
LOC:               -60K (remove duplication)
Add Tests:         +2000 (increase coverage)

---

Daily/Weekly Checklist

Today's Work

• Calendar consolidation completed
• Grading consolidation completed
• Navigation updated
• PRD status report created
• Todo list created

This Week (Days 2-5)

• Review consolidation (performance test)
• Start API standardization
• Complete Module A DB schema
• Begin useApi hook refactor (first 10 routes)

Next Week (Week 2)

• Complete useApi implementation (all 264 routes)
• Start Module L (GDPR)
• Add 10 priority DB tables
• Complete Module A academics core

---

Risk Tracking

Risk	Impact	Mitigation	Status
Module L not ready for German law	🔴 CRITICAL	Start Week 1, hire legal consultant	⚠️ At Risk
Browser lockdown impossible	🟡 HIGH	Research Electron/Kiosk.js alternatives	✅ Planned
Database schema incomplete	🟡 HIGH	Add all 39 tables Week 1-2	⚠️ In Progress
API inconsistency	🟡 HIGH	Standardize responses + middleware	🚀 Starting
Test coverage <5%	🟡 HIGH	Add 2000+ tests in parallel	✅ Planned

---

Success Criteria (Week 8 Deliverable)

• 12 modules defined
• 100% module feature parity with PRD
• All 39+ DB tables implemented
• 264 API routes standardized
• 70%+ test coverage
• Module L (GDPR) production-ready
• Zero hardcoded values (all DB-driven)
• Soft deletes + audit trail
• DPIA gating functional
• Self-hosting Docker image ready

---

Deployment Timeline

Week 1-3:  Stabilize Foundation + Legal (Module L)
Week 4-6:  Implement Core Features (Modules A-H, K)
Week 7-8:  Polish, Test, Document, Deploy
Week 9:    Go-Live to Real School

---

Notes

1. Module L (GDPR) is non-negotiable — German schools cannot use without it
2. Database first — Define all tables before UI code
3. No hardcoding — All rules, thresholds, templates must be DB-driven
4. Tests early — Each module needs tests, not afterthought
5. Self-hosting path — Docker + SQLite + local storage must work

---

Created: August 1, 2026
Target Completion: September 26, 2026 (8 weeks)
Status: On Track (with focused execution required)