talos-access / progress /sprint_plan.md
Greg
Claude Opus 4.7 (1M context)
Preparar despliegue en fly.io: monolito dockerizado + seeder demo
6aa6081
|
Raw History Blame Contribute Delete
5.89 kB

Sprint Plan β€” Post-MVP Sprint (Friday 2026-05-29)

Status: πŸ“‹ PLANNED

Goal: Close remaining gaps blocking client demo β€” password reset, school calendar, section capacity, admin/obrero workflows, and basic documentation.

Constraint: 1 day β€” prioritize items a client would notice first in a demo.


Sprint A β€” Client-Demo Blockers (Morning, ~4 hrs)

ID Priority Description Effort Verification
F007a P0 Password reset flow β€” Admin-generated reset token + forced password change on next login. No email dependency (schools often lack mail infra). Add "Reset Password" button on UsersPage, backend endpoint POST /auth/reset-password/{user_id} returning a one-time token, and a ResetPasswordPage where user enters new password. ~2 hrs Admin resets user password β†’ user logs in with token β†’ forced to set new password β†’ redirected to dashboard
F006a P0 Hide Sat/Sun in schedule grid β€” Modify ScheduleModal.tsx DAY_NAMES to filter out SΓ‘bado/Domingo by default, add a "Mostrar fin de semana" toggle. No model changes needed. ~30 min Schedule modal shows only Mon-Fri; toggle shows all 7 days
F006b P1 Holiday calendar β€” New Holiday model (id, account_id, name, date, type enum national/school/vacation). CRUD endpoints at /settings/holidays. Admin UI page to add/edit/delete holidays (HolidaysPage.tsx or embedded in Settings). Block attendance creation on holiday dates at the backend. ~3 hrs Admin creates holiday β†’ teacher cannot take attendance for that date (409 or warning)

Sprint B β€” UX Completeness (Afternoon, ~3 hrs)

ID Priority Description Effort Verification
F006.1 P1 Section capacity enforcement β€” Add COUNT query in POST /enrollments and POST /enrollments/bulk checking Enrollment count < Section.max_students. Return 409 with message "SecciΓ³n al mΓ‘ximo de capacidad (N estudiantes)" for single, skip+message for bulk. ~1 hr Enroll 40 students β†’ 41st returns 409; bulk skips over-capacity with error row
F007b P1 Audit log viewer β€” Backend endpoint GET /audit-logs (paginated, filterable by user/action/date). Admin-only AuditLogsPage.tsx with table showing timestamp, user, action, resource, IP. Add to sidebar nav under ConfiguraciΓ³n. ~1.5 hrs Admin visits audit logs β†’ sees paginated list of actions with filters
F008 P2 Admin/obrero basic workflows β€” GET /reports/students endpoint for administrativo (student list with attendance stats). Obrero gets access to PublicCheckInPage as primary view. Late arrival analytics: GET /reports/late-arrivals?section_id=X&date_from=Y&date_to=Z counting records with RETRASO: in note, grouped by student, with frequency + avg tardiness. ~2.5 hrs Admin role sees student reports link; Obrero sees check-in as default; late arrivals endpoint returns structured data

Sprint C β€” Quality & Maintainability (Flex, ~2 hrs)

ID Priority Description Effort Verification
F009a P2 CHECKPOINTS.md + docs β€” Write CHECKPOINTS.md with verification criteria matching all 9 features. Create docs/architecture.md documenting system layers, patterns, data flow. Create docs/conventions.md with naming, style, commit conventions. ~1.5 hrs All 3 files exist with meaningful content
F009b P2 Core business logic tests β€” pytest fixtures with SQLite in-memory DB. Tests for: attendance present/absent counting, enrollment duplicate + capacity check, auth JWT validation, holiday attendance blocking. Aim for β‰₯20% coverage on backend/app/api/ and backend/app/models/. ~2 hrs pytest tests/ --cov=backend/app --cov-fail-under=20 passes

Execution Order (Recommended)

Morning (Sprint A):
  09:00-09:30  F006a β€” Hide Sat/Sun (quick win)
  09:30-11:30  F007a β€” Password reset (highest client demo value)
  11:30-12:30  F006b β€” Holiday calendar (model + backend)

Lunch

Afternoon (Sprint B):
  13:30-14:30  F006b β€” Holiday calendar UI + attendance blocking
  14:30-15:30  F006.1 β€” Section capacity enforcement
  15:30-17:00  F007b β€” Audit log viewer
  17:00-18:30  F008 β€” Admin/obrero workflows + late analytics

Flex (Sprint C, if time):
  18:30-19:30  F009a β€” CHECKPOINTS.md + docs
  19:30-21:00  F009b β€” Core business logic tests

Dependencies

Feature Depends On Risk
F006b (holiday calendar) New migration (018) Low β€” standard CRUD
F006a (hide Sat/Sun) None None β€” pure frontend change
F006.1 (capacity) F005 (already done β€” constraint fixed) Low β€” simple COUNT query
F007a (password reset) Auth system (already done) Medium β€” token expiry design
F007b (audit log UI) AuditLog model (already exists) Low β€” paginated query
F008 (role workflows) Permission system (already done) Medium β€” route guard changes
F009a (docs) None None β€” writing only
F009b (tests) Pytest fixtures Medium β€” SQLite in-memory DB setup

Rollback Plan

If Sprint A exceeds time, defer F006b (holiday calendar UI polish) to Sprint B. If Sprint B overflows, defer F008 (late analytics) to flex. The minimum viable for client demo is: password reset (F007a) + hide Sat/Sun (F006a) + section capacity (F006.1).


Pipeline

  1. Leader dispatches each feature to an Implementer
  2. Implementer builds code + tests + documents in progress/current.md
  3. Reviewer validates via ./init.sh + manual checks
  4. Advisor confirms business logic is correct
  5. Leader closes loop (log rotation + purge)