# 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), )