flowchart LR A1["责任人
填写页表单"] --> API["自有服务 API"] A2["填报表内的附件"] --> API A3["财务审核台
录入实际降本"] --> API A4["页面右下角
反馈面板"] --> API A5["填报模版.xlsx
线下填写"] -.->|"逐条录入"| A1 API --> T1[("ideas 表
降本措施")] API --> T2[("fb 表
页面反馈")] API --> F1["uploads/ 目录
附件文件"] T1 --> P1["汇总看板 /summary"] T1 --> P2["项目总览 /overview"] T2 --> P3["反馈处理台"] F1 --> P4["/files/文件名
下载与预览"] T2 --> P5["我的反馈
反馈人可见"]
| ideas 表(降本措施,24 列) | |
|---|---|
| id / created_at / updated_at | 序号、提交时间、最后修改时间 |
| uid / ip | 提交人身份标识:浏览器 uid + 服务端采集 IP |
| proposer / dept / area | 提案人、提案部门、实施领域 |
| plan / status | 具体方案、现状描述 |
| cost_now / cost_goal / pct | 现状年成本、优化目标、优化幅度(自动) |
| impl_time / impl_dept | 实施时间、实施部门 |
| owner / owner_contact | 责任人姓名、责任人联系方式(两栏分填) |
| method / remark / files | 计算方法、备注、附件清单(JSON) |
| actual | 实际降本(万元),财务在审核台录入 |
| review / review_note / reviewed_at | 审核结果、审核意见、审核时间 |
| fb 表(页面反馈,14 列) | |
|---|---|
| id / page / created_at | 序号、反馈所在页面、提交时间 |
| uid / token | 反馈人标识(免登录站点用 uid) |
| content | 反馈正文(可含 @元素N 页面元素引用) |
| refs / files | 引用的元素路径(JSON)、截图附件(JSON) |
| reply / replied_at | 处理说明与回复时间 |
| status / done_at | 处理状态(开发中/已上线)与完成时间 |
| followups | 追评与追加回复流水(JSON,含时间与身份) |
uploads/,库内只存文件名与 URL;单文件 ≤20MB、单条 ≤10 个。
数据库单文件 cost.db,随服务器每日备份。
| 指标 | 公式 | 取数范围 | 说明 |
|---|---|---|---|
| 优化幅度 pct | 优化目标 ÷ 现状年成本 × 100 | 单条 | 提交时算定;现状年成本为 0 时计 0,不报错 |
| 目标降幅 drop | 现状年成本 − 优化目标 | 部门汇总 | 单位万元,部门/总计两级 |
| 实际降幅 actual_pct | 实际降本 ÷ 现状年成本 × 100 | 部门汇总 | 财务录入实际降本后自动生效 |
| 优化完成率 done_rate | 实际降本 ÷ 优化目标 × 100 | 部门汇总 | 排名依据降序,同率按目标额、措施数 |
| 小数处理 | 保留 1 位,四舍五入 | 全部百分比 | 服务端与前端同口径,避免同页两个数字打架 |
| 看板口径 | 含义 | 金额类是否计入 | 典型用途 |
|---|---|---|---|
| 已通过pass | 仅财务审核通过的提案 | 计入 | 默认口径,绩效考核 |
| 含待审核nr | 未驳回的提案(含待审核) | 计入 | 过程管控与预期测算 |
| 全部all | 全部提案(含已驳回) | 仅已通过计入金额 | 项目总览进度核对 |
flowchart TD S["责任人填写
提案人/部门/具体方案 必填"] --> V{"必填校验"} V -->|"缺项"| S V -->|"通过"| ST1["写入 ideas
状态:待审核"] ST1 --> OWN{"是否本人操作"} OWN -->|"是"| EDIT["可修改 / 可删除
改后仍为待审核"] EDIT --> ST1 OWN -->|"否"| DENY["拒绝:只能管理自己提交的提案"] ST1 --> RV{"财务审核台
管理钥匙鉴权"} RV -->|"驳回+意见"| ST2["状态:已驳回
可改可删,修改后回到待审核"] ST2 --> ST1 RV -->|"通过"| ST3["状态:已通过
锁定:不可改不可删"] ST3 --> ACT["财务录入实际降本(万元)"] ACT --> AGG["部门聚合
实际降幅 / 优化完成率 / 排名"] AGG --> OUT["汇总看板展示 · 导出 CSV · 年度考核"]
| 状态 | 填报人可做 | 财务可做 | 是否计入看板金额 |
|---|---|---|---|
| 待审核 | 修改、删除 | 通过、驳回 | 否 |
| 已驳回 | 修改(回待审核)、删除 | 通过、驳回 | 否 |
| 已通过 | 不可改不可删 | 录入实际降本 | 是 |
| 审计点 | 实现方式 | 效果 |
|---|---|---|
| 身份识别 | 浏览器 uid(本地生成不可逆标识)优先;无 uid 的老数据以服务端采集 IP 兜底 | 同一浏览器恒定身份,换浏览器可由 IP 兜底找回 |
| 身份不可伪造 | IP 一律取服务端 X-Real-IP / remote_addr,不接受前端传值 |
防伪造 IP 越权改他人数据 |
| 改删权限 | 记录有 uid 时只认 uid,无 uid 时退 IP 判定 | 只能管理自己提交的提案 |
| 审核锁定 | 已通过 → 改/删一律拒绝;驳回 → 放开并自动清除旧审核结论 | 通过后不可篡改,驳回可修后重走流程 |
| 管理端鉴权 | 管理钥匙 ADMIN_KEY,审核、实际降本、反馈列表、回复、状态均校验 | 无钥匙调用一律 401,管理动作不落匿名 |
| 附件限制 | 单文件 ≤20MB、单条 ≤10 个、请求体 ≤25MB,文件名安全化后落盘 | 防超大文件与路径穿越写入 |
| 源码与库保护 | 网关对 .py / .db / .db-wal / .db-shm / .log 一律 404 |
数据库与后端源码不可经 Web 下载 |
| 服务暴露面 | 应用只监听 127.0.0.1:8301,外部仅能经网关反代进入 |
不经网关无法直连应用端口 |
| 操作留痕 | 每条记录带 created_at / updated_at / reviewed_at;反馈带回复与追评流水时间 | 可回溯提交、修改、审核时点 |
sequenceDiagram
autonumber
participant U as 反馈人
participant J as 反馈组件
participant V as 自有服务
participant M as 管理者
U->>J: 描述问题(可引用页面元素、粘截图)
J->>V: POST /api/feedback
V->>V: 写入 fb 表(内容/引用/附件/页面/时间)
J->>V: GET /api/feedback/mine 我的反馈
V->>J: 返回处理说明与处理状态
M->>V: POST /api/feedback/reply 回复
M->>V: POST /api/feedback/status 标开发中/已上线
V->>U: 反馈人端可见回复与进度
U->>V: POST /api/feedback/followup 追评
M->>V: POST /api/feedback/followup_reply 追加回复
| 环节 | 留痕字段 | 可见范围 |
|---|---|---|
| 提交反馈 | content / refs / files / page / uid / created_at | 反馈人本人 + 管理者 |
| 处理回复 | reply / replied_at | 反馈人本人 + 管理者 |
| 进度状态 | status / done_at | 反馈人本人 + 管理者 |
| 追评与追加回复 | followups(含 who=user/admin 与时间) | 反馈人本人 + 管理者 |
| 边界 / 限制 | 现状 | 影响与应对 |
|---|---|---|
| 免登录身份 | 靠浏览器 uid + IP,无账号体系与「认领」 | 换设备或清缓存后,历史记录靠 IP 兜底;跨网络提交可能不在「我的提交」中,需在反馈里说明 |
| 模版与线上关系 | 模版.xlsx 仅作线下填写参考,无批量导入 | 部门线下填好后需逐条录入;如需要可后续加导入 |
| 删除行为 | 填报人删除为物理删除,无删除审计日志 | 建议重要措施先审核,通过即锁定不可删 |
| 附件留存 | 仅存服务器本地目录,无独立备份策略 | 随服务器整体备份;重要佐证建议同时走邮件/共享盘 |
127.0.0.1:8301(waitress,进程 cost-plan),
经网关 cost.fslxlaser.com(HTTPS,Let's Encrypt 自动续期)对外;
数据库 cost.db 与附件目录不与代码库混放,删除代码不影响数据。