Files
sap-cli-skill/docs/dev/adt-endpoint-reference.md
吴让宇 c5905a5b1e refactor: 本仓升为唯一源(原 sap-cli 源码仓归档)
方向反转:此前 SKILL.md 是「模板渲染产物」、sap-cli 是源;现 sap-cli 归档,
sap-cli-skill 承接开发与分发,SKILL.md 回归手工维护的正本。

迁移(来自 sap-cli,共 104 文件):
- tests/           692 例测试(15 个文件的内联 sys.path 改指 assets/)
- openspec/        SDD 规格与归档变更(42 文件)
- docs/            开发文档与 ADT 原理(含 dev/CLAUDE.md、AGENTS.md)
- .claude/         rules 副本 + settings.json(供 Claude Code)
- .github/ .hermes/ .pre-commit-config.yaml .editorconfig CLAUDE.md
- scripts/ 保持仅 setup.py(pack_skill.py 已随旧仓归档,不迁)

修复(迁移暴露的真实缺陷):
- assets/pyproject.toml 的 build-backend 写作 `setuptools.backends._legacy:_Backend`,
  该模块在 setuptools 中不存在 → `pip install -e` 从来装不上。改为 build_meta。
  实测:临时 venv 安装成功,sap-cli --help 正常列出 31 个命令
- pyproject readme 指向不存在的 assets/README.md(editable 安装会失败)→ 改内联文本
- pyproject urls 改指 sap-cli-skill

机制调整:
- .github/workflows/ci.yml 适配 assets/ 布局;顶部注明该工作流仅 GitHub 执行,
  本仓在 Gitee 不会自动跑
- pre-commit 增本地测试门禁(Gitee 上真正生效的那道)
- .gitignore 合并旧仓完整规则(保留 log/ 下 md 知识库入库,只忽略运行日志)
- 大文件上限 100KB→1MB(架构图 512KB)

守卫测试 tests/unit/test_repo_guards.py(10 → 18 例):
- SKILL.md 须记录 parser 全部 CLI 命令 / 铁律 1-5 须为真实小节标题 / 示例不得违反铁律 5
- references/ 规则齐备;.claude/rules 与 references 必须一致(实测抓到一次真实漂移)
- VERSION == sapcli.__version__ == README 版本
- 仓内不得再出现 pack_skill.py / skill-src(防废弃流程回潮)

698 tests OK;editable 安装与 CLI 入口经临时 venv 实测通过。
docs/RELEASING.md 重写为单源开发流程。
2026-09-11 00:40:15 +08:00

52 lines
2.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# ADT 对象类型码映射(来源:abap-adt-api objectcreator.ts
## 已确认的 ADT 可创建类型
| TypeId | 对象类型 | ADT 端点路径 |
|--------|---------|-------------|
| CLAS/OC | Class | /oo/classes |
| INTF/OI | Interface | /oo/interfaces |
| PROG/P | Program/Report | /programs/programs |
| PROG/I | Include | /programs/includes |
| FUGR/F | Function Module | /functions/groups/{grp}/fmodules |
| FUGR/FF | Function Group | /functions/groups |
| DOMA/DD | Domain | /ddic/domains |
| DTEL/DE | Data Element | /ddic/dataelements |
| TABL/DT | Table | /ddic/tables |
| TABL/DS | Structure | /ddic/structures |
| MSAG/N | Message Class | /oo/t100/messages/classes |
| DDLS/DF | CDS View (DDL Source) | /ddic/ddlsources |
| DCLS/DL | CDS Access Control (DCL) | /ddic/dclsources |
| DDLX/EX | Metadata Extension | /ddic/metadataextensions |
| DDLA/ADF | Abstract Entity | /ddic/ddlabstractentities (推测) |
| SRVD/SRV | Service Definition | /ddic/servicedefinitions (推测) |
| AUTH | Authorization Object | (需验证) |
| SUSO/B | Auth Check Object | (需验证) |
## 确认不在 ADT 标准创建列表中的类型
| 类型 | 原因 | 替代方案 |
|------|------|---------|
| Type Group (TYPE-POOL) | ADT 可能归入 programs | 通过 /programs/typegroups 尝试 |
| Number Range Object | 无 ADT 创建端点 | 需 RFCNUMBER_RANGE_GET_INFO |
| Enhancement Spot | 使用专用 /enhancements 端点 | 需验证 |
| Behavior Definition (BDEF) | RAP 专用,S/4HANA Cloud 才有 | NW 7.40 可能不支持 |
| SICF Service | 使用 /discovery/services | 需验证 |
| Table Type | 通过 VIT 端点 | 已有部分支持 |
## Phase 2 调整建议
### 可直接实现(ADT 有标准端点)
- ✅ DCL (CDS Access Control) — /ddic/dclsources,类似 CDS View
- ✅ DDLX (Metadata Extension) — /ddic/metadataextensions,类似 CDS View
- ✅ DDLA (Abstract Entity) — 类似 CDS View
### 需要验证端点后决定
- ⚠️ Type Group — 可能在 /programs/typegroups
- ⚠️ Enhancement Spot — 可能在 /enhancements
- ⚠️ SICF Service — 可能通过 /discovery/services
### NW 7.40 不支持(需移到远期)
- ❌ Behavior Definition (BDEF) — RAP 专用,NW 7.40 无此功能
- ❌ Number Range Object — 无 ADT 端点,需 RFC