Initial project setup

- Create documentation directory structure
- Add project planning documents
- Add README for project overview

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

docs/01-项目启动/调研访谈地图.md

@@ -0,0 +1,170 @@
+# 调研访谈对话地图
+
+**项目：** 调节阀工厂信息化系统建设  
+**用途：** 内部访谈引导 · 非逐题照读，按对话节奏灵活使用  
+**版本：** v2.0
+
+---
+
+> **使用说明**  
+> 每个模块抓核心问题，客户聊到哪里就引导到哪里。  
+> 每道问题后的"→ 备注"是提问目的，帮助理解为什么问这个。
+
+---
+
+## 模块一：订单接入
+
+1. 一个订单进来，现在是怎么记录的？记在哪里？谁来记？  
+    → 了解订单信息的载体，是纸质、Excel还是微信，决定数据迁移难度
+    
+2. 接到订单之后，你们内部怎么把这个信息传到生产那边去？  
+    → 找出订单流转的断点，往往这里是第一个信息混乱的地方
+    
+3. 客户问你们"我的货到哪了"，你们现在怎么回答他？  
+    → 用客户视角倒逼出"订单状态跟踪"的现状，比直接问更容易得到真实答案
+    
+4. 你们同时在手上的订单，大概有多少个？有没有过搞混、漏掉的情况？  
+    → 评估订单并发量，以及当前管理方式下的出错频率
+    
+5. 一个订单从接下来到发货，中间大概要多少天？这个周期稳定吗？  
+    → 了解生产交付周期，判断是否需要交货期预警功能
+    
+6. 如果客户临时改了需求，比如改规格或者改数量，你们内部怎么处理？  
+    → 探测变更管理的现状，这是信息流转最容易出问题的场景之一
+    
+
+---
+
+## 模块二：技术与图纸
+
+1. 你们的图纸现在存在哪里？工人需要图纸的时候怎么拿到？  
+    → 了解图纸管理的现状，是否存在版本混乱、找不到图纸的问题
+    
+2. 一个产品要用哪些零件、多少数量，这个信息现在记录在哪里？  
+    → 探测是否有BOM概念，以及BOM的维护方式
+    
+3. 你们的物料有没有自己的编号体系，还是就靠名字来区分？  
+    → 物料编码是整个系统的地基，这里的现状决定编码建设的工作量
+    
+4. 图纸改版了，你们怎么通知到相关的人？有没有出现过用了旧版图纸的情况？  
+    → 了解图纸版本控制的现状，是否存在因版本混乱导致的生产错误
+    
+5. 同一类零件，如果材质不同，你们现在怎么区分它们？  
+    → 探测物料属性的管理深度，材质是调节阀物料的关键字段
+    
+6. 一个新产品从设计完成到可以投产，中间要经过哪些确认步骤？  
+    → 了解技术交底和工艺确认的流程，判断系统是否需要支持审批环节
+    
+
+---
+
+## 模块三：采购管理
+
+1. 你们怎么知道该去采购什么？是有人通知，还是自己去看库存判断？  
+    → 了解采购需求的触发方式，是否存在漏采、多采的情况
+    
+2. 采购的时候，供应商信息记在哪里？价格、账期这些怎么管的？  
+    → 了解供应商数据的维护现状
+    
+3. 货到了之后，怎么确认收货、入库？这个过程有没有出过问题？  
+    → 采购闭环是否完整，找出容易出错的节点
+    
+4. 有没有同一种物料有多个供应商的情况？你们怎么决定从哪家买？  
+    → 了解是否需要多供应商管理和比价功能
+    
+5. 采购单现在是用什么方式发给供应商的？有没有留存记录？  
+    → 了解采购单的开具和归档方式
+    
+6. 有没有遇到过货到了但对不上账，或者多送少送的情况？  
+    → 用具体场景探出收货核对的痛点，判断是否需要到货核验功能
+    
+
+---
+
+## 模块四：仓库与库存
+
+1. 你们仓库里大概存哪几类东西？原材料、半成品、成品是分开放的吗？  
+    → 了解仓库结构，判断是否需要多仓库或多库位管理
+    
+2. 东西出库入库，现在有没有记录？怎么知道库里现在有多少货？  
+    → 评估库存数据的准确性，这是库存模块的出发点
+    
+3. 有没有发生过"以为有货，结果没有"，或者"不知道货在哪里"的情况？  
+    → 用具体场景引出库存管理的真实痛点
+    
+4. 你们现在有没有定期盘点？多久盘一次？盘点结果和账面符不符？  
+    → 了解库存数据的可信度，以及盘点的工作量
+    
+5. 有没有物料积压的问题？有没有东西放着放着就不知道还能不能用了？  
+    → 探测是否需要库龄管理或有效期预警功能
+    
+6. 领料的时候，是谁来领、怎么领的？有没有记录谁领了什么？  
+    → 了解出库管理的规范程度，是否需要领料申请和审批流程
+    
+
+---
+
+## 模块五：生产过程
+
+1. 一个产品从开始生产到完工，大概要经过哪几道工序？  
+    → 梳理生产工序节点，为后续生产工单设计做准备
+    
+2. 生产计划是谁来排的？工人怎么知道今天要做什么？  
+    → 了解计划下达和任务派发的方式
+    
+3. 生产过程中，如果发现缺料或者出了质量问题，现在是怎么处理的？  
+    → 了解生产异常的处理机制，往往是信息断层最明显的地方
+    
+4. 现在同时在生产的产品有多少种？不同产品之间会不会抢资源、抢人手？  
+    → 了解多任务并行的情况，判断是否需要生产优先级管理
+    
+5. 一道工序做完了，怎么知道下一道工序可以开始了？是口头通知还是有别的方式？  
+    → 了解工序间的交接方式，找出生产流转的断点
+    
+6. 产品做完之后，怎么确认它是合格的？检验是谁来做、结果记在哪里？  
+    → 了解质检环节的现状，判断是否需要质检记录功能
+    
+
+---
+
+## 模块六：发货与交付
+
+1. 产品做好了，到发货这一步，要走哪些流程？单据怎么开？  
+    → 了解发货流程，出库单、装箱单、发货记录的现状
+    
+2. 发出去之后，有没有地方记录"哪个客户、发了什么、什么时候发的"？  
+    → 了解发货记录的完整性，以及是否具备追溯能力
+    
+3. 发货用的是自己的车还是第三方物流？物流单据和费用现在怎么管？  
+    → 了解物流方式，判断是否需要对接物流信息
+    
+4. 客户收到货之后，有没有反馈确认的环节？货款结算是怎么对账的？  
+    → 了解交付闭环，以及是否需要对账或回款跟踪功能
+    
+5. 有没有发错货、发漏货的情况？当时是怎么发现、怎么处理的？  
+    → 用具体场景探出发货管理的痛点
+    
+
+---
+
+## 收尾：领导层诉求确认
+
+1. 在你们日常工作里，最让你头疼、最浪费时间的事情是什么？  
+    → 开放式问题，让客户说出最真实的痛点，优先级比我们预设的更准确
+    
+2. 你理想中，这套系统做好之后，你们的工作会有什么不一样？  
+    → 了解客户对"成功"的定义，对齐预期
+    
+3. 你们工厂里，员工用电脑、手机处理工作的情况多不多？大家对新系统的接受程度你觉得怎么样？  
+    → 评估系统推广难度，影响界面设计的复杂程度
+    
+4. 你们有没有用过什么管理软件，哪怕只是财务软件或者进销存？体验怎么样？  
+    → 了解客户对软件系统的既有认知，避免预期错位
+    
+5. 如果让你给这几个方向排个顺序——订单、库存、生产、采购——你最希望先解决哪个？  
+    → 让客户自己确认优先级，为后续分阶段规划提供依据
+    
+
+---
+
+_内部工作文件 · v2.0 · 可根据访谈进展持续更新_

docs/01-项目启动/项目规划文档.md

@@ -0,0 +1,321 @@
+# 项目规划文档
+
+**项目名称：** 调节阀工厂信息化管理系统建设  
+**项目性质：** 定制化轻量信息化系统  
+**实施团队：** 内部两人团队（领导 + 技术实施）  
+**文档用途：** 内部规划参考，指导项目全周期落地  
+**文档版本：** v1.0
+
+---
+
+## 一、项目背景与目标
+
+### 背景
+
+目标客户为一家中小型调节阀制造企业，年产值约1亿元，当前信息化基础几乎为零，主要依靠 Excel 表格和口头传达进行生产管理。企业领导希望引入一套信息化管理系统，提升生产效率，但明确不希望使用复杂的大型通用系统（如 ERP），而是寻求一套小巧、灵活、高度贴合自身现状的定制化解决方案。
+
+### 项目目标
+
+- 为客户搭建一套覆盖核心业务环节的轻量信息化管理系统
+- 系统需高度定制，贴合客户实际生产流程
+- 研发成本和信息化改造成本控制在合理范围内
+- 系统易于使用，员工无需专业培训即可上手
+
+### 可行性判断
+
+本团队当前已有在相近场景下搭建信息化系统的实践经验，技术路线成熟，且在 AI 辅助开发工具的加持下，开发效率可显著提升。项目需求与团队能力匹配度高，整体可行性良好。
+
+---
+
+## 二、技术选型
+
+### 主要技术栈
+
+|技术|用途|说明|
+|---|---|---|
+|Microsoft Excel + VBA|界面与业务逻辑|无需额外环境，部署简单，客户熟悉度高|
+|Microsoft Access|数据存储与应用界面（可选方案A）|与 Office 生态集成，兼具数据库和界面开发能力，部署简单，但存在并发和稳定性局限|
+|SQL Server Express|数据存储（可选方案B）|微软出品，免费，稳定性和并发能力显著优于 Access，但部署复杂度更高|
+|Python|辅助脚本与自动化|用于 VBA 难以处理的复杂逻辑，按需引入|
+
+### 数据库方案对比
+
+数据库的选择是本项目技术层面最关键的决策之一，直接影响系统的稳定性、部署方式和后期维护成本。以下是两个方案的详细对比，供内部讨论决策。
+
+**方案A：Microsoft Access**
+
+适用场景：单机使用，或并发用户数极少（1～2人）的情况。
+
+优点：
+
+- 无需额外安装数据库服务，部署极为简单
+- 自带窗体和报表设计器，可作为应用界面直接使用，减少开发工作量
+- 与 Excel、VBA 集成度高，开发门槛低
+- 客户已有 Office 环境即可运行，无额外软件成本
+
+局限性：
+
+- 文件型数据库，多人并发写入时存在文件损坏风险，数据一旦损坏难以恢复
+- 并发性能较弱，不适合多人同时操作的场景
+- 数据量增大后性能下降明显，长期扩展性有限
+
+**方案B：SQL Server Express（推荐）**
+
+适用场景：多人共享访问，对数据稳定性有要求的生产环境。
+
+优点：
+
+- 微软官方出品，Express 版本免费，功能满足本项目体量
+- 真正的服务型数据库，支持多人并发访问，稳定性高
+- 数据存储在服务器端，不依赖单个文件，安全性和可靠性远优于 Access
+- 后期若系统规模扩大，可平滑升级至 SQL Server 完整版，无需重构
+
+局限性：
+
+- 需要在服务器上安装和配置数据库服务，部署复杂度高于 Access
+- 需要服务器支撑（操作系统建议使用 Windows Server，普通 Windows 系统对局域网并发连接数有约20个的上限限制）
+- 界面部分仍需通过 Excel + VBA 开发，无法像 Access 一样直接利用内置界面工具
+
+### 选型原则
+
+- **优先使用 VBA**：无需搭建运行环境，客户机器上只要有 Office 即可运行，部署成本极低
+- **Python 按需补充**：当 VBA 实现成本过高时，以 Python 脚本的形式补充，不强求统一
+- **本地部署**：系统部署在客户本地机器或服务器上，数据不出厂，安全可控
+- **不追求技术先进性**：以稳定、可维护、易交付为第一优先级
+
+### 部署方式
+
+部署方式取决于数据库方案的选择：
+
+- **方案A（Access）**：数据库文件存放在共享网络路径，各工作站直接访问，无需服务器，部署简单；适合初期试用或并发用户极少的情况
+- **方案B（SQL Server）**：数据库服务安装在服务器上，各工作站通过局域网连接访问；服务器操作系统建议使用 Windows Server，以避免普通 Windows 系统的并发连接上限问题；如客户当前没有服务器，需在项目启动前提前规划采购
+
+---
+
+## 三、模块规划
+
+系统按业务流程划分为以下核心模块，各模块之间存在数据依赖关系，需按顺序建设。
+
+### 模块依赖关系
+
+```
+物料编码 & BOM（地基）
+        ↓
+库存管理 ← 采购管理
+        ↓
+   生产管理
+        ↓
+ 订单管理 → 发货管理
+```
+
+### 各模块说明
+
+**模块一：物料编码与BOM管理**（地基模块）
+
+- 建立统一的物料编码体系，每条物料有唯一编码
+- 物料主数据字段：编码、名称、规格、材质、单位、物料类型等
+- 支持多层级 BOM 结构：产品 → 子组件 → 零件
+- 这是整个系统的数据地基，所有后续模块的数据均基于此建立
+
+**模块二：库存管理**
+
+- 入库、出库记录
+- 实时库存数量查询
+- 库存预警（低库存提示）
+- 基于物料编码与 BOM 模块的数据运作
+
+**模块三：采购管理**
+
+- 采购需求发起与记录
+- 供应商信息维护
+- 采购单开具与跟踪
+- 到货确认与入库联动
+
+**模块四：订单管理**
+
+- 客户订单录入与查询
+- 订单状态跟踪（接单 → 生产中 → 完工 → 已发货）
+- 交货期管理与提醒
+
+**模块五：生产管理**
+
+- 生产工单开具与下达
+- 生产进度记录
+- 生产异常记录
+- 与库存联动（领料出库）
+
+**模块六：发货管理**
+
+- 出库确认与发货单开具
+- 发货记录查询
+- 与订单状态联动（发货后订单标记完成）
+
+---
+
+## 四、分阶段实施计划
+
+项目总周期约 **5个月**，共分为5个阶段，每个阶段有明确产出物。
+
+---
+
+### 第一阶段：调研与需求确认
+
+**时间：第1～3周（约3周）**
+
+**工作内容**
+
+- 与客户开展调研访谈，覆盖全部业务模块
+- 记录客户当前各环节的操作方式和痛点
+- 确认各模块的具体需求和优先级
+- 输出需求确认文档，作为后续开发的依据
+
+**产出物**
+
+- 客户现状调研记录
+- 系统需求确认文档（各模块字段、流程、规则）
+- 物料编码规则草案
+
+**阶段目标**
+
+- 双方对系统要做什么达成一致
+- 物料编码体系的设计方向确定，可进入开发阶段
+
+---
+
+### 第二阶段：基础数据层建设
+
+**时间：第4～8周（约5周）**
+
+**工作内容**
+
+- 设计并确认物料编码规则
+- 搭建物料主数据管理模块（录入界面 + 数据库）
+- 设计 BOM 数据结构，搭建 BOM 管理模块
+- 协助客户完成存量物料数据的整理与录入
+
+**产出物**
+
+- 物料编码规则文档
+- 可用的物料主数据管理模块
+- 可用的 BOM 管理模块
+- 初始物料数据库（含客户现有物料数据）
+
+**阶段目标**
+
+- 物料编码体系落地，数据库中有真实可用的物料数据
+- 为后续所有模块提供数据基础
+
+---
+
+### 第三阶段：库存与采购模块
+
+**时间：第9～12周（约4周）**
+
+**工作内容**
+
+- 搭建库存管理模块（入库、出库、库存查询、预警）
+- 搭建采购管理模块（采购单、供应商、到货确认）
+- 实现库存与采购的数据联动
+- 与客户对接，验证流程是否符合实际操作习惯
+
+**产出物**
+
+- 可用的库存管理模块
+- 可用的采购管理模块
+- 两模块的操作说明文档
+
+**阶段目标**
+
+- 客户可以通过系统管理日常的入库、出库、采购操作
+- 库存数据可实时查询，告别依靠记忆和人工盘点
+
+---
+
+### 第四阶段：订单与生产模块
+
+**时间：第13～17周（约5周）**
+
+**工作内容**
+
+- 搭建订单管理模块（订单录入、状态跟踪、交货期）
+- 搭建生产管理模块（工单、进度、领料）
+- 实现订单 → 生产 → 库存的数据联动
+- 测试完整业务流程的数据流转是否顺畅
+
+**产出物**
+
+- 可用的订单管理模块
+- 可用的生产管理模块
+- 完整业务流程的数据流转测试记录
+
+**阶段目标**
+
+- 系统可以覆盖从接单到生产完成的完整流程
+- 各环节数据可以贯通，不再孤立
+
+---
+
+### 第五阶段：发货模块与系统整合交付
+
+**时间：第18～20周（约3周）**
+
+**工作内容**
+
+- 搭建发货管理模块（出库确认、发货单、发货记录）
+- 全系统整合测试，修复问题
+- 数据迁移协助（将客户现有 Excel 数据导入系统）
+- 客户使用培训
+- 交付系统及相关文档
+
+**产出物**
+
+- 可用的发货管理模块
+- 完整可交付的信息化管理系统
+- 用户操作手册
+- 系统维护说明文档
+
+**阶段目标**
+
+- 系统全流程打通，覆盖接单到发货的完整业务链
+- 客户可以独立使用系统，完成日常业务操作
+
+---
+
+## 五、时间节点总览
+
+|阶段|主要内容|时间区间|关键产出|
+|---|---|---|---|
+|第一阶段|调研与需求确认|第1～3周|需求确认文档|
+|第二阶段|物料编码 + BOM|第4～8周|物料与BOM模块上线|
+|第三阶段|库存 + 采购|第9～12周|库存采购模块上线|
+|第四阶段|订单 + 生产|第13～17周|订单生产模块上线|
+|第五阶段|发货 + 整合交付|第18～20周|完整系统交付|
+
+**总周期：约20周（5个月）**
+
+---
+
+## 六、风险识别与应对
+
+|风险|说明|应对方式|
+|---|---|---|
+|需求变更|调研不充分导致开发中途改需求|第一阶段重点投入，确保需求文档经双方确认后再开发|
+|数据录入量大|存量物料数据录入可能耗时超预期|协助客户设计数据整理模板，分批录入，不影响开发进度|
+|客户使用习惯|员工不习惯新系统，使用率低|界面设计贴近 Excel 操作习惯，降低学习成本，上线前做培训|
+|并发访问限制|普通 Windows 系统对局域网并发连接数有上限，多人同时使用时可能出现连接被拒的情况|服务器操作系统必须使用 Windows Server，在项目启动前与客户确认并推动采购落实|
+|数据库稳定性|Access 文件型数据库在多人并发写入时存在文件损坏的风险，一旦损坏数据难以恢复|采用 SQL Server Express 替代 Access 作为数据库，从根本上规避此风险|
+|开发时间有限|技术实施以业余时间为主|借助 AI 辅助开发提升效率，各阶段设置缓冲时间，优先保证核心模块|
+
+---
+
+## 七、项目成功标准
+
+- 系统覆盖从接单到发货的完整业务流程
+- 客户可以独立完成日常操作，无需长期依赖技术支持
+- 物料编码体系落地，库存数据准确可查
+- 系统在客户现有设备上稳定运行，无重大性能问题
+- 客户对系统的使用满意度达到预期
+
+---
+
+_内部工作文件 · v1.2 · 可根据调研结果和项目进展持续更新_