mirror of
https://github.com/pacnpal/thrillwiki_django_no_react.git
synced 2025-12-20 10:11:09 -05:00
8d70bf8994
- Created comprehensive documentation structure - Added productContext.md for product understanding - Added activeContext.md for current development status - Added systemPatterns.md for architecture patterns - Added developmentWorkflow.md for process standards - Added operationalContext.md for runtime details - Added projectBoundaries.md for technical constraints - Added techContext.md for technology stack - Documented all major aspects of the system - Established foundation for maintaining context
216 lines
4.1 KiB
Markdown
216 lines
4.1 KiB
Markdown
# Operational Context
|
|
|
|
## System Runtime
|
|
|
|
### Production Environment
|
|
- Production URL: http://thrillwiki.com
|
|
- Django-based web application
|
|
- WSGI deployment
|
|
- Static file serving via staticfiles/
|
|
|
|
### Development Environment
|
|
- Command: python manage.py tailwind runserver
|
|
- Local development setup
|
|
- Debug mode configurations
|
|
- Development-specific settings
|
|
|
|
## Error Handling Patterns
|
|
|
|
### Application Errors
|
|
1. Django Error Pages
|
|
- 404.html for not found
|
|
- 500.html for server errors
|
|
- Custom error templates
|
|
- User-friendly messages
|
|
|
|
2. HTMX Error Handling
|
|
- Partial template errors
|
|
- Response status codes
|
|
- Error feedback in UI
|
|
- Graceful degradation
|
|
|
|
3. Form Validation
|
|
- Server-side validation
|
|
- Client-side checks
|
|
- Error message display
|
|
- Field-level feedback
|
|
|
|
### System Monitoring
|
|
1. Error Tracking
|
|
- Django logging
|
|
- Error reporting
|
|
- Performance monitoring
|
|
- User feedback collection
|
|
|
|
2. Performance Metrics
|
|
- Page load times
|
|
- Database query performance
|
|
- Media processing speed
|
|
- API response times
|
|
|
|
## Infrastructure Details
|
|
|
|
### File Storage
|
|
1. Media Handling
|
|
- Upload directory structure
|
|
- Media processing pipeline
|
|
- Storage backend configuration
|
|
- File type validation
|
|
|
|
2. Static Files
|
|
- Collected to staticfiles/
|
|
- CSS organization
|
|
- JavaScript structure
|
|
- Image optimization
|
|
|
|
### Database Operations
|
|
1. Query Optimization
|
|
- Indexed fields
|
|
- Efficient joins
|
|
- Cached queries
|
|
- Bulk operations
|
|
|
|
2. Data Integrity
|
|
- Foreign key constraints
|
|
- Validation rules
|
|
- Transaction management
|
|
- Backup procedures
|
|
|
|
### Caching Strategy
|
|
1. Template Caching
|
|
- Fragment caching
|
|
- Page caching
|
|
- Query caching
|
|
- Cache invalidation
|
|
|
|
2. Static Asset Caching
|
|
- Browser caching
|
|
- CDN configuration
|
|
- Cache headers
|
|
- Version control
|
|
|
|
## Performance Requirements
|
|
|
|
### Response Times
|
|
1. Page Load
|
|
- Initial load < 2s
|
|
- HTMX updates < 500ms
|
|
- API responses < 200ms
|
|
- Media loading optimized
|
|
|
|
2. Interactive Elements
|
|
- UI feedback < 100ms
|
|
- Form submission < 1s
|
|
- Search results < 500ms
|
|
- Media upload feedback
|
|
|
|
### Resource Usage
|
|
1. Server Resources
|
|
- CPU utilization
|
|
- Memory management
|
|
- Disk space monitoring
|
|
- Network bandwidth
|
|
|
|
2. Client Resources
|
|
- JavaScript performance
|
|
- DOM updates
|
|
- Memory usage
|
|
- Network requests
|
|
|
|
### Scalability Considerations
|
|
1. Database Scaling
|
|
- Connection pooling
|
|
- Query optimization
|
|
- Index management
|
|
- Partition strategy
|
|
|
|
2. Application Scaling
|
|
- Request handling
|
|
- Worker processes
|
|
- Cache distribution
|
|
- Load balancing
|
|
|
|
## Security Implementation
|
|
|
|
### Authentication
|
|
1. User Management
|
|
- Django authentication
|
|
- Session handling
|
|
- Password policies
|
|
- Account recovery
|
|
|
|
2. Access Control
|
|
- Permission system
|
|
- Role-based access
|
|
- View restrictions
|
|
- API security
|
|
|
|
### Data Protection
|
|
1. Input Validation
|
|
- Form validation
|
|
- File upload checks
|
|
- XSS prevention
|
|
- CSRF protection
|
|
|
|
2. Data Privacy
|
|
- User data handling
|
|
- Content visibility
|
|
- Access logging
|
|
- Data retention
|
|
|
|
## Maintenance Procedures
|
|
|
|
### Regular Tasks
|
|
1. System Updates
|
|
- Security patches
|
|
- Dependency updates
|
|
- Feature deployments
|
|
- Configuration changes
|
|
|
|
2. Monitoring
|
|
- Error tracking
|
|
- Performance metrics
|
|
- User activity
|
|
- Resource usage
|
|
|
|
### Backup Procedures
|
|
1. Data Backups
|
|
- Database dumps
|
|
- Media files
|
|
- Configuration
|
|
- User content
|
|
|
|
2. Recovery Plans
|
|
- Restore procedures
|
|
- Failover options
|
|
- Emergency contacts
|
|
- Incident response
|
|
|
|
## Integration Points
|
|
|
|
### External Services
|
|
1. Email Service
|
|
- Sending configuration
|
|
- Template management
|
|
- Queue handling
|
|
- Delivery tracking
|
|
|
|
2. Analytics
|
|
- Data collection
|
|
- Event tracking
|
|
- Performance monitoring
|
|
- User behavior analysis
|
|
|
|
### Internal Services
|
|
1. Media Processing
|
|
- Upload handling
|
|
- Image processing
|
|
- File validation
|
|
- Storage management
|
|
|
|
2. Search System
|
|
- Index management
|
|
- Query optimization
|
|
- Result ranking
|
|
- Filter implementation
|