工程条线的反馈收集服务:问卷、投票、图文上报、供应商报告一站式沉淀到信创库;登录走 OA 统一身份,自助注册已关闭;反馈数据与安全管理平台、智慧工地业务数据汇入 AI 中台做融合分析,为领导提供决策支撑。全程信创,数据不出内网。
定位、难点、技术框架——30 秒建立全貌。
工程现场每天产生大量反馈:现场问题、供应商报告、履约异常、满意度调查。散在微信群和纸面,收不上来、对不上去,更进不了分析。公有问卷平台数据落别人服务器,涉企信息不合规;通用表单工具不懂工程语义,也接不住多平台数据。本系统的做法:问卷、投票、图文上报统一入口,一站式沉淀到内网信创库;登录复用 OA 账号,不再多记密码;12 个内置模板一键建表,发布即得链接;数据看板先看大盘,明细再导出。
AI 融合与数据流动:本系统采集的问卷、投票、图文上报数据,将与安全管理平台、智慧工地等多系统数据汇聚至 AI 中台,经统一分析生成领导决策支持报告,形成数据流动与 AI 融合设计。问卷投票是反馈入口,AI 分析是出口。
提交身份冒用——客户端传 respondent_id 可冒用他人绕过限次。身份只认服务端 token 解析,匿名回落指纹/IP。选项统计串味——答案存选项 id,跨题 id 重复。统计按本题建映射反查。门禁误挡填答页——全站门禁把外部填卷人挡在门外。梳理公开面清单,放行 /f/ 与 /api/public/*。Vue 模板编译杀手——:class 拼接、this.$set、分号多语句、v-if 空值,四类写法直接整页空白。改方法返回、整体替换、延时兜底。信创库连不上——口令含 @ 被解析成主机名。连接串 URL 转义,凭据只放服务端。
三条主链路,每条各守一个硬约束。
列表接口严格按 owner_id 过滤,协作者走直接 URL 鉴权;题目保存走批量事务,杜绝逐题 PUT 的「半存」脏数据;发布前强制落盘一次。
状态 → 时间窗 → 配额 → IP → 每人 → 归一 → 逐题校验;身份只认服务端 token,匿名回落指纹/IP;首错用中文分号连成一句,一次看全。
跨题选项 id 重复,必须按本题建映射反查,缺失日期补零;反馈数据与安管、工地业务统一口径后汇入 AI 中台做风险预警与供应商画像。
| 模块 | 职责 | 难点所在 |
|---|---|---|
| app/main.py(1833 行) | 35 接口编排、鉴权、校验、统计、导出 | 批量部分成功、错误聚合、公开面放行 |
| app/logic.py(101 行) | 条件规则求值纯函数 | 零 DB 依赖、显隐跳转全覆盖 |
| app/models.py(233 行) | 8 张表 ORM:用户/表单/题目/答卷/明细/协作/模板/公告 | JSONB 建模、增量建表免迁移 |
| app/sso_yzt.py(351 行) | HMAC 票据验签、问 OA、多入口冷却 | 防重放、防死循环、fail-open |
| app/auth.py + 前端 JWT | 签发校验、客户端 IP 提取 | 服务端认定身份、Bearer 桥接 |
| static/app.js(1664 行) | 单页应用:路由/编辑/填答/统计/看板/弹窗 | 模板即契约、缓存双 key |
全部取自线上仓库真实源码,未改写逻辑,按难度递进:验签 → 校验 → 统计 → 删除 → 过滤。
格式 → 签名(恒定时间比较)→ 时效 → 内存 nonce 防重放;payload 解出四字段建号或登录。
def verify_ticket(ticket):
if not ticket or ticket.count(".") != 3:
return None, "票据格式不对"
b64, ts, nonce, sig = ticket.split(".")
try:
if not hmac.compare_digest(_sign(b64 + "." + ts + "." + nonce), sig):
return None, "签名校验失败"
if abs(time.time() - int(ts)) > SSO_TTL:
return None, "票据已过期"
with SEEN_LOCK:
if nonce in SEEN_NONCE:
return None, "票据已被使用"
SEEN_NONCE[nonce] = time.time() 身份只认服务端 token 解析;未登录视为匿名,回落指纹/IP 限制;客户端传的 respondent_id 直接丢弃。
if form.status != "published":
return _single_error("问卷未开放填写")
_state = util.open_state(form)
if _state == "not_started":
return _single_error("问卷尚未开始")
if _state == "ended":
return _single_error("问卷已结束")
# 绝不信任客户端传入的 respondent_id(否则可冒用他人身份绕过限次)
_uid = None
try:
_uid = auth.get_current_user(request, db).id
except HTTPException:
_uid = None # 未登录视为匿名,回落指纹/IP 限制 选项 id 在不同题目间会重复,全局建表必串味;未知 id 直接丢弃不崩;评分另算均值与分布。
counts = {}
for o in q.options or []:
oid = str(o.get("id"))
counts[oid] = {"label": o.get("label"), "count": 0}
for d in details: # 答案存的是选项 id,必须按本题建映射
a = d.answer
if isinstance(a, list):
for x in a:
if str(x) in counts:
counts[str(x)]["count"] += 1
else:
if str(a) in counts:
counts[str(a)]["count"] += 1 无权项在 failed 里逐项说明原因,不整体回滚;上限 100 个防刷。
for fid in ids[:100]:
try:
f = db.query(Form).filter(Form.id == int(fid)).first()
if not f:
failed.append({"id": fid, "reason": "不存在"})
continue
_check_form_perm(db, f, user, "edit")
db.delete(f)
deleted.append(int(fid))
except HTTPException: # 无权只记 failed,不整体回滚
db.rollback()
failed.append({"id": fid, "reason": "无权限"}) 协作者仍可通过直接 URL 访问被共享表单,查看权限由 _check_form_perm 把关。
q = db.query(Form).filter(Form.owner_id == user.id)
forms = q.all()
if keyword:
kw = keyword.lower()
forms = [f for f in forms
if kw in f.title.lower()
or kw in f.description.lower()]每条都是攻坚现场真实发生的:现象 → 根因 → 解法。
| 技术难点 | 现象与根因 | 解决法 |
|---|---|---|
| SSO 票据协议 | 参考实现是 Flask/cookie 风格,本平台是 FastAPI + Bearer;且生产 OA 与测试 OA 并存,直连探错对象会误判缺能力 | 移植验签与门禁中间件,SSO 成功后再签 JWT 经落地页写 localStorage;四套 OA 端点实测 401 确认签票能力,不部署多余组件 |
| 提交身份冒用 | 最初信任客户端 respondent_id,可冒用他人身份绕过限次与一票一投 | 身份只认服务端 token 解析;未登录视为匿名回落指纹/IP;客户端传的 id 直接丢弃 |
| 选项统计串味 | 答案存选项 id,id 跨题重复;搜索「薪酬」搜不出选择题 | 统计按本题 options 建 id→文字映射再计数;搜索同样按题建表反查后匹配 |
| 门禁误挡填答页 | 全站门禁上线后外部填卷人打不开问卷,被挡在闸门页 | 梳理公开面清单,放行 /f/ 页面与 /api/public/*;管理端保持门禁 |
| 投票去重与出口 IP | 匿名按 IP 去重,经网关后看到同一出口 IP,连投只进一票;内网复制的链接外网打不开 | 默认一票一投、可配放开;分享基址默认公网域名;测试用不同出口 IP 补票验证 |
| 深浅主题串色 | 变量驱动换肤后,工具栏、灯箱、输入框等硬编码浅色处在深色下看不见字 | 逐个打覆盖补丁;Ctrl+A 全选态两种主题分别截图验对比度 |
| 前端编译契约 | :class 对象拼接、this.$set、分号多语句、v-if 空值,四类写法直接整页空白;改样式不生效竟是缓存 | 页面内调 Vue.compile 逐行二分定位;改方法返回、整体替换、延时兜底;style.css 与 app.js 双 key 同步 bump |
| 信创库与透传链路 | 口令含 @ 被解析成主机名连不上库;公网 5270 曾不通,不知断在哪一段 | 连接串 URL 转义、凭据只放服务端;链路分段验证:回环 → 内网 → 公网,UFW 按网段放行 v4/v6 |
控制台真实截图,版本与线上一致。







