fix: 修复测试文件 lint 错误

- 移除 test_history.py 未使用的导入
- 修复 test_schema.py 变量名歧义 (l -> layout)
- 更新 CLAUDE.md commit 规范

Author: MKY508

CLAUDE.md

@@ -13,6 +13,7 @@ QueryGPT v2 是自然语言数据库查询助手，采用前后端分离架构
 ./start.sh          # 同时启动前后端
 ./start.sh stop     # 停止服务
 ./start.sh restart  # 重启
+./start.sh status   # 查看状态
 ```
 
 ### 后端 (apps/api)
@@ -25,9 +26,14 @@ uvicorn app.main:app --reload --port 8000
 alembic upgrade head
 alembic revision --autogenerate -m "description"
 
-# 代码检查
+# 代码检查和格式化
 ruff check .
+ruff check --fix .  # 自动修复
 ruff format .
+
+# 测试
+pytest tests/ -v --tb=short
+pytest tests/test_auth.py -v  # 单个测试文件
 ```
 
 ### 前端 (apps/web)
@@ -37,6 +43,11 @@ npm run dev         # 开发服务器 :3000
 npm run build       # 构建
 npm run lint        # ESLint
 npm run type-check  # TypeScript 检查
+
+# 测试
+npm run test              # 运行测试
+npm run test:watch        # 监听模式
+npm run test:coverage     # 覆盖率报告
 ```
 
 ## Architecture
@@ -45,28 +56,37 @@ npm run type-check  # TypeScript 检查
 - `api/v1/` - API 路由
   - `auth.py` - 注册/登录/刷新 token
   - `chat.py` - SSE 流式对话接口
-  - `config.py` - 模型/数据库连接 CRUD
+  - `connections.py` - 数据库连接 CRUD
+  - `models.py` - AI 模型配置 CRUD
+  - `schema.py` - 表关系管理 + 布局 API
+  - `semantic.py` - 语义层术语 CRUD
+  - `export_import.py` - 配置导出/导入
   - `history.py` - 对话历史
+  - `user_config.py` - 用户偏好设置
 - `core/` - 核心模块
   - `config.py` - Pydantic Settings 配置
   - `security.py` - JWT + Fernet 加密
   - `demo_db.py` - SQLite 示例数据库初始化
-- `db/tables.py` - SQLAlchemy 2.0 模型 (User, Model, Connection, Conversation, Message)
+- `db/`
+  - `tables.py` - SQLAlchemy 2.0 模型 (User, Model, Connection, Conversation, Message, TableRelationship, SemanticTerm)
+  - `metadata.py` - SQLite 元数据库 (布局存储，独立于主数据库)
 - `services/`
   - `execution.py` - 执行服务入口
   - `gptme_engine.py` - gptme AI 引擎封装，获取表结构后执行查询
 
 ### 前端 Next.js (apps/web/src/)
 - `app/` - App Router 页面
   - `page.tsx` - 主页（登录/对话）
-  - `settings/page.tsx` - 设置页
+  - `settings/page.tsx` - 设置页（模型、连接、表关系、语义层、偏好、关于）
 - `components/`
   - `chat/` - ChatArea, Sidebar, DataTable, ChartDisplay, SqlHighlight
-  - `settings/` - ModelSettings, ConnectionSettings, PreferencesSettings
+  - `settings/` - ModelSettings, ConnectionSettings, SchemaSettings, SemanticSettings
+  - `schema/` - TableNode (React Flow 节点)
 - `lib/`
   - `api/client.ts` - Axios 实例 + SSE 流处理
   - `stores/auth.ts` - Zustand 认证状态
   - `stores/chat.ts` - Zustand 对话状态
+  - `types/` - TypeScript 类型定义
 
 ### 数据流
 1. 用户输入 → `ChatArea` → `POST /api/v1/chat/stream` (SSE)
@@ -95,3 +115,28 @@ OPENAI_API_KEY=...
 ```
 NEXT_PUBLIC_API_URL=http://localhost:8000
 ```
+
+## Git Commit 规范
+
+**重要**: 提交时不要添加任何 AI 生成标记或署名！
+
+```bash
+# 正确的 commit 格式
+git commit -m "feat: 添加新功能"
+git commit -m "fix: 修复某个问题"
+git commit -m "docs: 更新文档"
+
+# 禁止添加以下内容:
+# - 🤖 Generated with [Claude Code]
+# - Co-Authored-By: Claude
+# - 任何 AI 相关的标记或署名
+```
+
+commit 类型:
+- `feat`: 新功能
+- `fix`: 修复 bug
+- `docs`: 文档更新
+- `style`: 代码格式
+- `refactor`: 重构
+- `test`: 测试
+- `chore`: 构建/工具

apps/api/.gitignore

@@ -0,0 +1 @@
+.coverage

apps/api/tests/test_history.py

@@ -2,9 +2,6 @@
 
 import pytest
 from httpx import AsyncClient
-from sqlalchemy.ext.asyncio import AsyncSession
-
-from app.db.tables import Conversation, Message
 
 
 async def get_auth_token(client: AsyncClient) -> str:

apps/api/tests/test_schema.py

@@ -330,7 +330,7 @@ async def test_delete_layout(client: AsyncClient):
         headers={"Authorization": f"Bearer {token}"},
     )
     layouts = list_response.json()["data"]
-    assert not any(l["id"] == layout_id for l in layouts)
+    assert not any(layout["id"] == layout_id for layout in layouts)
 
 
 @pytest.mark.asyncio