Files
orion/app/modules/enums.py
Samir Boulahtit d7a0ff8818 refactor: complete module-driven architecture migration
This commit completes the migration to a fully module-driven architecture:

## Models Migration
- Moved all domain models from models/database/ to their respective modules:
  - tenancy: User, Admin, Vendor, Company, Platform, VendorDomain, etc.
  - cms: MediaFile, VendorTheme
  - messaging: Email, VendorEmailSettings, VendorEmailTemplate
  - core: AdminMenuConfig
- models/database/ now only contains Base and TimestampMixin (infrastructure)

## Schemas Migration
- Moved all domain schemas from models/schema/ to their respective modules:
  - tenancy: company, vendor, admin, team, vendor_domain
  - cms: media, image, vendor_theme
  - messaging: email
- models/schema/ now only contains base.py and auth.py (infrastructure)

## Routes Migration
- Moved admin routes from app/api/v1/admin/ to modules:
  - menu_config.py -> core module
  - modules.py -> tenancy module
  - module_config.py -> tenancy module
- app/api/v1/admin/ now only aggregates auto-discovered module routes

## Menu System
- Implemented module-driven menu system with MenuDiscoveryService
- Extended FrontendType enum: PLATFORM, ADMIN, VENDOR, STOREFRONT
- Added MenuItemDefinition and MenuSectionDefinition dataclasses
- Each module now defines its own menu items in definition.py
- MenuService integrates with MenuDiscoveryService for template rendering

## Documentation
- Updated docs/architecture/models-structure.md
- Updated docs/architecture/menu-management.md
- Updated architecture validation rules for new exceptions

## Architecture Validation
- Updated MOD-019 rule to allow base.py in models/schema/
- Created core module exceptions.py and schemas/ directory
- All validation errors resolved (only warnings remain)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-01 21:02:56 +01:00

52 lines
1.6 KiB
Python

# app/modules/enums.py
"""
Module system enums.
This file contains enums used by the module system that need to be
importable without triggering database model imports.
The FrontendType enum is defined here to break a circular import:
- app.modules.base imports FrontendType
- Previously FrontendType was in models.database.admin_menu_config
- Importing from models.database triggers model discovery
- Model discovery imports module definitions
- Module definitions import from app.modules.base → CIRCULAR
By defining FrontendType here, we break this cycle.
"""
import enum
class FrontendType(str, enum.Enum):
"""Frontend types that can have menu configuration."""
PLATFORM = "platform" # Public marketing pages (pricing, signup, about)
ADMIN = "admin" # Admin panel (super admins, platform admins)
VENDOR = "vendor" # Vendor dashboard
STOREFRONT = "storefront" # Customer-facing shop
# Menu items that cannot be hidden - always visible regardless of config
# Organized by frontend type
# NOTE: This will be deprecated in favor of MenuItemDefinition.is_mandatory
MANDATORY_MENU_ITEMS = {
FrontendType.ADMIN: frozenset({
"dashboard", # Default landing page after login
"companies",
"vendors",
"admin-users",
"settings",
"my-menu", # Super admin menu config - must always be accessible
}),
FrontendType.VENDOR: frozenset({
"dashboard", # Default landing page after login
"settings",
}),
FrontendType.PLATFORM: frozenset(),
FrontendType.STOREFRONT: frozenset(),
}
__all__ = ["FrontendType", "MANDATORY_MENU_ITEMS"]