Review B: Rewrite README to document the actual application

[davidpomerenke]

Summary

The existing README described the generic boilerplate the project was scaffolded from, not the actual application. This PR replaces it with documentation that covers:

• What the app actually does: SG Reports Survey, entity confirmations, AI chat, Excel export, analysis dashboard
• Full DB provisioning order: auth_tables.sql → reports_tables.sql → survey/frequency tables → views.sql → migrations → create_chat_user.sql
• All required environment variables, including DATABASE_URL_CHAT (previously undocumented)
• Python data pipeline: existence and purpose of the python/ ingestion scripts
• Admin access: how the admin_emails table works (post-migration 007)
• AI Chat architecture: Azure OpenAI + pgvector + chat_readonly DB user
• Project structure: accurate tree reflecting the actual src/ and sql/ directories

Test plan

• Read through and verify accuracy against the actual codebase
• Confirm the DB provisioning steps match the actual SQL files in sql/
• Verify env var list matches .env.template

🤖 Generated with Claude Code

---

Generated by Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
un80-sg-reports-survey	Ready	Preview, Comment	Jun 19, 2026 6:27am