85 lines
4.2 KiB
Markdown
85 lines
4.2 KiB
Markdown
# Audit Checklist (Launch Readiness)
|
|
|
|
This checklist is meant to be executed as a repeatable “startup-style” audit pass: verify the user flow end-to-end, confirm expected network calls + auth, and check that the UI has no dead-ends.
|
|
|
|
Status legend: `PASS`, `FAIL`, `N/A`, `FOLLOWUP`
|
|
|
|
## 1) Gitgram Core Web Flows
|
|
|
|
### Auth
|
|
- [ ] `GET /` loads unauthenticated and routes to login/signup actions (`PASS|FAIL`)
|
|
- [ ] Register with email/password creates account, stores tokens, routes to onboarding (`PASS|FAIL`)
|
|
- [ ] Login with email/password routes to `/feed` (`PASS|FAIL`)
|
|
- [ ] OAuth GitHub callback (`/auth/github/callback`) stores tokens and routes to onboarding for new users (`PASS|FAIL`)
|
|
- [ ] OAuth Google callback (`/auth/google/callback`) stores tokens and routes to onboarding for new users (`PASS|FAIL`)
|
|
- [ ] Logout clears local state and returns to `/` (`PASS|FAIL`)
|
|
|
|
### Onboarding
|
|
- [ ] `/onboarding/welcome` has a clear next action to interests/follow (`PASS|FAIL`)
|
|
- [ ] `/onboarding/interests` persists interests to backend and updates stored user state (`PASS|FAIL`)
|
|
- [ ] `/onboarding/follow` suggests accounts and persists follows (`PASS|FAIL`)
|
|
- [ ] First-time empty feed redirects to onboarding once (no loop) (`PASS|FAIL`)
|
|
|
|
### Feed + Social
|
|
- [ ] `/feed` loads posts, handles empty state, can like/unlike (`PASS|FAIL`)
|
|
- [ ] Follow/unfollow flows update counts and feed suggestions (`PASS|FAIL`)
|
|
- [ ] Search (`/search`) returns results for repos/people/posts/hashtags (`PASS|FAIL`)
|
|
- [ ] Trending pages show meaningful content or a non-empty placeholder (`PASS|FAIL`)
|
|
|
|
### Create Content
|
|
- [ ] Create post (`/create`) upload validation errors are user-friendly (`PASS|FAIL`)
|
|
- [ ] Create story (`/story/create`) upload validation errors are user-friendly (`PASS|FAIL`)
|
|
- [ ] Create reel (`/reel/create`) upload validation errors are user-friendly (`PASS|FAIL`)
|
|
- [ ] Media uploads hit the configured API base (no hardcoded localhost) (`PASS|FAIL`)
|
|
|
|
### Repo Profile + Account Switching
|
|
- [ ] Repository profile page loads in production base URL (`PASS|FAIL`)
|
|
- [ ] Account switcher lists accounts + switches successfully (`PASS|FAIL`)
|
|
|
|
### Moderation/Admin
|
|
- [ ] Report flow exists from content UI and creates a report (`PASS|FAIL`)
|
|
- [ ] Moderation queue (`/admin/moderation`) loads for moderators/admins and is blocked for normal users (`PASS|FAIL`)
|
|
- [ ] Enforcement actions (remove content / suspend user) are audited (`PASS|FAIL`)
|
|
|
|
## 2) AITM Flows
|
|
|
|
### Website Signup + Keys
|
|
- [ ] Sign up / sign in works in local/dev (`PASS|FAIL`)
|
|
- [ ] API keys page: create key shows secret once; list does not expose full secret (`PASS|FAIL`)
|
|
- [ ] Key revoke works and blocks API usage (`PASS|FAIL`)
|
|
|
|
### CLI Auth + Capture
|
|
- [ ] `aitm login --api-key ...` persists auth and `aitm whoami` returns expected user (`PASS|FAIL`)
|
|
- [ ] `aitm init` initializes a project and creates a checkpoint (`PASS|FAIL`)
|
|
- [ ] Capture path enforces consent where required (`PASS|FAIL`)
|
|
|
|
### Timeline + Restore
|
|
- [ ] Timeline UI loads and filters work (`PASS|FAIL`)
|
|
- [ ] Restore preview shows scoped diff summary (`PASS|FAIL`)
|
|
- [ ] Restore apply requires confirmation and is reversible (`PASS|FAIL`)
|
|
|
|
### Webhooks
|
|
- [ ] Webhooks list/create/enable-disable/delete all hit real API endpoints (`PASS|FAIL`)
|
|
- [ ] Deliveries page loads and retry works (no “simulate success”) (`PASS|FAIL`)
|
|
|
|
### Export/Consent
|
|
- [ ] Export endpoints are gated by consent and traceability IDs are present (`PASS|FAIL`)
|
|
- [ ] Exported artifacts are redacted per policy (`PASS|FAIL`)
|
|
|
|
## 3) Docs Correctness Sweep
|
|
|
|
### Ops/Runbook
|
|
- [ ] `docs/runbook.md` local ports match compose (`PASS|FAIL`)
|
|
- [ ] `docs/ops-quickref.md` commands match current health endpoints (`PASS|FAIL`)
|
|
- [ ] Deploy docs reference current workflows (`PASS|FAIL`)
|
|
|
|
### Env/Secrets
|
|
- [ ] `docs/environment-matrix.md` matches `.env.*.example` files (`PASS|FAIL`)
|
|
- [ ] `docs/secrets-contract.md` lists all required third-party keys + rotation owners (`PASS|FAIL`)
|
|
|
|
### Install Guides
|
|
- [ ] Gitgram web docs use `:3000` and backend `:4000` (`PASS|FAIL`)
|
|
- [ ] AITM Quickstart reflects current CLI commands (`aitm setup --global` semantics, MCP install) (`PASS|FAIL`)
|
|
- [ ] MCP install instructions work with `npx` (no monorepo assumptions) (`PASS|FAIL`)
|
|
|