# 市监局法律风险提示系统 (LawRisk Backend)

智能法律风险检索与管理系统后端服务，基于 Flask 开发，提供行政许可事项的风险提示检索、数据管理及自动化备份功能。

## 🌟 核心功能

- **智能检索 (V2 API)**: 支持自然语言查询，结合向量嵌入和 LLM 技术，精准匹配许可事项与风险点。
- **行政许可管理**: 提供完善的 Excel 导入机制，支持“以新盖旧”模式，并在覆盖前自动创建风险点数据快照。
- **自动化备份 (Checkpoint)**: 内置数据库检查点系统，定期或手动记录数据库全量状态，支持一键恢复。
- **权限管理**: 灵活的角色与层级控制，支持市级、区级及具体单位的细粒度数据隔离。
- **组织架构**: 动态组织架构管理，支持拖拽调整层级关系。

## 🚀 快速开始

### 1. 环境准备
```bash
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -r requirements.txt
```

### 2. 配置环境变量
修改 `.env` 文件，配置数据库连接、DashScope API 密钥等。详细说明请参考 [配置指南](docs/guides/README.md#2-配置环境变量)。

### 3. 运行服务
```bash
python app.py
```

## 📖 详细文档

- **[项目架构与指南](docs/guides/README.md)**: 了解技术栈、项目结构及开发流程。
- **[API 文档 (V2)](docs/V2_API文档.md)**: 详细的 API 接口说明与示例。
- **[文档索引](docs/README.md)**: 包含所有功能开发、测试报告及维护文档的详细列表。

## 🛠️ 最近更新

- **Checkpoint 系统增强**: 修复了二进制数据（Excel 原始文件）备份时的 JSON 序列化问题，增强了备份稳定性。
- **导入机制确认**: 支持许可事项的智能覆盖模式，系统在覆盖前会自动执行风险点快照备份。
- **数据清理**: 优化了检查点清理逻辑，支持手动触发全量备份并清空冗余历史记录。

---
© 2025 市监局项目开发组