restructure of dirs, huge docs update

app/web/api/alerts.py

@@ -0,0 +1,144 @@
+"""
+Alerts API blueprint.
+
+Handles endpoints for viewing alert history and managing alert rules.
+"""
+
+from flask import Blueprint, jsonify, request
+
+from web.auth.decorators import api_auth_required
+
+bp = Blueprint('alerts', __name__)
+
+
+@bp.route('', methods=['GET'])
+@api_auth_required
+def list_alerts():
+    """
+    List recent alerts.
+
+    Query params:
+        page: Page number (default: 1)
+        per_page: Items per page (default: 20)
+        alert_type: Filter by alert type
+        severity: Filter by severity (info, warning, critical)
+        start_date: Filter alerts after this date
+        end_date: Filter alerts before this date
+
+    Returns:
+        JSON response with alerts list
+    """
+    # TODO: Implement in Phase 4
+    return jsonify({
+        'alerts': [],
+        'total': 0,
+        'page': 1,
+        'per_page': 20,
+        'message': 'Alerts list endpoint - to be implemented in Phase 4'
+    })
+
+
+@bp.route('/rules', methods=['GET'])
+@api_auth_required
+def list_alert_rules():
+    """
+    List all alert rules.
+
+    Returns:
+        JSON response with alert rules
+    """
+    # TODO: Implement in Phase 4
+    return jsonify({
+        'rules': [],
+        'message': 'Alert rules list endpoint - to be implemented in Phase 4'
+    })
+
+
+@bp.route('/rules', methods=['POST'])
+@api_auth_required
+def create_alert_rule():
+    """
+    Create a new alert rule.
+
+    Request body:
+        rule_type: Type of alert rule
+        threshold: Threshold value (e.g., days for cert expiry)
+        enabled: Whether rule is active (default: true)
+        email_enabled: Send email for this rule (default: false)
+
+    Returns:
+        JSON response with created rule ID
+    """
+    # TODO: Implement in Phase 4
+    data = request.get_json() or {}
+
+    return jsonify({
+        'rule_id': None,
+        'status': 'not_implemented',
+        'message': 'Alert rule creation endpoint - to be implemented in Phase 4',
+        'data': data
+    }), 501
+
+
+@bp.route('/rules/<int:rule_id>', methods=['PUT'])
+@api_auth_required
+def update_alert_rule(rule_id):
+    """
+    Update an existing alert rule.
+
+    Args:
+        rule_id: Alert rule ID to update
+
+    Request body:
+        threshold: Threshold value (optional)
+        enabled: Whether rule is active (optional)
+        email_enabled: Send email for this rule (optional)
+
+    Returns:
+        JSON response with update status
+    """
+    # TODO: Implement in Phase 4
+    data = request.get_json() or {}
+
+    return jsonify({
+        'rule_id': rule_id,
+        'status': 'not_implemented',
+        'message': 'Alert rule update endpoint - to be implemented in Phase 4',
+        'data': data
+    }), 501
+
+
+@bp.route('/rules/<int:rule_id>', methods=['DELETE'])
+@api_auth_required
+def delete_alert_rule(rule_id):
+    """
+    Delete an alert rule.
+
+    Args:
+        rule_id: Alert rule ID to delete
+
+    Returns:
+        JSON response with deletion status
+    """
+    # TODO: Implement in Phase 4
+    return jsonify({
+        'rule_id': rule_id,
+        'status': 'not_implemented',
+        'message': 'Alert rule deletion endpoint - to be implemented in Phase 4'
+    }), 501
+
+
+# Health check endpoint
+@bp.route('/health', methods=['GET'])
+def health_check():
+    """
+    Health check endpoint for monitoring.
+
+    Returns:
+        JSON response with API health status
+    """
+    return jsonify({
+        'status': 'healthy',
+        'api': 'alerts',
+        'version': '1.0.0-phase1'
+    })