鲸工是什么
鲸工是鲸云 AIoT 平台下的智能制造子平台（与鲸农、鲸仓、鲸油、鲸宴同属鲸云行业子平台），也就是通常说的 MES—— 管的是从一张工单到一台合格品之间的全过程： 计划排产、SOP 执行、工艺下发、报工、批次与序列号追溯，以及贯穿其中的质量、设备、物料、人员与视频。
架构上刻意做成了单体：一条主业务链 （计划→派工→SOP 执行→工艺下发→报工→追溯→OEE）全程进程内 service 直调， 零跨服务 HTTP 自调用。部署只需要一个端口、一个库，中小产线不需要先搭一套微服务集群。
上面的规模数字取自 2026-09-27 运行实例的 /openapi.json （版本 0.2.3）与平台登录页自述，均为接口与结构计数，不含任何演示库业务数据。
一条主业务链
从工单到 OEE 的七个环节，环环有校验、步步留痕迹——这是 MES 与「一堆表格」的差别所在。
10 大功能域
与平台前端菜单门户一一对应（登录页自述：1 租户 · 10 大功能域）。每条描述都对应真实存在的接口与页面，可在接口文档里逐条核对。
守卫链：把错误挡在发生之前
MES 的价值不只在记录，更在于不让错误的动作发生。 鲸工内置四条硬守卫，以下口径与平台「关于鲸工」页原文一致。
五种角色，权限写进接口层
不是前端把按钮藏起来，而是后端按角色拦截。写权限白名单：admin / manager / engineer 全域可写。
| 角色 | 标识 | 权限边界 |
|---|---|---|
| 系统管理员 | admin | 全域可写，含系统设置 |
| 生产主管 | manager | 全域可写，不含系统设置 |
| 工艺工程师 | engineer | 全域可写，负责工艺与配方 |
| 一线操作员 | operator | 可执行开工/报工/签到/安灯，不可改主数据与配方 |
| 只读访客 | viewer | 除系统接口外只读，提供 3 个月试用账号 |
开放访问，接口文档在线可查
平台已开放公网访问。与「只给看宣传页」不同，这里把接口文档也一并开放—— 155 个接口路径、18 个领域模块逐条可查，能力清单不需要听我们口头介绍。
平台地址：http://119.45.13.100:3600/
接口文档：http://119.45.13.100:3600/docs
演示账号 admin（全权限）在登录页公示，密码请联系获取；也可在登录页 「申请免费试用」开通 3 个月只读试用账号。
部署与集成
部署形态
- 架构
- 单体 FastAPI + 单库 SQLite(WAL)，一条主业务链全程进程内 service 直调，零跨服务 HTTP 自调用
- 前端
- 单 Vue3 SPA，10 菜单门户，与后端同端口托管（history fallback）
- 迁移
- Alembic 双版本迁移；对外仅暴露 3600 一个端口，SRS 与 GB28181 为外部进程
鉴权与安全
- 登录态
- 单 JWT + RBAC 角色权限 + token_version 吊销机制
- 权限边界
- admin / manager / engineer 全域可写；operator 仅生产动作；viewer 只读
- 接口文档
- /docs 与 /openapi.json 在线可查，接口层面可逐一核对能力清单
采集与联动
- 采集
- 全局唯一 MQTT / 轮询订阅器，告警归一为 alarm_event 统一处置
- 视频
- 摄像头台账 + SRS 流媒体 + GB28181 国标设备，可从工作台直接看视频接入数
- AI
- 模型仓库 / 引擎加载 / 推理统计 / 违规处置与预测流水线，与产线数据同一平台
鲸工 · 智造云平台
一个登录、一个门户、一条主业务链 —— 鲸云 AIoT 平台智能制造子平台