parcours-utilisateur

Documents the end-to-end Toollab school management business workflow across all user roles.

Updated May 5, 2025
One-click install
npx skills add https://github.com/sebauvray/toollab-api --skill parcours-utilisateur-sebauvray
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: parcours-utilisateur
Source: https://github.com/sebauvray/toollab-api/tree/main/.claude/skills/parcours-utilisateur
Command: npx skills add https://github.com/sebauvray/toollab-api --skill parcours-utilisateur-sebauvray

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It gives developers and AI assistants the full functional context of the Toollab school management platform, so any change request can be correctly situated within the end-to-end business flow instead of being treated in isolation. ## Core Features & Use Cases - Complete role-based journey: Maps the flows of super-admin, director, registar, teacher, and family from school creation through enrollment, payment, attendance, decisions, and year rollover. - Business rules reference: Documents enrollment replace rules, payment validation (422 on overpayment), decision types per cursus, and year-closing behavior (409 on writes to closed years). - Explicit non-features: Lists what does not exist (no student portal, no online payment, no automatic re-enrollment, no soft delete) to prevent wrong assumptions. - Use Case: When asked to modify the enrollment screen, consult this Skill to understand that enrollment follows a replace rule per cursus and type, snapshots pricing, and requires a student UserRole on the family. ## Quick Start Explain where the family payment feature fits in the overall Toollab user journey and what rules apply to it.

Frequently Asked Questions about parcours-utilisateur

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How does student enrollment work in the Toollab school platform?▼

Enrollment uses POST /api/student-classrooms/enroll with a replace rule: any active enrollment of the student on the same cursus and type is removed before creating the new one. It validates the student role, class capacity, and duplicates, then snapshots the pricing.

How is a new school created in Toollab?▼

A super-admin creates a school via POST /api/schools, which in one transaction creates the school, the director user, an accepted director role, an active school year, and an invitation token emailed to the director for password setup.

What happens when a school year is closed in Toollab?▼

Closing happens when creating the next year via POST /api/school-years, which clones selected pricing and reductions. The old year becomes read-only: all write attempts return 409, and there is no automatic student re-enrollment.

Does Toollab support online payments or student accounts?▼

No. Payments are entered manually by staff (cash, card, check, exemption) and there is no online payment. Student accounts exist only to carry identity; there is no student portal or login.

Why does school creation fail with a 500 error on a fresh database?▼

On an unseeded database, the roles table is empty, so Role::where('slug','director') returns null and the route fails. Seed the database first, and create the first super-admin with the toollab:create-super-admin artisan command.