feat(web): scaffold web API module with [web] optional dependency

pyproject.toml

@@ -15,6 +15,7 @@ easy-tdx = "easy_tdx.cli:cli"  # cli/__init__.py exposes the click group
 
 [project.optional-dependencies]
 dev = ["pytest>=8.0", "pytest-asyncio>=0.23", "pytest-cov", "mypy>=1.9", "ruff>=0.4"]
+web = ["fastapi>=0.110", "uvicorn[standard]>=0.29"]
 
 [tool.hatch.build.targets.wheel]
 packages = ["src/easy_tdx"]
@@ -31,6 +32,10 @@ ignore_missing_imports = true
 module = "easy_tdx.MyTT"
 # Type stubs provided via MyTT.pyi — keep strict checks enabled
 
+[[tool.mypy.overrides]]
+module = ["fastapi.*", "uvicorn.*", "pydantic.*"]
+ignore_missing_imports = true
+
 [tool.ruff]
 target-version = "py310"
 line-length = 100

src/easy_tdx/web/__init__.py

@@ -0,0 +1,50 @@
+"""easy-tdx Web API — FastAPI REST + WebSocket layer.
+
+Install with: pip install easy-tdx[web]
+
+Usage::
+
+    from easy_tdx.web import create_app
+
+    app = create_app()
+
+    # Run with uvicorn:
+    # uvicorn easy_tdx.web:app --host 0.0.0.0 --port 8000
+"""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from fastapi import FastAPI
+
+
+def create_app(
+    host: str | None = None,
+    port: int | None = None,
+    timeout: float | None = None,
+) -> FastAPI:
+    """Create and configure the FastAPI application.
+
+    Args:
+        host: TDX server host (None = auto-detect best host).
+        port: TDX server port (None = default 7709).
+        timeout: Connection timeout in seconds.
+
+    Returns:
+        Configured FastAPI application instance.
+    """
+    from easy_tdx.web.app import _create_app
+
+    return _create_app(host=host, port=port, timeout=timeout)
+
+
+def app_factory() -> FastAPI:
+    """Factory function for uvicorn --reload mode."""
+    from easy_tdx.web.app import _create_app
+
+    return _create_app()
+
+
+__all__ = ["create_app", "app_factory"]

src/easy_tdx/web/routers/__init__.py

@@ -0,0 +1 @@
+"""API route modules."""