houhuan 2bc7460f1f feat: 初始化Webhook中继系统项目

- 添加FastAPI应用基础结构，包括主入口、路由和模型定义
- 实现Webhook接收端点(/webhook/{namespace})和健康检查(/health)
- 添加管理后台路由和模板，支持端点、目标、渠道和模板管理
- 包含SQLite数据库模型定义和初始化逻辑
- 添加日志记录和统计服务
- 包含Dockerfile和配置示例文件
- 添加项目文档，包括设计、流程图和验收标准

2025-12-21 18:43:12 +08:00

2.1 KiB

Raw Permalink Blame History

系统修复与全链路优化计划

针对“弹窗失效”的紧急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 条失败记录（方便快速排查）

实施路线图

UI 架构调整：修复 base.html 及所有子页面（解决弹窗问题）。
数据模型迁移：更新 DB，添加 operator 字段。
业务逻辑升级：更新 engine.py 支持新操作符，实现重试逻辑。
界面功能补全：更新前端页面适配新功能。
部署：重置数据库并重启服务。

2.1 KiB Raw Permalink Blame History Unescape Escape