Scaffold Engine application interfaces

Data/Engine/interfaces/http/__init__.py

@@ -4,6 +4,16 @@ from __future__ import annotations
 
 from flask import Flask
 
+from . import admin, agents, enrollment, health, tokens
+
+_REGISTRARS = (
+    health.register,
+    agents.register,
+    enrollment.register,
+    tokens.register,
+    admin.register,
+)
+
 
 def register_http_interfaces(app: Flask) -> None:
     """Attach HTTP blueprints to *app*.
@@ -11,8 +21,8 @@ def register_http_interfaces(app: Flask) -> None:
     The implementation is intentionally minimal for the initial scaffolding.
     """
 
-    # Future phases will import and register blueprints here.
-    return None
+    for registrar in _REGISTRARS:
+        registrar(app)
 
 
 __all__ = ["register_http_interfaces"]

Data/Engine/interfaces/http/admin.py

@@ -0,0 +1,21 @@
+"""Administrative HTTP interface placeholders for the Engine."""
+
+from __future__ import annotations
+
+from flask import Blueprint, Flask
+
+
+blueprint = Blueprint("engine_admin", __name__, url_prefix="/api/admin")
+
+
+def register(app: Flask) -> None:
+    """Attach administrative routes to *app*.
+
+    Concrete endpoints will be migrated in subsequent phases.
+    """
+
+    if "engine_admin" not in app.blueprints:
+        app.register_blueprint(blueprint)
+
+
+__all__ = ["register", "blueprint"]

Data/Engine/interfaces/http/agents.py

@@ -0,0 +1,21 @@
+"""Agent HTTP interface placeholders for the Engine."""
+
+from __future__ import annotations
+
+from flask import Blueprint, Flask
+
+
+blueprint = Blueprint("engine_agents", __name__, url_prefix="/api/agents")
+
+
+def register(app: Flask) -> None:
+    """Attach agent management routes to *app*.
+
+    Implementation will be populated as services migrate from the legacy server.
+    """
+
+    if "engine_agents" not in app.blueprints:
+        app.register_blueprint(blueprint)
+
+
+__all__ = ["register", "blueprint"]

Data/Engine/interfaces/http/enrollment.py

@@ -0,0 +1,21 @@
+"""Enrollment HTTP interface placeholders for the Engine."""
+
+from __future__ import annotations
+
+from flask import Blueprint, Flask
+
+
+blueprint = Blueprint("engine_enrollment", __name__, url_prefix="/api/enrollment")
+
+
+def register(app: Flask) -> None:
+    """Attach enrollment routes to *app*.
+
+    Implementation will be ported during later migration phases.
+    """
+
+    if "engine_enrollment" not in app.blueprints:
+        app.register_blueprint(blueprint)
+
+
+__all__ = ["register", "blueprint"]

Data/Engine/interfaces/http/health.py

@@ -0,0 +1,21 @@
+"""Health check HTTP interface placeholders for the Engine."""
+
+from __future__ import annotations
+
+from flask import Blueprint, Flask
+
+
+blueprint = Blueprint("engine_health", __name__)
+
+
+def register(app: Flask) -> None:
+    """Attach health-related routes to *app*.
+
+    Routes will be populated in later migration phases.
+    """
+
+    if "engine_health" not in app.blueprints:
+        app.register_blueprint(blueprint)
+
+
+__all__ = ["register", "blueprint"]

Data/Engine/interfaces/http/tokens.py

@@ -0,0 +1,21 @@
+"""Token management HTTP interface placeholders for the Engine."""
+
+from __future__ import annotations
+
+from flask import Blueprint, Flask
+
+
+blueprint = Blueprint("engine_tokens", __name__, url_prefix="/api/tokens")
+
+
+def register(app: Flask) -> None:
+    """Attach token management routes to *app*.
+
+    Implementation will be introduced as authentication services are migrated.
+    """
+
+    if "engine_tokens" not in app.blueprints:
+        app.register_blueprint(blueprint)
+
+
+__all__ = ["register", "blueprint"]