Upload New File

AGENTS.md

+# 鸿星项目 KB（客户项目知识层）
+
+> doc_type: project_kb_navigation
+> 项目：鸿星文具 SAP S/4HANA Cloud Public Edition 实施项目（覆盖鸿星、凌可、杭州艾尼等公司）
+> 版本：v0.3 **脱源版 + 二次审计** | 审计日期：2026-08-24 | 依据：KB_建设方法论_指导书 v1.0 / 客户项目KB_建设指引 v1.1 | 源件归档索引见文末
+> 治理：Owner=项目经理（待认领，ISS-013）| 验收门禁：KB_QA_验收题库.md
+> 读者：① AI Agent（与 KB_SA / KB_SC 叠加使用，本层优先级最高）② 项目顾问
+
+---
+
+## 一、本 KB 的定位与使用规则
+
+```
+客户提问 → ① 本项目KB（客户专属决策/规则/流程）→ 命中即引用并注明来源文档
+         → ② 未命中 → KB_SC（怎么配/怎么跑的标准操作）
+         → ③ 再未命中 → KB_SA（功能边界/选型）
+冲突裁决：项目 KB > SC Base KB > SA KB（官方步骤正确性仍以 SAP BPD/Base 为锚）
+```
+
+铁律：
+- **脱源原则**：本 KB 自足——作答所需事实全部在正文与 `KB_DATA_*.md` 查找表内，不依赖解压/重读原始 Office 文件；文末归档索引仅供审计追溯。
+- Base KB 已覆盖的标准功能**只引用不重写**；本项目文件只记录"项目怎么定的、和标准有什么差异"。
+- 所有条目可溯源（文末索引），引用格式：`来源：[文档名] [日期]`。
+- 标注 ⚠️ 的条目为存疑内容，不得作为确定性答案输出。
+- 阶段标注：【通用】= 全项目适用；【鸿星阶段】= 一期鸿星/凌可相关；【艾尼阶段】= 艾尼系公司相关。
+
+## 二、导航图
+
+| 文件 | 内容 | 典型问题 |
+|------|------|---------|
+| KB_ORG_组织与主数据.md | 公司码/工厂/销售组织/库存地点要点/科目/成本利润中心（客户真实值） | "公司代码3000是什么""科目编码几位数" |
+| KB_ORG_单据与移动类型.md | PR/PO/SO/生产订单单据类型号段、标准+两套新增移动类型 | "退货PO用什么类型""551是什么移动类型" |
+| KB_MD_主数据规则.md | 物料/BP/客户/供应商维护规则、物料类型与物料组、品类货号命名 | "物料编码怎么给号""客户主数据谁建""新品货号怎么编" |
+| KB_BP_采购到付款.md | PR→PO→审批→收货→质检→发票→付款 全链 + 8 个子场景 | "采购订单怎么审批""预付款怎么做""委外怎么收货" |
+| KB_BP_库存与仓储.md | 领退料/调拨/物料转换/报废/盘点 + 不良品处理决策树 | "报废怎么走""两步调拨怎么操作""盘点冻结两种模式区别" |
+| KB_BP_销售到收款.md | 销售发货/冲销/退货/借贷项/免费销售/客户预付款 + B2B/B2C OMS 流程 | "免费销售用什么订单类型""电商单怎么进SAP" |
+| KB_BP_生产.md | MRP→生产订单→MES 报工/领料/入库→关闭 + 返工/退补料/不良处理 | "MES挂了怎么办""返工订单什么类型""反冲失败怎么处理" |
+| KB_BP_财务.md | 应收应付确认与清账、资产、在建工程、月结年结 | "发票校验三单匹配""月结顺序""在建工程怎么转固" |
+| KB_INT_外围系统接口.md | 聚水潭/领星/钉钉宜搭/MES鼎捷/每刻/北森 接口方向与范围 | "客户主数据从哪来""哪些单据走钉钉审批""领星没接口怎么办" |
+| KB_OPS_操作手册盘点.md | 盘点 APP 操作步骤 + 手册类材料的存疑标注 | "盘点凭证怎么建""过账冻结和冻结账面库存的区别" |
+| KB_TST_UAT与配置.md | UAT 场景矩阵、系统配置值与 CR 号、租户 URL | "质检使用决策代码有哪些""系统配置到哪一步了" |
+| KB_DATA_物料组_鸿星版.md / _AN版.md | 物料组全量两套（513 条 / AN 版）⚠️ 编码含义不同勿混用 | "010101是什么物料组" |
+| KB_DATA_库存地点.md | 鸿星 58 条 + 艾尼 22 条仓库全量 | "3000工厂有哪些仓库" |
+| KB_DATA_工作中心.md | 工作中心 58 条（鸿星/凌可车间工序级） | "叠板工序的工作中心编码" |
+| KB_ISS_未决与存疑.md | 未决问题清单（带状态）+ 已关闭存疑的处置口径 | "Z008到底能不能用""哪些事还没定" |
+| KB_QA_验收题库.md | Release 门禁题库（陷阱/反向陷阱/序列/场景/边界） | KB 改动后的回归验证 |
+
+## 三、版本裁决表（同一主题多版本时以谁为准）
+
+| 主题 | 权威文档 | 说明 |
+|------|---------|------|
+| 鸿星阶段业务流程 | 业务场景规划文档 **V3.0**_260203（02-业务场景规划） | 51 个场景 SUB-001~047，签字版 |
+| 艾尼阶段业务流程 | 业务场景规划文档 **V4.0**_260724（根目录） | ANWH 前缀场景，艾尼系公司 |
+| 数据规则（艾尼系） | 数据规则文档全 **V4.1**_260813（根目录） | 最新；公司码 3000~7000、Z21~Z38、单据类型 |
+| 数据规则（鸿星阶段） | 数据规则文档全 **V3.2**_260421（01-架构&数据结构） | 工作中心编码、仓库定义等 |
+| 系统实际配置值 | 配置文档 V1.0_260119 xlsx（01-架构&数据结构） | 含 CR 号 F24K900003、租户 URL；⚠️ 日期早于上述新版，冲突处以新版数据规则为准 |
+| 操作步骤 | 盘点流程操作手册 20260306（03-培训） | ⚠️ 内部有存疑点，见该文件 |
+| 外围接口与实施范围 | 会议纪要 18（20260130） | 一期/二期边界 |
+| 打印模板 | 采购订单打印 4.0（06-报表打印） | PO 表样与条款 |
+
+## 四、已知矛盾与存疑速览（回答前必读；状态跟踪见 `KB_ISS_未决与存疑.md`）
+
+1. ⚠️ **UAT 测试用例表为外部模板残留**：`UAT测试时间安排` xlsx 中 `UAT测试用例` 工作表的用例编号为 ECARX-*、样例客户为吉利系公司，**不是本项目规则，禁止引用**。仅 `UAT测试概览` 工作表可用。
+2. ⚠️ **财务分模块文档疑为其他项目模板**：`分模块\鸿星SAP项目财务业务场景规划文档1.0.docx` 内容前缀 SAP-WHSX-*、日期 2022-09。其场景内容已由 V3.0 主蓝图 SUB-036~047 覆盖，以 V3.0 为准，WHSX 文件不作为权威源。
+3. ⚠️ **新增移动类型有两套**：配置文档 V1.0（260119，鸿星阶段）为 Z01~Z12（业务招待/办公用品/在建工程/研发支出/车间消耗领料）；数据规则 V4.1（260813，艾尼阶段）为 Z21~Z38（慈善捐赠/包材消耗/返工辅料/质检损耗/盘点调整/开箱损耗/云仓耗材/商品资料调整/无头单）。按阶段+公司区分适用，不可混用。
+4. ⚠️ **物料组有两套编码**：配置文档 V1.0 的鸿星物料组（010101 白板-杨木白板…570101 赠品）与 AN_SAP_物料组清单（20260721，艾尼版重编，010101=马克笔…）编号含义不同。
+5. ⚠️ **退货 PO 类型三个文档不一致**：V4.1 数据规则 = Z005 退货类；配置文档 V1.0 = Z005 退货；盘点手册操作示例 = "Z008 Return PO"。以 V4.1 为准，手册的 Z008 按存疑处理。
+6. ⚠️ **盘点手册中 MIR7 公司代码写 "1040"、PO 审批写 "BPM"**：项目中不存在公司码 1040（各文档均为 1000~7000 体系），审批平台其他所有文档均写钉钉宜搭。视为模板残留，引用该手册时需加警告。
+
+> 以上为常驻警告摘要；每条的编号、状态与处置口径以 `KB_ISS_未决与存疑.md` 为准（ISS-001~014）。
+
+## 五、项目速查卡
+
+- 系统：SAP S/4HANA Cloud Public Edition，生产租户 `my36246819.prod01.cbc.one.sapcloud.cn`（来源：配置文档 V1.0）
+- 主要传输请求：F24K900003（配置类）
+- 实施分期：一期=鸿星(+铅芯工厂1010)+艾利尔；二期=学泰工厂+HR北森（来源：纪要18 20260130）
+- 外围系统：OMS=聚水潭/领星，审批=钉钉宜搭，报销=每刻，MES=鼎捷7.0，HR=北森(二期)
+- 主数据收集模板序号：00-物料 → 10-供应商 → 20-采购信息记录 → 30-客户 → 40-BOM → 50-工艺路线 → 60-生产版本 → 70-检验计划
+
+### 明确不在范围 / 未定事项（防止 AI 替客户推断）
+- 学泰工厂、HR 北森 = 二期，一期问题不展开其方案。
+- 领星接口一期未定（兜底=表格导出导入）；钉钉宜搭接口细节待议（ISS-003/004）。
+- 产品功能"2602 支不支持 X"、Scope Item 选型 → 转介 KB_SA；标准操作步骤 → 引用 KB_SC，不在本层重写。
+
+## 六、Agent 操作铁律
+
+**铁律〇 · 开场先分类**：每次对话先判断请求类型并声明——A 项目咨询 / B 客户决策查询 / C 问题诊断 / D 系统操作 / E 对外输出，按类走对应铁律。
+**铁律〇A · 开答前确认场景**：C/E 类且语境不明时先问一句：问题是"客户提出的""要给客户方案的"还是"内部排查"，再决定输出形态。
+**铁律一 · 开答先输出来源**：项目层答案必须带 `来源：[文件名] [日期]`；⚠️ 条目不得作为确定性结论。
+**铁律二 · 分层路由不跳层**：客户决策/真实值→本 KB；标准怎么配怎么跑→KB_SC；功能边界/选型→KB_SA。冲突时 项目KB > 蓝图 > SC > SA，但与官方步骤正确性矛盾时停下让顾问判断。
+**铁律三 · 真实值替换占位值**：操作类回答用 `KB_ORG_*` / `KB_DATA_*` 的客户真实值，禁用 Base 样例值（1310/TG11 等）直接下单。
+**铁律四 · 写操作二次确认**：对生产租户执行创建/过账/冲销/删除前，必须复述单据与影响并获用户确认；删除/批量操作一律二次确认。
+**铁律五 · 诊断四步不跳步**：报错类问题按 ①本 KB 存疑清单(KB_ISS) ②issues-ledger 已有记录 ③KB 操作特例 ④升级项目经理 的顺序排查，禁止直接猜原因。
+**铁律六 · 集成只答触点**：聚水潭/领星/宜搭/MES/每刻问题只回答触发条件、SAP 侧替代步骤、异常兜底；禁止推断外部系统内部逻辑。
+**铁律七 · 双输出**：内容将发给客户时，分「给客户」（可直发、无内部术语）与「给顾问」（内部分析）两区。
+**铁律八 · 自查只对照 KB**：被追问复核时只用 KB 内容验证，不得引入训练记忆推翻已给出的 KB 结论。
+**铁律九 · 禁说"我无法查询"**：KB 未覆盖时说"KB 未覆盖，建议向项目经理确认/查 KB_SC/KB_SA"，给出下一步动作。
+**铁律十 · Session 闭环回写**：诊断/新决策落定后，经确认将结论回写 `KB_ISS`（状态变更）或对应 KB 文件，保持周级新鲜度。
+
+### Issue Ledger
+- 问题登记目录：`hongxing-project-kb\issues-ledger\`（字段与状态门禁见其 `list-config.md`）；C 类诊断完成后按铁律十提炼回写。
+
+---
+
+## 源件归档索引（仅供审计追溯，不作答时无需读取）
+
+> 本 KB 为脱源版：以下源件已不在本地保留解压件；如需核对原文，按路径在项目资料库中打开。
+
+| 材料 | 源件路径（项目资料库内） |
+|------|------|
+| 业务场景规划 V3.0 | 03-项目资料\02-业务场景规划\鸿星公司-SAP项目_业务场景规划文档_V3.0_260203.docx |
+| 业务场景规划 V4.0 | 鸿星公司-SAP项目_业务场景规划文档_V4.0_260724.docx（根目录） |
+| 分模块蓝图 PP | 03-项目资料\02-业务场景规划\分模块\鸿星PP.docx |
+| 数据规则 V4.1 | 鸿星文具-SAP项目_数据规则文档全_V4.1_260813.docx（根目录） |
+| 数据规则 V3.2 | 03-项目资料\01-架构&数据结构\鸿星文具-SAP项目_数据规则文档全_V3.2_260421.docx |
+| 配置文档 V1.0 | 03-项目资料\01-架构&数据结构\鸿星_SAP项目实施_配置文档V1.0_260119.xlsx |
+| 移动类型 V1.0 | 03-项目资料\01-架构&数据结构\鸿星_SAP_移动类型_V1.0.xlsx |
+| 配置清单 | 04-测试数据\鸿星文具_SAP项目_配置清单.xlsx |
+| UAT 时间安排 | 03-项目资料\鸿星文具SAP项目_UAT测试时间安排_V1.0_202604120-MM.xlsx |
+| 盘点操作手册 | 03-项目资料\03-培训\鸿星SAP项目_SAP盘点流程操作手册_20260306.docx |
+| 采购订单打印 4.0 | 03-项目资料\06-报表打印\采购订单4.0.docx |
+| 纪要18 接口与范围 | 02-会议纪要\18.…外围系统接口对接&实施范围确定_会议纪要_20260107.docx |
+| AN 物料组清单 | AN_SAP_物料组清单_2026.07.21.xlsx（根目录） |
+| TD 品类货号规则 | TD-品类货号品名编写规则.xlsx（根目录） |
+| AN 销售办事处对应关系 | AN_SAP_销售范围、销售办事处对应关系.xlsx（根目录，⚠️ 未收录本 KB，店铺明细需查原件） |