fs-lawrisk/README.md

44 lines
2.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 市监局法律风险提示系统 (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 市监局项目开发组