From 45e57fcd07d6cfe2e158d18be1dfaf44e544fcef Mon Sep 17 00:00:00 2001
From: admin <116870791@qq.com>
Date: Thu, 13 Aug 2026 11:44:55 +0800
Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=20=E6=91=A9=E9=80=9A?=
=?UTF-8?q?=E7=94=B5=E6=B0=94-=E7=A0=94=E5=8F=91=E5=8D=8F=E5=90=8C?=
=?UTF-8?q?=E7=AE=A1=E7=90=86=E6=96=B9=E6=A1=88.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
摩通电气-研发协同管理方案.md | 245 +++++++++++++++++++++++++++++++++++
1 file changed, 245 insertions(+)
create mode 100644 摩通电气-研发协同管理方案.md
diff --git a/摩通电气-研发协同管理方案.md b/摩通电气-研发协同管理方案.md
new file mode 100644
index 0000000..92a6f76
--- /dev/null
+++ b/摩通电气-研发协同管理方案.md
@@ -0,0 +1,245 @@
+# 摩通电气 · 研发协同管理方案说明
+
+> 面向：深圳摩通电气有限公司
+> 文档目的：说明「代码怎么管、进度怎么看、结果怎么呈现在飞书」的整体架构，便于管理层与技术负责人理解与评审。
+> 版本：演示版（基于已搭建的飞书多维表格「摩通电气-研发管理」）
+
+---
+
+## 1. 要解决什么问题
+
+摩通电气从事电网运行状态检测类仪器设备（核相测量、电缆探测、校验等），研发同时覆盖：
+
+- 嵌入式固件
+- 上位机 / 手持机软件
+- 硬件与试验相关资料
+- 版本发版与售后追溯
+
+技术人数较多时，常见痛点是：
+
+| 痛点 | 结果 |
+|------|------|
+| 代码与文档分散 | 找不到、难协作、难追溯 |
+| 进度只在口头/群聊 | 负责人看不到全局 |
+| 提交很多但看不出交付 | 无法判断是否按期发版 |
+| 固件版本与任务脱节 | 现场与售后难以追责 |
+
+本方案的目标一句话：
+
+**Gitea 管研发资产（代码与技术文档），飞书管协作与呈现（任务、排期、发版、统计）；中间由自动化能力把代码动态同步进飞书。**
+
+---
+
+## 2. 整体架构（先看这一张图）
+
+```mermaid
+flowchart TB
+ subgraph Dev["研发侧 · 真相源"]
+ Gitea["Gitea
代码 / 文档 / PR / Release"]
+ end
+
+ subgraph Sync["同步层 · 匠厂平台技能"]
+ Skill["RPA / API 技能
读取 Gitea 事件与数据"]
+ end
+
+ subgraph Feishu["飞书 · 协作与呈现"]
+ Base["多维表格：摩通电气-研发管理"]
+ Board["看板 · 按状态"]
+ Gantt["甘特 · 按产品线"]
+ Dash["仪表盘 · 研发总览"]
+ end
+
+ subgraph People["使用角色"]
+ Eng["技术工程师"]
+ Lead["组长 / 负责人"]
+ Boss["管理层"]
+ end
+
+ Gitea --> Skill
+ Skill --> Base
+ Base --> Board
+ Base --> Gantt
+ Base --> Dash
+
+ Eng --> Gitea
+ Eng --> Board
+ Lead --> Board
+ Lead --> Gantt
+ Lead --> Dash
+ Boss --> Dash
+```
+
+### 三层分工（务必记住）
+
+| 层级 | 用什么 | 干什么 | 不干什么 |
+|------|--------|--------|----------|
+| 资产层 | Gitea | 存代码、技术文档、合并请求、发版包 | 不承担公司级进度汇报 |
+| 同步层 | 匠厂技能（RPA/API） | 把提交、PR、发版等写入飞书 | 不替代项目管理决策 |
+| 呈现层 | 飞书多维表格 | 任务流转、排期、发版台账、管理看板 | 不替代 Git 作为代码仓库 |
+
+---
+
+## 3. 和摩通业务怎么对齐
+
+官网产品线大致分为：**核相测量、电缆探测、校验系列**（另有公共平台与代理类）。
+飞书里的「产品线」按此划分，任务、仓库、发版都用同一套口径，避免各说各话。
+
+示例对应关系：
+
+| 产品线 | 典型型号（示例） | 常见研发对象 |
+|--------|------------------|--------------|
+| 核相测量 | MT-870、INPUT-6600 | 固件 + 手持/上位 + 授时/通信 |
+| 电缆探测 | K-90、K-73 等 | 固件 + 探测算法 + 地图/定位相关 |
+| 校验系列 | 开关柜校验类设备 | 固件 + 试验验证 |
+| 公共平台 | BSP、协议库等 | 跨产品复用组件 |
+
+---
+
+## 4. 飞书里建了什么（客户可直接打开看）
+
+飞书多维表格名称：**摩通电气-研发管理**
+
+### 4.1 六张数据表
+
+| 表名 | 作用 | 演示时怎么讲 |
+|------|------|----------------|
+| 研发任务表 | 任务主表：谁做、做到哪、何时完成 | 「日常工作入口」 |
+| 仓库台账表 | 有哪些 Gitea 仓库、归属哪条产品线 | 「代码资产目录」 |
+| 人员档案表 | 人员 ↔ Gitea 账号映射、团队与角色 | 「人和账号对齐」 |
+| 版本发布表 | 固件/软件发版记录、适用型号、测试结论 | 「发版可追溯」 |
+| 提交流水表 | 从 Gitea 同步的 commit 明细 | 「代码活跃证据」 |
+| 合并请求表 | 从 Gitea 同步的 PR 状态与超时未审 | 「评审与风险」 |
+
+> 说明：表与表之间的深度关联（双向关联）可按实施节奏逐步加强；当前演示版以「字段对齐 + 同一套仓库名/任务编号」保证能讲清楚闭环。
+
+### 4.2 三种看法（同一套数据，三种用途）
+
+```mermaid
+flowchart LR
+ T["研发任务表"] --> K["看板-按状态
看流转"]
+ T --> G["甘特-按产品线
看排期"]
+ T --> D["仪表盘-研发总览
看结果"]
+ C["提交流水 / 合并请求 / 版本发布"] --> D
+```
+
+| 视图 | 回答的问题 | 主要给谁看 |
+|------|------------|------------|
+| 看板-按状态 | 现在卡在评审 / 开发 / 联调 / 测试 / 发布哪一环？ | 工程师、组长 |
+| 甘特-按产品线 | 什么时候开始、什么时候该完成？会不会撞期？ | 负责人、项目协调 |
+| 仪表盘-研发总览 | 在研多少、提交多少、PR 多少、发了几个版？ | 管理层、周会 |
+
+### 4.3 任务状态（看板列，统一语言）
+
+```
+待评审 → 待开发 → 开发中 → 联调中 → 待测试 → 待发布 → 已发布 → 已关闭
+```
+
+嵌入式场景保留 **联调中**，避免「写完代码就算完成」。
+
+### 4.4 仪表盘关键指标（研发总览）
+
+- 在研任务数
+- 本周提交数
+- 打开中的 PR 数
+- 已发布版本数
+- 任务按状态 / 按产品线分布
+- 开发者提交活跃度
+- PR 状态（可突出超时未审）
+- 发版明细、阻塞任务明细
+
+---
+
+## 5. 数据如何从 Gitea 到飞书
+
+```mermaid
+sequenceDiagram
+ participant Dev as 工程师
+ participant Gitea as Gitea
+ participant Skill as 匠厂同步技能
+ participant FS as 飞书多维表格
+
+ Dev->>Gitea: Push / 提PR / 发Release
+ Gitea-->>Skill: Webhook 或 API 拉取
+ Skill->>Skill: 账号映射、仓库归属、字段清洗
+ Skill->>FS: 写入提交流水 / 合并请求 / 版本发布等
+ Note over FS: 任务看板仍以人工维护状态为主
代码动态自动进表作证
+```
+
+**原则：**
+
+1. **任务状态以飞书为准**（人要确认是否联调完、是否可测、是否可发）。
+2. **代码事实以 Gitea 为准**（提交了什么、PR 是否合并、发了哪个 Tag）。
+3. **同步层只搬运与对齐**，不在飞书里「发明」第二套代码库。
+
+---
+
+## 6. 推荐使用方式（落地后怎么干活）
+
+| 角色 | 每天/每周怎么用 |
+|------|-----------------|
+| 工程师 | 代码提交到 Gitea；在飞书任务看板更新自己的任务状态；阻塞打勾并注明原因 |
+| 组长 | 看看板堵点；看 PR 是否超时未审；看甘特是否撞期 |
+| 负责人 | 看甘特产品线排期；看版本发布表是否按计划出包 |
+| 管理层 | 打开「研发总览」仪表盘；周会只看数字与风险，不翻聊天记录 |
+
+---
+
+## 7. 为什么这样设计（给决策用）
+
+1. **客户已在飞书**：学习成本低，看板/甘特/仪表盘都在熟悉环境里。
+2. **Gitea 适合内网研发资产**：权限可控，符合电力行业对代码与资料的管理习惯。
+3. **不把「提交次数」当唯一考核**：仪表盘里的活跃度只作参考；真正交付看任务完成与发版。
+4. **按产品线（核相/电缆/校验）组织**：贴合摩通实际销售与研发布局，而不是抽象「项目编号」。
+
+---
+
+## 8. 实施节奏建议
+
+| 阶段 | 内容 | 结果 |
+|------|------|------|
+| 已完成（演示版） | 飞书六表 + 看板 + 甘特 + 仪表盘 + 模拟数据 | 可对外讲清架构与呈现 |
+| 下一阶段 | 正式 Gitea 仓库规范 + 账号映射 + 同步技能接通 | 流水/PR/发版变为真实数据 |
+| 加强阶段 | 任务与仓库/PR/发版深度关联、权限分级、周报自动化 | 周会与售后追溯更省力 |
+
+---
+
+## 9. 演示时建议打开的页面顺序
+
+1. **架构说明**（本文档 / 口述三层分工）
+2. **看板-按状态** → 任务怎么流转
+3. **甘特-按产品线** → 排期怎么看
+4. **提交流水 / 合并请求** → 代码动态如何进飞书
+5. **版本发布表** → 固件版本如何追溯
+6. **研发总览仪表盘** → 给管理层的一页纸
+
+---
+
+## 10. 总结
+
+本方案不是「再买一套项目管理软件」，而是：
+
+> **用 Gitea 把摩通的研发资产收拢，用飞书把进度与结果讲清楚，用同步技能把两边连起来。**
+
+当前飞书「摩通电气-研发管理」已具备可演示的完整呈现骨架；接入真实 Gitea 与同步技能后，即可从演示版升级为日常生产用法。
+
+---
+
+## 附录 A · 表职责一览（速查）
+
+| 表 | 一行代表什么 |
+|----|----------------|
+| 研发任务表 | 一个可交付研发任务 |
+| 仓库台账表 | 一个 Gitea 仓库 |
+| 人员档案表 | 一个研发人员及其账号映射 |
+| 版本发布表 | 一次发版（Tag/Release） |
+| 提交流水表 | 一次代码提交 |
+| 合并请求表 | 一个 PR |
+
+## 附录 B · 文档信息
+
+| 项 | 内容 |
+|----|------|
+| 方案对象 | 深圳摩通电气有限公司 |
+| 参考官网 | http://www.szmtdq.cn/ |
+| 飞书载体 | 多维表格「摩通电气-研发管理」 |
+| 文档性质 | 架构与呈现说明（客户可读） |