mirror of
https://github.com/pacnpal/thrillwiki_django_no_react.git
synced 2025-12-20 18:11:08 -05:00
d504d41de2
- Add complete backend/ directory with full Django application - Add frontend/ directory with Vite + TypeScript setup ready for Next.js - Add comprehensive shared/ directory with: - Complete documentation and memory-bank archives - Media files and avatars (letters, park/ride images) - Deployment scripts and automation tools - Shared types and utilities - Add architecture/ directory with migration guides - Configure pnpm workspace for monorepo development - Update .gitignore to exclude .django_tailwind_cli/ build artifacts - Preserve all historical documentation in shared/docs/memory-bank/ - Set up proper structure for full-stack development with shared resources
2.8 KiB
2.8 KiB
Technical Context
Architecture Overview
Stack Components
- Framework: Django (MVT Architecture)
- Frontend: HTMX + AlpineJS + Tailwind CSS
- Database: Django ORM
- Authentication: Django Built-in Auth
Technical Architecture
Backend (Django)
-
Core Framework Features
- MVT pattern implementation
- ORM for data management
- Template system
- Authentication & permissions
- Admin interface
- URL routing
- Form processing
-
Data Layer
- Models & relationships
- Validation rules
- Signal handlers
- Database migrations
Frontend Architecture
-
HTMX Integration
- Dynamic updates
- Partial page renders
- Server-side processing
- Progressive enhancement
-
AlpineJS Usage
- UI state management
- Component behaviors
- Event handling
- DOM manipulation
-
Tailwind CSS
- Utility-first styling
- Custom theme configuration
- Responsive design
- Dark mode support
Integration Patterns
Template System
-
Structure
- Base templates
- Model-specific partials
- Reusable components
- Template inheritance
-
HTMX Patterns
- Partial updates
- Server triggers
- Event handling
- Response processing
State Management
-
Server-side
- Django sessions
- Database state
- Cache management
-
Client-side
- AlpineJS state
- Local storage
- HTMX state management
Performance Requirements
Frontend Targets
- First contentful paint < 1.5s
- Time to interactive < 2s
- Core Web Vitals compliance
- Progressive enhancement
- Latest 2 versions of major browsers
Backend Optimization
- Database query optimization
- Caching strategy
- Asset optimization
- API response times
Development Environment
Required Tools
- Python with virtual environment
- Node.js (Tailwind build)
- Git version control
- VSCode IDE
Configuration
- Environment variables
- Development settings
- Database setup
- Media handling
Security Framework
Authentication
- Django auth system
- Session management
- Permission levels
- User roles
Data Protection
- CSRF protection
- XSS prevention
- SQL injection prevention
- Input validation
Testing Strategy
Backend Testing
- Django test runner
- Unit tests
- Integration tests
- Coverage requirements
Frontend Testing
- Browser testing
- Performance metrics
- Accessibility testing
- User flow validation
Deployment Process
Environment Setup
- Production configuration
- Database migration
- Static file handling
- SSL/TLS setup
Monitoring
- Error tracking
- Performance monitoring
- User analytics
- System health checks
Documentation Requirements
Code Documentation
- Python docstrings
- Type hints
- Component documentation
- API documentation
System Documentation
- Setup guides
- Architecture docs
- Maintenance procedures
- Troubleshooting guides