houhuan
2bc7460f1f
- 添加FastAPI应用基础结构，包括主入口、路由和模型定义
- 实现Webhook接收端点(/webhook/{namespace})和健康检查(/health)
- 添加管理后台路由和模板，支持端点、目标、渠道和模板管理
- 包含SQLite数据库模型定义和初始化逻辑
- 添加日志记录和统计服务
- 包含Dockerfile和配置示例文件
- 添加项目文档，包括设计、流程图和验收标准
43 lines
2.1 KiB
Markdown
43 lines
2.1 KiB
Markdown
# 系统修复与全链路优化计划
|
||
|
||
针对“弹窗失效”的紧急Bug和您对系统的长远期望，我制定了以下全方位的优化方案：
|
||
|
||
## 1. 紧急修复：UI 交互失效 (Priority 0)
|
||
**问题根源**：页面脚本（Script）在 Bootstrap 库加载之前执行了，导致 `bootstrap` 对象未定义。
|
||
**修复方案**：
|
||
* 调整 `base.html` 结构，在底部引入 Bootstrap JS 之后新增 `{% block scripts %}` 插槽。
|
||
* 将所有管理页面的 JS 代码移动到 `block scripts` 中，确保执行顺序正确。
|
||
|
||
## 2. 核心增强：规则引擎升级 (Priority 1)
|
||
目前的规则仅支持“等于”，无法满足复杂业务（如匹配特定前缀的订单号）。
|
||
**优化方案**：
|
||
* **数据库变更**：`ProcessingRule` 表新增 `operator` 字段（默认为 `eq`）。
|
||
* **支持操作符**：
|
||
* `eq` (等于)
|
||
* `neq` (不等于)
|
||
* `contains` (包含)
|
||
* `startswith` (以...开头)
|
||
* `regex` (正则表达式)
|
||
* **UI 适配**：在端点详情页的添加规则弹窗中，增加“操作符”下拉选择。
|
||
|
||
## 3. 运维增强：日志重试 (Replay) (Priority 2)
|
||
Webhook 系统最常见的问题是下游服务暂时不可用，导致消息丢失。
|
||
**优化方案**：
|
||
* **后端**：新增 `/admin/logs/{id}/replay` 接口，读取历史日志的 `raw_body` 重新注入规则引擎。
|
||
* **前端**：在“系统日志”列表的失败记录旁，添加“重试”按钮。
|
||
|
||
## 4. 体验优化：首页仪表盘 (Priority 3)
|
||
目前的首页直接跳转到列表，缺乏全局视野。
|
||
**优化方案**：
|
||
* 重写 `/admin/` 首页，展示：
|
||
* 今日请求总量 / 成功率
|
||
* 各端点 (Endpoint) 的流量占比
|
||
* 最近 10 条失败记录（方便快速排查）
|
||
|
||
## 实施路线图
|
||
1. **UI 架构调整**：修复 `base.html` 及所有子页面（解决弹窗问题）。
|
||
2. **数据模型迁移**：更新 DB，添加 `operator` 字段。
|
||
3. **业务逻辑升级**：更新 `engine.py` 支持新操作符，实现重试逻辑。
|
||
4. **界面功能补全**：更新前端页面适配新功能。
|
||
5. **部署**：重置数据库并重启服务。
|