ai_qc/backend/CLAUDE.md
nickviljoen 59a0b2408c Restructure CLAUDE.md docs: slim project-wide root, complete per-client coverage
Splits the monolithic CLAUDE.md (962 lines) into a slim project-wide root (211 lines)
plus per-client files. Auto-loaded context drops ~88% per session.

Changes:
- CLAUDE.md slimmed to project-wide essentials (architecture, auth, deployment, branch
  strategy, deploy scripts, prod troubleshooting, pre-session checklist). Adds explicit
  session-start convention pointing to CLAUDE_<CLIENT>.md for client-specific work.
  Updates client roster table to all 10 clients with profile counts.
- New CLAUDE_AXA.md: document-mode pipeline + axa_policy_document profiles
- New CLAUDE_DIAGEO.md: key_visual + packaging profiles, check inventories
- New CLAUDE_UNILEVER.md: profiles + zero-score logic for face/new visibility
- New CLAUDE_HONDA.md, CLAUDE_RANK.md, CLAUDE_GENERAL.md: stubs (clients use generic
  profiles only — kept for completeness and future expansion)
- backend/CLAUDE.md: stale 932-line duplicate replaced with 18-line redirect to root
  + backend-specific quick pointers

Per-client files (CLAUDE_LOREAL.md, CLAUDE_AMAZON.md, CLAUDE_BOOTS.md,
CLAUDE_DOW_JONES.md) unchanged — already had the right content.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-06 12:29:16 +02:00

955 B

CLAUDE.md (backend/)

This file used to duplicate the project-wide guidance and is now stale. Read ../CLAUDE.md at the repo root for current project-wide guidance, and the relevant ../CLAUDE_<CLIENT>.md when working on client-specific code.

Quick pointers for backend work

  • API server entry point: api_server.py
  • QC check modules: visual_qc_apps/{check_name}/app.py
  • Document-mode pipeline (multi-page PDF): document_mode/
  • Profile JSONs: profiles/
  • Profile loading + check discovery: profile_config.py
  • Client ↔ profile mapping: client_config.py
  • LLM config: llm_config.py
  • User access control: user_access.py + user_access.json (gitignored)
  • Usage logs: usage_logs/<YYYY-MM-DD>.jsonl
  • Deploy scripts: scripts/deploy.sh, scripts/rollback.sh, scripts/health-check.sh

For everything else (architecture, auth, deployment, branch strategy, troubleshooting, pre-session checklist) see ../CLAUDE.md.