mirror of
https://github.com/pacnpal/thrillwiki_django_no_react.git
synced 2025-12-21 09:31:09 -05:00
feat: complete monorepo structure with frontend and shared resources
- 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
This commit is contained in:
157
shared/docs/memory-bank/techContext.md
Normal file
157
shared/docs/memory-bank/techContext.md
Normal file
@@ -0,0 +1,157 @@
|
||||
# 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)
|
||||
1. Core Framework Features
|
||||
- MVT pattern implementation
|
||||
- ORM for data management
|
||||
- Template system
|
||||
- Authentication & permissions
|
||||
- Admin interface
|
||||
- URL routing
|
||||
- Form processing
|
||||
|
||||
2. Data Layer
|
||||
- Models & relationships
|
||||
- Validation rules
|
||||
- Signal handlers
|
||||
- Database migrations
|
||||
|
||||
### Frontend Architecture
|
||||
1. HTMX Integration
|
||||
- Dynamic updates
|
||||
- Partial page renders
|
||||
- Server-side processing
|
||||
- Progressive enhancement
|
||||
|
||||
2. AlpineJS Usage
|
||||
- UI state management
|
||||
- Component behaviors
|
||||
- Event handling
|
||||
- DOM manipulation
|
||||
|
||||
3. Tailwind CSS
|
||||
- Utility-first styling
|
||||
- Custom theme configuration
|
||||
- Responsive design
|
||||
- Dark mode support
|
||||
|
||||
## Integration Patterns
|
||||
|
||||
### Template System
|
||||
1. Structure
|
||||
- Base templates
|
||||
- Model-specific partials
|
||||
- Reusable components
|
||||
- Template inheritance
|
||||
|
||||
2. HTMX Patterns
|
||||
- Partial updates
|
||||
- Server triggers
|
||||
- Event handling
|
||||
- Response processing
|
||||
|
||||
### State Management
|
||||
1. Server-side
|
||||
- Django sessions
|
||||
- Database state
|
||||
- Cache management
|
||||
|
||||
2. 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
|
||||
Reference in New Issue
Block a user