给新壹我(天蛙)综合素质评价系统做自动化工具时,最该先想清楚的不是「怎么导出数据」,而是「凭什么能导出」。
这套技能会接触到 学号、姓名、班级、身份证号、考号、成绩、成长档案——其中大部分是未成年人的个人信息。所以我把整份设计单独写成了一篇完整文章:它不讲功能,讲的是边界画在哪、谁来守、怎么证明守住了。
全文怎么读
这篇文章原本发布在综评系统内部(作为一条写实记录),后来搬成独立整页发布。嫌跳转麻烦的话,现在它已经作为一篇正式文章挂在博客里了,URL 变成本文底部链接指向的地址:
- 正文是完整 HTML(配色、卡片、11 张 SVG 示意图都在),md 里直接内嵌,样式不与博客打架;
- 构建管线不需要为它做任何特殊处理,
npm run build照常出页面。
三个我认为最值得抄的部分
1 · 能力边界:删,而不是加开关
平台有不少接口比前端宽松——传个非法参数就能拿到比界面大得多的数据面。处理这类问题最容易被带偏的做法是「加个开关,默认关着」。
我的选择是直接删掉高敏能力,一个环境变量旁路都不留。理由:留后门等于「藏起来但没关掉」,会诱导绕过。正当需求总有替代路径(取某个人的用户 ID 走「班级」范围就够了,不需要全校搜人)。
删不掉的那部分(服务端确实需要保留的能力),才加客户端收口,并且收口必须留痕——确需绕开时要显式传参,每次绕开打 WARNING。
2 · 闸门自证:恒 PASS 的检查是装饰品
CI 里那条「能力红线」检查,我逐条破坏过一遍,确认它真的会变红:
移除范围白名单 → FAIL
移除归属校验 → FAIL
把脱敏默认值关掉 → FAIL
还原 → PASS
如果一条合规检查从来没红过,那它不提供任何保证——它只是让日志好看。
3 · 诚实标注缺口
文章里有一节专门写「已知缺口」,其中最重要的一条是:
客户端闸门只防误用、不是安全控制。绕过工具直接发 HTTP 请求,依然能拿到全量数据——因为宽松的是服务端。真正的修复必须在平台侧。
这条我写得很重。因为一个「我们已经加了校验」的表述,很容易被理解成「问题解决了」,而实际上工具侧的改动只是让人不容易手滑。
一句总结
制度说清什么不许做,代码强制它做不到的事,CI 持续证明它没退化——三件事都要可验证,否则只是态度表态。