mirror/TimeTracker
1
0
Fork 0
mirror of https://github.com/DRYTRIX/TimeTracker.git synced 2026-05-19 04:40:32 -05:00
Code Issues Packages Projects Releases Wiki Activity
Files
0275be901367ae3fe36ccd7efb7d7a7219835090
TimeTracker/app/utils/module_registry.py
T
Dries Peeters b4486a627f fix: CI tests, code quality, and duplicate DB indexes 
- Webhook models: remove duplicate index definitions so db.create_all()
  no longer raises 'index already exists' (columns already have index=True)
- ImportService: fix circular import by late-importing ClientService,
  ProjectService, TimeTrackingService in __init__
- reports: fix F823 by renaming unpack variable _ to _entry_count to avoid
  shadowing gettext _ in export_task_excel()
- Code quality: add .flake8 with extend-ignore so flake8 CI passes;
  simplify pyproject.toml isort config (drop unsupported options)
- Format: run black and isort on app/
- tests: restore minimal app fixture in test_import_export_models
2026-03-15 10:51:52 +01:00

790 lines
25 KiB
Python
Raw Blame History

"""
Module Registry System
Centralized registry for managing module metadata, dependencies, and visibility.
"""
from dataclasses import dataclass, field
from enum import Enum
from typing import Dict, List, Optional, Tuple
class ModuleCategory(Enum):
"""Module categories for organization"""
CORE = "core"
TIME_TRACKING = "time_tracking"
PROJECT_MANAGEMENT = "project_management"
CRM = "crm"
FINANCE = "finance"
INVENTORY = "inventory"
ANALYTICS = "analytics"
TOOLS = "tools"
ADMIN = "admin"
ADVANCED = "advanced"
@dataclass
class ModuleDefinition:
"""Definition of a module with its metadata and configuration"""
id: str
name: str
description: str
category: ModuleCategory
blueprint_name: str
default_enabled: bool = True
requires_admin: bool = False
# If the module is disabled in settings.disabled_module_ids, allow admins to still use it.
# This supports "admin-only" behavior for modules like Clients.
admin_only_when_disabled: bool = False
dependencies: List[str] = field(default_factory=list) # Module IDs this depends on
routes: List[str] = field(default_factory=list) # Route endpoints
icon: Optional[str] = None # FontAwesome icon class
order: int = 0 # Display order in navigation
def __post_init__(self):
"""Validate and normalize module definition"""
if self.dependencies is None:
self.dependencies = []
if self.routes is None:
self.routes = []
class ModuleRegistry:
"""Centralized registry for all application modules"""
_modules: Dict[str, ModuleDefinition] = {}
_initialized: bool = False
@classmethod
def register(cls, module: ModuleDefinition):
"""Register a module definition"""
cls._modules[module.id] = module
@classmethod
def get(cls, module_id: str) -> Optional[ModuleDefinition]:
"""Get a module definition by ID"""
return cls._modules.get(module_id)
@classmethod
def get_all(cls) -> Dict[str, ModuleDefinition]:
"""Get all registered modules"""
return cls._modules.copy()
@classmethod
def get_by_category(cls, category: ModuleCategory) -> List[ModuleDefinition]:
"""Get all modules in a specific category, sorted by order"""
modules = [m for m in cls._modules.values() if m.category == category]
return sorted(modules, key=lambda m: m.order)
@classmethod
def is_enabled(cls, module_id: str, settings=None, user=None) -> bool:
"""
Check if a module is enabled for a user.
Args:
module_id: The module ID to check
settings: Settings instance (deprecated, kept for backwards compatibility)
user: User instance (optional, will use current_user if not provided)
Returns:
True if module is enabled, False otherwise
"""
module = cls.get(module_id)
if not module:
return False
# Resolve user lazily (avoid importing flask_login unless needed)
if user is None:
try:
from flask_login import current_user
user = current_user
except Exception:
user = None
# Core modules are always enabled
if module.category == ModuleCategory.CORE:
return True
# Admin-only modules require admin access
if module.requires_admin:
if not user or not getattr(user, "is_authenticated", False):
return False
if not getattr(user, "is_admin", False):
return False
# Role-based module visibility (denylist): if ALL assigned roles hide the module, disable it.
# - No roles (legacy edge) => do not hide anything by default.
# - Super admins bypass role-based hiding to avoid lockouts.
if user and getattr(user, "is_authenticated", False):
if getattr(user, "is_super_admin", False):
pass
else:
roles = getattr(user, "roles", None) or []
if roles:
hidden_by_all_roles = True
for role in roles:
role_hidden = module_id in (getattr(role, "hidden_module_ids", None) or [])
if not role_hidden:
hidden_by_all_roles = False
break
if hidden_by_all_roles:
return False
# Check dependencies recursively
for dep_id in module.dependencies:
if not cls.is_enabled(dep_id, settings, user):
return False
# Admin-disabled modules (settings.disabled_module_ids)
if settings:
disabled = getattr(settings, "disabled_module_ids", None) or []
if isinstance(disabled, list) and module_id in disabled:
# Some modules can be disabled for non-admin users only.
if module.admin_only_when_disabled:
if user is None:
from flask_login import current_user
user = current_user
if user and getattr(user, "is_authenticated", False) and getattr(user, "is_admin", False):
return True
return False
return True
@classmethod
def get_enabled_modules(cls, settings=None, user=None) -> List[ModuleDefinition]:
"""Get all enabled modules for a user"""
enabled = []
for module in cls._modules.values():
if cls.is_enabled(module.id, settings, user):
enabled.append(module)
return sorted(enabled, key=lambda m: (m.category.value, m.order))
@classmethod
def get_dependents(cls, module_id: str) -> List[ModuleDefinition]:
"""
Get all modules that depend on the given module.
Args:
module_id: The module ID to check for dependents
Returns:
List of ModuleDefinition objects that depend on the given module
"""
dependents = []
target_module = cls.get(module_id)
if not target_module:
return dependents
for module in cls._modules.values():
if module_id in module.dependencies:
dependents.append(module)
return dependents
@classmethod
def validate_module_disable(cls, module_id: str, disabled_list: List[str]) -> Tuple[bool, List[str]]:
"""
Validate if a module can be disabled, checking for dependent modules.
Args:
module_id: The module ID to check
disabled_list: List of module IDs that will be disabled
Returns:
Tuple of (can_disable, affected_modules)
- can_disable: True if module can be disabled without breaking dependencies
- affected_modules: List of module IDs that depend on this module and will be affected
"""
module = cls.get(module_id)
if not module:
return True, []
# Core modules cannot be disabled
if module.category == ModuleCategory.CORE:
return False, []
# Get all modules that depend on this one
dependents = cls.get_dependents(module_id)
affected = []
for dependent in dependents:
# If the dependent is not in the disabled list, disabling this module will break it
if dependent.id not in disabled_list:
affected.append(dependent.id)
# Can disable if no unaffected dependents exist
can_disable = len(affected) == 0
return can_disable, affected
@classmethod
def initialize_defaults(cls):
"""Initialize the registry with all default module definitions"""
if cls._initialized:
return
# Core modules (always enabled)
cls.register(
ModuleDefinition(
id="auth",
name="Authentication",
description="User authentication and profile management",
category=ModuleCategory.CORE,
blueprint_name="auth",
default_enabled=True,
icon="fa-user-circle",
order=0,
)
)
cls.register(
ModuleDefinition(
id="main",
name="Dashboard",
description="Main dashboard",
category=ModuleCategory.CORE,
blueprint_name="main",
default_enabled=True,
icon="fa-tachometer-alt",
order=1,
)
)
cls.register(
ModuleDefinition(
id="projects",
name="Projects",
description="Project management",
category=ModuleCategory.CORE,
blueprint_name="projects",
default_enabled=True,
icon="fa-folder",
order=2,
)
)
cls.register(
ModuleDefinition(
id="timer",
name="Time Tracking",
description="Time entry and timer management",
category=ModuleCategory.CORE,
blueprint_name="timer",
default_enabled=True,
icon="fa-clock",
order=3,
)
)
cls.register(
ModuleDefinition(
id="tasks",
name="Tasks",
description="Task management",
category=ModuleCategory.CORE,
blueprint_name="tasks",
default_enabled=True,
dependencies=["projects"],
icon="fa-tasks",
order=4,
)
)
cls.register(
ModuleDefinition(
id="clients",
name="Clients",
description="Client management",
category=ModuleCategory.CRM,
blueprint_name="clients",
default_enabled=True,
admin_only_when_disabled=True,
icon="fa-users",
order=5,
)
)
# Time Tracking Features
cls.register(
ModuleDefinition(
id="calendar",
name="Calendar",
description="Calendar view and integrations",
category=ModuleCategory.TIME_TRACKING,
blueprint_name="calendar",
default_enabled=True,
icon="fa-calendar-alt",
order=10,
)
)
cls.register(
ModuleDefinition(
id="project_templates",
name="Project Templates",
description="Project template system",
category=ModuleCategory.PROJECT_MANAGEMENT,
blueprint_name="project_templates",
default_enabled=True,
dependencies=["projects"],
icon="fa-layer-group",
order=11,
)
)
cls.register(
ModuleDefinition(
id="gantt",
name="Gantt Chart",
description="Gantt chart visualization",
category=ModuleCategory.PROJECT_MANAGEMENT,
blueprint_name="gantt",
default_enabled=True,
dependencies=["tasks"],
icon="fa-project-diagram",
order=12,
)
)
cls.register(
ModuleDefinition(
id="kanban",
name="Kanban Board",
description="Kanban task board",
category=ModuleCategory.PROJECT_MANAGEMENT,
blueprint_name="kanban",
default_enabled=True,
dependencies=["tasks"],
icon="fa-columns",
order=13,
)
)
cls.register(
ModuleDefinition(
id="weekly_goals",
name="Weekly Goals",
description="Weekly time goals tracking",
category=ModuleCategory.TIME_TRACKING,
blueprint_name="weekly_goals",
default_enabled=True,
icon="fa-bullseye",
order=14,
)
)
cls.register(
ModuleDefinition(
id="issues",
name="Issues",
description="Issue and bug tracking",
category=ModuleCategory.PROJECT_MANAGEMENT,
blueprint_name="issues",
default_enabled=True,
icon="fa-bug",
order=15,
)
)
cls.register(
ModuleDefinition(
id="time_entry_templates",
name="Time Entry Templates",
description="Reusable time entry templates",
category=ModuleCategory.TIME_TRACKING,
blueprint_name="time_entry_templates",
default_enabled=True,
icon="fa-clipboard-list",
order=16,
)
)
# CRM Features
cls.register(
ModuleDefinition(
id="quotes",
name="Quotes",
description="Quote management",
category=ModuleCategory.CRM,
blueprint_name="quotes",
default_enabled=True,
dependencies=["clients"],
icon="fa-file-contract",
order=20,
)
)
cls.register(
ModuleDefinition(
id="contacts",
name="Contacts",
description="Contact management",
category=ModuleCategory.CRM,
blueprint_name="contacts",
default_enabled=True,
dependencies=["clients"],
icon="fa-address-book",
order=21,
)
)
cls.register(
ModuleDefinition(
id="deals",
name="Deals",
description="Deal pipeline management",
category=ModuleCategory.CRM,
blueprint_name="deals",
default_enabled=True,
dependencies=["clients"],
icon="fa-handshake",
order=22,
)
)
cls.register(
ModuleDefinition(
id="leads",
name="Leads",
description="Lead management",
category=ModuleCategory.CRM,
blueprint_name="leads",
default_enabled=True,
dependencies=["clients"],
icon="fa-user-tag",
order=23,
)
)
# Finance & Expenses
cls.register(
ModuleDefinition(
id="reports",
name="Reports",
description="Standard reports",
category=ModuleCategory.FINANCE,
blueprint_name="reports",
default_enabled=True,
icon="fa-chart-bar",
order=30,
)
)
cls.register(
ModuleDefinition(
id="custom_reports",
name="Report Builder",
description="Custom report builder",
category=ModuleCategory.FINANCE,
blueprint_name="custom_reports",
default_enabled=True,
icon="fa-magic",
order=31,
)
)
cls.register(
ModuleDefinition(
id="scheduled_reports",
name="Scheduled Reports",
description="Automated report scheduling",
category=ModuleCategory.FINANCE,
blueprint_name="scheduled_reports",
default_enabled=True,
icon="fa-clock",
order=32,
)
)
cls.register(
ModuleDefinition(
id="invoices",
name="Invoices",
description="Invoice management",
category=ModuleCategory.FINANCE,
blueprint_name="invoices",
default_enabled=True,
dependencies=["projects"],
icon="fa-file-invoice",
order=33,
)
)
cls.register(
ModuleDefinition(
id="invoice_approvals",
name="Invoice Approvals",
description="Invoice approval workflow",
category=ModuleCategory.FINANCE,
blueprint_name="invoice_approvals",
default_enabled=True,
dependencies=["invoices"],
icon="fa-check-circle",
order=34,
)
)
cls.register(
ModuleDefinition(
id="recurring_invoices",
name="Recurring Invoices",
description="Recurring invoice management",
category=ModuleCategory.FINANCE,
blueprint_name="recurring_invoices",
default_enabled=True,
dependencies=["invoices"],
icon="fa-sync-alt",
order=35,
)
)
cls.register(
ModuleDefinition(
id="payments",
name="Payments",
description="Payment tracking",
category=ModuleCategory.FINANCE,
blueprint_name="payments",
default_enabled=True,
dependencies=["invoices"],
icon="fa-credit-card",
order=36,
)
)
cls.register(
ModuleDefinition(
id="payment_gateways",
name="Payment Gateways",
description="Payment gateway integration",
category=ModuleCategory.FINANCE,
blueprint_name="payment_gateways",
default_enabled=True,
dependencies=["payments"],
icon="fa-credit-card",
order=37,
)
)
cls.register(
ModuleDefinition(
id="expenses",
name="Expenses",
description="Expense tracking",
category=ModuleCategory.FINANCE,
blueprint_name="expenses",
default_enabled=True,
dependencies=["projects"],
icon="fa-receipt",
order=38,
)
)
cls.register(
ModuleDefinition(
id="mileage",
name="Mileage",
description="Mileage tracking",
category=ModuleCategory.FINANCE,
blueprint_name="mileage",
default_enabled=True,
icon="fa-car",
order=39,
)
)
cls.register(
ModuleDefinition(
id="per_diem",
name="Per Diem",
description="Per diem expense tracking",
category=ModuleCategory.FINANCE,
blueprint_name="per_diem",
default_enabled=True,
icon="fa-utensils",
order=40,
)
)
cls.register(
ModuleDefinition(
id="budget_alerts",
name="Budget Alerts",
description="Project budget monitoring",
category=ModuleCategory.FINANCE,
blueprint_name="budget_alerts",
default_enabled=True,
dependencies=["projects"],
icon="fa-exclamation-triangle",
order=41,
)
)
# Inventory
cls.register(
ModuleDefinition(
id="inventory",
name="Inventory",
description="Inventory management",
category=ModuleCategory.INVENTORY,
blueprint_name="inventory",
default_enabled=True,
icon="fa-boxes",
order=50,
)
)
# Analytics
cls.register(
ModuleDefinition(
id="analytics",
name="Analytics",
description="Analytics dashboard",
category=ModuleCategory.ANALYTICS,
blueprint_name="analytics",
default_enabled=True,
icon="fa-chart-line",
order=60,
)
)
# Tools & Data
cls.register(
ModuleDefinition(
id="integrations",
name="Integrations",
description="External integrations",
category=ModuleCategory.TOOLS,
blueprint_name="integrations",
default_enabled=True,
icon="fa-plug",
order=70,
)
)
cls.register(
ModuleDefinition(
id="import_export",
name="Import/Export",
description="Data import and export",
category=ModuleCategory.TOOLS,
blueprint_name="import_export",
default_enabled=True,
icon="fa-exchange-alt",
order=71,
)
)
cls.register(
ModuleDefinition(
id="saved_filters",
name="Saved Filters",
description="Saved filter management",
category=ModuleCategory.TOOLS,
blueprint_name="saved_filters",
default_enabled=True,
icon="fa-filter",
order=72,
)
)
# Advanced Features
cls.register(
ModuleDefinition(
id="workflows",
name="Workflows",
description="Automation workflows",
category=ModuleCategory.ADVANCED,
blueprint_name="workflows",
default_enabled=True,
icon="fa-sitemap",
order=80,
)
)
cls.register(
ModuleDefinition(
id="time_approvals",
name="Time Approvals",
description="Time entry approval workflow",
category=ModuleCategory.ADVANCED,
blueprint_name="time_approvals",
default_enabled=True,
dependencies=["timer"],
icon="fa-check-double",
order=81,
)
)
cls.register(
ModuleDefinition(
id="activity_feed",
name="Activity Feed",
description="Activity stream",
category=ModuleCategory.ADVANCED,
blueprint_name="activity_feed",
default_enabled=True,
icon="fa-stream",
order=82,
)
)
cls.register(
ModuleDefinition(
id="recurring_tasks",
name="Recurring Tasks",
description="Automated recurring tasks",
category=ModuleCategory.ADVANCED,
blueprint_name="recurring_tasks",
default_enabled=True,
dependencies=["tasks"],
icon="fa-redo",
order=83,
)
)
cls.register(
ModuleDefinition(
id="team_chat",
name="Team Chat",
description="Team messaging",
category=ModuleCategory.ADVANCED,
blueprint_name="team_chat",
default_enabled=True,
icon="fa-comments",
order=84,
)
)
cls.register(
ModuleDefinition(
id="client_portal",
name="Client Portal",
description="Client-facing portal",
category=ModuleCategory.ADVANCED,
blueprint_name="client_portal",
default_enabled=True,
dependencies=["clients"],
icon="fa-door-open",
order=85,
)
)
cls.register(
ModuleDefinition(
id="kiosk",
name="Kiosk Mode",
description="Kiosk interface",
category=ModuleCategory.ADVANCED,
blueprint_name="kiosk",
default_enabled=True,
icon="fa-desktop",
order=86,
)
)
cls._initialized = True
Reference in New Issue View Git Blame Copy Permalink