Files
ccdi/doc
wkc e0ce344d09 feat: 完成中介黑名单管理模块测试脚本、API文档、菜单配置和测试报告模板
## 新增文件

### 测试脚本 (Task 11)
- doc/scripts/test-intermediary-api.sh: 完整的API自动化测试脚本
  * 获取Token
  * 测试查询列表(含条件查询)
  * 测试新增个人/实体中介
  * 测试查询详情
  * 测试修改操作
  * 测试唯一性校验
  * 支持彩色输出和错误处理

- doc/scripts/cleanup-intermediary-test-data.sh: 测试数据清理脚本
  * 查询测试数据
  * 删除测试数据
  * 验证删除结果

- doc/scripts/run-test.bat: Windows测试脚本启动器
- doc/scripts/run-cleanup.bat: Windows清理脚本启动器

### API文档 (Task 12)
- doc/api/中介黑名单管理API文档-v2.0.md: 完整的v2.0 API接口文档
  * 14个API接口详细说明
  * 请求参数、响应格式、错误码
  * 字典数据说明
  * 业务错误信息
  * v2.0主要变更说明

### 菜单配置 (Task 13)
- sql/menu-intermediary.sql: 菜单和权限配置SQL
  * 主菜单: 中介黑名单(目录)
  * 子菜单: 中介管理(页面)
  * 按钮权限: 查询、列表、新增、修改、删除、导出、导入
  * 包含详细的注释和使用说明

### 测试报告模板 (Task 14)
- doc/test/intermediary-blacklist-test-report.md: 测试报告模板
  * 44个测试用例(列表查询、个人/实体中介、唯一性校验、删除、导入导出、权限)
  * 测试结果统计表格
  * 缺陷统计表格
  * 测试结论模板
  * 签名确认

### 文档 (Task 10)
- doc/README-中介黑名单测试部署.md: 测试与部署指南
  * 快速开始指南
  * API接口列表
  * 菜单权限说明
  * 数据字典说明
  * 常见问题解答
  * 版本历史

## 功能特性

1. **自动化测试**
   - 支持Linux/Windows环境
   - 完整的API覆盖
   - 彩色输出,易于阅读
   - 错误处理和提示

2. **完整的文档**
   - 详细的API文档
   - 清晰的测试报告模板
   - 便于复现的测试用例

3. **菜单配置**
   - 一键SQL执行
   - 完整的权限体系
   - 支持角色分配

4. **测试支持**
   - 测试数据清理
   - 测试结果验证
   - 批处理支持

## 技术亮点

- 使用jq进行JSON解析
- 支持Token自动获取
- 完整的错误处理
- 跨平台支持(Linux/Windows)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-04 19:37:17 +08:00
..
2026-02-04 19:16:34 +08:00
2026-02-04 19:16:34 +08:00
2026-01-30 15:50:30 +08:00
2026-01-30 14:15:21 +08:00
2026-01-30 14:15:21 +08:00
2026-02-04 19:16:34 +08:00
2026-02-04 18:36:20 +08:00
2026-01-29 22:03:42 +08:00
2026-01-29 22:03:42 +08:00
2026-01-30 15:50:30 +08:00
2026-01-30 15:50:30 +08:00

文档目录结构

本目录包含纪检初核系统的各类文档、测试数据和脚本。

目录说明

📁 docs/

项目文档目录

  • 纪检初核系统功能说明书-V1.0.docx/md - 系统功能说明书
  • 纪检初核系统模块划分方案.md - 模块划分方案
  • 若依环境使用手册.docx - 若依框架使用手册
  • 中介黑名单弹窗优化设计.md - UI设计文档
  • EasyExcel字典下拉框使用说明.md - Excel导入使用说明

📁 api/

API接口文档目录

  • 员工信息管理API文档.md - 员工信息管理模块API
  • 中介黑名单管理API文档.md - 中介黑名单管理模块API

📁 scripts/

测试脚本目录

  • test_import.py - 导入功能测试脚本
  • test_import_simple.py - 简单导入测试脚本
  • test_uniqueness_validation.py - 唯一性校验测试脚本
  • generate_test_data.py - 测试数据生成脚本

📁 test-data/

测试数据目录

  • 个人中介黑名单模板_1769667622015.xlsx - 导入模板
  • 个人中介黑名单测试数据_1000条.xlsx - 测试数据第1批
  • 个人中介黑名单测试数据_1000条_第2批.xlsx - 测试数据第2批
  • 中介人员信息表.csv - 中介人员数据
  • 中介主体信息表.csv - 中介主体数据

📁 other/

其他文件目录

  • 纪检初核系统-离线演示包/ - 离线演示包(解压版)
  • 纪检初核系统-离线演示包.zip - 离线演示包(压缩版)
  • ScreenShot_*.png - 截图文件

📁 modules/

模块设计文档目录

  • 01-项目管理模块/ - 项目管理模块文档
  • 02-项目工作台/ - 项目工作台模块文档
  • 03-信息维护模块.md - 信息维护模块文档
  • 04-参数配置模块.md - 参数配置模块文档
  • 05-系统管理模块.md - 系统管理模块文档

使用说明

生成测试数据

cd doc/scripts
python generate_test_data.py

运行测试脚本

cd doc/scripts
python test_uniqueness_validation.py

导入测试数据

  1. test-data/ 目录下载对应的Excel文件
  2. 在系统页面点击"导入"按钮
  3. 选择文件并上传