Merge branch 'dev' of https://github.com/xerrors/Yuxi-Know into dev

Author: xerrors

.env.template

@@ -37,3 +37,7 @@ NEO4J_URI=
 NEO4J_USERNAME=
 NEO4J_PASSWORD=
 # endregion neo4j
+
+# Servies
+YUXI_SUPER_ADMIN_NAME=
+YUXI_SUPER_ADMIN_PASSWORD=

AGENTS.md

@@ -5,17 +5,6 @@ Yuxi-Know 是一个基于知识图谱和向量数据库的智能知识库系统
 
 文档中心在 `docs` 文件夹下面。
 
-
-# 核心服务与容器 (Core Services & Containers)
-
-项目使用 Docker Compose 管理多个服务，主要容器名称如下：
-- `api-dev` - FastAPI 后端服务
-- `web-dev` - Vue.js 前端开发服务器
-- `graph` - Neo4j 图数据库
-- `milvus` - 向量数据库，包含 etcd 和 MinIO 依赖
-- `mineru` - 可选的 MinerU OCR 服务（需要 GPU）
-- `paddlex` - 可选的 PaddleX OCR 服务（需要 GPU）
-
 ## 开发与调试工作流 (Development & Debugging Workflow)
 
 本项目完全通过 Docker Compose 进行管理。所有开发和调试都应在运行的容器环境中进行。使用 `docker compose up -d` 命令进行构建和启动。
@@ -32,7 +21,7 @@ Yuxi-Know 是一个基于知识图谱和向量数据库的智能知识库系统
 
 后端开发规范：
 
-- 项目使用 uv 来管理依赖
+- 项目使用 uv 来管理依赖，所以需要使用 uv run 来调试。
 - Python 代码要符合 Python 的规范，尽量使用较新的语法，避免使用旧版本的语法（版本兼容到 3.12+），使用 make lint 检查 lint。使用 make format 来格式化代码。
 
 其他：

Makefile

@@ -1,5 +1,7 @@
 
-.PHONY: start logs
+.PHONY: start stop logs lint format format_diff router-tests
+
+PYTEST_ARGS ?=
 
 start:
 	docker compose up -d
@@ -27,4 +29,7 @@ format:
 	uv run ruff check . --fix
 
 format_diff:
-	uv run ruff format --diff .
+	uv run ruff format --diff .
+
+router-tests:
+	docker compose exec -T api uv run --group test pytest test/api $(PYTEST_ARGS)

docs/changelog/contributing.md

@@ -60,16 +60,29 @@ chore: 构建过程或辅助工具的变动
 
 ### 测试要求
 
-::: info
- 部分测试脚本待补充
+::: tip 测试
+- `make lint` / `make format` 保持代码整洁
+- `cp test/.env.test.example test/.env.test` 配置测试凭据
+- `make router-tests` 运行集成路由测试，支持 `PYTEST_ARGS="-k chat_router"`
+- `uv run --group test pytest test/api` 可直接运行 pytest（容器内）
 :::
 
-- 确保所有测试通过
-- 添加新功能的测试用例
-- 验证现有功能不受影响
-- 测试不同环境下的兼容性
+<details>
+<summary>常用命令</summary>
+
+```bash
+# 全量路由测试
+make router-tests
+
+# 仅运行知识库相关用例
+make router-tests PYTEST_ARGS="-k knowledge_router"
+
+# 不经过 Makefile，直接调用 pytest
+uv run --group test pytest test/api -vv
+```
+
+</details>
 
 ## 许可证
 
 本项目基于 MIT License 开源，贡献的代码将遵循相同的许可证。
-

server/routers/auth_router.py

@@ -7,7 +7,7 @@
 from sqlalchemy.orm import Session
 
 from src.storage.db.manager import db_manager
-from src.storage.db.models import User
+from src.storage.db.models import User, OperationLog
 from server.utils.auth_middleware import get_admin_user, get_current_user, get_db, get_required_user
 from server.utils.auth_utils import AuthUtils
 from server.utils.user_utils import generate_unique_user_id, validate_username, is_valid_phone_number
@@ -503,15 +503,18 @@ async def delete_user(
             detail="不能删除自己的账户",
         )
 
-    # 记录操作
-    log_operation(
-        db, current_user.id, "删除用户", f"删除用户: {user.username}, ID: {user.id}, 角色: {user.role}", request
-    )
+    deletion_detail = f"删除用户: {user.username}, ID: {user.id}, 角色: {user.role}"
+
+    # 清理关联的操作日志，避免外键约束报错
+    db.query(OperationLog).filter(OperationLog.user_id == user.id).delete(synchronize_session=False)
 
     # 删除用户
     db.delete(user)
     db.commit()
 
+    # 记录操作
+    log_operation(db, current_user.id, "删除用户", deletion_detail, request)
+
     return {"success": True, "message": "用户已删除"}
 
 

src/storage/db/models.py

@@ -176,7 +176,7 @@ class User(Base):
     login_locked_until = Column(DateTime, nullable=True)  # 锁定到什么时候
 
     # 关联操作日志
-    operation_logs = relationship("OperationLog", back_populates="user")
+    operation_logs = relationship("OperationLog", back_populates="user", cascade="all, delete-orphan")
 
     def to_dict(self, include_password=False):
         result = {

test/.env.test.example

@@ -5,8 +5,8 @@
 TEST_BASE_URL=http://localhost:5050
 
 # 测试用户凭据
-TEST_USERNAME=zwj
-TEST_PASSWORD=zwj12138
+TEST_USERNAME=
+TEST_PASSWORD=
 
 # 数据库连接（如果需要）
 # DATABASE_URL=sqlite:///test.db