Skip to content

Classroom Public Adapter Preflight Task

Agent workflow: follow README.md for Audit -> Investigate -> Code -> Test -> Fix; keep this pack's writable scope and verification commands authoritative.

Dispatch type: orchestrator

Owner: classroom-service; orchestrator owns gateway route examples.

Goal:

Prepare /api/classrooms* native route promotion only after cross-service validation and hydration boundaries are explicit.

Legacy source evidence:

  • /Users/velikho/Desktop/WORKING/HOCTAPAZ/node-platform/apps/api/src/modules/classrooms/**
  • /Users/velikho/Desktop/WORKING/HOCTAPAZ/node-platform/apps/api/prisma/schema.prisma
  • classroom frontend callers under /Users/velikho/Desktop/WORKING/HOCTAPAZ/node-platform/apps/web.

Writable files:

  • services/classroom-service/**
  • contracts/openapi/services/classroom-service.yaml
  • docs/api/classroom-service.md
  • docs/agents/service-tasks/classroom-public-adapter-preflight.md

Orchestrator-owned files:

  • Gateway route tables, profile/org hydration adapters, shared deploy manifests, and default public route promotion.

Tasks:

  • Audit legacy classroom list/detail/member/join flows.
  • Define profile/org hydration inputs that classroom-service receives by ID or gateway aggregation.
  • Add route guard coverage proving default routes stay legacy.
  • Add focused tests for join code, member writes, delete impact, purge, and progress summary.

Acceptance:

  • Classroom-service does not read profile, IAM, organization, document, question, or exam databases.
  • Native promotion has rollback route-table evidence.

Verification:

  • GOTOOLCHAIN=go1.25.11 go test ./services/classroom-service/... ./services/api-gateway/internal/gateway
  • make test-classroom-route-guard

Go-platform documentation is generated from repository Markdown.