Commerce, library & communications

Marketplace and library

/api/v1/marketplace/ provides categories, listings, search, atomic purchases, and order history. Purchases use PostgreSQL transactions and conditional balance handling; Redis is never the wallet authority.

/api/v1/library/ provides categories, browsing, search, uploads, downloads, and counters. Binary content uses the shared object-storage adapter and must be authorized before any public URL or stream is returned.

Channels and class communications

/api/v1/channel/ manages channels, memberships, wallets, broadcasts, and broadcast detail. /api/v1/public/channel/ provides invite-safe information and joins.

/api/v1/class-comms/ and /api/v1/classcomms/ manage class profiles, contacts, representatives, wallets, broadcasts, and details. /api/v1/public/class-comms/ offers public registration only. All SMS-affecting operations enforce required phone verification, role checks, available wallet credit, and durable delivery history.

Assignments

/api/v1/assignments/ supports lecturer assignment CRUD, student drafts/submissions, grading, and feedback. The handler/repository pair keeps lecturer and student permissions distinct at every state change.