This repository has been archived on 2026-11-17. You can view files and clone it, but cannot push or open issues or pull requests.
gitgram-ai/AUDIT_CHECKLIST.md
2026-06-22 17:45:56 +03:00

4.2 KiB

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)