V0.8.3.1 (#299)

* - **Added `is_role_default` and `force_role_default` to account creation logic:**
  - Updated `EntityModel.create_account` method to support new flags for default role assignment.
  - Passed `is_role_default` and `force_role_default` to the `ChartOfAccountsModel.create_account` method.

- **Implemented default role handling in `ChartOfAccountsModel.create_account`:**
  - Added validation to prevent multiple default accounts for the same role unless `force_role_default` is enabled.
  - Updated existing default account behavior to unset the previous default when `force_role_default` is used.
  - Included transaction atomicity to ensure account creation consistency.

- **Refactored account creation logic for clarity and maintainability:**
  - Reorganized parameter handling and method logic for `AccountModel` creation.
  - Enhanced validation error messaging for default role assignment conflicts.

### **Summary**
Introduced `is_role_default` and `force_role_default` flags for `AccountModel` creation to manage default role accounts more effectively. Implemented validation and transaction safety measures for default account assignments.

### **Backwards Compatibility**
Changes are backwards compatible. Default behavior is preserved unless the new flags are explicitly used.

* v0.8.3.1

* - **Enhanced `create_account` method in `ChartOfAccountsModel`:**
  - Improved role default validation logic to utilize more detailed error messaging, replacing queryset code reference with actual `AccountModel` instance code for clarity.
  - Refactored existing account model handling by replacing variable names (`default_role_account` -> `existing_account_model`) for consistency.
  - Made line formatting adjustments for improved readability.

- **Updated QuickStart Notebook:**
  - Removed all execution-specific metadata (`ExecuteTime`, `execution_count`) to clean up notebook revisions.
  - Refined outputs across cells by clearing response data and any previously stored execution results for a fresher state.

### **Summary**
Refactored the account creation logic in `ChartOfAccountsModel` for better naming and messaging, enhancing consistency and clarity

* Dev Env Dependency Update

Author: elarroba

django_ledger/__init__.py

@@ -6,7 +6,7 @@
 default_app_config = 'django_ledger.apps.DjangoLedgerConfig'
 
 """Django Ledger"""
-__version__ = '0.8.3'
+__version__ = '0.8.3.1'
 __license__ = 'GPLv3 License'
 
 __author__ = 'Miguel Sanda'

django_ledger/models/chart_of_accounts.py

@@ -43,29 +43,28 @@
 import warnings
 from random import choices
 from string import ascii_lowercase, digits
-from typing import Optional, Union, Dict
-from uuid import uuid4, UUID
+from typing import Dict, Optional, Union
+from uuid import UUID, uuid4
 
 from django.contrib.auth import get_user_model
 from django.core.exceptions import ValidationError
-from django.db import models
-from django.db.models import Q, F, Count, Manager, QuerySet, BooleanField, Value
-from django.db.models.signals import pre_save, post_save
+from django.db import models, transaction
+from django.db.models import BooleanField, Count, F, Manager, Q, QuerySet, Value
+from django.db.models.signals import post_save, pre_save
 from django.dispatch import receiver
 from django.urls import reverse
 from django.utils.translation import gettext_lazy as _
-
 from django_ledger.io import (
-    ROOT_COA,
-    ROOT_GROUP_LEVEL_2,
-    ROOT_GROUP_META,
     ROOT_ASSETS,
-    ROOT_LIABILITIES,
     ROOT_CAPITAL,
-    ROOT_INCOME,
+    ROOT_COA,
     ROOT_COGS,
     ROOT_EXPENSES,
     ROOT_GROUP,
+    ROOT_GROUP_LEVEL_2,
+    ROOT_GROUP_META,
+    ROOT_INCOME,
+    ROOT_LIABILITIES,
 )
 from django_ledger.models import lazy_loader
 from django_ledger.models.accounts import AccountModel, AccountModelQuerySet
@@ -605,6 +604,8 @@ def create_account(
         balance_type: str,
         active: bool,
         root_account_qs: Optional[AccountModelQuerySet] = None,
+        is_role_default: bool = False,
+        force_role_default: bool = False,
     ):
         """
         Proper method for inserting a new Account Model into a CoA.
@@ -624,23 +625,51 @@ def create_account(
             Specifies whether the account is active or not.
         root_account_qs : Optional[AccountModelQuerySet], optional
             The query set of root accounts to which the created account should be linked. Defaults to None.
+        is_role_default : bool
+            Marks the new account as the default for the account role.
+        force_role_default: bool
+            Forces the new account model to be set as default for a specified role. Any pre-existing default account
+            will be removed as default for the specified role.
 
         Returns
         -------
         AccountModel
             The created account model instance.
         """
-        account_model = AccountModel(
-            code=code,
-            name=name,
-            role=role,
-            active=active,
-            balance_type=balance_type,
-            coa_model=self,
-        )
-        account_model.clean()
 
-        account_model = self.insert_account(account_model=account_model, root_account_qs=root_account_qs)
+        with transaction.atomic():
+            if is_role_default:
+                account_model_qs: AccountModelQuerySet = self.get_coa_accounts()
+
+                default_role_account_qs: AccountModelQuerySet = account_model_qs.filter(
+                    role__exact=role, role_default=True
+                )
+                default_account_exists = default_role_account_qs.exists()
+
+                if default_account_exists and not force_role_default:
+                    existing_account_model: AccountModel = default_role_account_qs.get()
+                    raise ChartOfAccountsModelValidationError(
+                        f'The role {role} already has a default account {existing_account_model.code} for CoA {self}'
+                    )
+
+                elif default_account_exists and force_role_default:
+                    existing_account_model: AccountModel = default_role_account_qs.get()
+                    existing_account_model.role_default = False
+                    existing_account_model.save(update_fields=['role_default', 'updated'])
+
+            account_model = AccountModel(
+                code=code,
+                name=name,
+                role=role,
+                active=active,
+                balance_type=balance_type,
+                coa_model=self,
+                role_default=is_role_default,
+            )
+
+            account_model.clean()
+            account_model = self.insert_account(account_model=account_model, root_account_qs=root_account_qs)
+
         return account_model
 
     # ACTIONS -----

django_ledger/models/data_import.py

@@ -686,8 +686,7 @@ def get_queryset(self) -> StagedTransactionModelQuerySet:
                     F('matched_transaction_model__journal_entry__entity_unit__name'),
                 ),
                 import_account_uuid=F('import_job__bank_account_model__account_model_id'),
-                children_count=Count(F('split_transaction_set'),
-                                     distinct=True),
+                children_count=Count(F('split_transaction_set'), distinct=True),
                 children_mapped_count=Count('split_transaction_set__account_model__uuid', distinct=True),
                 imported_count=Count(
                     'split_transaction_set',
@@ -1689,7 +1688,12 @@ def can_have_account(self) -> bool:
         bool
             True if the entity can have an account, False otherwise.
         """
-        return not self.is_parent()
+        return any(
+            [
+                all([self.is_parent(), not self.has_children()]),
+                self.is_children()
+            ]
+        )
 
     def can_have_activity(self) -> bool:
         if any([self.is_transfer(), not self.is_cash_transaction()]):