Update project startup documents

- Interview map v2.1 → v2.2: Add Office version, workstation, and network questions
- Project retrospective v1 → v2: Document two-round discussion, add version tracking, reorganize pending items
- Planning document v1.4 → v1.5: Add frontend deployment strategy, early demo, and client cooperation items

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Misaka
2026-04-12 16:52:01 +08:00
parent 3ac3d3f4bb
commit 740041d034
3 changed files with 127 additions and 27 deletions

View File

@@ -4,7 +4,7 @@
**项目性质:** 定制化轻量信息化系统
**实施团队:** 内部两人团队(领导 + 技术实施)
**文档用途:** 内部规划参考,指导项目全周期落地
**文档版本:** v1.4
**文档版本:** v1.5
---
@@ -79,6 +79,22 @@
- **本地部署**:系统部署在客户本地机器或服务器上,数据不出厂,安全可控
- **不追求技术先进性**:以稳定、可维护、易交付为第一优先级
### 前端部署与版本管理策略
系统前端基于 Excel + VBA 开发,部署和版本管理需要提前规划,避免在多人使用时出现文件冲突或版本混乱。
**核心设计原则:一人一份应用文件,避免多人同时操作同一文件。**
每个使用系统的员工在自己的电脑上运行独立的 Excel 应用文件,所有数据的读写通过后端数据库完成,前端文件本身不存储业务数据。这样既避免了多人同时打开同一 Excel 文件带来的锁定和冲突问题,也使得应用更新时只需替换各工作站上的文件即可。
**Office 版本统一要求:**
由于 VBA 在不同 Office 版本间存在兼容性差异(如控件行为、函数支持、界面渲染等),需要在项目启动前确认客户各工作站的 Office 版本情况。建议推动客户将所有工作站的 Office 统一到同一版本,以降低开发和测试的复杂度,避免出现"在一台电脑上能用、在另一台上出问题"的情况。
**应用更新与分发:**
当系统功能迭代或修复 Bug 时,需要将新版本的 Excel 应用文件分发到各工作站。具体的分发机制(如通过共享文件夹统一存放最新版本,或由我方远程协助更新)需结合客户的 IT 环境在实施阶段确定。设计应用文件时应考虑版本标识,便于确认各工作站是否运行的是最新版本。
### 部署方式
部署方式取决于数据库方案的选择:
@@ -178,7 +194,7 @@ graph TD
- 记录客户当前各环节的操作方式和痛点
- 确认各模块的具体需求和优先级
- 摸底客户现有数据状况:盘点现有 Excel 及其他载体中的物料数据、BOM 数据、订单数据等的规模、格式和质量,评估数据整理与迁移的工作量
- 确认客户 IT 基础条件:并发用户数、是否已有服务器、是否需要移动端访问等,为数据库选型部署方案提供决策依据
- 确认客户 IT 基础条件:并发用户数、是否已有服务器、是否需要移动端访问、各工作站 Office 版本及操作系统等,为数据库选型部署方案和前端兼容性提供决策依据
- 输出需求确认文档,作为后续开发的依据
**产出物**
@@ -202,16 +218,19 @@ graph TD
- 搭建物料主数据管理模块(录入界面 + 数据库)
- 设计 BOM 数据结构,搭建 BOM 管理模块
- 协助客户完成存量物料数据的整理与录入
- 在基础数据初步录入后,尽早搭建一个可演示的小型功能点(如物料查询界面),供客户实际体验,建立对系统的直观感知和信心
**产出物**
- 物料编码规则文档
- 可用的物料主数据管理模块
- 可用的 BOM 管理模块
- 初始物料数据库(含客户现有物料数据)
- 可演示的早期 Demo如物料查询功能
**阶段目标**
- 物料编码体系落地,数据库中有真实可用的物料数据
- 为后续所有模块提供数据基础
- 客户能够通过早期 Demo 看到实际成果,对项目方向建立信心
---
@@ -282,7 +301,7 @@ graph TD
| 阶段 | 主要内容 | 时间区间 | 关键产出 |
|------|---------|---------|---------|
| 第一阶段 | 调研与需求确认 | 第13周 | 需求确认文档、数据摸底报告 |
| 第二阶段 | 物料编码 + BOM | 第48周 | 物料与BOM模块上线 |
| 第二阶段 | 物料编码 + BOM | 第48周 | 物料与BOM模块上线、早期Demo |
| 第三阶段 | 库存 + 采购 | 第912周 | 库存采购模块上线 |
| 第四阶段 | 订单 + 生产 | 第1317周 | 订单生产模块上线 |
| 第五阶段 | 发货 + 整合交付 | 第1820周 | 完整系统交付 |
@@ -297,14 +316,38 @@ graph TD
|------|------|---------|
| 需求变更 | 调研不充分导致开发中途改需求 | 第一阶段重点投入,确保需求文档经双方确认后再开发 |
| 数据录入量大 | 存量物料数据录入可能耗时超预期 | 第一阶段完成数据摸底,提前评估工作量;协助客户设计数据整理模板,分批录入,不影响开发进度 |
| 客户使用习惯 | 员工不习惯新系统,使用率低 | 界面设计贴近 Excel 操作习惯,降低学习成本,上线前做培训 |
| 客户使用习惯 | 员工不习惯新系统,使用率低 | 界面设计贴近 Excel 操作习惯,降低学习成本,上线前做培训;尽早提供可体验的 Demo让客户逐步适应 |
| 并发访问限制 | 普通 Windows 系统对局域网并发连接数有上限,多人同时使用时可能出现连接被拒的情况 | 服务器操作系统必须使用 Windows Server在项目启动前与客户确认并推动采购落实 |
| 数据库稳定性 | Access 文件型数据库在多人并发写入时存在文件损坏的风险,一旦损坏数据难以恢复 | 采用 SQL Server Express 替代 Access 作为数据库,从根本上规避此风险 |
| 开发时间有限 | 技术实施以业余时间为主 | 借助 AI 辅助开发提升效率,各阶段设置缓冲时间,优先保证核心模块 |
| Office 版本不一致 | 不同工作站 Office 版本不同,可能导致 VBA 程序出现兼容性问题 | 调研阶段摸清各工作站 Office 版本,推动客户在项目启动前统一 Office 版本 |
| 应用分发与更新 | 系统迭代后需将新版本分发到各工作站,若缺乏机制可能导致版本混乱 | 采用一人一份应用文件的设计,应用内置版本标识;结合客户 IT 环境确定分发机制(如共享文件夹存放最新版) |
---
## 七、项目成功标准
## 七、客户侧配合事
> **说明:** 以下事项需要客户方配合完成,建议在项目启动前或调研阶段与客户明确沟通,形成书面备忘,避免后期因预期不对齐产生分歧。
**项目启动前需客户配合确认的事项:**
- 是否同意将各工作站 Office 统一到同一版本(我方指定),并在项目开发启动前完成
- 是否已有服务器或是否愿意采购服务器(若选择 SQL Server 方案)
- 指定一名内部对接人,负责协调访谈安排、数据收集和日常沟通
**项目实施过程中需客户配合的事项:**
- 安排相关岗位人员参与调研访谈
- 配合整理现有物料、BOM 等存量数据,按模板格式提供
- 每个阶段交付时安排人员进行试用和反馈
- 系统上线前安排员工参与使用培训
**建议形成书面备忘的事项:**
- 系统包含哪些模块、不包含哪些(明确项目边界)
- 交付后的维护和修改如何处理(响应方式、是否收费)
- 客户方需承担的配合责任(数据整理、硬件采购、版本统一等)
---
## 八、项目成功标准
- 系统覆盖从接单到发货的完整业务流程
- 客户可以独立完成日常操作,无需长期依赖技术支持
@@ -314,4 +357,4 @@ graph TD
---
*内部工作文件 · v1.4 · 可根据调研结果和项目进展持续更新*
*内部工作文件 · v1.5 · 可根据调研结果和项目进展持续更新*