How liqd/adhocracy-plus works
Main Components
a) Frontend Layer:
• React Components (in /apps/*/assets/)
• Static Assets (SCSS, images, fonts)
• Templates (Django templates in /apps/*/templates/)
b) Backend Layer:
• Django Applications:
• Core Apps: account, users, organisations
• Feature Apps: ideas, debates, documents, polls, etc.
• Support Apps: notifications, exports, dashboard
• REST API Endpoints
• Authentication/Authorization System
c) Data Layer:
• Database (PostgreSQL/SQLite)
• Redis (for Celery task queue)
• Media Storage
d) Background Processing:
• Celery Workers
• Task Queue System
Key Relationships to Highlight
a) User Flow:
• Authentication flow
• Organization management
• Project participation
• Content creation/interaction
b) Data Flow:
• API communications
• Background task processing
• Media handling
• Export functionality
Architectural Patterns to Emphasize
a) Django's MVT (Model-View-Template) Architecture:
• Models (/apps/*/models.py)
• Views (/apps/*/views.py)
• Templates (/apps/*/templates/)
b) REST API Architecture:
• Serializers
• ViewSets
• Routers
Component Details
a) Frontend Section:
• [React Components] → [Django Templates] → [Static Assets]
• ↓ ↓
• [Browser Interface] ← [Asset Pipeline]
b) Backend Section:
• [Django Apps] → [URL Routing] → [Views/ViewSets]
• ↓ ↓ ↓
• [Authentication] → [Permissions] → [Models]
c) Data Storage:
• [PostgreSQL/SQLite] ← [Models] → [Cache (Redis)]
• ↓ ↓ ↓
• [Media Files] ← [File Handlers] → [Task Queue]
Important Subsystems
• Email notification system
• Export functionality
• Moderation system
• Multi-language support
• Organization management
• Project management
Notes
Annotations for:
• Security implementations
• Scalability points
• Integration points
• Configuration options