工程反馈系统 · TK-Form-Vote
工程反馈系统 · 工程反馈收集与多平台数据融合分析
项目定位
Positioning工程一线反馈收集服务:问卷、投票、图文上报、供应商报告一站式沉淀。10 种题型、条件逻辑、图文投票、12 个模板、数据看板、说明公告,全部跑在内网信创数据库上
反馈数据与安全管理平台、智慧工地业务数据统一沉淀、统一身份口径,汇入 AI 中台做风险预警、供应商画像、趋势研判,为领导提供决策支撑
数据库、代码、服务全在内网,零公有云依赖;OA 统一身份无外部账号;每份答卷记 IP 与时间戳,可追溯
技术架构
Architecture无公网依赖、禁 CDN;MiMo 暖米色调 + 深浅主题变量驱动 + 淡格纹底纹;写操作全部弹窗化,资源页卡片网格可切表格
管理 API 需 JWT,公开读写免登录;门禁中间件按公开面放行;批量接口逐项鉴权、部分成功
不碰数据库,可独立复用与测试;支撑显隐、跳转、必填、字数、正则、配额全套规则
8 张表一次建模、增量建表免迁移;设置、选项、答案走 JSONB;统计按本题建映射反查选项文字
HMAC 四段票据、时效与防重放、多入口问 OA;门禁保护管理端、放行填答页;提交身份只认服务端
操作说明书、项目展示、技术架构、变更日志;Markdown + Mermaid 渲染,可静态导出
模块组成
Modules| 文件 / 目录 | 类型 | 说明 |
|---|---|---|
| img | 目录 | 22 个条目 |
| index.html | 文件 | 23.4 KB |
源码与素材清单
| 文件 / 目录 | 类型 | 说明 |
|---|---|---|
| img | 目录 | 22 个条目 |
| index.html | 文件 | 23.4 KB |
数据流转
Data Flow公告横幅在填答页以驻留弹窗展示,读完才能关闭 模板库复用题目结构,从模板创建后直接进入编辑器,不经过答卷校验链 反馈、安管、工地三类数据统一身份口径后汇入 AI 中台,问卷投票是反馈入口,AI 分析是出口
接口与集成
API/api/auth/login本地登录,SSO 上线后仍保留
/api/auth/register已关闭,默认返回注册已关闭提示
/api/forms表单列表,严格按 owner 过滤
/api/forms创建表单
/api/forms/{id}表单详情含题目
/api/forms/{id}/questions题目批量事务保存,失败整体回滚
/api/forms/{id}/stats统计:选项分布、评分均值、文本计数、近 30 天趋势
/api/forms/{id}/export导出 CSV 或 XLSX 答卷
/api/forms/batch-delete批量删除,无权项在 failed 中逐项说明
/api/forms/{id}/duplicate复制表单含全部题目
/api/public/forms/{uuid}公开读取表单,免登录
/api/public/forms/{uuid}/submit公开提交答卷,免登录
/api/public/forms/{uuid}/result公开查看实时结果
/api/announcements公告公开列表
/api/announcements发布公告,仅管理员
/api/announcements/{aid}卡片行内编辑公告,仅管理员
/api/announcements/{aid}删除公告,仅管理员
/api/templates模板列表:12 个内置与自建合并
/api/templates/{key}单个模板完整结构,用于预览渲染
/api/templates/{key}/create从模板创建表单
/api/templates/from-form/{form_id}把已有表单存为模板
/api/templates/{key}删除自建模板,仅创建者或管理员
/api/upload图片与头像上传,5MB 上限
/api/auth/profile账户资料接口,SSO 后返回由 OA 管理提示
/ssoSSO 票据入口,验票后签发门禁 Cookie 与前端 JWT
/gate跳转 OA 换票入口
/seeyon/leongate问 OA 会话入口,失败回落引导页
/whoami门禁会话查询
/api/sso/whoamiSSO 会话查询 JSON 版
部署形态
DeploymentTK-Server(Ubuntu 24.04),路径 ~/Desktop/Leon-TK-Station/TK-Form-Vote
5270 监听 0.0.0.0;内网 http://192.168.11.70:5270/,公网 http://119.145.17.34:5270/
公网 5270 → EG3220 NAT 映射 → 网关 stream 透传 → 本机 5270
cd 项目目录 && ./venv/bin/python -m uvicorn app.main:app --host 0.0.0.0 --port 5270,日志 /tmp/tkfv.log
信创 PostgreSQL,172.168.10.17:5432,库 tk_form_vote
内网 Gitea,主分支 main
UFW 按网段放行 5270,v4/v6 双栈
改 static 资源必须同步 bump ?v= 版本号,style.css 与 app.js 是独立缓存 key
数据库、代码、服务全在内网,零公网依赖
答卷与业务数据统一沉淀,按统一口径供 AI 中台融合分析