coati-payroll 0.0.11__py3-none-any.whl → 0.0.13__py3-none-any.whl

coati_payroll/__init__.py

@@ -1,16 +1,5 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#    http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """
 Coati Payroll
 =============
@@ -224,8 +213,9 @@ def create_app(config) -> Flask:
     app.config["PERMANENT_SESSION_LIFETIME"] = timedelta(hours=24)  # Session timeout
 
     # Configure Flask-Babel
-    app.config["BABEL_DEFAULT_LOCALE"] = "en"
-    app.config["BABEL_TRANSLATION_DIRECTORIES"] = "translations"
+    app.config["BABEL_DEFAULT_LOCALE"] = "es"
+    app.config["BABEL_TRANSLATION_DIRECTORIES"] = join(dirname(__file__), "translations")
+    app.config["BABEL_SUPPORTED_LOCALES"] = ["es", "en"]
     babel.init_app(app, locale_selector=get_locale)
 
     session_manager.init_app(app)
@@ -366,10 +356,10 @@ def ensure_database_initialized(app: Flask | None = None) -> None:
             _db.create_all()
             log.trace("ensure_database_initialized: create_all() completed")
         except Exception as exc:
-            from sqlalchemy.exc import OperationalError
+            from sqlalchemy.exc import OperationalError, ProgrammingError
 
             msg = str(exc).lower()
-            if isinstance(exc, OperationalError) and "already exists" in msg:
+            if isinstance(exc, (OperationalError, ProgrammingError)) and "already exists" in msg:
                 log.trace("ensure_database_initialized: create_all skipped existing objects")
             else:
                 log.trace(f"ensure_database_initialized: create_all() raised: {exc}")

coati_payroll/app.py

@@ -1,16 +1,5 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#    http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """App module."""
 
 from __future__ import annotations

coati_payroll/audit_helpers.py

@@ -1,16 +1,5 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#    http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """Helper functions for audit and governance of payroll concepts."""
 
 from __future__ import annotations

coati_payroll/auth.py

@@ -1,16 +1,5 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#    http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """Auth module."""
 
 from __future__ import annotations

coati_payroll/cli.py

@@ -1,16 +1,5 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#    http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """Command line interface for Coati Payroll system administration."""
 
 from __future__ import annotations
@@ -43,10 +32,12 @@ from coati_payroll.model import db, Usuario, PluginRegistry
 from coati_payroll.auth import proteger_passwd
 from coati_payroll.log import log
 from coati_payroll.plugin_manager import discover_installed_plugins, load_plugin_module, sync_plugin_registry
+from coati_payroll.wsgi_server import serve as wsgi_server
 
 
 # Global context to store CLI options
 class CLIContext:
+
     def __init__(self):
         self.environment = None
         self.json_output = False
@@ -69,6 +60,7 @@ def output_result(ctx, message, data=None, success=True):
 
 
 class PluginsCommand(click.Group):
+
     def list_commands(self, cli_ctx):
         try:
             return [p.plugin_id for p in discover_installed_plugins()]
@@ -76,6 +68,7 @@ class PluginsCommand(click.Group):
             return []
 
     def get_command(self, cli_ctx, name):
+
         def _load_module_or_fail():
             try:
                 return load_plugin_module(name)
@@ -326,7 +319,6 @@ class PluginsCommand(click.Group):
 
 plugins = PluginsCommand(name="plugins", help="Gestión de plugins instalados")
 
-
 # ============================================================================
 # SYSTEM COMMANDS
 # ============================================================================
@@ -548,6 +540,17 @@ def _database_status():
     return {"tables": len(tables), "table_names": tables[:10], "record_counts": counts}
 
 
+@click.command()
+@with_appcontext
+@pass_context
+def serve():
+    """Run the application server."""
+    try:
+        wsgi_server(app=current_app)
+    except Exception as e:
+        click.echo(f"Failed to start server: {e}", err=True)
+
+
 @click.group()
 def database():
     """Database management commands."""

coati_payroll/config.py

@@ -1,16 +1,5 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#    http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """Base configuration for the payroll module."""
 
 from __future__ import annotations

coati_payroll/demo_data.py

@@ -1,16 +1,5 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#    http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """Demo data loading for manual testing.
 
 This module provides comprehensive sample data to facilitate manual testing

coati_payroll/enums.py

@@ -1,16 +1,5 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#    http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """Enumerations for type safety using Python 3.11+ StrEnum.
 
 This module defines string-based enums using Python 3.11's StrEnum class,

coati_payroll/forms.py

@@ -1,16 +1,5 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#    http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 
 """Forms module.
 
@@ -1767,3 +1756,8 @@ class VacationInitialBalanceForm(FlaskForm):
     )
 
     submit = SubmitField(_("Cargar Saldo Inicial"))
+
+
+class ConfiguracionIdiomaForm(FlaskForm):
+    idioma = SelectField("Idioma", validators=[DataRequired()])
+    submit = SubmitField("Guardar Cambios")

coati_payroll/formula_engine/__init__.py

@@ -1,16 +1,5 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#    http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """Formula engine package.
 
 This package contains the refactored formula engine with modular architecture:
@@ -21,6 +10,17 @@ This package contains the refactored formula engine with modular architecture:
 
 from __future__ import annotations
 
+# <-------------------------------------------------------------------------> #
+# Standard library
+# <-------------------------------------------------------------------------> #
+
+# <-------------------------------------------------------------------------> #
+# Standard library
+# <-------------------------------------------------------------------------> #
+
+# <-------------------------------------------------------------------------> #
+# Local modules
+# <-------------------------------------------------------------------------> #
 # Import from formula_engine_examples
 # EXAMPLE_PROGRESSIVE_TAX_SCHEMA is the new generic name
 # EXAMPLE_IR_NICARAGUA_SCHEMA is kept for backward compatibility (deprecated)
@@ -51,6 +51,7 @@ from .ast import (
 from .data_sources import AVAILABLE_DATA_SOURCES
 from .novelty_codes import NOVELTY_CODES
 
+# <==================[ Expose all varaibles and constants ]===================>
 __all__ = [
     # Main engine
     "FormulaEngine",

coati_payroll/formula_engine/ast/__init__.py

@@ -1,4 +1,5 @@
-# Copyright 2025 BMO Soluciones, S.A.
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
+# Copyright 2025 - 2026 BMO Soluciones, S.A.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -70,6 +71,19 @@ Security Notes:
 - Regular security audits are recommended
 """
 
+# <-------------------------------------------------------------------------> #
+# Standard library
+# <-------------------------------------------------------------------------> #
+
+
+# <-------------------------------------------------------------------------> #
+# Third party packages
+# <-------------------------------------------------------------------------> #
+
+
+# <-------------------------------------------------------------------------> #
+# Local modules
+# <-------------------------------------------------------------------------> #
 from .ast_visitor import ASTVisitor, SafeASTVisitor
 from .expression_evaluator import ExpressionEvaluator
 from .safe_operators import (
@@ -90,6 +104,7 @@ from .type_converter import (
     MIN_DECIMAL_VALUE,
 )
 
+# <==================[ Expose all varaibles and constants ]===================>
 __all__ = [
     "ASTVisitor",
     "SafeASTVisitor",

coati_payroll/formula_engine/ast/ast_visitor.py

@@ -1,16 +1,5 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#    http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """AST Visitor pattern for safe expression evaluation.
 
 This module implements a secure AST visitor that evaluates mathematical expressions
@@ -30,11 +19,20 @@ and each type has an explicit, auditable handler method.
 
 from __future__ import annotations
 
+# <-------------------------------------------------------------------------> #
+# Standard library
+# <-------------------------------------------------------------------------> #
+import ast
 from abc import ABC, abstractmethod
 from decimal import Decimal
 
-import ast
+# <-------------------------------------------------------------------------> #
+# Third party packages
+# <-------------------------------------------------------------------------> #
 
+# <-------------------------------------------------------------------------> #
+# Local modules
+# <-------------------------------------------------------------------------> #
 from ..exceptions import CalculationError
 from .safe_operators import SAFE_FUNCTIONS, SAFE_OPERATORS
 from .type_converter import to_decimal
@@ -151,7 +149,7 @@ class SafeASTVisitor(ASTVisitor):
         """
         if node.id not in self.variables:
             raise CalculationError(
-                f"Undefined variable: '{node.id}'. " f"Available variables: {', '.join(sorted(self.variables.keys()))}"
+                f"Undefined variable: '{node.id}'. Available variables: {', '.join(sorted(self.variables.keys()))}"
             )
         return self.variables[node.id]
 
@@ -174,7 +172,7 @@ class SafeASTVisitor(ASTVisitor):
         op_func = SAFE_OPERATORS.get(op_type)
         if not op_func:
             raise CalculationError(
-                f"Operator '{op_type.__name__}' is not allowed. " f"Allowed operators: +, -, *, /, //, %, **"
+                f"Operator '{op_type.__name__}' is not allowed. Allowed operators: +, -, *, /, //, %, **"
             )
 
         if op_type in (ast.Div, ast.FloorDiv, ast.Mod) and right == 0:
@@ -226,7 +224,7 @@ class SafeASTVisitor(ASTVisitor):
         """
         if not isinstance(node.func, ast.Name):
             raise CalculationError(
-                "Only direct named function calls are allowed. " "Attribute access and lambda functions are prohibited."
+                "Only direct named function calls are allowed. Attribute access and lambda functions are prohibited."
             )
 
         func_name = node.func.id

coati_payroll/formula_engine/ast/expression_evaluator.py

@@ -1,16 +1,5 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#    http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """Expression evaluator using AST visitor pattern.
 
 This module provides secure evaluation of mathematical expressions from JSON rules.
@@ -40,13 +29,22 @@ Example Unsafe Expression (rejected):
 
 from __future__ import annotations
 
+# <-------------------------------------------------------------------------> #
+# Standard library
+# <-------------------------------------------------------------------------> #
 import ast
 from decimal import Decimal
 from typing import Callable
 
+# <-------------------------------------------------------------------------> #
+# Third party packages
+# <-------------------------------------------------------------------------> #
+
+# <-------------------------------------------------------------------------> #
+# Local modules
+# <-------------------------------------------------------------------------> #
 from coati_payroll.i18n import _
 from coati_payroll.log import TRACE_LEVEL_NUM, is_trace_enabled, log
-
 from ..exceptions import CalculationError
 from .ast_visitor import SafeASTVisitor
 from .safe_operators import ALLOWED_AST_TYPES, MAX_EXPRESSION_LENGTH, MAX_AST_DEPTH

coati_payroll/formula_engine/ast/safe_operators.py

@@ -1,16 +1,5 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#    http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """Safe operators and functions for expression evaluation.
 
 This module defines the ONLY operators and functions allowed in formula expressions.
@@ -40,10 +29,22 @@ Prohibited Operations:
 
 from __future__ import annotations
 
+# <-------------------------------------------------------------------------> #
+# Standard library
+# <-------------------------------------------------------------------------> #
 import ast
 import operator
 from typing import Any, Callable
 
+# <-------------------------------------------------------------------------> #
+# Third party packages
+# <-------------------------------------------------------------------------> #
+
+# <-------------------------------------------------------------------------> #
+# Local modules
+# <-------------------------------------------------------------------------> #
+
+# <-------------------- Constantes Locales --------------------> #
 MAX_EXPRESSION_LENGTH = 1000
 MAX_AST_DEPTH = 50
 MAX_FUNCTION_ARGS = 20
@@ -61,12 +62,12 @@ def validate_safe_function_call(func_name: str, args: list[Any]) -> None:
     """
     if func_name not in SAFE_FUNCTIONS:
         raise ValueError(
-            f"Function '{func_name}' is not in the whitelist. " f"Allowed functions: {', '.join(SAFE_FUNCTIONS.keys())}"
+            f"Function '{func_name}' is not in the whitelist. Allowed functions: {', '.join(SAFE_FUNCTIONS.keys())}"
         )
 
     if len(args) > MAX_FUNCTION_ARGS:
         raise ValueError(
-            f"Too many arguments ({len(args)}) for function '{func_name}'. " f"Maximum allowed: {MAX_FUNCTION_ARGS}"
+            f"Too many arguments ({len(args)}) for function '{func_name}'. Maximum allowed: {MAX_FUNCTION_ARGS}"
         )
 
     if func_name == "round" and len(args) > 2:

coati_payroll/formula_engine/ast/type_converter.py

@@ -1,16 +1,5 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#    http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """Type conversion utilities for formula engine.
 
 This module provides safe type conversion functions that maintain financial
@@ -36,12 +25,23 @@ Security Considerations:
 
 from __future__ import annotations
 
+# <-------------------------------------------------------------------------> #
+# Standard library
+# <-------------------------------------------------------------------------> #
+import math
 from decimal import Decimal, InvalidOperation
 from typing import Any
-import math
 
+# <-------------------------------------------------------------------------> #
+# Third party packages
+# <-------------------------------------------------------------------------> #
+
+# <-------------------------------------------------------------------------> #
+# Local modules
+# <-------------------------------------------------------------------------> #
 from ..exceptions import ValidationError
 
+# <-------------------- Constantes Locales --------------------> #
 MAX_DECIMAL_DIGITS = 28
 MAX_DECIMAL_VALUE = Decimal("9" * MAX_DECIMAL_DIGITS)
 MIN_DECIMAL_VALUE = -MAX_DECIMAL_VALUE
@@ -98,7 +98,7 @@ def to_decimal(value: Any) -> Decimal:
             )
         if math.isinf(value):
             raise ValidationError(
-                "Cannot convert infinity to Decimal. " "Check for division by zero or overflow in input calculations."
+                "Cannot convert infinity to Decimal. Check for division by zero or overflow in input calculations."
             )
 
     try:
@@ -127,10 +127,10 @@ def _validate_decimal_range(value: Decimal) -> None:
         ValidationError: If value is outside acceptable range
     """
     if value.is_nan():
-        raise ValidationError("Decimal value is NaN (Not a Number). " "This indicates an invalid calculation result.")
+        raise ValidationError("Decimal value is NaN (Not a Number). This indicates an invalid calculation result.")
 
     if value.is_infinite():
-        raise ValidationError("Decimal value is infinite. " "This indicates an overflow or division by zero.")
+        raise ValidationError("Decimal value is infinite. This indicates an overflow or division by zero.")
 
     if value > MAX_DECIMAL_VALUE or value < MIN_DECIMAL_VALUE:
         raise ValidationError(

coati_payroll/formula_engine/data_sources.py

@@ -1,22 +1,12 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#    http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """Available data sources for formula engine calculations.
 
 This module defines all available data sources that can be accessed
 when creating calculation rules in the formula engine.
 """
 
+# ................................ CONTANTES ................................ #
 AVAILABLE_DATA_SOURCES = {
     "empleado": {
         "label": "Empleado",

coati_payroll/formula_engine/engine.py

@@ -1,23 +1,22 @@
-# Copyright 2025 BMO Soluciones, S.A.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#    http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: 2025 - 2026 BMO Soluciones, S.A.
 """Main formula engine facade."""
 
 from __future__ import annotations
 
+# <-------------------------------------------------------------------------> #
+# Standard library
+# <-------------------------------------------------------------------------> #
 from decimal import Decimal
 from typing import Any
 
+# <-------------------------------------------------------------------------> #
+# Third party packages
+# <-------------------------------------------------------------------------> #
+
+# <-------------------------------------------------------------------------> #
+# Local modules
+# <-------------------------------------------------------------------------> #
 from coati_payroll.i18n import _
 from coati_payroll.log import TRACE_LEVEL_NUM, is_trace_enabled, log