Spaces:
Runtime error
Runtime error
Greg
Claude Opus 4.7 (1M context)
Preparar despliegue en fly.io: monolito dockerizado + seeder demo
6aa6081 |
Download progress/sprint_plan.md from Talosware/talos-access: direct link, hf CLI and curl.
- Browser
- Download file 5.89 kB
-
https://huggingface.co/spaces/Talosware/talos-access/resolve/main/progress/sprint_plan.md
- Command line
-
hf download hf://spaces/Talosware/talos-access/progress/sprint_plan.md
-
curl -L -o sprint_plan.md https://huggingface.co/spaces/Talosware/talos-access/resolve/main/progress/sprint_plan.md
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
- Leader dispatches each feature to an Implementer
- Implementer builds code + tests + documents in
progress/current.md - Reviewer validates via
./init.sh+ manual checks - Advisor confirms business logic is correct
- Leader closes loop (log rotation + purge)