Expand CLAUDE.md with comprehensive project documentation

[letam]

Summary

Significantly expanded and reorganized the CLAUDE.md documentation file to provide comprehensive guidance for working with the Django + React web framework project. The documentation now covers architecture details, development workflows, code style conventions, project structure, environment configuration, deployment procedures, and middleware stack.

Key Changes

• Architecture Documentation: Added detailed sections for both backend (Django) and frontend (React + Vite) with specific framework versions, app descriptions, and key API endpoints
• Development Commands: Reorganized and expanded command reference with quick start instructions, backend/frontend-specific commands, and justfile alternatives
• Code Style Conventions: Documented Python/Django style rules (Black, isort, Ruff, Google docstrings) and TypeScript/React conventions (Biome, ESLint, shadcn/ui patterns)
• Testing Guidelines: Added backend and frontend testing frameworks with test locations and base class information
• Project Structure: Added comprehensive directory tree showing all major directories and key files with descriptions
• Environment Configuration: Documented all backend and frontend environment variables with examples and use cases
• Deployment Section: Added Fly.io deployment instructions, Docker multi-stage build details, and GitHub Actions workflow information
• Middleware Stack: Listed all 10 middleware components in order with brief descriptions
• Important Notes: Expanded with details about package managers, media processing requirements, authentication approach, CORS configuration, and media streaming features

Notable Details

• Clarified the role of each Django app (website, users, blogs, uploads, auth) with specific responsibilities
• Documented API endpoints including authentication, posts CRUD, transcription, and media streaming
• Specified tool versions (Django 5.2.5, React 19, Vite 6, TypeScript strict mode disabled)
• Included information about anonymous user support and presigned URL caching
• Added Open Graph metadata support for social sharing
• Documented ffmpeg/ffprobe requirements for media processing

https://claude.ai/code/session_018tuPu8ePu2f54p9m3ncVyp