● 由 Leyon 开发 · FastAPI · Vue 3 · 信创 PostgreSQL · OA SSO · AI 融合分析

工程反馈系统

工程条线的反馈收集服务:问卷、投票、图文上报、供应商报告一站式沉淀到信创库;登录走 OA 统一身份,自助注册已关闭;反馈数据与安全管理平台、智慧工地业务数据汇入 AI 中台做融合分析,为领导提供决策支撑。全程信创,数据不出内网。

10 种题型 · 12 模板一键建表OA SSO 登录直进公开填答免登录存储信创化AI 中台数据融合与分析国企数据安全兜底
自上而下通读即可
01 / 概括

为工程反馈而建的收集服务

定位、难点、技术框架——30 秒建立全貌。

定位反馈散在群里纸面上,收不上来、对不上去

工程现场每天产生大量反馈:现场问题、供应商报告、履约异常、满意度调查。散在微信群和纸面,收不上来、对不上去,更进不了分析。公有问卷平台数据落别人服务器,涉企信息不合规;通用表单工具不懂工程语义,也接不住多平台数据。本系统的做法:问卷、投票、图文上报统一入口,一站式沉淀到内网信创库;登录复用 OA 账号,不再多记密码;12 个内置模板一键建表,发布即得链接;数据看板先看大盘,明细再导出。

AI 融合与数据流动:本系统采集的问卷、投票、图文上报数据,将与安全管理平台、智慧工地等多系统数据汇聚至 AI 中台,经统一分析生成领导决策支持报告,形成数据流动与 AI 融合设计。问卷投票是反馈入口,AI 分析是出口。

难点五个真问题

提交身份冒用——客户端传 respondent_id 可冒用他人绕过限次。身份只认服务端 token 解析,匿名回落指纹/IP。选项统计串味——答案存选项 id,跨题 id 重复。统计按本题建映射反查。门禁误挡填答页——全站门禁把外部填卷人挡在门外。梳理公开面清单,放行 /f/ 与 /api/public/*。Vue 模板编译杀手——:class 拼接、this.$set、分号多语句、v-if 空值,四类写法直接整页空白。改方法返回、整体替换、延时兜底。信创库连不上——口令含 @ 被解析成主机名。连接串 URL 转义,凭据只放服务端。

框架技术栈与运行形态

语言/形态
FastAPI + Uvicorn 后端 · Vue 3.4.38 本地化单页应用,零框架以外的公网依赖,禁 CDN
接口层
35 个接口:认证/表单/公开提交/模板/公告/上传/SSO;JWT 鉴权 + 公开免登;批量接口逐项鉴权部分成功
逻辑层
app/logic.py 条件求值纯函数,不碰数据库,可独立复用;支撑显隐、跳转、必填、字数、正则、配额
登录
OA SSO 统一身份:HMAC 四段票据 + 防重放 + 多入口冷却;门禁保护管理端、放行填答页;自助注册已关闭
数据
信创 PostgreSQL,8 张表一次建模增量建表;设置、选项、答案走 JSONB;统计按题映射反查
展示
Leon-Web-Host 四入口:说明书/展示/架构/日志;深浅主题变量驱动;写操作弹窗、资源页卡片网格
运维
UFW 按网段放行 5270;venv 直启日志落盘;前端 ?v= 双 key 缓存;改动先备份再重启
02 / 架构

数据怎么流,难点压在哪一层

三条主链路,每条各守一个硬约束。

链路 A创建 → 发布:每人只看自己的表单

编辑器弹窗→owner 过滤列表→批量事务存题→发布生成 uuid→分享链接(公网基址)

列表接口严格按 owner_id 过滤,协作者走直接 URL 鉴权;题目保存走批量事务,杜绝逐题 PUT 的「半存」脏数据;发布前强制落盘一次。

链路 B填答 → 入库:七道校验守公开口

公开链接 /f/uuid→公开 API 读表单→提交七道校验→Response 入库

状态 → 时间窗 → 配额 → IP → 每人 → 归一 → 逐题校验;身份只认服务端 token,匿名回落指纹/IP;首错用中文分号连成一句,一次看全。

链路 C统计 → AI 融合:先看大盘再出报告

/stats 按题映射→趋势折线/占比条→导出 CSV/XLSX→多平台汇入 AI 中台→领导报告

跨题选项 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
03 / 代码

五段核心代码

全部取自线上仓库真实源码,未改写逻辑,按难度递进:验签 → 校验 → 统计 → 删除 → 过滤。

C1SSO 票据验签:四段式,失败原因精确到字

格式 → 签名(恒定时间比较)→ 时效 → 内存 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()

C2公开提交校验:状态 → 时间窗 → 配额 → IP → 每人

身份只认服务端 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 限制

C3选项统计反查:答案存 id,必须按本题建映射

选项 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

C4批量删除:逐个鉴权,无权跳过并说明

无权项在 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": "无权限"})

C5列表过滤:每人只看自己做的表单

协作者仍可通过直接 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()]
04 / 优化

主要优化

每条都是攻坚现场真实发生的:现象 → 根因 → 解法。

技术难点现象与根因解决法
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
实拍 / 导览

实拍速览

控制台真实截图,版本与线上一致。

登录页(OA 登录入口)
登录页(OA 登录入口)
仪表盘(我的表单)
仪表盘(我的表单)
新建表单(问卷 / 投票入口)
新建表单(问卷 / 投票入口)
编辑器 · 题目设计
编辑器 · 题目设计
填答第 1 页(公告横幅 + 分页)
填答第 1 页(公告横幅 + 分页)
投票填答与实时结果
投票填答与实时结果
统计页
统计页
用户管理页
用户管理页
📖 说明书📐 说明文档🕘 日志