Home - AY2627S1-CS3219-P23/foc GitHub Wiki
FoC Wiki
Design and solution docs for Favours on Campus (CS3219 AY26/27 S1, group P23) that live outside the code tree. Service-level design records stay in-repo next to the code they describe.
Wiki pages
- D3 Design â Order & Credit Services â the D3 progress-check writeup (all five parts: Order, Credit, async workflow, containerization, N2H plan + task allocation); open team decisions carried as comparison tables.
- D3 Demo Script â skeleton curl walkthrough for the Week 10 session; fill in as Order/Credit endpoints land.
- D2 Design â User & Supplier Services â answers to the eleven D2 questions as built: roles, schemas, auth/JWT, supplier API. Migrated from Lark 2026-09-29; the Lark original is frozen.
- D2 Demo Script â runnable curl walkthrough: login for a JWT, then every endpoint with accepted/rejected calls per role, UI stopped.
In-repo design docs (versioned with the code)
- architecture.md â high-level service architecture (+ architecture.mmd)
- supplier-service.md â Supplier Service decision record (D1âD8)
- notification-service.md â Notification Service decision record (D1âD31: broker + push, REST API, ingest-time display-name enrichment)
- credit-service.md â Credit Service design
- AGENTS.md â tech stack, conventions, port table, AI Usage Policy
âšī¸ House rule carried over from the repo: docs are AI-disclosure-headed where AI tooling touched them, decisions are made by the team and attributed to their PR/issue, and diffs live on the PRs â wiki pages record decisions, not file manifests.