HackSoftware/Django-Styleguide

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.

Star history