orion/app/modules/dev_tools/routes/pages/admin.py

# app/modules/dev_tools/routes/pages/admin.py
"""
Dev Tools Admin Page Routes (HTML rendering).

Admin pages for developer tools:
- Components library
- Icons browser
- Testing dashboard
- Testing hub
- Test auth flow
- Test stores/users migration
"""

from fastapi import APIRouter, Depends, Request
from fastapi.responses import HTMLResponse
from sqlalchemy.orm import Session

from app.api.deps import get_db, require_menu_access
from app.modules.core.utils.page_context import get_admin_context
from app.modules.enums import FrontendType
from app.modules.tenancy.models import User
from app.templates_config import templates

router = APIRouter()


# ============================================================================
# DEVELOPER TOOLS - COMPONENTS & TESTING
# ============================================================================


@router.get("/components", response_class=HTMLResponse, include_in_schema=False)
async def admin_components_page(
    request: Request,
    current_user: User = Depends(
        require_menu_access("components", FrontendType.ADMIN)
    ),
    db: Session = Depends(get_db),
):
    """
    Render UI components library page.
    Reference for all available UI components.
    """
    return templates.TemplateResponse(
        "dev_tools/admin/components.html",
        get_admin_context(request, db, current_user),
    )


@router.get("/icons", response_class=HTMLResponse, include_in_schema=False)
async def admin_icons_page(
    request: Request,
    current_user: User = Depends(require_menu_access("icons", FrontendType.ADMIN)),
    db: Session = Depends(get_db),
):
    """
    Render icons browser page.
    Browse and search all available icons.
    """
    return templates.TemplateResponse(
        "dev_tools/admin/icons.html",
        get_admin_context(request, db, current_user),
    )


@router.get("/testing", response_class=HTMLResponse, include_in_schema=False)
async def admin_testing_dashboard(
    request: Request,
    current_user: User = Depends(require_menu_access("testing", FrontendType.ADMIN)),
    db: Session = Depends(get_db),
):
    """
    Render testing dashboard page.
    pytest results and test coverage overview.
    """
    return templates.TemplateResponse(
        "dev_tools/admin/testing-dashboard.html",
        get_admin_context(request, db, current_user),
    )


@router.get("/testing-hub", response_class=HTMLResponse, include_in_schema=False)
async def admin_testing_hub(
    request: Request,
    current_user: User = Depends(require_menu_access("testing", FrontendType.ADMIN)),
    db: Session = Depends(get_db),
):
    """
    Render manual testing hub page.
    Central hub for all manual test suites and QA tools.
    """
    return templates.TemplateResponse(
        "dev_tools/admin/testing-hub.html",
        get_admin_context(request, db, current_user),
    )


@router.get("/test/auth-flow", response_class=HTMLResponse, include_in_schema=False)
async def admin_test_auth_flow(
    request: Request,
    current_user: User = Depends(require_menu_access("testing", FrontendType.ADMIN)),
    db: Session = Depends(get_db),
):
    """
    Render authentication flow testing page.
    Tests login, logout, token expiration, and protected routes.
    """
    return templates.TemplateResponse(
        "dev_tools/admin/test-auth-flow.html",
        get_admin_context(request, db, current_user),
    )


@router.get(
    "/test/stores-users-migration",
    response_class=HTMLResponse,
    include_in_schema=False,
)
async def admin_test_stores_users_migration(
    request: Request,
    current_user: User = Depends(require_menu_access("testing", FrontendType.ADMIN)),
    db: Session = Depends(get_db),
):
    """
    Render stores and users migration testing page.
    Tests CRUD operations, data migration, and form validation.
    """
    return templates.TemplateResponse(
        "dev_tools/admin/test-stores-users-migration.html",
        get_admin_context(request, db, current_user),
    )


@router.get("/platform-debug", response_class=HTMLResponse, include_in_schema=False)
async def admin_platform_debug_page(
    request: Request,
    current_user: User = Depends(
        require_menu_access("testing", FrontendType.ADMIN)
    ),
    db: Session = Depends(get_db),
):
    """
    Render platform resolution debug page.
    Traces middleware pipeline for all URL patterns.
    """
    return templates.TemplateResponse(
        "dev_tools/admin/platform-debug.html",
        get_admin_context(request, db, current_user),
    )


@router.get("/translation-editor", response_class=HTMLResponse, include_in_schema=False)
async def admin_translation_editor_page(
    request: Request,
    current_user: User = Depends(
        require_menu_access("translation-editor", FrontendType.ADMIN)
    ),
    db: Session = Depends(get_db),
):
    """Render translation editor page."""
    return templates.TemplateResponse(
        "dev_tools/admin/translation-editor.html",
        get_admin_context(request, db, current_user),
    )


@router.get("/sql-query", response_class=HTMLResponse, include_in_schema=False)
async def admin_sql_query_page(
    request: Request,
    current_user: User = Depends(
        require_menu_access("sql-query", FrontendType.ADMIN)
    ),
    db: Session = Depends(get_db),
):
    """
    Render SQL query tool page.
    Ad-hoc SQL query execution with saved query management.
    """
    return templates.TemplateResponse(
        "dev_tools/admin/sql-query.html",
        get_admin_context(request, db, current_user),
    )