Commit graph

10 commits

Author SHA1 Message Date
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
nickviljoen
d8062aaa07 Refresh CLAUDE.md docs for v1.1.0
- Bump headline client count from 8 to 10 (added AXA + Rank).
- Refresh the Client Configuration tables to match client_config.py (10 rows, video_general listed across all entries).
- Flip the Prod row in the Deployment Environments table from "Not yet stood up" to "Live (currently v1.1.0)" and drop the matching "prod-to-come" wording.
- Bump the Pre-Session Completion Checklist from "all 8 clients" to "all 10 clients".
- Add a "Self-service Client Access Requests" section under Recent System Enhancements covering the new client-picker tile, /api/access_request + /api/all_clients endpoints, the email_service module, and a "Settings Modal UX (Apr 2026)" section covering the simplified Reference Assets / Media Plan tabs and the context-aware modal footer.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-27 14:43:30 +02:00
nickviljoen
d7d83cf90a Update CLAUDE.md with access control, environments, deploy scripts
- Bump stale counts to 14 profiles / 8 clients / 75 checks across
  overview, file structure, profile system, pre-session checklist.
- New section: User Access Control System (storage schema,
  user_access.py module surface, enforcement points, audit trail,
  frontend hooks).
- New section: Deployment Environments table (local/dev/prod/
  sandbox) with URLs, branches, servers, services, status.
- New section: Branch Strategy (develop→dev, main tags→prod,
  feature branches).
- New section: Deploy Scripts (deploy.sh, rollback.sh, health-check.sh).

Applied to both root CLAUDE.md and backend/CLAUDE.md.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-22 18:50:10 +02:00
nickviljoen
ff112c830e Update docs with L'Oreal prompt tuning round 2 results (2026-04-07)
Document text_readability neutral scoring for product-only shots,
background_contrast visibility-focused tuning, and test results
for 5 new L'Oreal Absolut Repair Molecular assets.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-07 19:25:48 +02:00
nickviljoen
5a57a8a064 Add Dow Jones client with 3 sub-brand QC profiles (17 new checks)
New client with embedded brand guidelines for Dow Jones Corporate,
MarketWatch, and Wall Street Journal sub-brands. Guidelines sourced
from live.standards.site scrapes and baked into check prompts.

- dow_jones_static: 5 checks (logo, color, typography, square motif, photography)
- marketwatch_static: 6 checks (logo, color, typography, image treatment, layout, art direction)
- wsj_static: 6 checks (logo, color tiers, typography, imagery, capitalization, layout)
- System now has 7 clients, 12 profiles, 65 QC checks

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-07 18:33:14 +02:00
nickviljoen
08b17508ba Add periodic auth session check and rename Amazon Box Placement to Element Placement
- Add silent auth check every 5 minutes to detect expired sessions proactively,
  showing a "Session Expired" prompt instead of failing silently on next action
- Rename amazon_box_placement to amazon_element_placement across module directory,
  profile config, class name, and documentation

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-02 10:01:27 +02:00
nickviljoen
6333cdeb3e Update docs with PDF processing, media plans, and production notes
Document pdf_processor.py and media_plan_processor.py in main
components. Add detailed sections for PDF reference asset processing
and media plan system. Add production permissions fix to common
issues table.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-26 23:11:34 +02:00
nickviljoen
57b6c28848 Update documentation for new clients, profiles, and features
Update CLAUDE.md and README.md to reflect current system state:
- 48 QC checks (was 33), 9 profiles (was 6), 6 clients
- Document Amazon ASD 2025 tools, Boots client, L'Oreal static profile
- Document client-scoped reporting dashboard, admin panel, user tracking
- Update pre-session checklist with all 9 profiles and 6 clients
- Add client configuration table

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-26 13:30:10 +02:00
nickviljoen
e46c1d1435 Add comprehensive production deployment documentation
Added detailed troubleshooting guide covering critical production issues
encountered during deployment:

1. Web UI 404 Error Fix
   - Document absolute path requirement for serve_web_ui()
   - Explain why relative paths fail in production environments
   - Provide code examples for both root and backend api_server.py

2. Apache ProxyPass Configuration
   - Document static directory conflict with ProxyPass rules
   - Explain Apache's file-first, proxy-second behavior
   - Provide solution: remove conflicting static directories
   - Include proper ProxyPass ordering (specific paths before general)

3. MSAL Authentication Error Fix
   - Document interaction_in_progress error and root causes
   - Explain concurrent sign-in prevention implementation
   - Include storage cleanup and proper flag reset patterns

4. Production Deployment Checklist
   - Step-by-step deployment verification process
   - Backend testing commands
   - Apache proxy testing commands
   - Browser testing best practices

5. Common Production Issues Table
   - Quick reference for troubleshooting
   - Check commands for each issue
   - Solutions for common problems

This documentation ensures future deployments avoid the same pitfalls
and provides clear guidance for troubleshooting production issues.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-06 23:23:02 +02:00
nickviljoen
3fec052c12 Create frontend and backend folder structure for deployment
Organized the application into separate frontend and backend directories for cleaner deployment and better separation of concerns.

Frontend Directory (frontend/):
- index.html: Single-page web interface (renamed from web_ui.html)
- README.md: Frontend deployment guide
- Total size: ~113 KB (self-contained)
- Smart base path detection (works at / or /ai_qc/)
- No configuration changes required

Backend Directory (backend/):
- All Python files (api_server.py, llm_config.py, etc.)
- visual_qc_apps/: 33 QC check modules
- profiles/: 6 QC profile configurations
- brand_guidelines/: Reference asset storage
- config/: Environment configurations
- scripts/: Deployment automation
- uploads/, output/: Data directories
- requirements.txt, ai_qc.service, apache_config.conf
- Complete documentation

New Documentation:
- FOLDER_STRUCTURE.md: Comprehensive guide to new structure
- frontend/README.md: Frontend deployment instructions
- backend/BACKEND_README.md: Backend deployment guide

Deployment Mapping:
- frontend/ → /var/www/html/ai_qc/ (web root)
- backend/ → /opt/ai_qc/ (application directory)

Benefits:
- Clear separation of concerns
- Backend code not in web-accessible directory
- Independent frontend/backend updates
- Matches server's existing patterns (/opt/veo3, /opt/voice2text)
- Industry-standard architecture
- Easy to deploy and maintain

Original files preserved in root directory for reference.
Ready for production deployment following MIGRATION_GUIDE.md.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-06 11:55:53 +02:00