Academy Coach Evaluation — AI Development Plan
What & Why
The coach evaluation tool exists (3-step wizard, sliders, checklists, DB tables, save routes) but has three gaps the user wants closed:
1. No AI-generated development plan — after a SuperAdmin completes an evaluation there is nowhere to generate, store, or display a coach-facing growth plan. 2. One template category doesn't fit academy coaching — "Game Management & Strategy" (lineup rotations, timeouts, reading opponents) is competition-coach work. Academy coaches never run matches; athletes return to their separate teams. That category needs an academy-appropriate replacement. 3. No history or read-only views — SuperAdmins can't browse past evaluations per coach, and coaches can't see the evaluations written about them (or any AI plan generated from those evaluations).
The goal is to complete the evaluation loop: SuperAdmin rates → AI plan is generated → coach can read their evaluation and plan on their coach portal.
Done looks like
- The "Game Management & Strategy" category is replaced with an academy-specific "Individual Athlete Development & Differentiated Instruction" category covering: managing mixed skill levels in one group, setting individual goals per athlete, tracking progress across sessions, and building athlete confidence and independence.
- After a SuperAdmin submits an evaluation, the system automatically generates and stores an AI development plan (no extra button click required). While it generates, a loading state is shown; once ready the plan appears as a new step 4 before the wizard closes.
- The AI plan is structured with: a brief overall summary, 2–3 strengths to acknowledge, 2–3 focused growth areas with specific next steps, a 30/60/90-day development path, and a recommended Volleyball Canada pathway or module where relevant.
- The AI prompt uses the coach's profile (academy level, NCCP status, years experience), all slider ratings and comments, and an explicit academy framing ("coaches develop individual athletes who return to their separate teams — not building one competition squad").
- A new page lists all academy coaches with their last evaluation date, overall score, and a link to view or create an evaluation.
- A coach can view their own past evaluations (read-only) and the AI plan from each on their Coach Portal.
- Creating evaluations is restricted to SuperAdmin only (the current POST route allows any ACADEMY_COACH — fix that).
- The AI plan is persisted on the row (, ) so it survives page refreshes.
Out of scope
- Emailing the evaluation or AI plan to the coach (future work).
- Editing or regenerating the AI plan after it has been created.
- Peer evaluations (coach evaluates another coach at the same level).
- Any changes to athlete-facing Penny homework or progress reports.
Steps
1. Update the evaluation template — In , remove the and add a new with academy-appropriate sliders and checklists: managing multiple skill levels simultaneously, setting and tracking individual goals, differentiating drills for athlete readiness, building independent learning habits in athletes, and celebrating individual growth milestones rather than team outcomes. Update the template to reflect the academy context.
2. Extend the DB schema — Add (nullable) and (nullable) to in . Run (or add to post-merge setup).
3. Add AI plan generation logic — Create (following the pattern in ). The function takes the coach's profile, all evaluation entries (ratings + notes), and overall notes. It builds a prompt with the academy context and calls to return a structured JSON plan: .
4. Wire AI plan into the submit route — In , after the transaction that saves the session + entries, kick off the AI plan generation asynchronously. Restrict the POST endpoint to SuperAdmin only (remove the fallback ACADEMY_COACH permission). Add a new endpoint that returns the session with entries + aiDevelopmentPlan (used for polling after submit). Also add a endpoint (SuperAdmin only) that returns each coach with their latest evaluation date and overall score.
5. Update the evaluation wizard (step 4) — After submit succeeds, add a 4th step that polls until is populated (with a 30-second timeout fallback). Display the plan in structured sections: summary card, strengths list, growth areas with next steps, 90-day path timeline, and resource links. Add a "Done" button that navigates to the admin coach evaluation list.
6. Add the SuperAdmin evaluation list page — Create at route . Shows a table/card list of all academy coaches with: avatar, name, coach level, last evaluation date (or "Never evaluated"), overall score badge, and action buttons ("View" / "New Evaluation"). "New Evaluation" links to the existing wizard. Register the route in and add it to the nav registry under SuperAdmin persona.
7. Add coach read-only evaluation history — On the Coach Portal (or as a sub-page ), add a section the coach can see showing their completed evaluations in reverse-chronological order. Each card shows date, overall score, the category breakdown, overall notes, and the AI development plan (collapsed by default, expandable). This view is read-only — no sliders or editing.
Relevant files
- - - - - - - - -
No comments:
Post a Comment