本页用于向管理层与审计视角说明:数据从哪来、怎么存、怎么算、怎么传导、谁在监管。 站点为免登录在线填报(cost.fslxlaser.com),全部数据落在自有服务器 SQLite 单库, 无第三方表单平台中转;每条数据的状态流转均带时间戳与操作人标识。
1 数据来源与存储 2 数据怎么算 3 传导链与状态流转 4 权限与审计点 5 反馈闭环 6 实时核对与已知边界

1数据来源与存储

共 4 个数据入口,全部经自有服务写入,无人工代录中转;附件单独落盘不存库。
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,随服务器每日备份。

2数据怎么算

全部指标由服务端一次算定,页面不二次加工;前端只做同口径的实时预览。
指标公式取数范围说明
优化幅度 pct优化目标 ÷ 现状年成本 × 100 单条提交时算定;现状年成本为 0 时计 0,不报错
目标降幅 drop现状年成本 − 优化目标 部门汇总单位万元,部门/总计两级
实际降幅 actual_pct实际降本 ÷ 现状年成本 × 100 部门汇总财务录入实际降本后自动生效
优化完成率 done_rate实际降本 ÷ 优化目标 × 100 部门汇总排名依据降序,同率按目标额、措施数
小数处理保留 1 位,四舍五入 全部百分比服务端与前端同口径,避免同页两个数字打架
看板口径含义金额类是否计入典型用途
已通过pass仅财务审核通过的提案计入默认口径,绩效考核
含待审核nr未驳回的提案(含待审核)计入过程管控与预期测算
全部all全部提案(含已驳回)仅已通过计入金额项目总览进度核对
统计卡金额(现状年成本合计 / 年度优化目标 / 实际降本合计)一律只累计已通过提案,与部门看板口径一致; 进度类计数(已立项 / 待审核 / 已通过 / 已驳回)为全量口径。

3传导链与状态流转

从填报到考核的完整链路,其中「财务审核」是唯一的准入卡点,通过即锁定。
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 · 年度考核"]
状态填报人可做财务可做是否计入看板金额
待审核修改、删除通过、驳回否
已驳回修改(回待审核)、删除通过、驳回否
已通过不可改不可删录入实际降本是

4权限与审计点

免登录不等于无身份:每一次写入都带 uid 与服务端 IP,权限按记录逐条判定。
审计点实现方式效果
身份识别浏览器 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;反馈带回复与追评流水时间 可回溯提交、修改、审核时点

5反馈闭环

站点自带反馈通道:反馈人可提、可查、可追评;管理者回复与状态变更对反馈人可见。
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 与时间)反馈人本人 + 管理者
注:撤销回复(unreply)会同时清空回复与状态,用于回复有误时纠正,操作同样需管理钥匙。

6实时核对与已知边界

下列数字为本页打开时从线上接口实时读取,用于与看板口径做交叉核对。
—
措施总数
—
待审核
—
已通过
—
已通过·现状年成本合计(万元)
—
已通过·优化目标合计(万元/年)
—
已通过·实际降本合计(万元)
边界 / 限制现状影响与应对
免登录身份靠浏览器 uid + IP,无账号体系与「认领」 换设备或清缓存后,历史记录靠 IP 兜底;跨网络提交可能不在「我的提交」中,需在反馈里说明
模版与线上关系模版.xlsx 仅作线下填写参考,无批量导入 部门线下填好后需逐条录入;如需要可后续加导入
删除行为填报人删除为物理删除,无删除审计日志 建议重要措施先审核,通过即锁定不可删
附件留存仅存服务器本地目录,无独立备份策略 随服务器整体备份;重要佐证建议同时走邮件/共享盘
数据落在自有服务器:应用 127.0.0.1:8301(waitress,进程 cost-plan), 经网关 cost.fslxlaser.com(HTTPS,Let's Encrypt 自动续期)对外; 数据库 cost.db 与附件目录不与代码库混放,删除代码不影响数据。