← 返回总览 / 工程反馈系统 · TK-Form-Vote 🏢 展示 📖 说明书 🕘 日志 技术架构说明
📐 Architecture

工程反馈系统 · TK-Form-Vote

工程反馈系统 · 工程反馈收集与多平台数据融合分析

📁 服务汇总 🌐 http://192.168.11.70:5270/ 🕑 更新于 2026-11-04
1

项目定位

Positioning
工程反馈系统

工程一线反馈收集服务:问卷、投票、图文上报、供应商报告一站式沉淀。10 种题型、条件逻辑、图文投票、12 个模板、数据看板、说明公告,全部跑在内网信创数据库上

点击查看全文 ⤢
AI 融合设计

反馈数据与安全管理平台、智慧工地业务数据统一沉淀、统一身份口径,汇入 AI 中台做风险预警、供应商画像、趋势研判,为领导提供决策支撑

点击查看全文 ⤢
国企数据安全

数据库、代码、服务全在内网,零公有云依赖;OA 统一身份无外部账号;每份答卷记 IP 与时间戳,可追溯

点击查看全文 ⤢
2

技术架构

Architecture
L1表现层
SPA
原生 HTML/CSS/JS + Vue 3.4.38 本地化单页应用

无公网依赖、禁 CDN;MiMo 暖米色调 + 深浅主题变量驱动 + 淡格纹底纹;写操作全部弹窗化,资源页卡片网格可切表格

点击查看全文 ⤢
L2接口层
REST
app/main.py 编排 35 个接口

管理 API 需 JWT,公开读写免登录;门禁中间件按公开面放行;批量接口逐项鉴权、部分成功

点击查看全文 ⤢
L3逻辑层
纯函数
app/logic.py 条件求值纯函数

不碰数据库,可独立复用与测试;支撑显隐、跳转、必填、字数、正则、配额全套规则

点击查看全文 ⤢
L4持久层
数据
SQLAlchemy 2.0 + 信创 PostgreSQL

8 张表一次建模、增量建表免迁移;设置、选项、答案走 JSONB;统计按本题建映射反查选项文字

点击查看全文 ⤢
L5认证安全
安全
OA SSO 票据验签 + JWT 双 token

HMAC 四段票据、时效与防重放、多入口问 OA;门禁保护管理端、放行填答页;提交身份只认服务端

点击查看全文 ⤢
L6展示文档
文档
Leon-Web-Host 四入口

操作说明书、项目展示、技术架构、变更日志;Markdown + Mermaid 渲染,可静态导出

点击查看全文 ⤢
3

模块组成

Modules
文件 / 目录类型说明
img 目录 22 个条目
index.html 文件 23.4 KB
源码与素材清单
文件 / 目录类型说明
img 目录 22 个条目
index.html 文件 23.4 KB
4

数据流转

Data Flow
创建者 → OA 登录签发 JWT → 编辑器弹窗设计 → 发布生成链接 → 填答人打开公开页 → 公开 API 读表单 → 提交七道校验 → 答卷入库 → 多平台数据汇入 AI 中台 → 融合分析与领导报告

公告横幅在填答页以驻留弹窗展示,读完才能关闭 模板库复用题目结构,从模板创建后直接进入编辑器,不经过答卷校验链 反馈、安管、工地三类数据统一身份口径后汇入 AI 中台,问卷投票是反馈入口,AI 分析是出口

点击查看全文 ⤢
5

接口与集成

API
/api/auth/login
POST

本地登录,SSO 上线后仍保留

点击查看全文 ⤢
/api/auth/register
POST

已关闭,默认返回注册已关闭提示

点击查看全文 ⤢
/api/forms
GET

表单列表,严格按 owner 过滤

点击查看全文 ⤢
/api/forms
POST

创建表单

点击查看全文 ⤢
/api/forms/{id}
GET

表单详情含题目

点击查看全文 ⤢
/api/forms/{id}/questions
PUT

题目批量事务保存,失败整体回滚

点击查看全文 ⤢
/api/forms/{id}/stats
GET

统计:选项分布、评分均值、文本计数、近 30 天趋势

点击查看全文 ⤢
/api/forms/{id}/export
POST

导出 CSV 或 XLSX 答卷

点击查看全文 ⤢
/api/forms/batch-delete
POST

批量删除,无权项在 failed 中逐项说明

点击查看全文 ⤢
/api/forms/{id}/duplicate
POST

复制表单含全部题目

点击查看全文 ⤢
/api/public/forms/{uuid}
GET

公开读取表单,免登录

点击查看全文 ⤢
/api/public/forms/{uuid}/submit
POST

公开提交答卷,免登录

点击查看全文 ⤢
/api/public/forms/{uuid}/result
GET

公开查看实时结果

点击查看全文 ⤢
/api/announcements
GET

公告公开列表

点击查看全文 ⤢
/api/announcements
POST

发布公告,仅管理员

点击查看全文 ⤢
/api/announcements/{aid}
PUT

卡片行内编辑公告,仅管理员

点击查看全文 ⤢
/api/announcements/{aid}
DELETE

删除公告,仅管理员

点击查看全文 ⤢
/api/templates
GET

模板列表:12 个内置与自建合并

点击查看全文 ⤢
/api/templates/{key}
GET

单个模板完整结构,用于预览渲染

点击查看全文 ⤢
/api/templates/{key}/create
POST

从模板创建表单

点击查看全文 ⤢
/api/templates/from-form/{form_id}
POST

把已有表单存为模板

点击查看全文 ⤢
/api/templates/{key}
DELETE

删除自建模板,仅创建者或管理员

点击查看全文 ⤢
/api/upload
POST

图片与头像上传,5MB 上限

点击查看全文 ⤢
/api/auth/profile
PUT

账户资料接口,SSO 后返回由 OA 管理提示

点击查看全文 ⤢
/sso
GET

SSO 票据入口,验票后签发门禁 Cookie 与前端 JWT

点击查看全文 ⤢
/gate
GET

跳转 OA 换票入口

点击查看全文 ⤢
/seeyon/leongate
GET

问 OA 会话入口,失败回落引导页

点击查看全文 ⤢
/whoami
GET

门禁会话查询

点击查看全文 ⤢
/api/sso/whoami
GET

SSO 会话查询 JSON 版

点击查看全文 ⤢
6

部署形态

Deployment
设备

TK-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 中台融合分析

点击查看全文 ⤢
© 2026 Leyon WorkStation · 工程反馈系统 · TK-Form-Vote 🏢 展示 📖 说明书 🕘 日志 ← 返回项目总览