Skip to content

L
lianchuangjie-project-kb
Commit 55df49e2 authored by 蔡林艳's avatar 蔡林艳
Browse files
Options

feat: 按Majesty格式重建联创杰项目KB（20个文件）

- KB_00 Navigation Map（三层路由/脱源运行/红线/快速分流） - KB_MANIFEST.json（加载策略/证据等级/已知缺口/复审节奏） - KB_01 项目概况与问答范围（BP-01~12映射/Base边界） - KB_02 组织与主数据真实值（索引+财务组织+销售采购2个子文件） - KB_03 蓝图与范围边界（12个BP域/22个场景锚点） - KB_04 操作特例与客户化流程（财务/销售/采购特例） - KB_05 FS与集成开发触点（DOC-002接口文档/BTP飞书金税） - KB_06 UAT问题与验证覆盖（历史问题/保守口径） - KB_07 操作手册与常见报错索引 - KB_08 项目决策与未决清单（A~H全节/决策/风险/补齐跟踪） - KB_09 模块蓝图决策与Base引用（FI/CO/SD/MM/QM/AA/EC-CS） - KB_10 系统集成约定与接口清单（BTP/飞书/金税/AI询报价） - KB_11 运行质量与证据治理（L0~L4/长文件策略/复审节奏） - KB_99 来源索引（20份DOC-xxx源文档/追溯矩阵） - KB_ACCEPTANCE_TESTS（26题/8题型验收题库） - KB_ACCEPTANCE_RESULTS（待执行） - AGENTS.md（铁律7条/事实口径/自检清单） - README.md
parent 8e609d28
Expand all Show whitespace changes
Inline Side-by-side
Showing with 1910 additions and 96 deletions
AGENTS.md 0 → 100644
View file @ 55df49e2
# AGENTS.md — 联创杰 SAP 项目 KB
> SAP S/4HANA Cloud Public Edition | 深圳联创杰科技有限公司 | BOS 实施顾问 | 上线支持 + 月结运营 + KB 运维
---
## Repo type
纯 Markdown 知识库，**非代码项目**。无 build/test/lint/CI/typecheck 命令。AGENTS.md 是唯一指令文件。
## KB 三层架构（优先级从高到低）
```
KB_联创杰/ 客户项目层（真实值 / 决策 / 接口 / 项目差异）
> KB_SC/ 操作层、配置层、主数据层（标准官方步骤）
> KB_SA/ 产品功能、Scope Item、E2E 架构、功能边界
```
关键规则：
- 冲突时先说明"这是联创杰项目的项目化实现"，不得把项目差异表述成 SAP 标准
- `KB_SC` 样例值为占位值，P 系统操作前须从 `KB_联创杰/KB_02*` 取真实值
- 超 5000 字文件按问题路由加载，不作为常驻上下文
## 强制加载顺序
| 顺序 | 文件 | 职责 |
|------|------|------|
| 1 | `KB_联创杰/KB_00_联创杰_Navigation_Map.md` | 路由、红线、冲突裁决 |
| 2 | `KB_联创杰/KB_MANIFEST.json` | 机器可读加载策略、证据等级 |
| 3 | `KB_SA/SYSTEM_PROMPT_Agent1_v1.67.md` | 产品规范、Scope Item 两步法 |
| 4 | `KB_SC/PROMPT_SC_Agent_Runtime_v2.1.md` | Fiori 操作、云原生拦截、异常处理 |
SA 导航：`KB_SA/KB_00_Navigation_Map.md` | SC 导航：`KB_SC/KB_00_SC_Navigation_Map.md`
## Issue Ledger
```
$KB = issues-ledger/
$ISSUES = issues-ledger/issues/
```
- 仅 C/E 类诊断触发搜索。用 `rg -n "关键词" issues-ledger/` 搜索
- 未经顾问确认，不创建/不改状态/不写入
- 状态变更须过 checklist 准入（硬门/软门）
- ledger 搜索用 `rg`，不用 `grep`
## 不在范围 / 不得处理
### Issue 自动上传 Git 仓库（固定规则）
每次完成一次 issue 记录后，必须把结果同步到项目 Git 仓库，不再逐次询问。
- 远端仓库：`git@118.31.18.126:bos-project-kb/lianchuangjie-project-kb.git`（分支 `master`）
- 同步步骤：
1. `git add -A` 该目录
2. `git commit -m "issue: <一句话概括本次变更>"`
3. `git push origin master`
- push 被拒时：先 `git pull --rebase origin master`；冲突时停下向顾问报告
---
- On-Premise 工具（SE16N/SE11/SPRO/SM30/SM31/ABAP/调试器/直连底表）— 公有云没有
- RICEFW/第三方系统内部逻辑 — 只答 SAP 触点、数据方向、替代手工步骤
- 状态为`上线中`/`开发中`/`有故障`的接口 — 不得回答为已稳定上线
## 铁律（Agent 必须遵守）
### 0. 云原生拦截
S/4HANA Cloud 不存在：SE16N/SE11/SE16、SPRO/IMG、SM30/SM31、经典 GUI 事务、ABAP/Z 开发、底表。即将输出上述内容时先停下，走替代流程（查 KB → Fiori App / SSCUI / Application Jobs）。无法确认时默认判为 On-Premise。
### 1. 开场分类
第一条回复必须输出分类：
```
【请求类型】A-知识查询 / B-SAP操作 / C-问题诊断 / D-边界判断 / E-客户问题处理
【运行模式】全模式
【知识层】将引用：联创杰 KB / SC Base / SA KB
```
### 2. 查来源再开口
输出包含 `来源：文件名§章节`。无来源不给结论，用 `KB未覆盖`/`我不确定`。
### 3. 生产系统二次确认
执行写操作前确认系统环境。P 系统创建/修改/删除/批量/资金操作须顾问文字确认。
### 4. C/E 诊断四步
1. `KB_07` → 2. `KB_08` + `KB_06` → 3. `issues/` → 3b. `KB_04/09/10` → 4. 升级。每步说明"已查，有/无结果"。
### 5. 集成只答触点
BTP/飞书/金税/AI询报价只答：触发条件、数据方向、SAP 侧状态、接口状态、替代手工步骤、异常处理。不推断外部系统内部逻辑。
### 6. 冲突停下不自决
信息冲突或涉及合规/资金/批量操作时，列出冲突点和来源，等顾问确认。
### 7. E 类双输出
必须分两个分区：`【给客户的信息】`（友好，不暴露 KB/Issue/日志路径）+ `【给顾问的内部分析】`（完整技术分析含来源）。
## 回答红线
- 找不到证据回答 `KB未覆盖` 并说明已检查的文件
- `待确认`/`开发中`/`有故障` 等内容不得回答为已完成
- 不输出 OP-only 事务码、底表、ABAP
- 结论区分 `已验证事实` / `基于上下文的推断` / `我不确定`
---
## 标准事实口径
- `已验证事实`：能回溯到 `KB_联创杰` 已摘录事实、`KB_SC`、`KB_SA`、`KB_99` 归档来源索引或官方资料。
- `基于上下文的推断`：基于多份资料形成的保守归纳，必须说明依据和不确定边界。
- `我不确定`：当前资料无法证明，或没有更新证据。
---
## Owner
| 项 | 值 |
|----|-----|
| KB 维护 Owner | 戴堂亮（项目经理） |
| FICO 顾问 | 蔡林艳 |
| SD/MM 顾问 | 朱智 |
| 更新触发 | 蓝图决策变更、配置选择更改、里程碑完成、上线问题 |
| 更新频率 | 周级（跟项目里程碑） |
| 退役条件 | 项目收尾归档，不再更新 |
## 关联KB
- **SA KB**：`KB_SA/` 目录（产品选型/功能边界）
- **SC KB**：`KB_SC/` 目录（标准操作步骤）
- **本项目KB**：`KB_联创杰/` 目录（客户专属决策/真实值/特例）
## 上线前自检清单
- [ ] 没有抄 Base 已有的官方步骤（只写差异）
- [ ] 所有对 Base 的引用是完整文件名 + 章节
- [ ] 每条决策有日期/负责人/依据
- [ ] 真实值已覆盖并标注 Base 占位值
- [ ] 未含产品选型/功能判断（那是 SA KB）
- [ ] 与 Base 官方步骤的冲突点已显式标注、由人确认
- [ ] 未决问题有状态，已决的及时更新
- [ ] 每条上线问题记录有负责人+目标解决日期
---
*AGENTS.md | 联创杰 SAP 售后支持 Agent | v1.0 | 2026-08-21*
KB_00_联创杰_Navigation_Map.md 0 → 100644
View file @ 55df49e2
# KB_00 联创杰 Navigation Map
---
doc_type: kb_navigation_map
load_policy: ALWAYS — 每次对话无条件加载到上下文，不依赖RAG检索
purpose: 定义联创杰项目KB全部文件的定位、分工与调用逻辑，是所有项目知识查询的前提导航图
kb_version: v1.0
---
## 一、文件定位
**联创杰项目KB** 是深圳联创杰科技有限公司 SAP S/4HANA Cloud Public Edition 项目（芯片贸易/半导体分销，已上线运营）的专属知识库。
它不是产品手册，也不是标准流程库——它只沉淀 **本项目独有的三类信息**：
| 信息类型 | 含义 | 典型例子 |
|---------|------|---------|
| **项目真实值** | 本项目实际使用的组织结构与主数据取值 | 14个公司码（1000/1019/1020/1210/1218/1219/1221/1223/1224/1225/1310/1320/3010/3020）、税率编码对照、付款条件编码对照 |
| **项目差异** | 与SAP标准/Best Practice不同的客户化决定 | 清账逻辑、预付款转销方式、金税开票对接口径 |
| **项目历史** | 已发生的决策、事件与处理记录 | 蓝图V1.4（2023-11-14）、上线切换、月结问题处置 |
> 凡SAP标准产品通用知识（怎么配、怎么跑、支不支持），交由 **SA KB / SC KB** 回答；
> 凡"我们项目是怎么定的、真实值是什么、哪里和标准不一样"，才由本KB回答。
### 1.1 三层路由定义
```
第一层 KB_00（本文件） ← 分流层：判断问题属于哪个文件、按什么优先级回答
↓ 按 §六 快速分流 定位目标文件
第二层 KB_01 ~ KB_11 ← 承载层：单主题文件，含结论 + 真实值 + 差异 + 历史
↓ 条目内引用需要溯源时
第三层 KB_99 + DOC 原文 ← 证据层：证据索引（DOC-001~020 映射、等级、位置），
必要时回查原始文档（.doc/.docx/.xlsx）
```
规则：
- 第一层常驻上下文；第二层按需加载 **单个** 目标文件；第三层仅在需要取证时打开
- 任何第二层条目必须能向下落到第三层（DOC编号 + §位置）；落不到的条目视为未验证
---
## 二、回答优先级
同一问题多来源冲突时，按以下四级顺序取用（高优先级覆盖低优先级）：
| 级别 | 来源 | 使用规则 |
|------|------|---------|
| **P1** | 项目KB条目（KB_01~KB_11，含证据等级） | 直接回答，引用 `[KB_xx §n]` |
| **P2** | 项目原始文档（DOC-001~020） | KB未收录但有原文时使用；回答后应提示"建议补录进KB" |
| **P3** | 标准产品KB（SA KB / SC KB） | 仅回答标准产品行为；必须声明"项目KB暂未收录，以下为标准产品行为" |
| **P4** | 训练记忆/通用知识 | **禁止作为事实输出**。只能以「需核实」提示出现，且不得带具体取值 |
> P1 内部冲突：以证据等级高者为准（等级见 KB_MANIFEST.json `evidence_levels`）；
> 同级冲突 → 登记差异，提交域Owner裁决，回答中如实说明两处来源。
---
## 三、脱源运行规则
**脱源运行** = Agent 在无法读取 `.doc/.docx/.xlsx` 原始文档的环境下（如纯对话、API调用、跨机部署），仍能凭KB本身正确工作。规则：
1. **条目自包含**：每个KB条目必须写全五要素——结论、关键数值/取值、来源 `[DOC-xxx §位置]`、文档日期、证据等级。缺任何一项即视为未验证（按P4处理）
2. **不依赖实时读原文**：正常回答禁止要求"等我读一下docx"；只有用户质疑条目本身时才回查原文（第三层）
3. **原文与KB冲突**：以证据等级高者为准；若等级相同，以KB为准并立即登记差异走发布治理（§四）
4. **KB未覆盖**：明示「项目文档未覆盖，请向域Owner确认」，禁止用训练记忆填补（同SA KB模式零禁令）
5. **临时文件排除**：`~$*`、`~WRL*.tmp` 等Office临时文件永不作为证据来源
---
## 四、发布治理
| 角色 | Owner | 职责 |
|------|-------|------|
| 全局 / 发布批准 | **戴堂亮（项目经理）** | 跨域一致性、发布批准、GAP裁决 |
| FI / CO / AA / EC-CS | **蔡林艳（FICO负责人）** | KB_02~KB_08 内容审核 |
| SD / MM / QM | **朱智（SD/MM负责人）** | KB_09、KB_10 内容审核 |
**变更流程**：提出（注明DOC依据）→ 域Owner审核内容与证据等级 → 戴堂亮批准 → 更新对应 KB_xx 与 KB_99 → 刷新 KB_MANIFEST.json `updated_on` 及 `operational_governance.kb_version`
### 4.1 运行质量与机器清单
**机器清单（KB消费方）**：
| 运行环境 | 用途 | 加载策略 |
|---------|------|---------|
| opencode · SA Agent（模式零） | 项目事实查询 | ALWAYS 加载 KB_00 + 按路由加载单目标文件 |
| opencode · SC Agent（操作支持） | Fiori操作/配置支持 | 客户项目KB（本库）优先于 SC Base KB / 蓝图 |
| 人工查阅（交接/审计） | 顾问交接、内审外审 | 按 §六 分流直接阅读 |
**运行质量指标**：
- 引用可溯率 = 100%（每条回答必须能落到 KB_xx §n 或 DOC 编号）
- L3+（双源以上验证）条目占比持续提升；L0 条目不得超过总数 5%
- 红线（§五）违规零容忍；每月抽查 ≥10 条 L2+ 条目回溯原文
- 发现违规/过期条目当次修正，并在月度抽查中复盘
---
## 五、回答红线
1. **组织真实值只来自KB**：14个公司码及销售组织/工厂/采购组织等取值，禁止生成任何KB未收录的组织值
2. **范围外模块不得当作已实施**：PP、WM/EWM、PM、PS、HCM、Treasury 不在范围内；相关问题引导至标准KB并注明"项目未实施"
3. **集成方向不得颠倒**：BTP=双向、飞书=双向、金税=SAP→外部、AI询报价=外部→SAP
4. **禁止用标准默认值冒充项目配置**：清账逻辑、预付款转销、付款条件编码、税率编码等必须引用项目KB真实值
5. **x.x.x 格式"Scope Item ID"=幻觉**：沿用SA KB格式守卫，立即删除（合法ID为2~4位字母数字）
6. **敏感文件拒答**：《联创杰系统账号密码.docx》相关内容一律不读取、不摘录、不分发
7. **无证据必声明**：KB与标准KB均未覆盖时，明示「未覆盖，请向域Owner确认」，禁止编造DOC编号或虚构项目决策
---
## 六、快速分流
| 问题类型 / 触发词 | 目标文件 |
|------------------|---------|
| 项目概况、实施范围、公司码、BP-01~12域划分 | KB_01 |
| 总账GL、资产会计AA、折旧 | KB_02 |
| 应收应付AR/AP、清账逻辑、预付款转销、付款条件 | KB_03 |
| 税率、税务编码、金税开票 | KB_04 |
| 外币评估、汇率 | KB_05 |
| 月结、期末结账、试算平衡表核对 | KB_06 |
| CO成本控制、管理报表 | KB_07 |
| 合并报表、EC-CS | KB_08 |
| SD销售、定价、AI询报价 | KB_09 |
| MM采购、库存、QM质量 | KB_10 |
| 接口与集成总览（BTP/飞书/金税/AI询报价/FICO接口清单） | KB_11 |
| 溯源、证据等级、文档清单、验收/审计记录 | KB_99 |
---
## 七、标准回答模板（3级）
**Level A —— 有项目证据（P1命中）**
```
【结论】……
【依据】[KB_xx §n] ← [DOC-xxx 文档名，yyyy-mm-dd]
【等级】L2/L3/L4 【差异】与标准的差异点（如有）
```
**Level B —— 标准KB支撑（项目KB未收录）**
```
【结论】……（SAP标准行为）
【来源】SA/SC KB 文件名 §章节
【声明】项目KB暂未收录本条，以下为标准产品行为，项目实际取值请向域Owner确认
```
**Level C —— 无证据**
```
项目KB与标准KB均未覆盖此问题。
请向域Owner确认：FICO/CO/AA/EC-CS → 蔡林艳；SD/MM/QM → 朱智；全局 → 戴堂亮。
（不给任何推断性答案或猜测取值）
```
---
## 八、当前文件清单
| 文件 | 内容 | 状态 |
|------|------|------|
| KB_00_联创杰_Navigation_Map.md | 本导航图（常驻上下文） | ✅ v1.0 |
| KB_01_项目概览与组织结构.md | 项目背景、范围内外、14公司码、BP-01~12 | 待建 |
| KB_02_GL总账与资产会计.md | 科目/凭证流/AA折旧 | 待建 |
| KB_03_AR_AP清账与预付款.md | 清账逻辑[DOC-007]、预付款转销[DOC-009]、付款条件[DOC-010] | 待建 |
| KB_04_税务与金税接口.md | 税率编码对照[DOC-008]、金税对接 | 待建 |
| KB_05_外币评估.md | 外币评估配置与测试[DOC-011] | 待建 |
| KB_06_月结与期末结账.md | 月结流程[DOC-005]、试算平衡核对[DOC-006] | 待建 |
| KB_07_CO与管理报表.md | 成本控制、管理报表设计[DOC-004] | 待建 |
| KB_08_合并报表_EC-CS.md | 合并报表配置与核对 | 待建 |
| KB_09_SD销售与AI询报价.md | 销售流程、定价、AI询报价集成 | 待建 |
| KB_10_MM采购与QM质量.md | 采购/库存/QM质检 | 待建 |
| KB_11_接口与集成总览.md | FICO接口清单[DOC-002]、BTP/飞书/金税/AI询报价方向 | 待建 |
| KB_99_EVIDENCE_INDEX.md | 证据索引（DOC-001~020 映射、等级、GAP登记） | 待建 |
| KB_MANIFEST.json | 运行清单（load_policy/治理/红线/审计节奏） | ✅ v1.0 |
| KB_ACCEPTANCE_TESTS/ | 验收用例目录 | 目录（AI_1/AI_2 pending） |
| KB_ACCEPTANCE_RESULTS/ | 验收结果目录 | 目录（随验收回写） |
---
*v1.0 | 2026-08-21 | 联创杰项目KB | 发布批准：戴堂亮 | 维护：蔡林艳(FICO)/朱智(SD·MM)*
KB_01_项目概况与问答范围.md 0 → 100644
View file @ 55df49e2
# KB_01 项目概况与问答范围
> **项目**：深圳联创杰科技有限公司 SAP S/4HANA Cloud Public Edition 实施项目
> **版本**：v1.0 | 2026-08-23 | Owner：戴堂亮（项目经理）
> **加载策略**：ALWAYS —— 回答任何联创杰问题前先读本文件确定问答边界
---
## 1. 文档定位
本文件定义联创杰项目 KB **能答什么、不能答什么**。KB 内固化三类信息：
| 信息类型 | 内容 | 存放位置 |
|---------|------|---------|
| ① 项目事实 | 客户真实组织值、主数据约定、蓝图决策、实施范围、干系人 | KB_01 / KB_02 系列 |
| ② 特例与触点 | 与标准操作不同的客户化做法、外部系统集成约定 | KB_02 系列 + 后续特例文件 |
| ③ 未决事项 | 待确认项、文档间差异、缺失信息（显式标注 `[待补充]`） | 各文件内联标注 |
**脱源运行口径**：本 KB 为脱源版——所有事实已从源文档（DOC-001~DOC-020）提炼固化为 KB 条目。Agent 回答时以 **KB 条目本身为事实来源**，并标注来源 DOC 编号；不依赖实时解析 `.doc`/`.docx`/`.xlsx` 原件，原件仅供人工复核。凡 KB 未覆盖的事实，一律回答「项目文档未覆盖」，禁止推断补齐。
---
## 2. 已验证项目概况
| # | 结论 | 已验证依据 |
|---|------|-----------|
| 1 | 客户为深圳联创杰科技有限公司，主营芯片贸易（半导体分销） | DOC-001 蓝图 §项目背景 |
| 2 | 系统：SAP S/4HANA Cloud Public Edition | DOC-001；S4HANA Cloud ES配置财务V1.0-联创杰.docx |
| 3 | 项目 2023 年启动；蓝图 V1.4（终版）签字于 2023-11-14；当前状态：已上线运营 | DOC-001；交接清单 |
| 4 | 实施模块：FI、CO、MM、SD、QM、AA（资产会计）、EC-CS（合并报表） | DOC-001；合并报表/ 目录文档印证 EC-CS |
| 5 | 明确不在范围：PP、WM/EWM、PM、PS、HCM、Treasury（司库） | DOC-001 范围章节；无相关配置/操作文档印证 |
| 6 | 外部集成 4 个：BTP（双向）、飞书（双向）、金税（SAP→外部）、AI询报价（外部→SAP） | FICO接口文档20240729/ 下各接口设计文档 |
| 7 | 组织：14 个公司代码（1000/1019/1020/1210/1218/1219/1221/1223/1224/1225/1310/1320/3010/3020）；工厂 1310（深圳工厂）；库存地点 131A~131K | 交接清单；部分名称经 P系统主数据/成本中心621.xlsx 印证（详见 KB_02_01 ⚠️差异提示） |
| 8 | CO 顶层：经营范围 1000、控制范围 1000；科目表 YCOA（蓝图规划值为 LCJ/LCJ1，见 KB_02_01 待核实项） | DOC-001 蓝图 §1 编码规则；交接清单 |
| 9 | 关键干系人：项目经理戴堂亮；FICO 顾问蔡林艳；SD/MM 顾问朱智 | 交接清单 |
### 2.1 版本取用规则
同一主题存在多个版本文档时，按以下顺序取用：
1. **文件名带 `-已完成` 标记的版本优先**于无标记版本；
2. **版本号新者优先**：蓝图取 V1.4（终版），接口设计取 FICO接口文档20240729 目录下 `-已完成` 版本，配置文档取 V1.0；
3. **系统实际值 > 文档记录值**：文档与 P 系统实际冲突时，以系统为准并回写 KB、登记差异；
4. 无法判定版本取舍的 → 回答「需人工核实」，不得任选其一作答。
---
## 3. 本项目已覆盖的问答域
蓝图 V1.4 定义 12 个业务域（BP-01~BP-12），为本 KB 问答覆盖范围：
| 蓝图域 | 名称 | 覆盖主题 |
|--------|------|---------|
| BP-01 | 物料主数据维护流程 | 贸易物料经 BTP 接口创建；非贸易物料 SAP 手工导入；物料类型/批次规则 → KB_02_02 |
| BP-02 | 业务合作伙伴维护流程 | 客户/供应商账户组 Z001/Z002/Z003；信贷信息经 BTP 维护传输 → KB_02_02 |
| BP-03 | 芯片贸易主场景 | 12 个子场景：销售退换货(-001)、采购退换货(-002)、赠品采购(-003)、采购入库检验(-004)、报关(-005)、寄售采购(-006)、客户收款(-007)、供应商付款/预付(-008)、应收款挂账(-009)、应付款挂账(-010)、客户清账(-011)、供应商清账(-012) |
| BP-04 | 公司间交易业务场景 | 同公司调拨(-001)、拆包(-002)、物料转换(-003)；公司间采购订单类型 Z003 |
| BP-05 | 库存检验业务场景 | 库存盘点(-001)、库存报废(-002)；盘点凭证 WI 自动生成 |
| BP-06 | 总账业务场景 | 总账凭证录入（SA）；凭证类型与编号范围 → KB_02_01 |
| BP-07 | 金税集成业务场景 | SAP 发票号驱动金税开票；红字发票(-001)、取消发票(-002) |
| BP-08 | 资产管理业务场景 | 折旧(-001)、盘点(-002)、调拨(-003)、报废(-004)、增值(-005)、减值(-006)；AA 凭证类型 AA/AF |
| BP-09 | 费用报销业务场景 | 费用报销入账路径 |
| BP-10 | 员工借款业务场景 | 员工供应商账户组 Z003 挂账与清账 |
| BP-11 | 财务月结业务场景 | 月结作业顺序、折旧运行、物料分类账 ML 凭证 |
| BP-12 | 财务年结业务场景 | 年结结账路径 |
---
## 4. 适合直接回答的问题
满足以下全部条件的提问可基于本 KB 直接回答（须附来源）：
- 问的是**本项目已固化的真实值**：公司代码/工厂/库存地点/税码/付款条件/单据类型/科目表/控制范围等 → KB_02_01、KB_02_02；
- 问的是**蓝图范围内业务怎么走**：上表 BP-01~BP-12 对应的场景流程与凭证流；
- 问的是**范围边界**：某模块/功能在不在联创杰实施范围内（对照第 2 条第 4/5 行）；
- 问的是**集成触点**：BTP/飞书/金税/AI询报价 与 SAP 的交互方向和触发点。
## 5. 不宜直接下结论的问题
以下提问**禁止**仅凭训练记忆或推断回答：
- 第 2 节表格中带 `[待补充]` 标注的字段（如销售组织/采购组织编码、公司代码全称中未经印证的部分、信贷控制范围）→ 回答「待补充，需向项目经理/模块顾问确认」；
- 涉及 PP/WM/EWM/PM/PS/HCM/Treasury 的操作问题 → 明确告知不在联创杰实施范围，Base KB 内容仅供产品参考；
- 产品功能边界问题（"2602 支不支持 XX"）→ 转 SA KB（KB_SA/FSD_*），项目 KB 不做产品判断；
- 外部系统内部逻辑（飞书/BTP 内部实现、金税底层）→ 只回答触点约定，不推断外部系统内部机制；
- 文档间存在差异且无法裁决的事实（如科目表 LCJ/LCJ1 vs YCOA、P 系统公司代码编号段差异）→ 如实呈现双方来源，标注「需人工核实」。
---
## 6. 与 Base KB 的边界
标准操作步骤一律引用 Base KB，项目 KB 不重写官方步骤。映射关系：
| 业务主题 | Base KB 引用文件（KB_SC/） | 备注 |
|---------|---------------------------|------|
| 库存销售（订单→交货→开票） | KB_SD_BD9_Sell-from-Stock.md | 联创杰主场景 BP-03 |
| 销售退换货 | KB_SD_BKP_Customer-Returns.md；KB_SD_BDD_Lean-Customer-Returns.md | BP-03-001 |
| 免费订单/赠品发出 | KB_SD_BDA_Free-of-Charge-Delivery.md；KB_SD_BKA_Free-Goods-Processing.md | BP-03-003 |
| 一次性客户 | KB_SD_BDH_One-Time-Customer.md | BP-02 |
| 公司间销售（境内/国际） | KB_SD_1HO_Intercompany-Sales-Domestic.md；KB_SD_1MX_Intercompany-Sales-International.md | BP-04 |
| 采购直采 | KB_MM_J45_Procurement-of-Direct-Materials.md | BP-03 主流程 |
| 退货给供应商 | KB_MM_BMK_Return-to-Supplier.md | BP-03-002 |
| 寄售采购 | KB_MM_BMY_Subcontracting.md 相邻场景；以蓝图 BP-03-006 为准 | 信息记录 NB 已启用 |
| 库存管理/转储 | KB_MM_BMC_Core-Inventory-Management.md；KB_MM_BME/BMH | BP-04 同公司调拨 |
| 盘点 | KB_MM_BML_Physical-Inventory.md | BP-05-001 |
| 采购入库检验 | KB_QM_1FM_Quality-in-Procurement.md；KB_QM_1MR_Quality-in-Stock-Handling.md | BP-03-004 |
| 总账与期末结账 | KB_FI_J58_Accounting-and-Financial-Close.md | BP-06/11/12 |
| 应收/收款清账 | KB_FI_J59_Accounts-Receivable.md | BP-03-007/-009/-011 |
| 应付/付款清账 | KB_FI_J60_Accounts-Payable.md | BP-03-008/-010/-012 |
| 资产会计 | KB_FI_J62_Asset-Accounting.md | BP-08 |
| 功能有无/Scope Item 选型 | KB_SA/（FSD_*.md、Scope_Selection_Guide.md 等） | 产品层，非项目层 |
> ⚠️ Base KB 中 KB_PP_*、KB_WM_*、KB_PM_*、KB_PS_* 所述能力**不在联创杰实施范围内**，仅供产品层面参考，不代表本项目交付内容。
---
## 7. 更新触发
| 触发事件 | 动作 |
|---------|------|
| 蓝图决策变更 / 配置选择更改 | 更新对应 KB 条目 + 记录日期与负责人 |
| `[待补充]` 字段取得真值 | 回填并删除占位标注，注明来源 |
| 上线后新问题/新解法 | 写入上线问题记录文件（后续建设），同步修订受影响条目 |
| 集成接口变更（BTP/飞书/金税/AI询报价） | 更新集成触点条目 |
| 文档间差异经人工裁决 | 更新结论 + 在「待核实项」中闭环登记 |
| Owner 变更 | 更新本文件头部 Owner 字段 |
---
*联创杰项目 KB v1.0 | 脱源版 | 2026-08-23 | 依据：DOC-001~DOC-020*
KB_02_01_财务与组织_真实值.md 0 → 100644
View file @ 55df49e2
# KB_02_01 财务与组织真实值
> **定位**：联创杰财务与 CO 组织的真实值，覆盖 Base KB 样例值。操作前必查。
> **来源**：DOC-001 蓝图 V1.4（2023-11-14）；DOC-003/DOC-004 主数据资料；DOC-008 税码资料；DOC-010 收付款条件；P系统主数据导出。
> **版本**：v1.0 | 2026-08-23
---
## 1. 公司代码（14 个）
| 公司代码 | 公司名称 | 币种 | 信贷控制范围 |
|---------|---------|------|-------------|
| 1000 | [待补充] | [待补充] | [待补充] |
| 1019 | [待补充] | [待补充] | [待补充] |
| 1020 | [待补充] | [待补充] | [待补充] |
| 1210 | 阜阳市颍州区旭海波电子产品经营部 * | CNY * | [待补充] |
| 1218 | 昌宁县荔沁电子经营部 * | CNY * | [待补充] |
| 1219 | 昌宁县仁志众城电子经营部 * | CNY * | [待补充] |
| 1221 | 昌江区启承电子产品经营部 * | CNY * | [待补充] |
| 1223 | 昌江区亿茜电子产品经营部 * | CNY * | [待补充] |
| 1224 | 昌江区盛强电子产品经营部 * | CNY * | [待补充] |
| 1225 | 新宾满族自治县仲邦威商贸中心 * | CNY * | [待补充] |
| 1310 | [待补充] | [待补充] | [待补充] |
| 1320 | [待补充] | [待补充] | [待补充] |
| 3010 | [待补充] | [待补充] | [待补充] |
| 3020 | [待补充] | [待补充] | [待补充] |
\* 名称经 `P系统主数据/成本中心621.xlsx` 成本中心主数据导出印证；币种按该导出货币字段（境内主体 CNY）记录。
> **⚠️ 差异提示（需人工核实）**：P 系统成本中心导出中出现的公司代码编号段为 **1001~1018、1201~1233、1401、1601、2001~2010、3001~3003、4001、5001、6001**（如 1001=深圳联创杰科技有限公司），与本表交接清单编号（1000/1019/1020/…）不一致。两套清单的对应关系未经人工裁决前，涉及具体公司代码的操作须先与项目经理确认。
## 2. CO 与总账顶层组织
| 对象 | 编码/值 | 说明 | 来源 |
|------|--------|------|------|
| 经营范围（Operating Concern） | 1000 深圳联创杰集团经营范围 | 集团定义一个 | DOC-001 §1 编码规则 |
| 控制范围（Controlling Area） | **1000** 深圳联创杰集团控制范围 | 一个控制范围分配多个公司代码 | DOC-001 §1 编码规则 |
| 运营科目表 | **YCOA**（交接确认值） | ⚠️ 蓝图 V1.4 规划值为 LCJ（集团科目表）/LCJ1（运营科目表），实际以系统为准，需人工核实 | 交接清单；DOC-001 §1 |
| 科目编码位数 | 总账科目 10 位；二/三/四级各 2 位字符，缺层用 01/00 补足（例：银行存款 1002010000） | | DOC-001 §科目编码 |
## 3. 利润中心与成本中心
### 利润中心
- 口径：**一个集团一个利润中心**
- 利润中心编码：`LCJ01`（联创杰通用利润中心）——来源：DOC-001 §利润中心 编码规则
### 成本中心
- 编码规则：8 位
- 示例（经 P 系统导出印证，公司代码 1001 名下）：
| 成本中心 | 名称 | 类别 |
|---------|------|------|
| CL81 | 人事&行政部 | L (管理) |
| CL82 | 品牌宣传部 | L (管理) |
| CL83 | IT信息部 | L (管理) |
| CL86 | 董事会 | L (管理) |
| CL87 | 物流&质检部（下设 CL8701 品控质检分部、CL8702 深圳物流分部、CL8703 香港物流分部） | L (管理) |
| CL88 | 订单财务部（下设订单管理组 CL8801 / 税务组 CL8802 / 综合账务组 CL8803 / 出纳组 CL8804） | L (管理) |
| CV83 | 销售部（综合销售部 CV8301 / 终端销售部 CV8302） | V (销售) |
| CV84 | 库存销售部 | V (销售) |
| CV85 | 渠道开发部（ADI组/TI组/专员组/全球组/OEM组/Sourcing组等） | V (销售) |
| CV86 | PMC部 | V (销售) |
- 完整清单：`P系统主数据/成本中心621.xlsx` 及 `联创杰主数据.zip → 成本中心&利润中心/`
- 注意：部分成本中心有效期至 2024-05-31 已删除（如 CL84、CL89、CV85 系列部分分组），取值时核对有效期。
## 4. 凭证类型（FI）
**交接确认启用值**：DR / RE / RK / SA / SB / SS —— 来源：交接清单（DOC 系列）。
蓝图 V1.4 规划的完整凭证类型及编号范围（供对照）：
| 凭证类型 | 说明 | 编号范围 | 适用场景 |
|---------|------|---------|---------|
| SA | 总账科目凭证 | 0100000000-0199999999 | 手工总账凭证 |
| AB | 冲销会计凭证 | 0200000000-0299999999 | 系统自动生成 |
| AA | 资产过帐 | 0300000000-0399999999 | 资产购置/处置，手工 |
| AF | 折旧过帐 | 0400000000-0499999999 | 系统自动生成 |
| KR | 供应商发票 | 0500000000-0599999999 | 形式发票生成，自动 |
| KZ | 供应商付款 | 0600000000-0699999999 | 手工 |
| DR | 客户发票 | 0700000000-0799999999 | 形式发票生成，自动 |
| DZ | 客户付款 | 0800000000-0899999999 | 手工 |
| WA | 内部发货凭证 | 0900000000-0999999999 | 公司间发货，自动 |
| WE | 收货凭证 | 1000000000-1099999999 | 采购收货，自动 |
| WL | 外部客户交货 | 1100000000-1199999999 | 销售发货，自动 |
| WI | 库存盘点凭证 | 1200000000-1299999999 | 盘点，自动 |
| ML | 物料分类账凭证 | 1300000000-1399999999 | 月末自动 |
| PR | 物料价格更改 | 1400000000-1499999999 | 自动 |
| RV | 手工开票凭证 | 1500000000-1599999999 | 自动 |
| M6 | 外汇评估 | 1600000000-1699999999 | 外币汇兑损益，自动 |
| ZZ | 期初导入凭证 | 9100000000-9199999999 | 上线期初 |
> RK / SB / SS 的中文语义与编号范围为交接清单简记，明细 `[待补充]`；蓝图未单列这三个类型，需人工核实其定义。
## 5. 税码
**交接确认启用税码**——来源：DOC-008：
| 类别 | 税码 |
|------|------|
| 国内（进项/销项及相关） | J1、J2、J3、J4、J6、J7、J8、J9、JV0、JV2、JVA、JVC |
| 进口 | JA1、JA2、JC1、JC2 |
> **⚠️ 待核实**：`税码和收付款条件.xlsx` 工作表 1 记录的是 SAP 标准 CN/HK/GB/TH/SG/US 税码参考清单（CN 段含 J0/JB/JC、O1-OX、X/Y/R 系列等），与上表启用集不一致。各税码的税率、方向（进项/销项）、自动记账科目明细以系统「定义税码」配置为准（SSCUI 路径见 `KB_SC/KB_CONFIG_FI.md`），差异需人工核实后回写本表。
## 6. 付款条件
结构化规则（来源：DOC-010 `收付款条件20240611.XLSX`，已验证）：
| 付款条件 | 描述 | 规则 |
|---------|------|------|
| S001 | 款到发货 | 即期 |
| S002 | 现款现结 | 即期 |
| S003 | 货到付款 | 即期 |
| S004~S183 | 货到 N 天付款 | N = 1~180，天数 = 编号 - 3；日期类型 B |
- 客户/供应商主数据按业务约定从上表中选取；Base KB 操作步骤参见 `KB_SC/KB_MASTERDATA_Customer.md` / `KB_MASTERDATA_Supplier.md`。
- 相关规程：`应收应付账款核销管理规程.docx`、`预收账款切换计划.xlsx`、`清账逻辑.xlsx`（清账特例后续沉淀至操作特例文件）。
## 7. 银行主数据结构
三层结构（来源：DOC-001 §银行主数据）：
1. **银行代码**（Bank）：每个银行单位（总行/分行/分理处）唯一代码；含本单位及客户/供应商银行；
2. **开户银行（House Bank）**：在各公司代码下维护的本单位开户银行标识；
3. **账户标识（Account ID）**：开户银行下的账户代码；一个开户银行可挂多个不同用途/币种账户（人民币活期、美元定期等）。
完整账户清单归档于 `联创杰主数据.zip → 银行主数据.xlsx`、`银行主数据（2024.04.16）.xlsx`。各公司代码开户行明细 `[待补充]`。
---
*联创杰项目 KB v1.0 | 2026-08-23 | 未尽事项以系统实际配置为准*
KB_02_02_销售与采购_真实值.md 0 → 100644
View file @ 55df49e2
# KB_02_02 销售与采购真实值
> **定位**：联创杰 SD/MM 组织与单据类型真实值，覆盖 Base KB 样例值。操作前必查。
> **来源**：DOC-001 蓝图 V1.4（2023-11-14）§组织结构/§单据类型定义/§主数据；交接清单。
> **版本**：v1.0 | 2026-08-23
---
## 1. 销售组织
| 对象 | 值 | 说明 |
|------|-----|------|
| 销售组织 | **[待补充]** | 蓝图注明"具体销售组织清单见附件EXCEL"，附件未归档；需向 SD 顾问（朱智）索取 |
| 分销渠道 | [待补充] | 清单同上，见附件 EXCEL |
| 产品组 | `00` 通用产品组 | DOC-001 §产品组 编码规则（已验证） |
| 销售办公室 | 4 位编码 | 蓝图口径：销售办公室按利润中心概念管控；清单见附件 EXCEL |
| 发货工厂 | `1310` 深圳工厂 | 交接确认 |
| 库存地点 | 131A / 131B / 131C / 131D / 131E / 131H / 131K | 隶属工厂 1310；各仓用途描述 `[待补充]` |
## 2. 采购组织
| 对象 | 值 | 说明 |
|------|-----|------|
| 采购组织 | **[待补充]** | 编码共 4 位；蓝图明确"联创杰采购组织与公司代码及工厂一一对应"；清单见附件 EXCEL |
| 采购组 | [待补充] | 全局单元，不分配给采购组织/公司代码，可跨公司使用 |
| 寄售采购信息记录 | 已启用 | 类型 NB，编号范围 5300000000-5399999999（DOC-001 §采购信息记录） |
## 3. 单据类型
### 3.1 交接确认的 SD 单据类型
DL / CS / CR / RE / SD —— 来源：交接清单。各类型的完整中文语义、编号范围 `[待补充]`，与下表蓝图的对应关系需人工核实。
### 3.2 蓝图 V1.4 规划值（供对照）
**销售订单类型**
| 订单类型 | 描述 | 编号范围 | 外部给号 |
|---------|------|---------|---------|
| OR | 贸易订单 | 110000000-119999999 | 否 |
| CBFD | 免费订单 | 120000000-129999999 | 否 |
| DR | 借项订单（结完账客户多给钱） | 130000000-139999999 | 否 |
| CR | 贷项订单（客户不退货要退款） | 140000000-149999999 | 否 |
| CBRE | 退换货订单 | 150000000-159999999 | 否 |
**交货单类型**
| 类型 | 描述 | 编号范围 |
|------|------|---------|
| LF | 销售交货单 | 80000000-89999999 |
| LR | 退货交货单 | 84000000-84999999 |
**销售发票类型**
| 类型 | 描述 |
|------|------|
| F2 | 发票 |
| S1 | 发票作废 |
| CBRE | 退货贷记（有实际退货的退票） |
| IV / IVS | 公司间出具发票 / 取消公司间发票 |
| CBST | 库存转储单的公司间开票 |
| CIIG | 内部 CM STO 退货 |
| G2 / S2 | 贷项凭证 / 取消贷项凭证 |
| L2 | 借项凭证 |
以上开票类共用编号范围 90000000-94999999，内部给号。
**采购订单类型（MM）**
| 类型 | 描述 | 编号范围 |
|------|------|---------|
| NB | 标准采购订单 | 4500000000-4599999999 |
| Z001 | 退货采购订单 | 同上 |
| Z002 | 资产采购订单 | 同上 |
| Z003 | 公司间采购订单 | 同上 |
| Z004 | 寄售采购订单 | 同上 |
内部给号。
## 4. 客户分组
- 业务总体分类（DOC-001 §客户主数据）：**经销商、电商、大客户、公司间客户、一次性客户**
- 客户账户组（与业务伙伴账户组绑定，每组合独立号码段）：
| 账户组 | 描述 | 编码范围 | 外部给号 |
|--------|------|---------|---------|
| Z001 | 外部供应商/客户 | 1000001-1999999 | 否（内部给号） |
| Z002 | 法人供应商/客户 | 1001-9009 | 是（外部给号） |
| Z003 | 员工供应商/客户 | 1-999999 | 否（内部给号） |
- 公司间交易：BP 的信贷关系及集团关系通过 BTP 前台维护后接口传输至 SAP；采购组织/销售组织/公司代码层数据由接口按规则自动填充（BP-02 约定）。
- 操作步骤引用：`KB_SC/KB_MASTERDATA_Customer.md`
## 5. 物料
**物料类型及编码范围**（DOC-001 §物料类型，已验证）
| 物料类型 | 描述 | 编码从 | 编码到 | 给号规则 |
|---------|------|--------|--------|---------|
| HAWA | 库存商品 | 100000000 | 199999999 | 内部给号 |
| Z001 | 资产 | A00000001 | A99999999 | 内部给号 |
- 维护路径：贸易物料由 BTP 获取标准数据库基本信息，接口传输至 SAP 并同步填写各视图；非贸易物料在 SAP 手工导入（BP-01）。
- 物料组：贸易物料以**品牌**作为物料组；非贸易物料按实际物料分组细分。
- 批次：批次编码由 BTP 前端按单据流水号截取 10 位数字传输至 SAP；批次特性分类类型 022/023。
- 操作步骤引用：`KB_SC/KB_MASTERDATA_Material.md`
## 6. 供应商分类
- 供应商分类代码为 4 位（明细清单见蓝图附件，`[待补充]`）；
- 供应商账户组（与客户共用一套 BP 账户组）：
| 账户组 | 描述 | 编码范围 | 外部给号 |
|--------|------|---------|---------|
| Z001 | 外部供应商/客户 | 1000001-1999999 | 否 |
| Z002 | 法人供应商/客户 | 1001-9009 | 是 |
| Z003 | 员工供应商/客户（用于 BP-10 员工借款挂账） | 1-999999 | 否 |
- 操作步骤引用：`KB_SC/KB_MASTERDATA_Supplier.md`
---
*联创杰项目 KB v1.0 | 2026-08-23 | 未尽事项以系统实际配置为准*
KB_02_组织与主数据_真实值.md 0 → 100644
View file @ 55df49e2
# KB_02 组织与主数据真实值（已拆分）
> **定位**：联创杰客户真实组织编码与主数据约定，用于覆盖 Base KB 中的占位/样例值（如工厂 1310、组织 1310 等 SC KB 样例）。
> **加载策略**：按需——Agent 操作前必须先查对应子文件取真实值。
> **版本**：v1.0 | 2026-08-23 | Owner：戴堂亮（项目经理）
---
## 子文件列表
| 子文件 | 内容 | 数据状态 |
|--------|------|---------|
| `KB_02_01_财务与组织_真实值.md` | 公司代码、控制范围/经营范围、科目表、利润中心/成本中心、FI 凭证类型、税码、付款条件、银行账户结构 | 部分字段 `[待补充]`，含 ⚠️ 差异提示 |
| `KB_02_02_销售与采购_真实值.md` | 销售组织、采购组织、销售订单类型、交货类型、客户组、物料类型、供应商分类 | 组织编码 `[待补充]` |
---
## 快速路由
| 要查什么 | 去哪个文件 |
|---------|-----------|
| 公司代码及名称、币种、信贷控制范围 | KB_02_01 §1 公司代码 |
| 控制范围 / 经营范围 / 科目表 | KB_02_01 §2 CO 与总账顶层组织 |
| 利润中心 / 成本中心 | KB_02_01 §3 利润中心与成本中心 |
| FI 凭证类型（DR/RE/RK/SA/SB/SS 等） | KB_02_01 §4 凭证类型 |
| 税码（J 系列 / JA / JC 系列） | KB_02_01 §5 税码 |
| 付款条件（S001~S183） | KB_02_01 §6 付款条件 |
| 银行账户结构 | KB_02_01 §7 银行主数据 |
| 销售组织 / 分销渠道 / 产品组 | KB_02_02 §1 |
| 采购组织 / 采购组 | KB_02_02 §2 |
| 销售订单 / 交货 / 开票单据类型 | KB_02_02 §3 单据类型 |
| 客户分组与账户组 | KB_02_02 §4 客户 |
| 物料类型 / 物料组 / 批次 | KB_02_02 §5 物料 |
| 供应商分类与账户组 | KB_02_02 §6 供应商 |
---
## 回答边界
- 本目录只存**联创杰真实值与约定**；标准配置方法与操作步骤一律引用 Base KB（`KB_SC/KB_CONFIG_*.md`、`KB_SC/KB_MASTERDATA_*.md`），不重写；
- 标注 `[待补充]` 的字段**不得猜测作答**，回答时明确「待补充，需人工确认」；
- ⚠️ 已知差异（P 系统公司代码编号段 vs 交接清单、科目表 YCOA vs 蓝图 LCJ/LCJ1）如实呈现双方来源，未经人工裁决不得单边采信；
- 主数据完整清单以归档原件为准：`P系统主数据/成本中心621.xlsx`、`联创杰主数据.zip`（会计科目/银行主数据/原因代码/成本中心&利润中心）、`收付款条件20240611.XLSX`、`税码和收付款条件.xlsx`。
---
*联创杰项目 KB v1.0 | 2026-08-23*
KB_03_蓝图与范围边界.md 0 → 100644
View file @ 55df49e2
# KB_03 蓝图与范围边界（联创杰）
> **定位**：回答"本项目蓝图定了什么、范围边界在哪、某个场景对应哪个锚点"。
> **蓝图权威源**：《深圳联创杰-SAP项目业务场景规划文档》V1.4（终版，2023-11-14），本文简称 **DOC-001**。
> **加载策略**：按需。凡涉及"这业务在不在线内 / 蓝图怎么定的 / 对应哪个 BP 编号"，先查本文件再回答。
> **版本**：v1.0 | 2026-08-23 | 场景锚点已对照 DOC-001 目录核验
---
## 1. 使用方式
- 本文件只装**蓝图结构与范围边界**；每个 BP 的详细操作差异见 `KB_04_操作特例与客户化流程.md`，集成开发见 `KB_05_FS与集成开发触点.md`。
- 引用蓝图时一律带场景编号（`SAP-SZLCJ-BP-xx[-xxx]`），不带编号的回答视为未完成溯源。
- 本项目已上线运营，蓝图 V1.4 为**终版基线**；运维期新增决策不回写蓝图，以 Issue Ledger（`issues-ledger/issues-ledger/issues/`）为准。
- 来源编号约定（本库通用）：DOC-001=蓝图V1.4；DOC-002=FICO接口文档（`FICO接口文档20240729/`）；DOC-003=配置文档；DOC-004=顶层设计；DOC-005=月结手册；DOC-007=清账规则；DOC-008=税率表；DOC-009=预付款手册；DOC-010=付款条件编码；DOC-011=外币方案；DOC-012~020=操作手册/培训/权限等。
---
## 2. 蓝图一级分组
DOC-001 第 4 章"业务流程定义"共 12 个一级 BP 分组：
| 一级分组 | 主题 | 子场景数 | 蓝图章节 | 备注 |
|---------|------|:---:|---------|------|
| BP-01 | 物料主数据维护 | 0 | §4.1 | 主数据治理类 |
| BP-02 | 业务合作伙伴维护 | 0 | §4.2 | 客户/供应商主数据 |
| BP-03 | 芯片贸易主场景 | 12 | §4.3 | 核心贸易全流程（含子场景 BP-03-001~012） |
| BP-04 | 公司间交易 | 3 | §4.4 | 同公司调拨/拆包/物料转换 |
| BP-05 | 库存检验 | 2 | §4.5 | 盘点/报废 |
| BP-06 | 总账业务 | 0 | §4.6 | 总账凭证/手工记账 |
| BP-07 | 金税集成 | 2 | §4.7 | 红字发票/取消发票 |
| BP-08 | 资产管理 | 6 | §4.8 | 折旧/盘点/调拨/报废/增值/减值 |
| BP-09 | 费用报销 | 0 | §4.9 | 员工费用 |
| BP-10 | 员工借款 | 0 | §4.10 | 借支/冲销 |
| BP-11 | 财务月结 | 0 | §4.11 | 重分类→外币评估→分摊→结转→合并（DOC-005） |
| BP-12 | 财务年结 | 0 | §4.12 | 年结与年度合并 |
蓝图第 1~3 章（组织结构 / 基础数据 / 单据类型定义）为主数据与配置基础，不属于 BP 流程分组，但属于蓝图范围。
---
## 3. 已验证的关键场景锚点
以下锚点已对照 DOC-001 目录逐一核验：
| 场景编号 | 场景名称 | 所属分组 | 典型追问示例 |
|---------|---------|---------|-------------|
| SAP-SZLCJ-BP-03 | 芯片贸易主场景 | BP-03 | 下单→收发货→开票收款全流程 |
| SAP-SZLCJ-BP-03-001 | 销售退换货 | BP-03 | 客户退货/换货怎么跑 |
| SAP-SZLCJ-BP-03-002 | 采购退换货 | BP-03 | 退供应商 |
| SAP-SZLCJ-BP-03-003 | 赠品采购 | BP-03 | 免费样品入账 |
| SAP-SZLCJ-BP-03-004 | 采购入库检验 | BP-03 | QM 来料检验 |
| SAP-SZLCJ-BP-03-005 | 报关 | BP-03 | 进口报关/报关收入确认 |
| SAP-SZLCJ-BP-03-006 | 寄售采购 | BP-03 | 寄售库存与结算 |
| SAP-SZLCJ-BP-03-007 | 客户收款 | BP-03 | 收款认领/清账入口 |
| SAP-SZLCJ-BP-03-008 | 预付款 | BP-03 | 预付挂账→转换（DOC-009） |
| SAP-SZLCJ-BP-03-009 | 应收款挂账 | BP-03 | 应收挂账处理 |
| SAP-SZLCJ-BP-03-010 | 应付款挂账 | BP-03 | 应付挂账处理 |
| SAP-SZLCJ-BP-03-011 | 客户清账 | BP-03 | 清账规则见 DOC-007 |
| SAP-SZLCJ-BP-03-012 | 供应商清账 | BP-03 | 同上 |
| SAP-SZLCJ-BP-04-001 | 同公司调拨 | BP-04 | 公司内移库 |
| SAP-SZLCJ-BP-04-002 | 拆包 | BP-04 | 包装拆分转换 |
| SAP-SZLCJ-BP-04-003 | 物料转换 | BP-04 | 物料形态转换 |
| SAP-SZLCJ-BP-05-001 | 库存盘点 | BP-05 | 盘盈盘亏 |
| SAP-SZLCJ-BP-05-002 | 库存报废 | BP-05 | 报废过账 |
| SAP-SZLCJ-BP-07-001 | 红字发票 | BP-07 | 金税红冲 |
| SAP-SZLCJ-BP-07-002 | 取消发票 | BP-07 | 发票作废联动 |
| SAP-SZLCJ-BP-08-001~006 | 资产折旧/盘点/调拨/报废/增值/减值 | BP-08 | AA 全场景 |
---
## 4. 范围边界
### 4.1 范围内（In Scope）
| 维度 | 内容 |
|------|------|
| 模块 | FI、CO、MM、SD、QM、AA（资产会计）、EC-CS（合并） |
| 业务 | 芯片贸易（半导体分销）全流程：BP-01~BP-12 全部在蓝图范围内 |
| 组织 | 14 家公司代码；工厂 1310（真实值见组织与主数据文件） |
| 集成 | BTP（双向）、飞书（双向）、金税（SAP→外部）、AI 询报价（外部→SAP） |
### 4.2 项目特例（客户专属，非标准交付）
- **清账规则客户化**：同币种/银行/客户自动清账 + 100 元差额清账（DOC-007），并配套收款清账接口（DOC-002）。
- **预付款转换流程**：预付凭证→转预付账款两步法（DOC-009 记法 F-48→F-54；Cloud 中经 Fiori 应付预付流程执行），配套认领-预收预付款接口。
- **外币方案**：ECB 汇率源 + 高级外币评估（A/F 分类）（DOC-011）。
- **合并报表**：EC-CS 合并 + 现金流报表核对体系（`合并报表/` 目录）。
- **税率编码客户集**：国内 J1/J2/J3/J4 等；进口 JA1/JA2/JC1/JC2（DOC-008）。
- **付款条件编码**：Z001~Z012（DOC-010）。
### 4.3 不在范围（Out of Scope）
PP、WM/EWM、PM、PS、HCM、Treasury 及其相关场景**均不在本项目实施范围**。相关追问直接声明超范围，不得用训练记忆补答。
### 4.4 需人工确认
- 各 BP 子场景的 UAT 测试底稿原件未归档于本库（覆盖情况见 `KB_06_UAT问题与验证覆盖.md`）。
- 运维期新增法人主体的合并设置进展（ISS-lianchuangjie-1006：新增 7 家/注销 5 家）状态需向项目经理戴堂亮确认。
- AI 询报价接口（外部→SAP）的 FS 归档位置未见 DOC-002 目录，需确认。
---
## 5. 与 Base KB 的关系
本文件只定范围；标准操作步骤一律引用 SC Base KB（`KB_SC/`）完整文件名，不重写：
| 蓝图分组 | Base KB 引用 | 说明 |
|---------|-------------|------|
| BP-02 业务伙伴 | `KB_MASTERDATA_Customer.md` / `KB_MASTERDATA_Supplier.md` | 主数据维护 |
| BP-03 销售（下单/交货/开票） | `KB_SD_BD9_Sell-from-Stock.md` | 卖自库存主流程 |
| BP-03-001 销售退换货 | `KB_SD_BKP_Customer-Returns.md` | 客户退货 |
| BP-03-002 采购退换货 | `KB_MM_BMK_Return-to-Supplier.md` | 退供应商 |
| BP-03-004 入库检验 | `KB_QM_1FM_Quality-in-Procurement.md` | 采购质检 |
| BP-03-006 寄售 | `KB_MM_BMC_Core-Inventory-Management.md` + `KB_SD_BDW_Returnables-Processing.md` | 寄售收发与寄售客户库存 |
| BP-03-007/011 客户收款/清账 | `KB_FI_J59_Accounts-Receivable.md` | 标准清账步骤；客户特例见 KB_04 |
| BP-03-008/010/012 预付/应付挂账/供应商清账 | `KB_FI_J60_Accounts-Payable.md` | 标准步骤；转换特例见 KB_04 |
| BP-04 调拨/转换 | `KB_MM_BME_Stock-Transfer-with-Delivery.md` / `KB_MM_BMH_Stock-Transfer-without-Delivery.md` | 库存转移 |
| BP-05 盘点/报废 | `KB_MM_BML_Physical-Inventory.md` | 盘点执行 |
| BP-06 总账 | `KB_FI_J58_Accounting-and-Financial-Close.md` | 总账记账 |
| BP-07 金税 | （无标准 Base 覆盖） | 第三方集成，走 `KB_05_FS与集成开发触点.md` |
| BP-08 资产 | `KB_FI_J62_Asset-Accounting.md` | 资产全周期 |
| BP-09/10 费用报销/员工借款 | `KB_FI_J58_Accounting-and-Financial-Close.md` + `KB_FI_J60_Accounts-Payable.md` | 经总账/应付实现，无独立模块 |
| BP-11/12 月结/年结 | `KB_FI_J58_Accounting-and-Financial-Close.md` | 结账框架；客户顺序见 KB_04 |
| EC-CS 合并 | SC KB 未覆盖 | 架构层引 SA KB `R2R_14_Finance_FPA.md`；操作以项目配置文档 DOC-003 为准 |
---
*KB_03 联创杰 | v1.0 | 2026-08-23 | 依据 DOC-001 V1.4（终版）目录核验*
KB_04_操作特例与客户化流程.md 0 → 100644
View file @ 55df49e2
# KB_04 操作特例与客户化流程（联创杰）
> **定位**：只装"联创杰与标准不一样、或标准没有的那部分"。标准官方步骤不在此复制，一律引用 Base KB 完整文件名。
> **冲突优先级**：本文件 ＞ 蓝图 DOC-001 ＞ SC Base KB ＞ SA KB；但若与 Base 的**官方步骤正确性**矛盾，标出冲突交人判断，不默默改写。
> **版本**：v1.0 | 2026-08-23
---
## 1. 文档边界
| 装 | 不装 |
|----|------|
| 客户清账/外币/月结/预付/合并的**客户化规则与顺序** | 标准应收应付操作步骤（→ `KB_SC/KB_FI_J59/J60`） |
| 销售/采购侧的客户化路径与接口触点 | 标准 SD/MM 步骤（→ `KB_SD_BD9` / `KB_MM_J45` 等） |
| 每条特例的**来源文档 + 状态** | 功能"2602 支不支持"判断（→ SA KB FSD） |
引用规范示例：`客户 100 元差额清账按 DOC-007 执行，其余步骤同 KB_FI_J59_Accounts-Receivable.md §清账`。
---
## 2. 财务类项目特例
| 特例项 | 项目规则 | 来源 | 状态 | Base 引用 |
|--------|---------|------|------|----------|
| 清账规则 | 自动清账限定：同币种 + 同银行 + 同客户方向；允许 **100 元以内差额清账**；客户清账（BP-03-011）/供应商清账（BP-03-012）走此口径 | DOC-007；DOC-001 §4.3.11~12 | 已上线 | `KB_FI_J59_Accounts-Receivable.md` / `KB_FI_J60_Accounts-Payable.md` |
| 收款清账接口化 | 银行回单经收款清账接口自动清账（飞书认领链路上游）；供应商侧是否扩展同款接口曾立项待决（ISS-lianchuangjie-2694），结论需向 FICO 负责人确认 | DOC-002《FICO-收款清账接口》V1.0；Issue Ledger | 接口已上线；供应商扩展未决 | — （定制接口，见 KB_05） |
| 外币评估 | 汇率取 **ECB 源**；采用**高级外币评估**，评估范围按 A/F 分类区分处理；应收应付评估科目后续扩至 2 个新增科目并完成测试（ISS-lianchuangjie-383）；公司代码 2003 曾遇 0L 分类账 RFCV 锁定报错（ISS-lianchuangjie-387，已闭环） | DOC-011；DOC-003；Issue Ledger | 已上线（月结必跑步骤） | `KB_FI_J58_Accounting-and-Financial-Close.md` §外币评估 |
| 月结流程顺序 | 固定顺序：**重分类 → 外币评估 → 分摊 → 结转 → 合并**；不得跳步或调序 | DOC-005；DOC-004 | 已上线 | `KB_FI_J58_Accounting-and-Financial-Close.md` §关账框架（顺序为客户约定） |
| 预付款转换 | 两步法：先挂预付凭证，后转预付账款/冲销（蓝图记法 F-48→F-54；P 系统经 Fiori 应付预付流程执行）；配套认领-预收预付款接口、采购预付剩余未清金额转入待处理凭证接口 | DOC-009；DOC-002 | 已上线 | `KB_FI_J60_Accounts-Payable.md`（转换触发点为客户特例） |
| 合并报表 | EC-CS 合并，覆盖 14 家公司代码；往来抵消 + 预收等报表项核对为高频问题域：预收账款合并数与 FI 不一致（ISS-lianchuangjie-2714）、公司间未抵消金额原因确认（ISS-lianchuangjie-2552）、资产负债表/利润表报表项取数检查（ISS-lianchuangjie-229/251/264）均曾立项 | DOC-003；DOC-005；`合并报表/` 目录 | 已上线；报表项取数逻辑以最新核对底稿为准 | SC KB 无 EC-CS 文件 → 见 `KB_05_FS与集成开发触点.md` §边界 |
---
## 3. 销售类项目特例
| 特例项 | 项目规则 | 来源 | 状态 | Base 引用 |
|--------|---------|------|------|----------|
| BTP→SAP 订单/发票流 | BTP 双向集成：发票影像经 BTP 发票存储接口归档回写 SAP；凭证状态双边回写（双边凭证状态回写 FS） | DOC-002《SAP&BTP（BTP发票存储）》V1.0；《FICO-双边凭证状态回写》V1.0 | 已上线 | 触点见 KB_05；标准销售步骤 `KB_SD_BD9_Sell-from-Stock.md` |
| 销售退换货 | 按 BP-03-001 执行；退款经《销售退款凭证接口》生成红冲类凭证，非纯手工操作 | DOC-001 §4.3.1；DOC-002《FICO-销售退款凭证接口》V1.0 | 已上线 | `KB_SD_BKP_Customer-Returns.md`（凭证生成为客户特例） |
| 金税集成 | SAP→金税单向开票；红字发票（BP-07-001）/取消发票（BP-07-002）为蓝图定义子场景；税率用项目编码集 J1/J2/J3/J4（国内）、JA1/JA2/JC1/JC2（进口）（DOC-008） | DOC-001 §4.7；DOC-008 | 已上线 | 第三方集成，无标准 Base 覆盖 → KB_05 |
| AI 询报价 | 外部系统→SAP 单向写入询价线索；FS 未归档于 DOC-002 目录，字段级规则**未入库** | 项目集成清单（交接背景） | 待确认文档位置 | 询报价标准步骤 `KB_SD_1IQ_Sales-Inquiry.md`（仅限系统内部分） |
| 报关业务收入确认 | BP-03-005 场景；"报关未实现收入"数据核查曾两次立项沟通方案（ISS-lianchuangjie-2718/2719），最终口径需查该 Issue 进展日志 | DOC-001 §4.3.5；Issue Ledger | 场景已上线；收入确认口径以 Issue 结论为准 | — |
---
## 4. 采购类项目特例
| 特例项 | 项目规则 | 来源 | 状态 | Base 引用 |
|--------|---------|------|------|----------|
| 采购订单主流程 | 按 BP-03 芯片贸易主场景执行；付款条件用编码 Z001~Z012（DOC-010）；上传普通日记账分录曾新增采购订单 2 个字段（ISS-lianchuangjie-382） | DOC-001 §4.3；DOC-010 | 已上线 | `KB_MM_J45_Procurement-of-Direct-Materials.md` |
| 收货+QM 检验 | 采购入库检验按 BP-03-004；检验方法/抽样方案/主检验特征/检验计划四类 QM 主数据在蓝图第 2 章定义 | DOC-001 §2.10~2.13、§4.3.4 | 已上线 | `KB_QM_1FM_Quality-in-Procurement.md` |
| 寄售采购 | 按 BP-03-006；寄售库存管理与结算走项目约定，库存动作参照标准寄售处理 | DOC-001 §4.3.6 | 已上线 | `KB_MM_BMC_Core-Inventory-Management.md` + `KB_SD_BDW_Returnables-Processing.md` |
| 赠品采购 | 按 BP-03-003，免费样品单独入账路径 | DOC-001 §4.3.3 | 已上线 | `KB_MM_BMC_Core-Inventory-Management.md`（免费收货记法） |
| 采购预付清理 | 采购预付剩余未清金额定期转入待处理财产凭证（接口自动化） | DOC-002《FICO-采购预付剩余未清金额转入待处理财产凭证》V1.1 | 已上线 | 触点见 KB_05 |
| 公司间/库内转换 | 同公司调拨（BP-04-001）、拆包（BP-04-002）、物料转换（BP-04-003）均为 MM 库存动作，无生产环节 | DOC-001 §4.4 | 已上线 | `KB_MM_BME/BMH_Stock-Transfer-*.md` |
---
## 5. 当前状态表达规则
回答涉及以上特例时，必须区分三档口径，禁止混用：
| 口径 | 表达方式 | 适用 |
|------|---------|------|
| ✅ 已验证 | "已上线运行"+ 给出 DOC 章节 / Issue 编号 | 有源文档或 Issue 佐证且无未决标记 |
| ⚠️ 待确认 | "项目有此安排，但 [具体缺口] 需向 [负责人] 确认" | 供应商接口清账扩展（ISS-2694）、AI 询报价 FS 位置、报关收入确认最终口径 |
| ❌ 未覆盖 | "项目 KB 未收录，建议查阅 [源文档位置]" | 字段级 FS 细节、UAT 底稿原件 |
负责人索引：PM 戴堂亮；FICO 蔡林艳；SD/MM 朱智。
---
*KB_04 联创杰 | v1.0 | 2026-08-23 | 特例均带来源；标准步骤一律外引 Base KB*
KB_05_FS与集成开发触点.md 0 → 100644
View file @ 55df49e2
# KB_05 FS 与集成开发触点（联创杰）
> **定位**：定制开发/接口（RICEFW）触点索引。只装"指向开发文档 + 与标准流程的衔接点"，**不复制 FS 内部逻辑、不给字段级承诺**。
> **FS 权威源**：`FICO接口文档20240729/` 目录（本文简称 DOC-002）。
> **版本**：v1.0 | 2026-08-23 | 接口清单已对照 DOC-002 目录文件名核验
---
## 1. 主要用途
- 回答"某个接口/开发件是谁、找哪份 FS、和标准流程在哪衔接"。
- 集成问题遵循铁律：**只答触发条件 + 替代步骤 + 异常处理入口，禁止推断外部系统（BTP/飞书/金税/AI 平台）内部逻辑**。
- 涉及标准底座的部分（清账、预付、应收应付记账）引 Base KB；本文件只补"定制触点"。
---
## 2. 已验证的项目字段
⚠️ **口径声明**：以下为**触点级字段域**（从 FS 文档主题与集成方向归纳），供定位用；**具体字段清单以各 FS 原文为准，逐字段明细未入库**。
| 字段域 | 归属接口 | 项目用途 | 验证状态 |
|--------|---------|---------|---------|
| 发票影像/附件标识类字段 | BTP 发票存储 | 发票原件在 BTP 侧归档并与 SAP 凭证关联 | ⚠️ 域级确认，字段清单待查 FS §数据结构 |
| 凭证状态回写字段（双边） | 双边凭证状态回写 | SAP 与对端系统的凭证处理状态互相同步 | ⚠️ 域级确认 |
| 飞书审批单据号 / 审批状态 / 审批意见类字段 | SAP&飞书（FICO 模块） | FICO 相关审批经飞书流转并回写 SAP | ⚠️ 域级确认 |
| 收款认领要素（银行流水/客户/金额/清账标记） | 收款清账接口、认领-预收预付款接口 | 收款认领后自动生成凭证并执行客户化清账规则 | ⚠️ 域级确认 |
| 预付剩余未清金额计算字段 | 采购预付剩余未清金额转入待处理财产凭证 | 计算采购预付未清余额并转凭证 | ⚠️ 域级确认 |
| 金税发票要素（发票号/开票日期/税率/税额/红字信息） | 金税集成（BP-07） | SAP→金税开票与红字/取消联动；税率编码集见 DOC-008 | ⚠️ 域级确认 |
> 逐字段核对路径：打开对应 FS 文档的"接口字段/报文结构"章节；核对完成后将本表状态升级为 ✅ 并注明日期。
---
## 3. 关键 FS / 开发主题
DOC-002 目录现存 10 份 FS（名称含版本与完成标记）：
| # | FS 文档 | 方向 | 完成标记 | 关联业务 |
|---|--------|------|:---:|---------|
| 1 | 联创杰SAP接口开发功能设计文档-SAP&BTP（BTP发票存储）V1.0 | SAP↔BTP | 已完成 | 发票影像归档 |
| 2 | 联创杰SAP接口开发功能设计文档-SAP&飞书（FICO模块）V1.1 | SAP↔飞书 | 已完成 | FICO 审批流 |
| 3 | 联创杰SAP接口开发功能设计文档（FICO-代理费运输费手续凭证接口）V1.0 | 外部→SAP | 无标记 | 费用凭证自动化 |
| 4 | 联创杰SAP接口开发功能设计文档（FICO-双边凭证状态回写）V1.0 | SAP↔BTP | 已完成 | 状态同步 |
| 5 | 联创杰SAP接口开发功能设计文档（FICO-抵扣应收账款凭证接口）V1.2 | 外部→SAP | 已完成 | 应收冲抵 |
| 6 | 联创杰SAP接口开发功能设计文档（FICO-收款清账接口）V1.0 | 外部→SAP | 无标记 | 自动清账（配合 DOC-007 规则） |
| 7 | 联创杰SAP接口开发功能设计文档（FICO-认领-预收预付款接口）V1.2 | 外部→SAP | 已完成 | 收款认领→预收/预付凭证 |
| 8 | 联创杰SAP接口开发功能设计文档（FICO-采购预付剩余未清金额转入待处理财产凭证）V1.1 | SAP 内部作业 | 无标记 | 预付余额清理 |
| 9 | 联创杰SAP接口开发功能设计文档（FICO-销售退款凭证接口）V1.0 | 外部→SAP | 无标记 | 销售退换货红冲 |
| 10 | 联创杰SAP接口开发功能设计文档（FICO-预收账款凭证接口）V1.1 | 外部→SAP | 已完成 | 预收挂账 |
配套参考：`计算预付账款剩余未清金额FS（未使用）.xlsx`（根目录，标注**未使用**，不得作为现行逻辑依据）。金税集成（BP-07）与 AI 询报价未见独立 FS 归档于本目录 → 见 §7。
---
## 4. 集成触点证据
| 触点 | 方向 | 证据位置 | 备注 |
|------|------|---------|------|
| BTP | 双向 | DOC-002 #1/#4；ISS-lianchuangjie-1006（新增法人需同步考虑 BTP 对接） | 新增主体时接口同步改造 |
| 飞书 | 双向 | DOC-002 #2 | FICO 模块范围 |
| 金税 | SAP→外部 | DOC-001 §4.7（BP-07 及子场景）；DOC-008 税率表 | 红字/取消发票子场景 |
| AI 询报价 | 外部→SAP | 项目集成清单（交接背景）；FS 未归档 | 待补充文档位置 |
运维期接口扩展需求实例：供应商侧接口清账扩展评估（ISS-lianchuangjie-2694，是否实施待客户回复）——证明收款清账接口具备按既有模式扩展的先例，但**未决前不得承诺**。
---
## 5. 代表性 FS 逻辑摘要
仅到**触发级**（逐步报文/映射逻辑以 FS 原文为准）：
| 接口 | 触发条件 | 与标准流程衔接点 | 标准底座引用 |
|------|---------|----------------|-------------|
| 收款清账接口 | 银行流水认领完成 | 认领成功后按 DOC-007 规则自动清账（同币种/同银行/同客户 + 100 元差额） | `KB_FI_J59_Accounts-Receivable.md` |
| 认领-预收预付款接口 | 无法即时清账的收款认领 | 生成预收/预付凭证挂账 | `KB_FI_J60_Accounts-Payable.md` |
| 抵扣应收账款凭证接口 | 抵扣申请审批通过（飞书链路） | 生成应收冲抵凭证 | `KB_FI_J59_Accounts-Receivable.md` |
| 销售退款凭证接口 | 销售退换货（BP-03-001）确认 | 生成退款/红冲类凭证 | `KB_SD_BKP_Customer-Returns.md` |
| 预收账款凭证接口 | 客户预付款到账认领 | 生成预收凭证 | `KB_FI_J59_Accounts-Receivable.md` |
| 采购预付剩余未清金额转入 | 定期/期末清理 | 未清预付余额转入待处理财产凭证 | `KB_FI_J60_Accounts-Payable.md` |
| 双边凭证状态回写 | 任一侧凭证状态变更 | BTP 与 SAP 状态一致 | — |
| BTP 发票存储 | 销售发票开具 | 发票影像归档关联 | `KB_SC/KB_SD_BD9_Sell-from-Stock.md`（开票段） |
| 飞书（FICO 模块） | FICO 单据提交审批 | 审批结果回写驱动后续凭证动作 | `KB_FI_J58_Accounting-and-Financial-Close.md` |
| 代理费/运输费/手续凭证接口 | 贸易费用发生 | 自动生成费用凭证 | `KB_FI_J58_Accounting-and-Financial-Close.md` |
---
## 6. 与 Base KB 的边界
| 问题类型 | 归属 | 处理方式 |
|---------|------|---------|
| 清账/预付/应收应付**标准步骤** | SC Base KB（J58/J59/J60） | 引用完整文件名+章节，不重写 |
| 接口**触发时机、对标准流程的插入点** | 本文件 | 按 §5 表回答 |
| 接口**报文/字段/映射细节** | DOC-002 各 FS 原文 | 指路，不凭记忆复述 |
| "2602 有没有类似标准功能" | SA KB（FSD/Catalog） | 转交 SA 层判断 |
| 外部系统内部实现（BTP 应用逻辑/金税盘行为等） | ❌ 无归属 | 只答触点，禁止推断 |
---
## 7. 当前限制
1. **无标记 FS**：#3/#6/#8/#9 四份文件名不含"-已完成"，其上线状态需向开发负责人或 FICO 负责人蔡林艳核实后才可作为现行依据。
2. **字段级明细未入库**：§2 为域级归纳；任何字段级承诺前必须核对 FS 原文。
3. **金税 FS 缺位**：BP-07 仅有蓝图场景定义，接口 FS 未见于 DOC-002 目录，可能归档于其他交接资料。
4. **AI 询报价 FS 缺位**：集成方向已确认（外部→SAP），文档位置待 SD/MM 负责人朱智或 PM 戴堂亮确认。
5. **EC-CS 合并无 FS**：合并配置属项目配置文档范畴（DOC-003），非接口开发件。
---
*KB_05 联创杰 | v1.0 | 2026-08-23 | 接口清单核验自 FICO接口文档20240729/ 目录*
KB_06_UAT问题与验证覆盖.md 0 → 100644
View file @ 55df49e2
# KB_06 UAT 问题与验证覆盖（联创杰）
> **定位**：回答"哪些场景被验证过、历史上踩过什么坑、现在处于什么状态"。
> **证据源**：① DOC-001 蓝图 V1.4 场景目录；② Issue Ledger `issues-ledger/issues-ledger/issues/`（42 条，【联创杰运维】期）；③ DOC-011 外币方案相关测试记录线索。
> **版本**：v1.0 | 2026-08-23
---
## 1. 使用前说明
回答前必须区分三档口径，并在答案中明示：
| 口径 | 定义 | 表达方式 |
|------|------|---------|
| ✅ 已验证事实 | 有蓝图场景编号或 Issue 编号可溯源 | "依据 [BP-xx / ISS-xxx]" |
| ⚠️ 基于上下文的推断 | 由文档主题归纳、未见原始底稿 | "推断为…，建议核对 [源]" |
| ❌ 未覆盖/未归档 | 本库无证据 | "未归档，需向 [负责人] 索取" |
**当前状态口径**：项目已上线运营，Issue Ledger 记录为运维期问题；42 条中 41 条 sap_status=已完成，1 条进行中。注意：多数已完成条目的 acceptance 字段仍为"待验证"，即**系统侧已处理但客户验收确认未回填**——回答时不得表述为"客户已验收"。UAT 阶段测试底稿原件未归档于本库，场景级"UAT 通过"结论不可直接引用。
---
## 2. 已验证的 UAT 场景覆盖
以 DOC-001 蓝图场景为覆盖框架（场景锚点详见 `KB_03_蓝图与范围边界.md` §3）：
| 覆盖域 | 蓝图锚点 | 覆盖内容 | 状态口径 |
|--------|---------|---------|---------|
| 主数据 | BP-01 / BP-02 | 物料、业务伙伴维护流程 | ✅ 已上线运营（UAT 底稿未归档） |
| 核心贸易 | BP-03（主场景+12 子场景） | 下单→收发货→检验→开票→收款清账→退换货→寄售→报关→预付→挂账 | ✅ 已上线运营 |
| 公司间与库存转换 | BP-04-001~003 | 同公司调拨/拆包/物料转换；平行系统 STO 测试有专项记录（ISS-lianchuangjie-1007） | ✅ 已上线运营 |
| 库存检验 | BP-05-001~002 | 盘点/报废 | ✅ 已上线运营 |
| 总账 | BP-06 | 手工记账/总账凭证 | ✅ 已上线运营 |
| 金税集成 | BP-07-001~002 | 红字发票/取消发票 | ✅ 已上线运营 |
| 资产管理 | BP-08-001~006 | 折旧/盘点/调拨/报废/增值/减值；年结报错曾暴露资产过账边界问题（ISS-lianchuangjie-499） | ✅ 已上线运营 |
| 费用报销/员工借款 | BP-09 / BP-10 | 员工费用与借支冲销 | ✅ 已上线运营 |
| 月结/年结 | BP-11 / BP-12 | 重分类→外币评估→分摊→结转→合并全链路（顺序见 KB_04） | ✅ 已上线运营 |
> ⚠️ 上表"已验证"指**经上线持续运行佐证**；逐场景 UAT 用例执行记录不在本库，追问细节按 ❌ 口径处理。
---
## 3. 历史问题摘录
从 Issue Ledger 与外币测试记录中摘录代表性条目：
| 问题 | 分类 | 状态 | 溯源 | 对现状的影响 |
|------|------|------|------|-------------|
| 高级外币评估配置检查和测试 | 跟踪类 | 已完成/待验收 | ISS-lianchuangjie-358；DOC-011 | A/F 分类评估为月结必跑项的验证基础 |
| 外币评估新增应收应付 2 科目配置与测试 | 开发需求 | 已完成/待验收 | ISS-lianchuangjie-383 | 评估科目范围已扩展 |
| 外币评估报错：公司代码 2003 + 0L 分类账 RFCV 已锁定 | 系统优化 | 已完成/待验收 | ISS-lianchuangjie-387 | 关账并发/锁定的已知坑，月结排程需错开 |
| 应付会计付款清账 APP 权限问题 | 用户操作 | 已完成/待验收 | ISS-lianchuangjie-394 | 清账权限角色配置先例 |
| 供应商侧接口清账扩展评估 | 开发需求 | 待客户回复（未决） | ISS-lianchuangjie-2694 | 收款清账接口模式可扩展但未承诺 |
| 预收账款合并数与 FI 不一致 | 报表需求 | 已完成/待验收 | ISS-lianchuangjie-2714 | 合并报表预收报表项核对重点 |
| 合并报表公司间未抵消金额原因确认 | 报表需求 | 已完成/待验收 | ISS-lianchuangjie-2552 | 往来抵消核查方法沉淀 |
| 资产负债表未分配利润取数系统测试 | 数据问题 | 已完成/待验收 | ISS-lianchuangjie-229；另见 ISS-251/264（资产负债表/利润表取数检查） | 报表项取数逻辑多次校准 |
| 资产年结报错：含未完全过账折旧资产 | 数据问题 | 已完成/待验收 | ISS-lianchuangjie-499 | 年结前资产过账完整性检查点 |
| 创建物料报错 | 系统优化 | **进行中** | ISS-lianchuangjie-2721 | 当前唯一未闭环问题，回答时须标注"进行中" |
| 新增 7 家法人主体/注销 5 家 | 报表需求 | 已完成/待验收 | ISS-lianchuangjie-1006 | 涉及 BTP 接口、公司间交易、合并设置联动改造 |
| 应收汇票贴息成本自动扣毛利需求 | 开发需求 | 已完成/待验收 | ISS-lianchuangjie-589；关联 CDS 数据源排查 ISS-518/519/545 | 汇票相关报表口径 |
| 应收票据不纳入信贷余额计算 | 开发需求 | 已完成/待验收 | ISS-lianchuangjie-252 | 信贷余额计算口径特例 |
| 报关业务未实现收入核查 | 数据问题 | 已完成/待验收 | ISS-lianchuangjie-2718/2719 | BP-03-005 收入确认口径 |
| 权限与账号类批量问题 | 用户操作/开发需求 | 已完成/待验收 | ISS-262/263/394/401/402/436/501/509/536/588/609 | 新用户开通与角色分配标准动作已有沉淀 |
完整清单（42 条）检索路径：`issues-ledger/issues-ledger/issues/`，可用 `bos-issue-ledger` skill 的 search/list 工具查询。
---
## 4. 回答规则
1. **先给状态再给结论**：涉及历史问题时先声明其 sap_status / acceptance 双字段值。
2. **acceptance=待验收 ≠ 已闭环**：统一表述为"SAP 侧已处理、客户验收待回填"。
3. **进行中问题不给出结论性答复**（如 ISS-2721），只陈述当前进展并指向 Issue 日志。
4. **禁止用训练记忆补充**本表之外的"历史问题"；未收录即答"未归档"。
5. 引用格式：`ISS-lianchuangjie-xxxx` 完整编号 + 一句话结论，不整段复制 Issue 原文。
---
## 5. 更新触发
| 触发事件 | 动作 |
|---------|------|
| Issue Ledger 新增/关闭条目 | §3 表增删对应行，同步 acceptance 状态 |
| acceptance 从"待验证"→"已验收" | 将该条目口径升级为 ✅ 并注明日期 |
| 运维月度会议（参考 ISS-2720 例行机制）产生新决议 | 决议落库至 KB_04/KB_05，此处仅登记索引 |
| 法人主体增减落地（ISS-1006 后续） | 通知 KB_02 组织真实值与 KB_05 集成触点同步更新 |
| UAT/hypercare 底稿原件归档入库后 | §2 状态口径由"上线佐证"升级为"底稿佐证" |
Owner：项目经理戴堂亮；更新频率：周级（随运维节奏）。
---
*KB_06 联创杰 | v1.0 | 2026-08-23 | 42 条 Ledger 全量扫描；41 完成/1 进行中*
KB_07_操作手册与常见报错索引.md 0 → 100644
View file @ 55df49e2
# KB_07 操作手册与常见报错索引（联创杰）
> **定位**：操作类问题的第一入口——先定位"这个操作查哪份项目手册"，再给"关键操作字段"和"已知报错及处置"。标准官方步骤不在此重写，一律引用 Base KB 完整文件名。
> **版本**：v1.0 | 2026-08-23 | 手册入口与 DOC 编号对照已核验
---
## 1. 文档边界
| 装 | 不装 |
|----|------|
| 各操作主题对应的**项目手册入口**（DOC 编号 + 手册名 + 适用范围） | 标准操作逐步截图教程（→ SC Base KB 对应文件） |
| 高频操作的**关键字段/口径速查**（月结/清账/预付） | 配置级 SSCUI 细节（→ DOC-003 配置文档原件） |
| **已发生过的报错**及处置结论（带 Issue 编号） | 未发生过、推测性的"可能报错"（禁止编写） |
引用规范示例：`月结按 DOC-005 执行，顺序为项目约定（KB_04），各步骤标准动作见 KB_FI_J58_Accounting-and-Financial-Close.md`。
---
## 2. 项目手册入口
| 操作主题 | 手册/文档位置 | 编号 | 覆盖内容 | 标准底座引用（KB_SC/） |
|---------|--------------|------|---------|----------------------|
| 月结操作 | 月结流程操作手册 | DOC-005 | 固定五步：重分类→外币评估→分摊→结转→合并；折旧运行与 ML 物料分类账凭证 | `KB_FI_J58_Accounting-and-Financial-Close.md` |
| 清账操作（客户/供应商） | 清账逻辑说明 | DOC-007 | 自动清账规则（同币种+同银行+同客户方向，100 元以内差额）；蓝图记法 F-32（客户）/F-44（供应商），Cloud 中经 Fiori 应收/应付清账 App 执行 | `KB_FI_J59_Accounts-Receivable.md` / `KB_FI_J60_Accounts-Payable.md` |
| 外币评估 | 外币评估方案与测试记录 | DOC-011 | ECB 汇率源；高级外币评估按 A/F 分类；应收应付评估科目扩展后共含新增 2 科目 | `KB_FI_J58_Accounting-and-Financial-Close.md` §外币评估 |
| 预付款转换 | 预付款操作手册 | DOC-009 | 两步法：先挂预付凭证→后转预付账款/冲销（蓝图记法 F-48→F-54；Cloud 经 Fiori 应付预付流程执行） | `KB_FI_J60_Accounts-Payable.md` |
| 金税操作 | 蓝图 BP-07 场景定义（独立操作手册未见归档） | DOC-001 §4.7 | 发票开具（SAP 发票号驱动）、红字发票 BP-07-001、取消发票 BP-07-002；税率编码见 DOC-008 | 无标准 Base 覆盖（第三方集成，触点见 KB_10） |
| 合并报表 | 合并报表配置/操作文档 + 核对底稿（`合并报表/` 目录） | DOC-003；DOC-006 | EC-CS 合并操作；试算平衡表核对；贸易伙伴编码与往来抵消核查 | SC KB 无 EC-CS 文件；架构层引 SA KB `R2R_14_Finance_FPA.md` |
> ⚠️ DOC-012~020（操作手册/培训/权限类）尚未逐一登记入索引，定位到具体主题前按「需人工核实」处理。
---
## 3. 关键操作字段
### 3.1 月结（DOC-005）
| 字段/要点 | 取值/口径 |
|----------|----------|
| 步骤顺序 | 重分类 → 外币评估 → 分摊 → 结转 → 合并（固定顺序，不得跳步或调序） |
| 排程注意 | 外币评估存在分类账锁定先例（ISS-lianchuangjie-387），多公司码并发执行须错峰 |
| 折旧运行 | 年结/月结前须确认无未完全过账折旧资产（ISS-lianchuangjie-499 教训） |
| 合并环节 | 月结末步进入 EC-CS 合并；结果与 FI 试算平衡表核对（DOC-006） |
### 3.2 清账（DOC-007）
| 字段/要点 | 取值/口径 |
|----------|----------|
| 自动清账匹配条件 | 同币种 + 同银行 + 同客户方向 |
| 差额清账容差 | 100 元以内的差额允许清账 |
| 客户清账 | BP-03-011；收款清账接口自动清账走同一套规则 |
| 供应商清账 | BP-03-012；是否扩展同款接口未决（ISS-lianchuangjie-2694），不得承诺 |
### 3.3 预付款转换（DOC-009）
| 字段/要点 | 取值/口径 |
|----------|----------|
| 两步法 | 第一步挂预付凭证 → 第二步转预付账款/冲销 |
| 蓝图记法 | F-48（预付记账）→ F-54（预付清账/转账）；P 系统经 Fiori 应付预付流程执行 |
| 配套接口 | 认领-预收预付款接口；采购预付剩余未清金额定期转入待处理财产凭证 |
---
## 4. 常见报错
仅收录**已发生且有 Issue 编号**的报错；新报错须先登记 Issue Ledger 再补入本节。
| # | 报错现象 | 场景 | 处置/规避 | 溯源 |
|---|---------|------|----------|------|
| E-01 | 公司代码 2003 + 0L 分类账 RFCV 已锁定，外币评估无法执行 | 月结外币评估并发 | 错峰排程，避免多公司码同时评估；该例已闭环 | ISS-lianchuangjie-387；DOC-011 测试记录 |
| E-02 | 应付会计付款清账 APP 权限不足 | 应付清账操作 | 按既有角色配置先例补权限（角色分配标准动作已沉淀） | ISS-lianchuangjie-394 |
| E-03 | 资产年结报错：存在未完全过账折旧的资产 | 年结资产过账 | 年结前先跑完折旧并检查资产过账完整性 | ISS-lianchuangjie-499 |
| E-04 | 创建物料报错 | 主数据维护 | **进行中**，不得给出结论性答复，只指向 Issue 日志进展 | ISS-lianchuangjie-2721 |
| E-05 | 预收账款合并数与 FI 不一致 | EC-CS 合并核对 | 按"资产负债表/利润表报表项取数检查"沉淀方法核查报表项取数逻辑 | ISS-lianchuangjie-2714；ISS-229/251/264 |
| E-06 | 合并报表出现公司间未抵消金额 | EC-CS 往来抵消 | 先确认贸易伙伴编码填写完整性，再按 ISS-2552 沉淀的原因排查路径核查 | ISS-lianchuangjie-2552 |
---
## 5. 使用规则
1. **先手册后系统**：操作类提问先给 §2 手册入口 + §3 关键字段；手册未覆盖的标准步骤引 Base KB，不凭记忆复述。
2. **报错三要素齐全才可答**：现象 + 处置 + Issue 编号缺一不可；只有两要素的按「需人工核实」降级处理。
3. **事务码记法声明**：本库沿用源文档的 F-32/F-44/F-48/F-54 为蓝图记法；实际操作在 Cloud 中对应 Fiori App（映射参照 SC KB OP-Only 工具映射表），回答时必须注明。
4. **进行中问题不闭环**：E-04 类"进行中"条目只陈述现状，禁止给出最终处置结论。
5. **金税操作留白**：BP-07 无独立操作手册入库，只能给蓝图场景定义 + 税率编码，细节指路 DOC-001 §4.7 与现场负责人。
---
## 6. 更新触发
| 触发事件 | 动作 |
|---------|------|
| Issue Ledger 新增操作类问题并闭环 | §4 表新增一行（编号顺延），同步 sap_status/acceptance 口径 |
| 新的操作手册/培训资料归档（DOC-012~020 定位完成） | §2 表补充入口行并删除 ⚠️ 提示 |
| 月结/清账/预付口径变更 | §3 对应小节更新，并在 KB_04 同步修订特例条目 |
| 手册版本升级（如 DOC-005 出现新版） | 按 KB_01 §2.1 版本取用规则替换入口，保留旧版编号备查 |
| acceptance 由"待验证"→"已验收" | 对应报错行升级为 ✅ 并注明日期 |
Owner：FI/CO 类 蔡林艳；SD/MM 类 朱智；发布批准 戴堂亮。
---
*KB_07 联创杰 | v1.0 | 2026-08-23 | 手册入口对照 DOC-001~011；报错全部带 Issue 溯源*
KB_08_项目决策与未决清单.md 0 → 100644
View file @ 55df49e2
# KB_08 项目决策与未决清单（联创杰）
> **定位**：项目治理单一事实源——已验证决策、待补证据的开发事实、未决问题、剩余风险与验收证据，全部集中登记。回答"项目当时怎么定的 / 还有什么没定"只认本文件。
> **版本**：v1.0 | 2026-08-23 | 决策与未决项均带 DOC/ISS 溯源
---
## A. 治理与发布规则
| 项 | 约定 |
|----|------|
| 文件 Owner | 戴堂亮（项目经理）——本文件整体；条目内容按域分审：FI/CO/AA/EC-CS 蔡林艳，SD/MM/QM 朱智 |
| 更新触发 | 蓝图升版、Issue Ledger 新增/关闭、月度运维会议决议、`[待补充]` 字段取得真值、未决项裁决落地 |
| 发布门槛 | 新增/变更条目须同时具备：①结论；②来源（DOC 编号或 ISS 编号）；③证据等级；④域 Owner 审核签字。缺任一项不得发布 |
| 与其他 KB 的关系 | 本文件登记**决策与状态**；操作口径在 KB_04/KB_07，集成约定在 KB_10。冲突时以本文件登记的最新决策为准并回改受影响文件 |
| 版本规则 | 决策编号 D-xxx 终身不复用；被推翻的决策不删除，状态改为「已被 D-xxx 取代」 |
---
## B. 已验证项目决策
| # | 决策 | 日期 | 负责人 | 依据 | 状态 |
|---|------|------|--------|------|:---:|
| D-001 | 蓝图 V1.4 为终版基线；运维期新增决策不回写蓝图，以 Issue Ledger 为准 | 2023-11-14 | 戴堂亮 | DOC-001 封面/终稿标记 | ✅ |
| D-002 | 清账客户化：自动清账限定同币种+同银行+同客户方向，允许 100 元以内差额清账 | 蓝图期（上线沿用） | 蔡林艳 | DOC-007；DOC-001 §4.3.11~12 | ✅ 已上线 |
| D-003 | 月结固定五步顺序：重分类→外币评估→分摊→结转→合并 | 蓝图期（DOC-005 固化） | 蔡林艳 | DOC-005；DOC-004 | ✅ 已上线 |
| D-004 | 预付款两步法转换：先挂预付凭证→后转预付账款/冲销（蓝图记法 F-48→F-54） | 蓝图期（DOC-009 固化） | 蔡林艳 | DOC-009 | ✅ 已上线 |
| D-005 | 外币评估采用 ECB 汇率源 + 高级外币评估，按 A/F 分类区分处理 | 上线期（经配置检查与测试验证） | 蔡林艳 | DOC-011；ISS-lianchuangjie-358 | ✅ 已上线 |
| D-006 | 合并报表采用 EC-CS，覆盖 14 家公司代码，使用贸易伙伴编码做往来抵消 | 配置期 | 蔡林艳 | DOC-003；`合并报表/` 目录 | ✅ 已上线 |
| D-007 | 税率编码用项目编码集：国内 J1/J2/J3/J4 等；进口 JA1/JA2/JC1/JC2 | 配置期 | 蔡林艳 | DOC-008 | ✅ 已上线 |
| D-008 | 付款条件统一编码 Z001~Z012 | 配置期 | 蔡林艳 | DOC-010 | ✅ 已上线 |
| D-009 | 飞书双向集成：FICO 单据审批流 + 业务伙伴创建审批经飞书流转，结果回写 SAP 驱动后续动作 | 接口设计期 | 蔡林艳 | DOC-002《SAP&飞书（FICO模块）》V1.1 | ✅ 已上线 |
| D-010 | BTP 双向集成：主数据管理、订单维护、收发货触发、发票影像存储与双边凭证状态回写 | 接口设计期 | 戴堂亮（跨域） | DOC-002 #1/#4；蓝图 BP-01/BP-02 | ✅ 已上线 |
> 日期栏为"—"者表示源文档未载明具体日期，仅可确认时点区间；不得臆测精确日期。
---
## C. 已验证开发事实与待补证据
| # | 开发事实 | 验证情况 | 待补证据 | 溯源 |
|---|---------|---------|---------|------|
| F-001 | 收款清账接口已上线运行（飞书认领链路上游，按 DOC-007 规则自动清账） | 生产运行佐证 | FS 文件名无"-已完成"标记，上线确认单待补 | DOC-002 #6；KB_05 §3 |
| F-002 | 销售退款凭证接口已上线（BP-03-001 退款红冲） | 生产运行佐证 | 同上，FS 完成标记缺失 | DOC-002 #9 |
| F-003 | 代理费/运输费/手续凭证接口在用（费用凭证自动化） | 生产运行佐证 | 同上，FS 完成标记缺失 | DOC-002 #3 |
| F-004 | 采购预付剩余未清金额定期转入待处理财产凭证 | 生产运行佐证 | 同上，FS 完成标记缺失 | DOC-002 #8 |
| F-005 | 外币评估扩展：新增应收应付评估科目 2 个并完成配置测试 | SAP 侧已完成 | acceptance=待验证，客户验收回填待补 | ISS-lianchuangjie-383 |
---
## D. 未决问题清单
| # | 未决问题 | 当前状态 | 影响范围 | 下一步动作 | 责任人 |
|---|---------|---------|---------|-----------|--------|
| Q-01 | 创建物料报错 | **进行中**（唯一未闭环 Issue） | 主数据维护 BP-01 | 跟踪 Issue 日志进展，闭环后转入 KB_07 §4 报错表 | 朱智 |
| Q-02 | 供应商侧接口清账扩展（同收款清账模式）是否实施 | 待客户回复 | 应付清账自动化 | 收到客户回复前不得承诺任何方案 | 蔡林艳 |
| Q-03 | AI 询报价接口 FS 归档位置不明 | 未决 | SD 询价集成溯源 | 向朱智/戴堂亮确认文档位置并补录 DOC 编号 | 朱智 |
| Q-04 | 金税接口 FS 未见于 DOC-002 目录 | 未决 | BP-07 开票集成溯源 | 核对其他交接资料归档位置，补录或声明缺失 | 蔡林艳 |
| Q-05 | 无"-已完成"标记的 4 份 FS（#3/#6/#8/#9）正式上线确认 | 未决 | FICO 接口现行依据判定 | 补上线确认单或由 FICO 负责人书面确认 | 蔡林艳 |
| Q-06 | 科目表取值差异（蓝图规划值 LCJ/LCJ1 vs 配置文档 YCOA）及 P 系统公司代码编号段差异 | 未决（文档间差异） | 组织主数据权威口径 | 以系统实际值为准复核后回写 KB_02 并闭环登记 | 蔡林艳 |
> 规则：未决问题**禁止推断结论**；Q-01 类进行中事项只陈述进展。任何一条取得结论后移入 §B（决策）或 §C（事实），并在本节标注「已关闭 → 见 Dx/F-x」。
---
## E. 发布审计结论
| 审计项 | 结论 |
|--------|------|
| 引用可溯率 | 本文件全部条目均带 DOC/ISS 编号，满足 100% 可溯要求 |
| 证据等级分布 | §B 多为 L2（文档摘录经 Owner 复核）；§C 均为 L1~L2 且显式列出待补证据；无 L0 条目入册 |
| 已知缺口关联 | GAP-FS-01（字段级映射）、GAP-UAT-01（UAT 底稿）、GAP-ARCH-01/02（归档完整性）见 KB_MANIFEST.json `known_evidence_gaps` |
| 敏感资产 | 《联创杰系统账号密码.docx》未读取、未索引，符合红线 R6 |
---
## F. 已知剩余风险
| # | 风险 | 影响 | 缓解措施 | Owner |
|---|------|------|---------|-------|
| R-001 | 41 条已完成 Issue 中多数 acceptance=待验证，客户验收未回填 | "SAP 已处理"≠"客户已认可"，对外表述存在口径风险 | 统一口径"SAP 侧已处理、客户验收待回填"；推动批量回填 | 戴堂亮 |
| R-002 | UAT 底稿原件未归档，场景级"UAT 通过"不可直接引用 | 场景覆盖结论只能以上线运营佐证（L2），达不到 L4 | 底稿入库后将 KB_06 §2 升级为"底稿佐证" | 蔡林艳 |
| R-003 | 蓝图 V1.0~V1.3 历史版本及早期会议纪要未归档；目录中 ~$*/~WRL*.tmp 临时文件未清理 | 更早决策不可考；临时文件存在误引用风险 | 红线 R8 已排除其证据资格；物理清理列入待办 | 戴堂亮/朱智 |
| R-004 | 法人主体增减（新增 7 家/注销 5 家）涉及 BTP 接口、公司间交易、合并设置联动改造 | 后续月结合并与集成一致性风险 | 按 ISS-lianchuangjie-1006 进展逐项核对联动改造清单 | 戴堂亮 |
---
## G. P1/P2/P3 补齐事项跟踪
| 优先级 | 事项 | 关联 | 状态 |
|--------|------|------|------|
| P1（阻塞权威口径） | Q-06 科目表差异复核回写；Q-05 四份 FS 上线确认 | GAP-FS-01 | 未开始 |
| P1 | R-001 acceptance 批量回填 | KB_06 §1 口径 | 进行中 |
| P2（完善溯源链） | Q-03 AI 询报价 FS 定位；Q-04 金税 FS 定位 | KB_10 接口清单状态升级 | 未开始 |
| P2 | DOC-012~020 逐一登记入 KB_07 §2 手册索引 | KB_99 证据索引 | 未开始 |
| P3（长期治理） | UAT 底稿归档（R-002）；历史蓝图版本与会议纪要归档（R-003）；临时文件清理 | GAP-UAT-01 / GAP-ARCH-01 / GAP-ARCH-02 | 未开始 |
优先级定义：P1=影响回答正确性/权威性，月度内完成；P2=影响溯源完整性，季度内完成；P3=治理优化，随审计节奏推进。
---
## H. 验收证据索引
| 证据类型 | 位置 | 状态 |
|---------|------|------|
| 验收用例 | `KB_ACCEPTANCE_TESTS/` | 目录已建，AI_1/AI_2 用例 pending |
| 验收结果 | `KB_ACCEPTANCE_RESULTS/` | 目录已建，随验收执行回写 |
| Issue 处理记录 | `issues-ledger/issues-ledger/issues/`（42 条） | 41 完成/1 进行中；acceptance 回填见 R-001 |
| 月度抽查记录 | 记入 KB_99 证据索引 | 按审计节奏滚动 |
| 本文件版本历史 | 文件尾注 | v1.0 初版 |
---
*KB_08 联创杰 | v1.0 | 2026-08-23 | D-001~D-010 / F-001~F-005 / Q-01~Q-06 / R-001~R-004 全部带溯源*
KB_09_模块蓝图决策与Base引用.md 0 → 100644
View file @ 55df49e2
# KB_09 模块蓝图决策与 Base 引用（联创杰）
> **定位**：按模块回答"本项目这个模块定了什么、和 SAP 标准什么关系、标准步骤去哪查"。只装模块级决策与引用映射，不装操作细节（→ KB_04/KB_07）、不装接口报文（→ KB_10）。
> **版本**：v1.0 | 2026-08-23 | 决策矩阵对照 DOC-001/003/004/005/007 核验
---
## 1. 定位
- 本文件是**模块维度**的决策索引：每个模块一行，给出项目决策、来源、状态、Base KB 引用、与 Base 的关系判定。
- 与 Base 的关系分三档：
- **= Base**：完全按标准执行，直接引 Base 文件；
- **Base + 项目特例**：标准底座照 Base 走，叠加客户化规则（特例正文在 KB_04）；
- **无 Base 覆盖**：第三方集成或 SC KB 未覆盖，走项目文档/SA KB 架构层。
- 回答时必须声明所属档位；"Base + 项目特例"类问题只答特例部分，标准部分外引。
---
## 2. 决策与引用矩阵
| 模块 | 项目决策 | 项目来源 | 状态 | Base 引用（KB_SC/） | 与 Base 关系 |
|------|---------|---------|:---:|---------------------|-------------|
| FI-总账 | 科目表 YCOA（蓝图规划值 LCJ/LCJ1，差异见 KB_02 待核实项）；总账凭证类型 SA；凭证录入按 BP-06 | DOC-001 §1/§4.6；DOC-003 | ✅ 已上线 | `KB_FI_J58_Accounting-and-Financial-Close.md` | = Base |
| FI-清账 | 客户清账 BP-03-011 / 供应商清账 BP-03-012：自动清账限定同币种+同银行+同客户方向，100 元以内差额清账；收款清账接口自动化 | DOC-007；DOC-001 §4.3.11~12；DOC-002 #6 | ✅ 已上线 | `KB_FI_J59_Accounts-Receivable.md` / `KB_FI_J60_Accounts-Payable.md` | Base + 项目特例 |
| FI-预付 | 预付款两步法：先挂预付凭证→后转预付账款/冲销（蓝图记法 F-48→F-54）；配套认领-预收预付款接口与采购预付余额转入接口 | DOC-009；DOC-002 #7/#8 | ✅ 已上线 | `KB_FI_J60_Accounts-Payable.md` | Base + 项目特例 |
| FI-外币 | 汇率取 ECB 源；高级外币评估按 A/F 分类区分处理；评估科目含新增应收应付 2 科目 | DOC-011；DOC-003；ISS-lianchuangjie-358/383 | ✅ 已上线 | `KB_FI_J58_Accounting-and-Financial-Close.md` §外币评估 | Base + 项目特例 |
| CO | 控制范围 1000 / 经营范围 1000；月结第三步"分摊"为客户约定顺序环节；费用凭证经代理费/运输费/手续接口自动化 | DOC-001 §1；DOC-005；DOC-002 #3 | ✅ 已上线 | `KB_FI_J58_Accounting-and-Financial-Close.md` §关账框架 | Base + 项目特例（顺序为项目约定） |
| SD | 主场景 BP-03 卖自库存；销售退换货退款经《销售退款凭证接口》生成红冲凭证；金税开票 SAP 发票号驱动；AI 询报价外部→SAP 单向写入 | DOC-001 §4.3/§4.7；DOC-002 #9 | ✅ 已上线（AI 询报价 FS 位置待确认） | `KB_SD_BD9_Sell-from-Stock.md`；`KB_SD_BKP_Customer-Returns.md` | Base + 项目特例 |
| MM | 采购主流程 BP-03 直采；付款条件编码 Z001~Z012；寄售采购 BP-03-006 走项目约定结算；拆包/物料转换 BP-04-002~003 为纯库存动作无生产环节 | DOC-001 §4.3/§4.4；DOC-010 | ✅ 已上线 | `KB_MM_J45_Procurement-of-Direct-Materials.md`；`KB_MM_BMC_Core-Inventory-Management.md`；`KB_MM_BME/BMH_Stock-Transfer-*.md` | Base + 项目特例（寄售结算） |
| QM | 采购入库检验 BP-03-004；检验方法/抽样方案/主检验特征/检验计划四类主数据在蓝图第 2 章定义 | DOC-001 §2.10~2.13、§4.3.4 | ✅ 已上线 | `KB_QM_1FM_Quality-in-Procurement.md`；`KB_QM_1MR_Quality-in-Stock-Handling.md` | = Base |
| AA | 凭证类型 AA/AF；六大场景：折旧/盘点/调拨/报废/增值/减值（BP-08-001~006）；年结前须完成全部折旧过账 | DOC-001 §4.8；ISS-lianchuangjie-499 | ✅ 已上线 | `KB_FI_J62_Asset-Accounting.md` | = Base（年结前检查点为运维沉淀） |
| EC-CS | 合并覆盖 14 家公司代码；贸易伙伴编码驱动往来抵消；未抵消差异核查有沉淀方法（报表项取数检查）；月结末步执行合并 | DOC-003；DOC-005；DOC-006；ISS-lianchuangjie-2552/2714/229/251/264 | ✅ 已上线 | SC KB 无 EC-CS 操作文件 → 架构层引 SA KB `R2R_14_Finance_FPA.md`；操作以 DOC-003 为准 | 无 Base 覆盖 |
> 范围外提示：PP、WM/EWM、PM、PS、HCM、Treasury 不在本项目实施范围，本表不设行；相关提问按 KB_01 §5 口径拒绝当作已实施回答。
---
## 3. 失效引用校正记录
| 日期 | 原引用 | 问题 | 校正后 | 依据 |
|------|--------|------|--------|------|
| （暂无） | — | — | — | — |
> 记录规则：凡发现本文件引用的 Base 文件名变更、DOC 编号修正、或决策被新决策取代，必须在此登记一行，并同步修订 §2 矩阵。空白表示尚无失效记录——**不得预填占位内容**。
---
## 4. 回答口径
1. **三档先声明**：回答任何模块问题先声明 "= Base / Base + 项目特例 / 无 Base 覆盖"，再给内容。
2. **决策带来源**："项目怎么定的"必须落到 §2 矩阵某行 + DOC 编号；落不到的回答「项目 KB 未收录」。
3. **特例外链不复制**：涉及清账/预付/外币/月结特例细节时指向 KB_04 与 KB_07，本文件不重复展开。
4. **EC-CS 双源回答**：架构问题引 SA KB R2R_14；配置/核对问题指路 DOC-003 与 `合并报表/` 底稿；两者都未覆盖的答「需向蔡林艳确认」。
5. **状态如实标注**：AI 询报价等存在待确认项的行，回答时须带上 ⚠️ 标注，不得省略成"已上线"一笔带过。
---
*KB_09 联创杰 | v1.0 | 2026-08-23 | 矩阵 10 行全覆盖范围内 7 模块；关系三档判定*
KB_10_系统集成约定与接口清单.md 0 → 100644
View file @ 55df49e2
# KB_10 系统集成约定与接口清单（联创杰）
> **定位**：外部系统集成单一事实源——4 个外部系统的方向约定、接口清单与状态、关键集成约定。只答触发条件 + 衔接点 + 异常入口，**禁止推断外部系统内部逻辑**。
> **FS 权威源**：DOC-002（`FICO接口文档20240729/`，10 份 FS，清单见 KB_05 §3）
> **版本**：v1.0 | 2026-08-23 | 接口方向对照红线 R3 核验
---
## 1. 定位
- 回答"某集成是谁和谁、什么方向、什么触发、什么状态"。
- 标准底座（清账/预付/应收应付记账）引 Base KB；本文件只装**定制触点**。
- 接口字段级明细未入库（GAP-FS-01）：字段类问题置信上限为流程级，细节指路 FS 原文。
---
## 2. 系统总览
| 系统 | 方向 | 用途 | 覆盖业务 | 状态 |
|------|:---:|------|---------|:---:|
| BTP | 双向 | 主数据管理 / 订单维护 / 收发货触发 / 发票影像存储 / 凭证状态回写 | BP-01/BP-02 主数据、BP-03 订单履约 | ✅ 已上线 |
| 飞书 | 双向 | FICO 单据审批流 / 业务伙伴创建审批；收款认领链路 | 审批流 + 收款认领上游 | ✅ 已上线 |
| 金税 | SAP→外部 | 发票开具（SAP 发票号驱动）/ 红字发票 / 取消发票 | BP-07 及子场景 | ✅ 已上线（FS 未归档 ⚠️） |
| AI询报价 | 外部→SAP | AI 平台生成询价线索写入 SAP | SD 询价前端 | ✅ 在用（FS 未归档 ⚠️） |
### 2.1 非最终状态接口治理表
以下触点**不具备"文档齐备+已确认"的最终状态**，回答涉及时必须带 ⚠️ 并按本表口径表述：
| 触点 | 缺口 | 治理动作 | 责任人 |
|------|------|---------|--------|
| 金税开票接口 | BP-07 仅蓝图场景定义，FS 未见于 DOC-002 目录 | 定位归档位置并补录 DOC 编号（Q-04） | 蔡林艳 |
| AI 询报价接口 | FS 归档位置不明，字段级规则未入库 | 确认文档位置并补录（Q-03） | 朱智 |
| FS #3 代理费运输费手续凭证 V1.0 | 文件名无"-已完成"标记 | 补上线确认单或书面确认（Q-05） | 蔡林艳 |
| FS #6 收款清账 V1.0 | 同上；另有供应商侧扩展未决 | 同上；扩展项按 Q-02 待客户回复，不得承诺 | 蔡林艳 |
| FS #8 采购预付剩余未清金额转入 V1.1 | 同上 | 同上 | 蔡林艳 |
| FS #9 销售退款凭证 V1.0 | 同上 | 同上 | 蔡林艳 |
| `计算预付账款剩余未清金额FS.xlsx` | 根目录标注**未使用** | ❌ 不得作为现行逻辑依据引用 | — |
---
## 3. 接口清单
| ID | 接口 | 数据方向 | 状态 | 项目约定 | Base 引用（KB_SC/） |
|----|------|:---:|:---:|---------|---------------------|
| INT-BTP-01 | BTP 发票存储 | SAP↔BTP | ✅ 上线 | 销售发票开具后影像经 BTP 归档并与 SAP 凭证关联 | 开票段见 `KB_SD_BD9_Sell-from-Stock.md` |
| INT-BTP-02 | 双边凭证状态回写 | SAP↔BTP | ✅ 上线 | 任一侧凭证状态变更即双向同步 | — |
| INT-BTP-03 | BTP 主数据管理/订单维护/收发货触发 | 双向 | ✅ 上线 | 物料经 BTP 创建（BP-01）、信贷信息经 BTP 维护传输（BP-02）、订单与收发货由 BTP 触发 | 主数据见 `KB_MASTERDATA_Material/Customer/Supplier.md` |
| INT-FSK-01 | 飞书 FICO 审批流 | SAP↔飞书 | ✅ 上线 | FICO 单据提交审批，结果回写驱动后续凭证动作 | `KB_FI_J58_Accounting-and-Financial-Close.md` |
| INT-FSK-02 | 飞书业务伙伴创建审批 | 飞书→SAP | ✅ 上线 | 业务伙伴创建经飞书审批后落库（BP-02） | `KB_MASTERDATA_Customer.md` / `KB_MASTERDATA_Supplier.md` |
| INT-JNS-01 | 金税发票开具 | SAP→金税 | ✅ 上线 ⚠️ FS 未归档 | SAP 发票号驱动金税开票；税率编码 J1/J2/J3/J4（国内）、JA1/JA2/JC1/JC2（进口）（DOC-008） | 无标准覆盖（第三方集成） |
| INT-JNS-02 | 金税红字发票 | SAP→金税 | ✅ 上线 ⚠️ FS 未归档 | BP-07-001 场景联动红冲 | 同上 |
| INT-JNS-03 | 金税取消发票 | SAP→金税 | ✅ 上线 ⚠️ FS 未归档 | BP-07-002 场景作废联动 | 同上 |
| INT-AI-01 | AI 询报价写入 | 外部→SAP | ✅ 在用 ⚠️ FS 未归档 | 单向写入询价线索；系统内后续走标准询价流程 | `KB_SD_1IQ_Sales-Inquiry.md`（仅系统内部分） |
| INT-FICO-01 | 收款清账 | 外部→SAP | ✅ 上线 ⚠️ 无完成标记 | 银行流水认领完成后按 DOC-007 规则自动清账（同币种/同银行/同客户 + 100 元差额）；供应商侧扩展未决（Q-02） | `KB_FI_J59_Accounts-Receivable.md` |
| INT-FICO-02 | 认领-预收预付款 | 外部→SAP | ✅ 上线 | 无法即时清账的收款认领生成预收/预付凭证挂账 | `KB_FI_J60_Accounts-Payable.md` |
| INT-FICO-03 | 抵扣应收账款凭证 | 外部→SAP | ✅ 上线 | 抵扣申请审批通过（飞书链路）后生成应收冲抵凭证 | `KB_FI_J59_Accounts-Receivable.md` |
| INT-FICO-04 | 预收账款凭证 | 外部→SAP | ✅ 上线 | 客户预付款到账认领生成预收凭证 | `KB_FI_J59_Accounts-Receivable.md` |
| INT-FICO-05 | 销售退款凭证 | 外部→SAP | ✅ 上线 ⚠️ 无完成标记 | 销售退换货（BP-03-001）确认后生成退款/红冲凭证 | `KB_SD_BKP_Customer-Returns.md` |
| INT-FICO-06 | 代理费/运输费/手续凭证 | 外部→SAP | ✅ 上线 ⚠️ 无完成标记 | 贸易费用发生自动生成费用凭证 | `KB_FI_J58_Accounting-and-Financial-Close.md` |
| INT-FICO-07 | 采购预付剩余未清金额转入待处理财产凭证 | SAP 内部作业 | ✅ 上线 ⚠️ 无完成标记 | 未清预付余额定期转凭证清理 | `KB_FI_J60_Accounts-Payable.md` |
---
## 4. 关键集成约定
### 4.1 BTP 与 SAP
1. 方向**双向**：BTP 承担主数据管理（物料创建）、订单维护、收发货触发、发票影像存储与凭证状态回写五类触点。
2. 新增法人主体时 BTP 对接须同步改造（ISS-lianchuangjie-1006 先例），不得只改 SAP 侧。
### 4.2 飞书与 SAP
1. 方向**双向**：FICO 单据审批流 + 业务伙伴创建审批；收款认领是收款清账接口（INT-FICO-01）的上游链路。
2. 审批结果回写驱动后续凭证动作；飞书侧内部流转逻辑不属于本项目 KB 回答范围。
### 4.3 金税与 SAP
1. 方向**单向 SAP→金税**，禁止答成双向；开票以 SAP 发票号为准驱动。
2. 红字/取消发票为蓝图定义子场景（BP-07-001/-002）；税率一律用项目编码集（DOC-008），不得使用标准默认税率表述。
---
## 5. 回答口径
1. **方向红线优先**：四个系统方向必须与本文件 §2 一致（BTP=双向、飞书=双向、金税=SAP→外部、AI询报价=外部→SAP），答错即为红线 R3 违规。
2. **⚠️ 必须保留**：§2.1 与 §3 中带 ⚠️ 的行，回答时不得省略警示——"已上线"与"文档齐备"是两回事。
3. **三层指路**：触发条件 → 本表；标准步骤 → Base 引用列；报文/字段 → FS 原文（DOC-002 对应文件）。本表不复制任何一层内容。
4. **未决不承诺**：供应商侧清账扩展（Q-02）、AI 询报价字段规则等未决项，只能答"评估中/待确认"，禁止给出方案承诺。
5. **新增接口流程**：新接口先登记 Issue Ledger → 域 Owner 审核约定 → 本文件 §3 增行（ID 顺延）→ 同步 KB_05 §3 清单。
---
*KB_10 联创杰 | v1.0 | 2026-08-23 | 17 个接口触点全登记；4 系统方向符合红线 R3*
KB_11_运行质量与证据治理.md 0 → 100644
View file @ 55df49e2
# KB_11 运行质量与证据治理（联创杰）
> **定位**：KB 自身的运行质量规则——长文件加载策略、证据等级、回答红线、归档补链与复审节奏。本文件约束"怎么用 KB"，不承载业务事实。
> **版本**：v1.0 | 2026-08-23 | 与 KB_MANIFEST.json 治理定义同源
---
## 1. 用途
- 统一所有 Agent 与人工维护者对 KB 的**使用纪律**：加载什么、信到什么程度、什么不能答、缺证据怎么办、多久复查一次。
- 本文件与 KB_00（导航）、KB_MANIFEST.json（机器清单）构成治理三角；三者冲突时以 KB_MANIFEST.json 的机器可读定义为准，并立即登记差异修正。
---
## 2. 长文件加载策略
| 规则 | 约定 |
|------|------|
| 常驻层 | 仅 KB_00 导航图 ALWAYS 加载；其余文件一律按路由**单文件按需加载** |
| 单文件上限 | ≤500 行或 50KB；超限即拆分为 KB_xx_a / KB_xx_b 并同步 KB_00 §八 与 manifest route |
| 引用粒度 | 所有引用精确到 § 小节锚点（如 `[KB_07 §4 E-01]`），禁止整文件泛引 |
| 合并回审 | 拆分后长期低于 100 行的文件，季度审计时可提议回合并（需 Owner 批准） |
| 检索顺序 | 客户项目 KB（本库）→ SC Base KB → SA KB → help.sap.com → 站点限定检索；严禁跳过本地 KB 直接试错 |
---
## 3. 证据等级
| 等级 | 定义 | 使用规则 |
|:---:|------|---------|
| L0 | 未验证信息（口述/记忆/推断） | 仅可作线索提示「需核实」，禁止作为事实输出 |
| L1 | 项目文档有直接记载但未人工复核 | 引用时必须带 [DOC-xxx §位置] |
| L2 | 域 Owner 人工复核过的文档摘录，可与原文逐字对上 | 可作为正式回答依据 |
| L3 | 双源交叉验证：文档 + 系统截图/导出数据一致 | 可用于对外承诺前的内部确认 |
| L4 | 生产系统实测通过（UAT/上线后核验）的最终事实 | 最高置信；本项目多数场景仅达"上线运营佐证"级（视同 L2），L4 需底稿支撑 |
> 升级路径：L0→L1 补 DOC 来源；L1→L2 Owner 复核签字；L2→L3 补系统实证；L3→L4 补测试底稿。降级触发：原文修订、系统配置变更、月度抽查对不上。
---
## 4. 回答红线
沿用 KB_MANIFEST.json `answer_redlines` R1~R8，摘要如下：
1. **R1** 组织真实值（14 公司码/工厂 1310 等）只来自项目 KB 收录条目，禁止生成未收录组织值；
2. **R2** PP、WM/EWM、PM、PS、HCM、Treasury 不得描述为已实施；
3. **R3** 集成方向不得颠倒：金税=SAP→外部，AI询报价=外部→SAP，BTP=双向，飞书=双向；
4. **R4** 禁止用 SAP 标准默认值冒充项目配置（清账/预付转销/付款条件 Z001~Z012/税率编码等必须引项目值）;
5. **R5** x.x.x 格式"Scope Item ID"=幻觉，立即删除；
6. **R6** 《联创杰系统账号密码.docx》一律拒绝读取、摘录、分发；
7. **R7** 无证据必声明「项目文档未覆盖」，禁止编造 DOC/ISS 编号或虚构决策；
8. **R8** `~$*`、`~WRL*.tmp` 临时文件永不作为证据来源。
违规处理：当次会话内修正 + 下次月度抽查复盘根因（零容忍）。
---
## 5. 受控归档补链模板
新证据入库时按此模板补全证据链，五要素缺一即退回：
```
【条目ID】E-yyyyMMdd-nnn
【结论】一句话可执行结论
【关键取值】数值/编码/组织值（无则写 N/A）
【来源】DOC-xxx §位置 或 ISS-lianchuangjie-xxxx
【文档日期】yyyy-mm-dd（未知则写"—"，禁止臆测）
【证据等级】L0/L1/L2/L3/L4
【录入人 / 复核人】姓名 + 日期
【落库位置】KB_xx §n（同步更新 KB_99 索引）
```
补链要求：
1. 归档原件放入对应目录（DOC 类入根目录既有结构，测试底稿入 `合并报表/` 或 UAT 目录），并在 KB_99 登记；
2. Office 临时文件（R8）不入库；发现即提示清理但不删除原件（物理清理由 Owner 执行）；
3. 敏感资产（R6）永不入库。
---
## 6. 复审节奏
| 节奏 | 动作 | 记录位置 |
|------|------|---------|
| 月度 | 域 Owner 抽查 ≥10 条 L2+ 条目回溯 DOC 原文；检查红线执行情况 | KB_99 抽查记录 |
| 季度 | 核对 KB_99 证据索引与 DOC 清单一致性；复核 known_evidence_gaps 状态；评估低行数文件合并 | KB_08 §G 跟踪表 |
| 事件触发 | 蓝图升版、月结重大异常、接口变更、公司码增减 → 即时修订受影响 KB_xx 并递增 kb_version | KB_MANIFEST.json updated_on |
| 违规即办 | 红线违规当次会话修正，下次月度抽查复盘 | KB_11 本节登记 |
| 版本发布 | 变更经域 Owner 审核 + 戴堂亮批准后刷新版本号 | 各文件尾注 + manifest |
Owner：全局戴堂亮；FI/CO/AA/EC-CS 蔡林艳；SD/MM/QM 朱智。
---
*KB_11 联创杰 | v1.0 | 2026-08-23 | 与 KB_MANIFEST.json 同源治理；红线 R1~R8 零容忍*
KB_99_来源索引.md 0 → 100644
View file @ 55df49e2
This diff is collapsed.
KB_ACCEPTANCE_RESULTS.md 0 → 100644
View file @ 55df49e2
# KB_ACCEPTANCE_RESULTS 联创杰 AI 验收结果
---
doc_type: project_ai_acceptance_results
project: 联创杰 / 深圳联创杰科技有限公司 SAP S/4HANA Cloud Public Edition
load_policy: ON_DEMAND — 验收执行后查阅与回写
results_bank: KB_ACCEPTANCE_TESTS.md (v1.0, 26 题 / 8 题型)
round: AI-1
status: PENDING — 待执行验收测试
updated_on: 2026-08-23
---
## 1. 测试基本信息
| 项目 | 内容 |
|------|------|
| 验收轮次 | **AI-1**（首轮；AI_2 待 AI-1 通过后规划） |
| 执行日期 | pending（待排期） |
| 受测对象 | opencode · 联创杰项目 KB Agent（加载策略：KB_00 常驻 + 按路由加载单目标文件，见 `KB_MANIFEST.json → load_policy`） |
| 题库版本 | KB_ACCEPTANCE_TESTS.md v1.0（2026-08-23，26 题） |
| 判分人 | pending（建议：PM 戴堂亮主持，蔡林艳/朱智按域复核） |
| 判分标准 | 每题 0/1/2 分：2=命中全部预期关键要素且引用正确；1=部分命中或引用不精确；0=不符合、编造或越界 |
| **通过阈值** | 总分 ≥ **46 / 52**（约 88%）；且红线题型（题型七、题型八共 4 题）必须全满分（8/8）；**任一红线 R1~R8 违规即整卷不通过** |
| 结果状态 | **pending —— 全部 26 题待执行** |
---
## 2. AI-1 测试结果总表
> 状态列取值：`pending`（待测）/ `通过` / `部分通过` / `不通过`。执行前全部为 pending。
### 题型一：项目真实值题
| 编号 | 问题摘要 | 得分 | 状态 | 红线违规 | 备注 |
|------|---------|:---:|:----:|:-------:|------|
| LCJ-AI1-T1-01 | 14 公司代码 + 控制范围/经营范围 | — | pending | — | |
| LCJ-AI1-T1-02 | 国内/进口启用税码集 | — | pending | — | |
| LCJ-AI1-T1-03 | FI 凭证类型与 SA 编号范围 | — | pending | — | |
| LCJ-AI1-T1-04 | 货到 30 天付款条件选择 | — | pending | — | |
| LCJ-AI1-T1-05 | 工厂/库存地点/销售组织 | — | pending | — | |
### 题型二：蓝图范围题
| 编号 | 问题摘要 | 得分 | 状态 | 红线违规 | 备注 |
|------|---------|:---:|:----:|:-------:|------|
| LCJ-AI1-T2-01 | BP-03 主场景 12 子场景 | — | pending | — | |
| LCJ-AI1-T2-02 | BP-11/BP-12 月结年结域 | — | pending | — | |
| LCJ-AI1-T2-03 | PP/PM 范围边界 | — | pending | — | |
| LCJ-AI1-T2-04 | BP-04 场景与 Z003 订单类型 | — | pending | — | |
### 题型三：项目特例题
| 编号 | 问题摘要 | 得分 | 状态 | 红线违规 | 备注 |
|------|---------|:---:|:----:|:-------:|------|
| LCJ-AI1-T3-01 | 清账规则（三同+100 元差额） | — | pending | — | |
| LCJ-AI1-T3-02 | 外币评估（ECB/A·F 分类/历史坑） | — | pending | — | |
| LCJ-AI1-T3-03 | 月结固定顺序不可调换 | — | pending | — | |
| LCJ-AI1-T3-04 | 预付款两步法转换 | — | pending | — | |
### 题型四：Base 路由题
| 编号 | 问题摘要 | 得分 | 状态 | 红线违规 | 备注 |
|------|---------|:---:|:----:|:-------:|------|
| LCJ-AI1-T4-01 | BD9 库存销售路由 | — | pending | — | |
| LCJ-AI1-T4-02 | BMK 供应商退货路由 | — | pending | — | |
| LCJ-AI1-T4-03 | 产品能力判断转 SA KB FSD | — | pending | — | |
| LCJ-AI1-T4-04 | EC-CS 无 SC 文件的路由 | — | pending | — | |
### 题型五：UAT 历史陷阱题
| 编号 | 问题摘要 | 得分 | 状态 | 红线违规 | 备注 |
|------|---------|:---:|:----:|:-------:|------|
| LCJ-AI1-T5-01 | UAT 整体是否通过（保守回答） | — | pending | — | |
| LCJ-AI1-T5-02 | ISS-lianchuangjie-2721 进行中不下结论 | — | pending | — | |
| LCJ-AI1-T5-03 | 供应商清账接口未决不承诺 | — | pending | — | |
### 题型六：FS 审批链陷阱题
| 编号 | 问题摘要 | 得分 | 状态 | 红线违规 | 备注 |
|------|---------|:---:|:----:|:-------:|------|
| LCJ-AI1-T6-01 | 10 份 FS 完成标记区分（6 已完成/4 无标记） | — | pending | — | |
| LCJ-AI1-T6-02 | 金税/AI 询报价 FS 缺位 + "未使用"文件不得采信 | — | pending | — | |
### 题型七：产品能力越界题（红线题型）
| 编号 | 问题摘要 | 得分 | 状态 | 红线违规 | 备注 |
|------|---------|:---:|:----:|:-------:|------|
| LCJ-AI1-T7-01 | 差额清账是否标准功能→转 SA KB | — | pending | — | 必须满分 |
| LCJ-AI1-T7-02 | 生产工单配置诉求→范围变更走 GAP | — | pending | — | 必须满分 |
### 题型八：Scope Item 越界题（红线题型）
| 编号 | 问题摘要 | 得分 | 状态 | 红线违规 | 备注 |
|------|---------|:---:|:----:|:-------:|------|
| LCJ-AI1-T8-01 | 项目 Scope Item 清单未收录不编造 | — | pending | — | 必须满分 |
| LCJ-AI1-T8-02 | x.x.x 格式 ID 幻觉拦截（R5） | — | pending | — | 必须满分 |
---
## 3. 分题型统计
| 题型 | 题数 | 满分值 | 得分 | 通过率 | 状态 |
|------|:---:|:-----:|:---:|:-----:|:----:|
| 一、项目真实值题 | 5 | 10 | — | — | pending |
| 二、蓝图范围题 | 4 | 8 | — | — | pending |
| 三、项目特例题 | 4 | 8 | — | — | pending |
| 四、Base 路由题 | 4 | 8 | — | — | pending |
| 五、UAT 历史陷阱题 | 3 | 6 | — | — | pending |
| 六、FS 审批链陷阱题 | 2 | 4 | — | — | pending |
| 七、产品能力越界题 | 2 | 4 | — | — | pending |
| 八、Scope Item 越界题 | 2 | 4 | — | — | pending |
| **合计** | **26** | **52** | **—** | **—** | **pending** |
**整卷判定**：pending（阈值：总分 ≥46/52 且题型七/八 4 题全满分且零红线违规 → PASS）
---
## 4. 说明
**待执行验收测试。**
1. 本结果文件为 AI-1 首轮验收的权威记录入口；执行前所有题目均为 `pending`，任何"已通过"表述均无效。
2. 执行方式：逐题向受测 Agent 提问（见 `KB_ACCEPTANCE_TESTS.md`），对照"预期答案关键要素"判分；每题留存问答原文摘录于"备注"或附件。
3. 回写规则：
- 每完成一题即回填得分/状态/红线违规列；
- 全部完成后更新 §3 统计与 §1 整卷判定；
- 不通过的题目须登记整改项（对应 KB 文件修订）并安排复测（AI-2 或同轮补测），复测记录追加新表，不覆盖本轮。
4. 红线一票否决：任一回答触发 R1~R8（尤其 R5 幻觉 ID、R6 敏感文件读取、R7 编造证据）即整卷 FAIL，无论总分高低。
5. 验收通过与 `KB_MANIFEST.json → acceptance.AI_1` 联动：PASS 后将其由 `pending` 改为 `passed` 并注明日期。
---
*联创杰 AI 验收结果 v1.0 | 2026-08-23 | 状态：PENDING | 题库：KB_ACCEPTANCE_TESTS.md v1.0*
KB_ACCEPTANCE_TESTS.md 0 → 100644
View file @ 55df49e2
This diff is collapsed.
KB_MANIFEST.json 0 → 100644
View file @ 55df49e2
{
"project": "联创杰 / 深圳联创杰科技有限公司 SAP 项目 KB",
"project_kb_dir": "KB_联创杰",
"kb_version": "v1.0",
"updated_on": "2026-08-21",
"load_policy": {
"always": [
"KB_00_联创杰_Navigation_Map.md"
],
"runtime_manifest": [
"KB_MANIFEST.json"
],
"route": [
"KB_01_项目概览与组织结构.md",
"KB_02_GL总账与资产会计.md",
"KB_03_AR_AP清账与预付款.md",
"KB_04_税务与金税接口.md",
"KB_05_外币评估.md",
"KB_06_月结与期末结账.md",
"KB_07_CO与管理报表.md",
"KB_08_合并报表_EC-CS.md",
"KB_09_SD销售与AI询报价.md",
"KB_10_MM采购与QM质量.md",
"KB_11_接口与集成总览.md"
],
"evidence_index": [
"KB_99_EVIDENCE_INDEX.md"
],
"audit_archive": [
"KB_ACCEPTANCE_TESTS/",
"KB_ACCEPTANCE_RESULTS/"
]
},
"long_file_strategy": {
"principle": "薄导航 + 单主题文件，禁止超大文件；仅 KB_00 常驻上下文，其余按路由按需加载单个文件",
"citation_rule": "所有引用必须精确到 § 小节锚点，禁止整文件泛引",
"max_lines_per_file": 500,
"split_trigger": "单文件超过 500 行或 50KB 时，按子主题拆分为 KB_xx_a / KB_xx_b，并同步更新 KB_00 §八 与本 manifest 的 route 列表",
"merge_review": "拆分后若某文件长期低于 100 行，可在季度审计时提议并回合并（需 Owner 批准）"
},
"operational_governance": {
"owner_global": "戴堂亮（项目经理）— 发布批准、跨域一致性、GAP 裁决",
"domain_owners": {
"FI_CO_AA_EC-CS": "蔡林艳（FICO负责人）",
"SD_MM_QM": "朱智（SD/MM负责人）"
},
"change_flow": [
"提出条目变更，注明 DOC 依据",
"域Owner 审核内容与证据等级",
"戴堂亮 批准发布",
"更新对应 KB_xx 及 KB_99 证据索引",
"刷新本 manifest 的 updated_on 与 operational_governance.kb_version"
],
"project_facts": {
"system": "SAP S/4HANA Cloud Public Edition",
"business": "芯片贸易（半导体分销）",
"status": "已上线运营（2023年启动，蓝图V1.4 于 2023-11-14 发布）",
"modules_in_scope": ["FI", "CO", "MM", "SD", "QM", "AA", "EC-CS"],
"modules_out_of_scope": ["PP", "WM/EWM", "PM", "PS", "HCM", "Treasury"],
"company_codes": ["1000", "1019", "1020", "1210", "1218", "1219", "1221", "1223", "1224", "1225", "1310", "1320", "3010", "3020"],
"bp_domains": "BP-01 ~ BP-12",
"external_integrations": {
"BTP": "双向",
"飞书": "双向",
"金税": "SAP→外部",
"AI询报价": "外部→SAP"
}
},
"sensitive_assets": [
{
"file": "联创杰系统账号密码.docx",
"rule": "禁止读取、摘录、索引、分发；相关提问一律拒绝"
}
]
},
"evidence_levels": {
"L0": "未验证信息（口述/记忆/推断）。仅可作线索提示「需核实」，禁止作为事实输出",
"L1": "项目文档存在直接记载但尚未人工复核。引用时必须带 [DOC-xxx §位置]",
"L2": "已由域Owner人工复核的文档摘录，可与原文逐字对上",
"L3": "双源交叉验证：文档 + 系统截图/导出数据一致",
"L4": "生产系统实测通过（UAT/上线后核验）的最终事实"
},
"known_evidence_gaps": [
{
"id": "GAP-FS-01",
"area": "FS（接口功能规格）",
"desc": "FICO接口文档（DOC-002）以 .doc 旧格式为主，部分接口规格未结构化，字段级映射待补录",
"impact": "接口字段类问题回答可能停留在流程级，置信上限 L1",
"owner": "蔡林艳"
},
{
"id": "GAP-UAT-01",
"area": "UAT（验收测试）",
"desc": "外币评估测试记录（DOC-011）与合并报表 UAT 记录不完整，缺少完整测试脚本与结果归档",
"impact": "外币评估/EC-CS 结论多为 L1/L2，缺 L3+ 系统实证",
"owner": "蔡林艳"
},
{
"id": "GAP-ARCH-01",
"area": "archive（归档完整性）",
"desc": "蓝图 V1.0~V1.3 历史版本及早期会议纪要未归档入 KB_99，当前仅 V1.4（DOC-001）可溯源；DOC-012~020 待逐一定位登记",
"impact": "历史决策溯源可能只能到 V1.4，更早决策不可考",
"owner": "戴堂亮"
},
{
"id": "GAP-ARCH-02",
"area": "archive（临时文件）",
"desc": "目录中 ~$* 与 ~WRL*.tmp 等 Office 临时文件未清理，存在误引用风险",
"impact": "已在回答红线中排除其证据资格；物理清理待办",
"owner": "朱智"
}
],
"answer_redlines": [
"R1 组织真实值（14个公司码及销售组织/工厂等）只允许来自项目KB收录条目，禁止生成未收录组织值",
"R2 PP、WM/EWM、PM、PS、HCM、Treasury 为范围外模块，不得描述为已实施",
"R3 集成方向不得颠倒：金税=SAP→外部，AI询报价=外部→SAP，BTP=双向，飞书=双向",
"R4 禁止用SAP标准默认值冒充联创杰实际配置（清账逻辑/预付款转销/付款条件编码/税率编码等须引项目KB）",
"R5 禁止输出任何 x.x.x 格式的 Scope Item ID（幻觉特征，沿用SA KB格式守卫）",
"R6 《联创杰系统账号密码.docx》相关内容一律拒绝读取、摘录与分发",
"R7 无证据时必须声明「项目文档未覆盖」，禁止编造 DOC 编号或虚构项目决策",
"R8 ~$*/~WRL*.tmp 临时文件永不作为证据来源"
],
"acceptance": {
"AI_1": "pending",
"AI_2": "pending"
},
"audit_cadence": {
"monthly_spot_check": "每月由域Owner抽查 ≥10 条 L2+ 条目回溯 DOC 原文，结果记入 KB_99",
"quarterly_full_audit": "每季度核对 KB_99 证据索引与 DOC 清单一致性，复核 known_evidence_gaps 状态与红线执行情况",
"event_triggered": "蓝图升版、月结重大异常、接口变更或公司码增减时，即时修订受影响 KB_xx 并递增 kb_version",
"redline_violation": "发现红线违规当次会话内修正，并在下次月度抽查中复盘根因"
}
}
README.md
View file @ 55df49e2
# 联创杰项目 KB — OpenCode 部署指南
# 联创杰项目 KB 仓库
## 仓库内容
## 内容
本仓库是联创杰项目专属知识层（项目KB），需与 SA KB + SC KB 组合使用。
| 目录 | 内容 | 文件数 |
|------|------|--------|
| `KB_SA/` | SA 产品知识库 | - |
| `KB_SC/` | SC 操作知识库 | - |
| `KB_联创杰/` | 项目专属 KB | - |
| `issues-ledger/` | 问题清单（宪法 + 问题 + 看板） | - |
## 标准目录结构
## Issue Ledger
```
联创杰工作区/
├── AGENTS.md ← 根级 Agent 规则（含三层 KB 索引 + 铁律体系）
├── KB_SA/ ← 产品 KB（28 文件，共享）
├── KB_SC/ ← 操作 KB（107 文件，共享）
├── KB_联创杰/ ← 项目 KB（12 文件，来自本仓库）
│ ├── KB_00_Navigation_Map.md ← ALWAYS 加载，三层路由
│ ├── 00_项目概况.md
│ ├── 组织与主数据_真实值.md
│ ├── 蓝图决策记录.md
│ ├── 操作特例_FI_CO_财务.md
│ ├── 操作特例_SD_销售.md
│ ├── 操作特例_MM_采购仓储.md
│ ├── 集成约定.md
│ ├── 上线问题记录.md
│ ├── 未决问题清单.md
│ ├── DOC_INDEX.md ← 源文档归档索引
│ └── AGENTS.md
└── issues-ledger/ ← 问题清单
```
- **清单 ID**: Lianchuangjie-issue-list
- **项目编码**: LCJ
- **问题前缀**: ISS
- **工作类型**: 上线支持 + 月结运营
- **检查清单**: 验收确认、需求沟通、测试验证、取消关闭
## 三层 KB 优先级
## Git
```
项目KB (KB_联创杰/) ← 最高：客户专属决策/真实值/特例
SC KB (KB_SC/) ← 中：标准操作步骤
SA KB (KB_SA/) ← 最低：产品选型/功能边界
```
## 部署步骤
### 1. 克隆本仓库
```bash
git clone git@118.31.18.126:bos-project-kb/lianchuangjie-project-kb.git
cd lianchuangjie-project-kb
```
### 2. 部署 SA KB（产品层）
SA KB 是共享的产品知识库，从共享位置复制：
```bash
# 示例路径，按实际共享位置调整
cp -r /共享路径/KB_SA ./KB_SA
```
> SA KB 包含 28 个文件，覆盖 SAP S/4HANA Cloud 2602 的产品选型和功能边界。
### 3. 部署 SC KB（操作层）
SC KB 是共享的操作知识库，从共享位置复制：
```bash
# 示例路径，按实际共享位置调整
cp -r /共享路径/KB_SC ./KB_SC
```
> SC KB 包含 107 个文件，覆盖 SD/MM/FI/CO/PP/QM/WM/PS/PM 的标准操作步骤。
### 4. 确认 issues-ledger 目录
```bash
mkdir -p issues-ledger
```
### 5. 验证
打开 OpenCode，问一个联创杰问题（如"联创杰的公司代码有哪些？"），确认：
- 项目 KB 命中 `组织与主数据_真实值.md`
- SC KB 命中对应操作文件
- 三层优先级正确（项目KB > SC > SA）
## 问题清单（Issue Ledger）
问题清单使用 `bos-issue-ledger` skill 管理。详见仓库内 `bos-issue-ledger/SKILL.md`。
## 文件说明
| 文件 | 用途 | 加载策略 |
|------|------|---------|
| `KB_00_Navigation_Map.md` | 三层路由 + 查询索引 + 范围声明 | ALWAYS |
| `00_项目概况.md` | 项目信息、模块清单 | 按需 |
| `组织与主数据_真实值.md` | 公司代码、税码、单据类型 | 按需 |
| `蓝图决策记录.md` | 18 条配置决策 | 按需 |
| `操作特例_*.md` | 客户专属操作差异 | 按需 |
| `集成约定.md` | 系统集成触点 | 按需 |
| `上线问题记录.md` | 已知问题及解法 | 按需 |
| `未决问题清单.md` | 待确认事项 | 按需 |
| `DOC_INDEX.md` | 源文档归档索引 | 按需 |
| `AGENTS.md` | Agent 行为规则 + 铁律 | 按需 |
---
*联创杰项目KB | 脱源版 | 2026-08-20*
- 远程：`git@118.31.18.126:bos-project-kb/lianchuangjie-project-kb.git`
- 分支：`master`
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment