Workout assignments — code map

API

Base path: /organizations/:orgId/assignments

Routes

Controller: apps/api/src/workout-assignments/workout-assignments.controller.ts Service: apps/api/src/workout-assignments/workout-assignments.service.ts (~1391 lines) Module: apps/api/src/workout-assignments/workout-assignments.module.ts

NestJS first-match-wins: literal routes (coach-overview, my-week, today, publish, bulk-*, program-day/replace, program-day/remove, program-day/preview, personal, feed, schedule) are declared above :id in the controller for routing precedence.

Cross-feature exports

forkSnapshotIfNeeded(assignmentId) is the canonical entry point for lazy-fork. Used by:

• apps/api/src/workouts/workouts.service.ts — resolveEditTarget and updateMovementPrescription.
• apps/api/src/workout-results/workout-results.service.ts — create (anchor result to snapshot id).

DTOs (apps/api/src/workout-assignments/dto/)

• create-assignment.dto.ts — legacy single-athlete create.
• update-assignment.dto.ts.
• assign-personal.dto.ts — { workoutId?, kind?, note?, programId?, date, athleteIds[], drip:'now'|'morning_of' }.
• assign-feed.dto.ts — { trackId, workoutId, publishAt, note? }.
• assign-schedule.dto.ts — { workoutId, classTypeId, slots:[{startAt, capacity}] }.
• set-published.dto.ts — bulk by id list.
• bulk-filter.dto.ts — WorkoutAssignmentsBulkPreviewDto, BulkDeleteDto, BulkPublishDto; WorkoutAssignmentsBulkFilter schema in libs/shared.
• replace-program-day.dto.ts — { programId, workoutId, date:'YYYY-MM-DD' }.
• remove-program-day.dto.ts — { programId, date:'YYYY-MM-DD' }.
• program-assignment-scope.ts — shared coaching-program and active-recipient validation for personal, legacy and template assignment creation. Program-day writes call it for program validation before touching the roster, so a foreign programId reports the program, not an empty roster.

Web

Routes

Components

• apps/web/src/components/overview/programming/ — the coaching program views:
  • member-week-grid.tsx — data, cell menus (workout/rest/note, publish toggle, chat), day-wide menu (assign/rest/note/replace/remove), the workout picker and bulk-actions sheets; renders its rows × 7 days grid through the shared week-grid.tsx (WeekGrid), the same component the daily-programming board uses — see daily-programming/code-map.md for the shared grid’s shape.
  • bulk-coaching-actions-sheet.tsx — bulk preview + delete + publish UI
  • feed-programming-view.tsx, client-compliance-view.tsx, program-enrollments-tab.tsx, program-comments-tab.tsx, program-class-types-tab.tsx
  • workout-picker-sheet.tsx — paste-first in create mode (paste → parse → StructureReviewDialog → assign, same as workout-parse’s other embedded entry points); picking a saved workout and “Build from scratch” are the secondary/adjust paths. Edit mode unchanged (no paste section).
  • week-navigation-bar.tsx, member-avatar.tsx, empty-state.tsx
• apps/web/src/components/shared/program-grid/ — reusable cell shell + menus
• apps/web/src/components/member/workouts/workout-detail-drawer.tsx — member’s view of one assignment’s snapshot
• apps/web/src/components/member/session-card.tsx, apps/web/src/components/member/day-selector-strip.tsx

DB

libs/db/src/lib/schema/workouts.ts:

• workout_assignments — see data-model.md.
• workout_feed_posts — feed broadcast row (lives in scheduling.ts).

Shared

libs/shared/src/lib/schemas/workout.schema.ts:

• workoutAssignmentResponseSchema — response shape.
• assignmentStatusValues — assigned/completed/skipped.
• workoutAssignmentsBulkFilterSchema, workoutAssignmentsBulkPreviewResponseSchema, workoutAssignmentsBulkDeleteInputSchema/ResponseSchema, workoutAssignmentsBulkPublishInputSchema/ResponseSchema.

Tests