docs(README): 更新项目说明文档，完善架构与启动指南

- 调整 CLAUDE.md 内容，增加使用指导和架构概览
- 补充微服务启动说明及单服务启动命令
- 明确 Gateway 服务器四阶段启动流程和职责划分
- 细化后端目录结构说明，补充主要文件职责描述
- 新增系统分层结构图，优化整体架构理解
- 更新 .gitignore，添加 runs 目录忽略规则
- 同步 .omc 相关状态文件，更新项目状态跟踪信息

backend/apps/__init__.py

@@ -9,6 +9,7 @@ from .runtime_service import app as runtime_app
 from .runtime_service import create_app as create_runtime_app
 from .trading_service import app as trading_app
 from .trading_service import create_app as create_trading_app
+from .cors import add_cors_middleware, get_cors_origins
 
 app = agent_app
 create_app = create_agent_app
@@ -24,4 +25,6 @@ __all__ = [
     "create_runtime_app",
     "trading_app",
     "create_trading_app",
+    "add_cors_middleware",
+    "get_cors_origins",
 ]

backend/apps/agent_service.py

@@ -8,7 +8,8 @@ from pathlib import Path
 from typing import AsyncGenerator
 
 from fastapi import FastAPI
-from fastapi.middleware.cors import CORSMiddleware
+
+from backend.apps.cors import add_cors_middleware
 
 from backend.api import agents_router, guard_router, workspaces_router
 from backend.agents import AgentFactory, WorkspaceManager, get_registry
@@ -47,13 +48,7 @@ def create_app(project_root: Path | None = None) -> FastAPI:
         lifespan=lifespan,
     )
 
-    app.add_middleware(
-        CORSMiddleware,
-        allow_origins=["*"],
-        allow_credentials=True,
-        allow_methods=["*"],
-        allow_headers=["*"],
-    )
+    add_cors_middleware(app)
 
     @app.get("/health")
     async def health_check() -> dict[str, object]:

backend/apps/runtime_service.py

@@ -4,10 +4,10 @@
 from __future__ import annotations
 
 from fastapi import FastAPI
-from fastapi.middleware.cors import CORSMiddleware
 
 from backend.api import runtime_router
 from backend.api.runtime import get_runtime_state
+from backend.apps.cors import add_cors_middleware
 
 
 def create_app() -> FastAPI:
@@ -18,13 +18,7 @@ def create_app() -> FastAPI:
         version="0.1.0",
     )
 
-    app.add_middleware(
-        CORSMiddleware,
-        allow_origins=["*"],
-        allow_credentials=True,
-        allow_methods=["*"],
-        allow_headers=["*"],
-    )
+    add_cors_middleware(app)
 
     @app.get("/health")
     async def health_check() -> dict[str, object]:

backend/apps/trading_service.py

@@ -6,7 +6,7 @@ from __future__ import annotations
 from typing import Any
 
 from fastapi import FastAPI, Query
-from fastapi.middleware.cors import CORSMiddleware
+from backend.apps.cors import add_cors_middleware
 
 from backend.domains import trading as trading_domain
 from shared.schema import (
@@ -26,13 +26,7 @@ def create_app() -> FastAPI:
         version="0.1.0",
     )
 
-    app.add_middleware(
-        CORSMiddleware,
-        allow_origins=["*"],
-        allow_credentials=True,
-        allow_methods=["*"],
-        allow_headers=["*"],
-    )
+    add_cors_middleware(app)
 
     @app.get("/health")
     async def health_check() -> dict[str, str]: