佛山法律风险
Go to file
Codex Agent cbefb81a35 feat: 实现数据库维护功能
## 新增功能

### 1. 后端API路由 (lawrisk/api/v2.py)
- 添加了5个新的管理API端点:
  * GET /admin/regions - 获取地区列表
  * GET /admin/themes - 获取主题列表(按地区筛选)
  * GET /admin/permits - 获取许可列表(按地区和主题筛选)
  * GET /admin/permit-details - 获取许可详细信息
  * GET /admin/test - 测试路由

### 2. 前端管理界面 (static/db_admin.html)
- 实现了完整的数据库维护管理页面
- 4步操作流程:地区选择 → 主题列表 → 许可列表 → 详细信息展示
- 现代化UI设计,包括:
  * 渐变背景和响应式布局
  * 平滑动画过渡效果
  * 实时数据加载提示
  * 完整的许可信息展示(许可状态、经营范围、法律风险等)

## 技术实现
- RESTful API设计,返回标准JSON格式
- 直接从PostgreSQL数据库读取数据
- 所有API已通过curl和Flask测试客户端验证

## 测试结果
在端口8888上测试通过:
- admin/regions: 1个地区
- admin/themes: 57个主题
- admin/permits: 6个许可
- admin/permit-details: 完整许可信息和3个风险记录
- 静态页面: 成功加载

## 使用方法
```bash
# 启动服务
PORT=8888 python app.py &

# 访问管理界面
http://localhost:8888/static/db_admin.html

# API调用示例
curl http://localhost:8888/fs-ai-asistant/api/workflow/lawrisk/admin/regions
```

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-30 08:52:48 +08:00
.claude refactor: 重新规划项目结构为标准Python包 2025-10-29 15:31:01 +08:00
data refactor: 重新规划项目结构为标准Python包 2025-10-29 15:31:01 +08:00
docs refactor: 重新规划项目结构为标准Python包 2025-10-29 15:31:01 +08:00
lawrisk feat: 实现数据库维护功能 2025-10-30 08:52:48 +08:00
static feat: 实现数据库维护功能 2025-10-30 08:52:48 +08:00
tests refactor: 重新规划项目结构为标准Python包 2025-10-29 15:31:01 +08:00
.gitignore chore: initial commit 2025-10-22 20:00:32 +08:00
README.md refactor: 重新规划项目结构为标准Python包 2025-10-29 15:31:01 +08:00
app.py refactor: 重新规划项目结构为标准Python包 2025-10-29 15:31:01 +08:00
requirements.txt refactor: 重新规划项目结构为标准Python包 2025-10-29 15:31:01 +08:00

README.md

LawRisk Backend

智能法律风险检索系统 - Flask后端服务

项目简介

LawRisk是一个基于Flask的Python后端服务为政务许可和风险提示提供智能检索功能。使用向量嵌入和LLM匹配技术帮助用户根据自然语言查询找到相关的许可证、执照和法律风险信息。

技术栈

  • 框架: Flask 2.3+
  • 数据库: PostgreSQL (pg8000驱动)
  • AI服务: 阿里云DashScope
    • 嵌入模型: text-embedding-v4
    • 对话模型: qwen-plus-latest
  • 开发工具: Black, Ruff, Pytest

项目结构

市监局-lawRisk-backend/
├── app.py                      # Flask应用入口
├── requirements.txt            # Python依赖
├── .env                        # 环境配置
│
├── lawrisk/                    # 主应用包
│   ├── __init__.py
│   ├── api/                    # API路由层
│   │   ├── v1.py              # V1 API (legacy)
│   │   └── v2.py              # V2 API (current)
│   ├── services/               # 业务逻辑层
│   │   ├── lawrisk_service.py  # 核心检索服务
│   │   ├── lawrisk_v2_service.py  # V2增强服务
│   │   └── licensing_repo.py   # 数据仓库
│   ├── middleware/             # 中间件
│   │   └── smart_cors_middleware.py
│   └── utils/                  # 工具模块
│       ├── env_loader.py
│       ├── export_risk_json.py
│       └── ingest_lawrisk.py
│
├── static/                     # 静态资源
│   └── v2_tester.html         # API测试页面
│
├── tests/                      # 测试套件 (计划中)
│   └── __init__.py
│
├── data/                       # 数据文件
│   ├── risk_tables_export.json
│   └── licensing_risks_dump.sql
│
└── docs/                       # 项目文档
    ├── PRD.md
    ├── API.md
    ├── V2_API文档.md
    ├── AGENTS.md
    ├── DB_GUIDE.md
    └── CLAUDE.md

快速开始

1. 安装依赖

pip install -r requirements.txt

2. 配置环境变量

复制.env文件并配置数据库和API密钥

# 数据库配置
PG_HOST=your_db_host
PG_PORT=5432
PG_USER=postgres
PG_PASSWORD=your_password
PG_DATABASE=fs_law_risk

LIC_PG_HOST=your_db_host
LIC_PG_DATABASE=licensing_risks

# DashScope API
DASHSCOPE_API_KEY=your_api_key
DASHSCOPE_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1

3. 运行应用

python app.py

应用将在 http://localhost:8000 启动

4. 测试API

访问 http://localhost:8000/static/v2_tester.html 进行API测试

或使用curl

curl http://localhost:8000/healthz
curl -X POST "http://localhost:8000/fs-ai-asistant/api/workflow/lawrisk/v2" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "query=我要办一家电影院&debug=1"

API文档

  • V1 API: 查看 docs/API.md
  • V2 API: 查看 docs/V2_API文档.md
  • 数据库指南: 查看 docs/DB_GUIDE.md

开发

代码格式化

black .
ruff .

运行测试 (计划中)

pytest

许可证

内部使用