初始提交：知行汽车 SAP S/4HANA Cloud PE 项目文档

AGENTS.md

+# AGENTS.md
+
+## What this repo is
+
+SAP S/4HANA Cloud Public Edition implementation project documentation for 知行汽车科技 (Zhixing Automotive Technology). **This is not a software build repository.** It contains project documents, data templates, interface specs, and test artifacts.
+
+## Directory structure (numbered phases)
+
+| Dir | Phase | Contents |
+|-----|-------|----------|
+| `01项目准备/` | Project prep | Contracts, SOW, kickoff decks, project plan, org charts |
+| `02项目调研/` | Discovery | Requirements questionnaires, meeting minutes, scope items. Sub-dirs by domain: 财务/供应链/销售/生产/质量/技术服务/集成 |
+| `03数据收集/` | Data collection | Master data templates (vendors, materials, GL accounts, cost centers, bank data). Key sub-dir: `样表模板 - 知行财务 to SAP1012/` |
+| `04业务蓝图/` | Business blueprint | Process docs, data rules, system limitation lists. Sub-dirs: `业务场景文档/`, `数据规则文档/`, `主业务流程图/` |
+| `05培训文档/` | Training | End-user training decks (MM, SD, FI/CO, PP, WM) |
+| `06集成测试/` | UAT | Test scripts (.docx), UAT test plans (.xlsx), key-user exam scores |
+| `07切换上线/` | Go-live | Cutover data, migration templates |
+| `99接口文档/` | Interface docs | Integration specs for SRM, PLM, MES, WMS, 飞书, 合思, 银企直连 (bank direct connect) |
+
+## Files you will encounter
+
+- **Office documents** (.xlsx, .docx, .pptx, .pdf): the bulk of the repo. Treat as read-only reference.
+- **Postman collections** (`1iMotion.postman_collection.json`, `IMotion.json`): API test collections for integration testing.
+- **WSDL files** (`99接口文档/*.wsdl`): SOAP interface definitions.
+- **Java source** (only in `99接口文档/银企直连/iMotion-EPIC/` and `02项目调研/集成/EPIC/opensdkdemo/`): Spring Boot app for bank direct-connect (浦发银行 SPDB integration). Uses Java 8, Spring Boot 2.7, hutool, dom4j, fastjson.
+- **Interface spec spreadsheets** (`99接口文档/*.xlsx`): field definitions for each integrated system.
+
+## Integration landscape
+
+Key systems integrated with SAP (see `99接口文档/` for specs):
+- **SRM** — supplier management
+- **PLM** — product lifecycle
+- **MES & WMS** — manufacturing execution & warehouse
+- **飞书 (Feishu)** — enterprise messaging
+- **合思 (Hose)** — expense reimbursement
+- **银企直连** — bank direct connect (宁波银行/NBSPDB via iMotion-EPIC)
+
+## Working with this repo
+
+- No build, lint, test, or typecheck commands apply.
+- `bak/` subdirectories contain superseded document versions — prefer the non-bak versions.
+- File naming convention: `知行汽车_SAP项目_<description>_V<version>.<ext>`.
+- Many files are Chinese-language business documents. Read content, not just filenames, to understand purpose.
+- The `iMotion-EPIC` Java project under `99接口文档/银企直连/` is a standalone Spring Boot service — not part of a larger app. Build with `mvn package` if modifications are needed.
+
+<!-- BOS-KB-START -->
+---
+
+## BOS SAP Cloud ERP Knowledge Base
+
+> 本专区由 bos-env-config skill 部署生成。KB 文件已部署到项目本地目录。
+
+### System Prompt 加载顺序
+
+每次对话开始时，按以下顺序加载 System Prompt：
+
+| 顺序 | 文件路径 | 职责 |
+|------|---------|------|
+| 1 | `客户项目KB_知行科技/KB_SystemPrompt_项目KB.md` | 客户专属规则：四步诊断法、行为红线、双输出格式、Issue Ledger闭环 |
+| 2 | `KB_SA/SYSTEM_PROMPT_Agent1_v1.67.md` | 产品选型规范：Scope Item两步法、格式守卫、跨域校验 |
+| 3 | `KB_SC/PROMPT_SC_Agent_Runtime_v2.1.md` | 操作执行规范：Fiori操作、系统探索、异常处理 |
+
+### 明确不在实施范围
+
+以下功能不在实施范围内，agent 收到相关问题时直接回答"不在范围"，不查KB：
+
+EWM · LIMS · APS · 金税数电票五期 · 质量通知单SAP内审批流
+
+### SA KB（Presales Agent）
+
+**KB 文件目录**：`KB_SA/`（28 个文件）
+
+#### SA KB 导航图
+{{KB_SA_NAV_MAP}}
+
+#### SA Agent System Prompt
+{{KB_SA_SYSTEM_PROMPT}}
+
+### SC KB（Solution Consultant Agent）
+
+**KB 文件目录**：`KB_SC/`（107 个文件）
+
+#### SC KB 导航图
+{{KB_SC_NAV_MAP}}
+
+#### SC KB OP-Only 工具映射表
+{{KB_SC_OP_TOOLS}}
+
+#### SC Agent System Prompt
+{{KB_SC_SYSTEM_PROMPT}}
+
+### 项目KB（知行汽车科技）
+
+**KB 文件目录**：`客户项目KB_知行科技/`（47 个 Markdown 文件，重建于 2026-07-02，基于 02/04/05/06/08/99 全量文档提取；含验收与 Issue Ledger 治理文件）
+
+**System Prompt**：`客户项目KB_知行科技/KB_SystemPrompt_项目KB.md v2.2（含请求分类+AskUserQuestion场景确认门+四步诊断法+双输出格式+生产确认规则+Issue Ledger闭环+Cloud Guard+禁止话术）`
+
+**项目导航入口**：`客户项目KB_知行科技/KB_00_知行项目_Navigation_Map.md`
+
+**Issue Ledger**：`客户项目KB_知行科技/issues/`（`ISS-ZX-*.md`），宪法 `客户项目KB_知行科技/list-config.md`
+
+#### 项目KB内容
+
+| 文件（索引） | 子文件 | 核心数据量 |
+|-------------|--------|-----------|
+| `00_项目概况.md` | `项目_系统架构与限制.md` | 10公司代码、3销售组织、7模块范围、91+子场景、时间线、干系人、BTP架构、系统限制清单 |
+| `蓝图决策记录.md` | `蓝图决策记录_FICO.md` `_SD.md` `_MM.md` `_PP.md` `_PS_Q.md` `_系统边界.md` | 9大类别、82+条决策（含日期+负责人+依据） |
+| `组织与主数据_真实值.md` | `组织与主数据_财务.md` `_销售.md` `_供应链生产.md` | 10公司代码、3工厂、3销售组织、4分销渠道、5产品组、8采购组、30+库存地点、编码规则、成本中心 |
+| `操作特例.md` | `操作特例_SD.md` `_MM.md` `_PP.md` `_QM.md` `_PS.md` `_GEN.md` | 16项操作特例（SD 5 + MM 4 + PP 5 + QM 2 + PS 2 + GEN 4） |
+| `集成约定.md` | `集成约定_PLM.md` `_SRM.md` `_MES_WMS.md` `_飞书.md` `_合思.md` `_银企直连.md` `_BTP.md` | 7集成系统、系统边界矩阵、接口清单索引、SAP API端点表、租户环境 |
+| `未决问题清单.md` | — | 25项已全部闭环（6系统边界+10生产+3财务+6业务） |
+| `上线问题记录.md` | — | 22条上线问题（嘉兴14+温州3+通用5），含状态标记 |
+| `KB_00_知行项目_Navigation_Map.md` | — | 项目KB自解释导航入口（文件清单、路由、红线、Issue Ledger入口） |
+| `list-config.md` | — | Issue Ledger宪法（schema、词表、checklist） |
+| `issues/ISS-ZX-*.md` | — | 12个Issue对象（11个已验证闭环问题 + 1个财务报表待补充问题） |
+
+#### Issue Ledger 操作路径
+
+| 变量 | 值 |
+|------|---|
+| `$KB` | `客户项目KB_知行科技/issues/` |
+| `$SD` | `~/.config/opencode/skills/bos-issue-ledger/scripts/` |
+
+```bash
+# 搜索 issue
+grep -rli "关键词" "客户项目KB_知行科技/issues/"
+# 更新 issue（通过 bos-issue-ledger skill）
+python "$SD/update_issue.py" "$KB" --id ISS-ZX-XXX --log "诊断日志" --source "session-YYYYMMDD"
+```
+
+#### 权威优先级
+
+`项目KB > SC Base KB > SA KB`
+
+- 客户专属决策/真实值以项目KB为准
+- 功能边界/Scope Item选型 → 查 SA KB
+- 标准操作步骤 → 查 SC KB
+- 项目KB不重复 Base 已有内容，只记录差异
+
+#### 使用说明
+
+当用户问题涉及知行汽车项目决策、客户配置选择、系统集成约定时：
+- 优先查 `客户项目KB_知行科技/`
+- 操作类问题 → 查 `KB_SC/`
+- 功能选型类 → 查 `KB_SA/`
+- 项目KB Agent行为规则 → 查 `KB_SystemPrompt_项目KB.md`
+- 项目KB入口/路由/红线 → 查 `KB_00_知行项目_Navigation_Map.md`
+- Issue Ledger 对象 → 查 `issues/ISS-ZX-*.md`，宪法 `list-config.md`
+
+#### 数据来源索引
+
+项目 KB 数据提取自以下文档（部分二进制文件需人工核验）：
+- **02项目调研**: 15+份会议纪要（财务4+销售1+生产5+供应链4+质量1+集成1+项目1+决策会1）
+- **04业务蓝图**: 业务场景文档V2.0（270页）、5份数据规则V1.3、系统限制清单、银企方案
+- **05培训文档**: MRP手册、14份培训PPTs
+- **06集成测试**: 测试脚本V1.11、UAT计划
+- **08配置文档**: SD/MM/FI/CO 6份配置手册
+- **99接口文档**: 7系统接口清单、银企直连全套、WSDL、Postman集合
+
+<!-- BOS-KB-END -->