compliance/README.md

DMS合规性测试工具

一个用于API合规性测试的Docker化工具，支持OpenAPI规范验证、PDF报告生成和测试历史管理。

🚀 快速开始

使用Docker（推荐）

# 1. 构建并启动服务
./docker-build.sh

# 2. 访问服务
# API服务器: http://localhost:5050
# 历史查看器: http://localhost:5051

本地运行

# 1. 安装依赖
pip install -r requirements.txt

# 2. 启动API服务器
python api_server.py

# 3. 启动历史查看器（另一个终端）
python history_viewer.py

📋 主要功能

• API合规性测试：基于OpenAPI规范的自动化测试
• PDF报告生成：生成详细的测试分析报告
• 测试历史管理：查看和管理历史测试记录
• 严格等级控制：根据严格等级分离必须和非必须测试用例
• 多服务架构：API服务和历史查看器独立运行

🔧 使用方法

命令行测试

python run_api_tests.py \
  --base-url http://your-api-server \
  --openapi-file api-spec.yaml \
  --strictness-level HIGH \
  --generate-pdf

Web界面测试

1. 访问 http://localhost:5050
2. 上传OpenAPI规范文件
3. 配置测试参数
4. 执行测试并下载报告

查看测试历史

访问 http://localhost:5051 查看历史测试记录和报告

📁 项目结构

compliance/
├── api_server.py           # API服务器
├── history_viewer.py       # 历史查看器
├── run_api_tests.py        # 命令行测试工具
├── docker-build.sh         # Docker构建脚本
├── docker-compose.yml      # Docker Compose配置
├── requirements.txt        # Python依赖
├── docker/                 # Docker相关文件
├── tests/                  # 测试脚本
├── docs/                   # 详细文档
├── nginx/                  # Nginx配置（可选）
├── test_reports/           # 测试报告目录
└── memory-bank/           # 项目文档和上下文

🐳 Docker部署

# 快速部署
./docker-build.sh

# 或使用Docker Compose
docker-compose up -d

🧪 测试

# 测试Docker部署
./tests/test-docker.sh

# 测试多服务功能
python tests/test_multi_service.py

📖 详细文档

查看 docs/ 目录获取详细的部署和使用指南。

🛠️ 故障排除

# 查看容器状态
docker ps

# 查看日志
docker logs dms-compliance-tool

🤝 开发

cursor-memory-bank在memory-bank目录下，对话前先传给cursor或其他AI。