Samir Boulahtit
9db0da25ec
Implement comprehensive code quality dashboard (Phase 2-4) to track and manage
architecture violations found by the validation script.
Backend Implementation:
- Add JSON output support to validate_architecture.py script
- Create CodeQualityService with scan management, violation tracking, and statistics
- Implement REST API endpoints for code quality management:
* POST /admin/code-quality/scan - trigger new architecture scan
* GET /admin/code-quality/scans - list scan history
* GET /admin/code-quality/violations - list violations with filtering/pagination
* GET /admin/code-quality/violations/{id} - get violation details
* POST /admin/code-quality/violations/{id}/assign - assign to developer
* POST /admin/code-quality/violations/{id}/resolve - mark as resolved
* POST /admin/code-quality/violations/{id}/ignore - mark as ignored
* POST /admin/code-quality/violations/{id}/comments - add comments
* GET /admin/code-quality/stats - dashboard statistics
- Fix architecture_scan model imports to use app.core.database
Frontend Implementation:
- Create code quality dashboard page (code-quality-dashboard.html)
* Summary cards for total violations, errors, warnings, health score
* Status breakdown (open, assigned, resolved, ignored)
* Trend visualization for last 7 scans
* Top violating files list
* Violations by rule and module
* Quick action links
- Create violations list page (code-quality-violations.html)
* Filterable table by severity, status, rule ID, file path
* Pagination support
* Violation detail view links
- Add Alpine.js components (code-quality-dashboard.js, code-quality-violations.js)
* Dashboard state management and scan triggering
* Violations list with filtering and pagination
* API integration with authentication
- Add "Code Quality" navigation link in admin sidebar (Developer Tools section)
Routes:
- GET /admin/code-quality - dashboard page
- GET /admin/code-quality/violations - violations list
- GET /admin/code-quality/violations/{id} - violation details
Features:
- Real-time scan execution from UI
- Technical debt score calculation (0-100 scale)
- Violation workflow: open → assigned → resolved/ignored
- Trend tracking across multiple scans
- File and module-level insights
- Assignment system with priorities and due dates
- Collaborative comments on violations
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
122 lines
3.8 KiB
Python
122 lines
3.8 KiB
Python
# app/api/v1/admin/__init__.py
|
|
"""
|
|
Admin API router aggregation.
|
|
|
|
This module combines all admin-related JSON API endpoints:
|
|
- Authentication (login/logout)
|
|
- Vendor management (CRUD, bulk operations)
|
|
- Vendor domains management (custom domains, DNS verification)
|
|
- Vendor themes management (theme editor, presets)
|
|
- User management (status, roles)
|
|
- Dashboard and statistics
|
|
- Marketplace monitoring
|
|
- Audit logging
|
|
- Platform settings
|
|
- Notifications and alerts
|
|
- Code quality and architecture validation
|
|
|
|
IMPORTANT:
|
|
- This router is for JSON API endpoints only
|
|
- HTML page routes are mounted separately in main.py at /vendor/*
|
|
- Do NOT include pages.router here - it causes route conflicts
|
|
"""
|
|
|
|
from fastapi import APIRouter
|
|
|
|
# Import all admin routers
|
|
from . import (
|
|
auth,
|
|
vendors,
|
|
vendor_domains,
|
|
vendor_themes,
|
|
users,
|
|
dashboard,
|
|
marketplace,
|
|
monitoring,
|
|
audit,
|
|
settings,
|
|
notifications,
|
|
content_pages,
|
|
code_quality
|
|
)
|
|
|
|
# Create admin router
|
|
router = APIRouter()
|
|
|
|
|
|
# ============================================================================
|
|
# Authentication & Authorization
|
|
# ============================================================================
|
|
|
|
# Include authentication endpoints
|
|
router.include_router(auth.router, tags=["admin-auth"])
|
|
|
|
|
|
# ============================================================================
|
|
# Vendor Management
|
|
# ============================================================================
|
|
|
|
# Include vendor management endpoints
|
|
router.include_router(vendors.router, tags=["admin-vendors"])
|
|
|
|
# Include vendor domains management endpoints
|
|
router.include_router(vendor_domains.router, tags=["admin-vendor-domains"])
|
|
|
|
# Include vendor themes management endpoints
|
|
router.include_router(vendor_themes.router, tags=["admin-vendor-themes"])
|
|
|
|
# Include content pages management endpoints
|
|
router.include_router(content_pages.router, prefix="/content-pages", tags=["admin-content-pages"])
|
|
|
|
|
|
# ============================================================================
|
|
# User Management
|
|
# ============================================================================
|
|
|
|
# Include user management endpoints
|
|
router.include_router(users.router, tags=["admin-users"])
|
|
|
|
|
|
# ============================================================================
|
|
# Dashboard & Statistics
|
|
# ============================================================================
|
|
|
|
# Include dashboard and statistics endpoints
|
|
router.include_router(dashboard.router, tags=["admin-dashboard"])
|
|
|
|
|
|
# ============================================================================
|
|
# Marketplace & Imports
|
|
# ============================================================================
|
|
|
|
# Include marketplace monitoring endpoints
|
|
router.include_router(marketplace.router, tags=["admin-marketplace"])
|
|
|
|
|
|
# ============================================================================
|
|
# Platform Administration
|
|
# ============================================================================
|
|
|
|
# Include monitoring endpoints (placeholder for future implementation)
|
|
# router.include_router(monitoring.router, tags=["admin-monitoring"])
|
|
|
|
# Include audit logging endpoints
|
|
router.include_router(audit.router, tags=["admin-audit"])
|
|
|
|
# Include platform settings endpoints
|
|
router.include_router(settings.router, tags=["admin-settings"])
|
|
|
|
# Include notifications and alerts endpoints
|
|
router.include_router(notifications.router, tags=["admin-notifications"])
|
|
|
|
|
|
# ============================================================================
|
|
# Code Quality & Architecture
|
|
# ============================================================================
|
|
|
|
# Include code quality and architecture validation endpoints
|
|
router.include_router(code_quality.router, prefix="/code-quality", tags=["admin-code-quality"])
|
|
|
|
# Export the router
|
|
__all__ = ["router"]
|