How lord-melflam/studens works
Studens is a modular student platform; its deployed module is RYC, a course catalogue and review service. The main journey runs from public pages and sign-in through first-run setup into the app shell, where students browse institution-scoped catalogues, read course details and submit or read reviews. Catalogue data is crawled from university sources, parsed into snapshots and exposed through a read interface. Other product branches include account management, moderation, feedback and suspension handling. Relationships beyond the excerpts are included only where the README or source index documents them; unsampled implementation details are not assumed.
Main entry points: main.tsx Web entry and zones · auth.ts Sign-in routes · src RYC screens · Console.tsx Moderation console and API
Components 24
Web experience
- Web entry and zones
apps/web/src/main.tsx - Language routing
apps/web/src/router.ts - Public site
apps/web/src/public - First-run setup
apps/web/src/firstrun - App shell and modules
apps/web/src/shell
Identity and accounts
- Sign-in routes
apps/api/src/routes/auth.ts - Identity resolution
apps/api/src/identity.ts - Session lifecycle
packages/platform/src/session.ts - Session cookies
apps/api/src/cookies.ts - Account features
apps/api/src/routes/account.ts
RYC catalogue and reviews
- RYC screens
packages/ryc-ui/src - RYC API
apps/api/src/routes/reviews.ts - Review operations
packages/ryc/src - Catalogue read interface
packages/ref/src/read.ts
Trust and operations
- Moderation console and API
apps/web/src/moderation/Console.tsx - Feedback handling
packages/platform/src/feedback.ts - Suspension notices
packages/platform/src/suspension.ts - Mail delivery worker
apps/worker/src/send-mail.ts
Catalogue ingestion
- Catalogue ingestion worker
apps/worker/src/ingest-catalogue.ts - Institution crawlers
packages/ref/src/sources - ULB source parsers
packages/ref/src/sources/ulb - Course-page parser
packages/ref/src/ingestion/parse/offering.ts - Snapshot validation and storage
packages/ref/src/ingestion/snapshot.ts
Other components
- Visitor or student
Connections 24
- Visitor or student → Web entry and zones: opens site
apps/web/src/main.tsx - Web entry and zones → Language routing: resolves route
apps/web/src/main.tsx - Web entry and zones → Public site: renders public zone
apps/web/src/main.tsx - Web entry and zones → First-run setup: routes first run
apps/web/src/main.tsx - Web entry and zones → App shell and modules: renders app
apps/web/src/main.tsx - Visitor or student → Sign-in routes: signs in
- Sign-in routes → Identity resolution: resolves identity
apps/api/src/routes/auth.ts - Sign-in routes → Session cookies: sets auth cookie
apps/api/src/routes/auth.ts - Identity resolution → Session lifecycle: checks session
apps/api/src/identity.ts - Visitor or student → App shell and modules: uses modules
- App shell and modules → RYC screens: mounts module
- RYC screens → RYC API: requests reviews
packages/ryc-ui/src/api.ts - RYC API → Review operations: delegates review edits
apps/api/src/routes/reviews.ts - RYC screens → Catalogue read interface: browses courses
- Catalogue ingestion worker → Institution crawlers: runs crawls
apps/worker/src/ingest-catalogue.ts - Institution crawlers → ULB source parsers: parses ULB pages
packages/ref/src/sources/ulb/index.ts - Institution crawlers → Course-page parser: parses offerings
packages/ref/src/sources/ulb/index.ts - Catalogue ingestion worker → Snapshot validation and storage: loads snapshots
- Catalogue read interface → Snapshot validation and storage: reads snapshots
packages/ref/src/read.ts - Visitor or student → Account features: manages account
- Visitor or student → Moderation console and API: reports content
- Moderation console and API → Feedback handling: reviews feedback
- Moderation console and API → Suspension notices: decides suspensions
- Suspension notices → Mail delivery worker: queues notice