Add Phase 8: lesson plan templates with deep-copy instantiation

- New tables: lesson_plan_template, lesson_plan_template_section, lesson_plan_template_item
- skill_level enum: beginner, intermediate, advanced, all_levels
- Templates are reusable curriculum definitions independent of any member/enrollment
- POST /lesson-plan-templates/:id/create-plan deep-copies the template into a member plan
- Instantiation uses template name as default plan title, accepts custom title override
- Instantiation deactivates any existing active plan on the enrollment (one-active rule)
- Plan items are independent copies — renaming the template does not affect existing plans
- 11 new integration tests

packages/backend/src/routes/v1/lessons.ts

@@ -20,10 +20,13 @@ import {
   LessonPlanItemUpdateSchema,
   GradeCreateSchema,
   SessionPlanItemsSchema,
+  LessonPlanTemplateCreateSchema,
+  LessonPlanTemplateUpdateSchema,
+  TemplateInstantiateSchema,
   InstructorBlockedDateCreateSchema,
   StoreClosureCreateSchema,
 } from '@lunarfront/shared/schemas'
-import { InstructorService, LessonTypeService, ScheduleSlotService, EnrollmentService, LessonSessionService, GradingScaleService, LessonPlanService, LessonPlanItemService, GradeHistoryService, SessionPlanItemService, InstructorBlockedDateService, StoreClosureService } from '../../services/lesson.service.js'
+import { InstructorService, LessonTypeService, ScheduleSlotService, EnrollmentService, LessonSessionService, GradingScaleService, LessonPlanService, LessonPlanItemService, LessonPlanTemplateService, GradeHistoryService, SessionPlanItemService, InstructorBlockedDateService, StoreClosureService } from '../../services/lesson.service.js'
 
 export const lessonRoutes: FastifyPluginAsync = async (app) => {
   // --- Instructors ---
@@ -385,6 +388,64 @@ export const lessonRoutes: FastifyPluginAsync = async (app) => {
     return reply.send(item)
   })
 
+  // --- Lesson Plan Templates ---
+
+  app.post('/lesson-plan-templates', { preHandler: [app.authenticate, app.requirePermission('lessons.admin')] }, async (request, reply) => {
+    const parsed = LessonPlanTemplateCreateSchema.safeParse(request.body)
+    if (!parsed.success) {
+      return reply.status(400).send({ error: { message: 'Validation failed', details: parsed.error.flatten(), statusCode: 400 } })
+    }
+    const template = await LessonPlanTemplateService.create(app.db, parsed.data, request.user.id)
+    return reply.status(201).send(template)
+  })
+
+  app.get('/lesson-plan-templates', { preHandler: [app.authenticate, app.requirePermission('lessons.view')] }, async (request, reply) => {
+    const query = request.query as Record<string, string | undefined>
+    const params = PaginationSchema.parse(query)
+    const filters = {
+      instrument: query.instrument,
+      skillLevel: query.skillLevel,
+    }
+    const result = await LessonPlanTemplateService.list(app.db, params, filters)
+    return reply.send(result)
+  })
+
+  app.get('/lesson-plan-templates/:id', { preHandler: [app.authenticate, app.requirePermission('lessons.view')] }, async (request, reply) => {
+    const { id } = request.params as { id: string }
+    const template = await LessonPlanTemplateService.getById(app.db, id)
+    if (!template) return reply.status(404).send({ error: { message: 'Template not found', statusCode: 404 } })
+    return reply.send(template)
+  })
+
+  app.patch('/lesson-plan-templates/:id', { preHandler: [app.authenticate, app.requirePermission('lessons.admin')] }, async (request, reply) => {
+    const { id } = request.params as { id: string }
+    const parsed = LessonPlanTemplateUpdateSchema.safeParse(request.body)
+    if (!parsed.success) {
+      return reply.status(400).send({ error: { message: 'Validation failed', details: parsed.error.flatten(), statusCode: 400 } })
+    }
+    const template = await LessonPlanTemplateService.update(app.db, id, parsed.data)
+    if (!template) return reply.status(404).send({ error: { message: 'Template not found', statusCode: 404 } })
+    return reply.send(template)
+  })
+
+  app.delete('/lesson-plan-templates/:id', { preHandler: [app.authenticate, app.requirePermission('lessons.admin')] }, async (request, reply) => {
+    const { id } = request.params as { id: string }
+    const template = await LessonPlanTemplateService.delete(app.db, id)
+    if (!template) return reply.status(404).send({ error: { message: 'Template not found', statusCode: 404 } })
+    return reply.send(template)
+  })
+
+  app.post('/lesson-plan-templates/:id/create-plan', { preHandler: [app.authenticate, app.requirePermission('lessons.edit')] }, async (request, reply) => {
+    const { id } = request.params as { id: string }
+    const parsed = TemplateInstantiateSchema.safeParse(request.body)
+    if (!parsed.success) {
+      return reply.status(400).send({ error: { message: 'Validation failed', details: parsed.error.flatten(), statusCode: 400 } })
+    }
+    const plan = await LessonPlanTemplateService.instantiate(app.db, id, parsed.data, request.user.id)
+    if (!plan) return reply.status(404).send({ error: { message: 'Template not found', statusCode: 404 } })
+    return reply.status(201).send(plan)
+  })
+
   // --- Grade History ---
 
   app.post('/lesson-plan-items/:id/grades', { preHandler: [app.authenticate, app.requirePermission('lessons.edit')] }, async (request, reply) => {