HackSoftware/Django-Styleguide
Django Styleguide
Este proyecto proporciona estándares arquitectónicos y patrones para organizar aplicaciones Django. Define una guía de arquitectura de proyectos centrada en desacoplar la lógica de negocio de las vistas y modelos a través de una arquitectura de capa de servicio.
La guía establece patrones de diseño específicos, incluyendo una capa de servicio para funciones de lógica de negocio independientes y un patrón de selector de datos para aislar consultas complejas a la base de datos. Define un estándar para vistas de propósito único que delegan la lógica a servicios y utilizan serializadores dedicados para la entrada y salida de datos.
El framework cubre varias áreas de capacidad más amplias, incluyendo gestión de configuración modular para separar las sobrescrituras de entorno de la configuración base, una jerarquía de excepciones personalizada para el mapeo de errores impulsado por el dominio y un sistema para coordinar tareas en segundo plano y programación periódica. También incluye estándares para combinar restricciones de base de datos con validación a nivel de modelo y servicio.
Features
- Application Architecture Guides - Defines a complete architectural standard for Django applications focused on decoupling logic through service layers.
- Service Layers - Implements a service layer to encapsulate business rules and database writes, decoupling them from views and models.
- Domain Logic Patterns - Provides standards for organizing business logic by separating data writing services from data retrieval selectors.
- Service-Selector Separation - Employs a structural pattern that separates data writing services from data fetching selectors to isolate business rules.
- Data Selectors - Implements a data selector pattern to isolate complex database queries from the API and service layers.
- API Design Standards - Provides standards for resource-oriented API design using single-purpose views and dedicated serializers.
- Data Selectors - Implements specialized selector functions for handling complex database queries to keep the API layer clean.
- Service-Layer Architectures - Provides a comprehensive architectural guide for organizing Django applications using a service layer and data selectors.
- Selector-Based Data Access - Utilizes a selector-based data access pattern to isolate complex database queries from business logic.
- Service Layer Patterns - Decouples business logic from views and models using standalone service functions.
- API View Controllers - Implements a pattern for structured API views that delegate business logic to services and use dedicated serializers.
- RESTful API Designs - Defines architectural patterns for building structured REST APIs using dedicated serializers and thin views.
- Logic Delegation Handlers - Structures API views to handle only request routing and response formatting while delegating business logic to services.
- Service-Centric Background Tasking - Implements asynchronous workers and periodic jobs as thin interfaces that trigger centralized service layer functions.
- Multi-Layer Data Validation - Combines database constraints with model and service-level validation to ensure comprehensive data integrity.
- Environment Configuration Modules - Provides a system for organizing project settings into a modular directory to separate environment overrides from base configurations.
- Recurring Job Scheduling - Provides a centralized command system for scheduling recurring jobs to ensure consistency of cron schedules.
- Service-Triggering Workers - Treats asynchronous background tasks as thin triggers that delegate all actual execution to the core service layer.
- Configuration Directories - Organizes project configuration into a modular directory to separate base defaults from environment-specific overrides.
- Domain Error Mapping - Implements a custom exception hierarchy to map framework errors to consistent domain-specific responses.
- Exception Hierarchies - Implements a custom exception hierarchy and global handlers to map framework errors to domain-specific responses.
- Background Task Schedulers - Coordinates background tasks by using asynchronous workers to trigger business logic within the service layer.
- Modular Settings Directories - Provides a modular directory structure to separate base Django settings from environment-specific overrides.
- Exception Response Mapping - Provides a mechanism to map framework-level exceptions to a custom domain hierarchy for consistent API responses.
- Django Project Configurations - Structures project settings into modular directories to separate base configurations from environment-specific overrides.
