yingyeothon/service

Contest-support backend for the Yingyeothon hackathon: per-channel OAuth login (auth), operations console (console), WebSocket topic broadcast (topic), FIFO matchmaker (match), and versioned per-player documents plus per-project key-value collections (state), deployed with Serverless Framework 4 on AWS ap-northeast-2. Game loops live in the sibling tslib packages; this repo only has to stay compatible with their JWT/WebSocket contracts.

Public repository. Secrets and infrastructure identifiers never enter git. Read docs/secrets.md before committing — the git hooks and CI enforce it.

Layout

• packages/* — shared libraries (core, redis, console-db, jwt, http, ws)
• services/{auth,console,topic,match,state} — one Serverless stack each
• apps/console-web — console SPA; cli/ — Go CLI yyt for Linux, macOS and Windows (cli/README.md: install scripts install.sh/install.ps1, login, commands, release)
• docs/ — decisions, contracts, secrets policy; rules/ — engineering rules for contributors and agents
• local/ — machine-local config (gitignored); todo/ — machine-local work tracker (gitignored)

Commands

pnpm install && pnpm -r build && pnpm test      # build + vitest (no Docker)
pnpm lint && pnpm format:check && pnpm typecheck # CI gates
YYT_IT=1 pnpm test                               # opt-in integration tests against dev MySQL/Redis
scripts/deploy.sh <service> <dev|prod>           # deploy one stack
cd cli && go test ./... && go build ./...        # CLI

Documentation

• docs/platform-overview.md — what the platform is, its invariants, ceilings and non-goals; the baseline for comparing it with other platforms
• docs/decisions.md — settled product/technical decisions (change the doc before the code)
• docs/secrets.md — secrets, identifiers, hooks, rotation
• docs/auth-game-contract.md — JWT contract shared with game stacks
• docs/kvstore.md — key-value collections: principals, surfaces, encryption, deploy order
• CONTRIBUTING.md — workflow and mandatory checks
• rules/index.md — detailed engineering rules