sap-cli-skill/openspec/spec-coverage-report.md

Spec-to-Code 需求覆盖验证报告

生成时间: 2026-06-09 对照 openspec/specs/ 下 7 个 spec 文件 vs sapcli/ 源码

---

1. Connection (connection/spec.md)

#	Scenario	状态	说明
1.1	Successful login	✅已实现	client.py:login() 使用 HTTP Basic Auth，app.py:101-102 打印"登录成功"
1.2	Login failure	✅已实现	client.py:62 raise LoginError，app.py:144-146 捕获 SapCliError 以非零退出码退出
1.3	Config not found	✅已实现	config.py:25-29 SAPConfig.__post_init__ 检查缺失字段抛 ConfigError，app.py:91-95 打印缺失提示和环境变量名称
1.4	Load from config file	✅已实现	config.py:32-49 搜索并读取 config.ini
1.5	Environment variable override	✅已实现	config.py:53-57 os.environ.get("SAP_XXX", sap.get(...)) 环境变量优先
1.6	Profile selection (--profile)	❌未实现	parser.py:69 定义了 --profile 参数，但 config.py:51 硬编码 cfg["SAP"]，未使用 args.profile
1.7	Client number default "100"	✅已实现	config.py:55 sap.get("client", "100")
1.8	Custom config path (--config)	✅已实现	parser.py:67 + app.py:88 传入 args.config
1.9	No command specified	✅已实现	app.py:77-79 检测 not args.command 打印帮助并以 exit(1) 退出

小计: 8/9 ✅, 1 ❌

---

2. Object Lifecycle (object-lifecycle/spec.md)

#	Scenario	状态	说明
2.1	Create with default template	⚠️部分实现	crud.py:31-58 仅有 report/class/function/interface 四种模板，其他 12 种类型无默认模板
2.2	Create with custom source file	✅已实现	crud.py:690-695 --source 参数读取文件
2.3	Create DDIC with --definition	✅已实现	crud.py:771-876 domain/dataelement/table/structure/tabletype 有 JSON→XML 转换
2.4	Create message class	❌未实现	types.py 未注册 messageclass 对象类型，无法 create/download/info/delete
2.5	Create database view	❌未实现	types.py 未注册 view 对象类型
2.6	Create search help	❌未实现	types.py 未注册 searchhelp 对象类型
2.7	Create lock object	❌未实现	types.py 未注册 lockobject 对象类型
2.8	Create already existing object	✅已实现	crud.py:642-644 检测 object_exists 后抛 ObjectAlreadyExistsError
2.9	Create with --corr_nr	✅已实现	parser.py:110 + crud.py:652-655 传入传输请求号
2.10	Download existing object	✅已实现	crud.py:73-122 完整实现，文件名小写+.abap
2.11	Download non-existent object	✅已实现	crud.py:95-98 检测不存在抛 ObjectNotFoundError
2.12	Download function type (group/module)	✅已实现	types.py:152-167 解析 组名/模块名 格式
2.13	Download type without source	✅已实现	crud.py:82-85 检测 src_uri is None 报错
2.14	Download view DDL source	❌未实现	view 类型未在 types.py 注册
2.15	Full sync success (lock→write→unlock→check→activate)	✅已实现	crud.py:226-317 完整五步流程，每步报告进度
2.16	Auto-create on sync	✅已实现	crud.py:213-224 检测不存在则自动创建空对象
2.17	Syntax check failure	✅已实现	crud.py:277-287 报告行号和错误描述
2.18	Activation failure	✅已实现	crud.py:308-317 报告激活错误详情
2.19	Sync with --corr_nr	✅已实现	crud.py:230-231 贯穿整个流程
2.20	Query existing object info	✅已实现	crud.py:371-449 显示名称/类型/描述/状态/负责人等元数据
2.21	Query non-existent object	✅已实现	crud.py:406-408 404 检测
2.22	Query message class info	❌未实现	messageclass 未注册
2.23	Query view info	❌未实现	view 未注册
2.24	Delete with confirmation	✅已实现	crud.py:483-486 input("yes") 确认
2.25	Delete cancelled	✅已实现	crud.py:484-486 非确认则取消
2.26	Delete non-existent object	✅已实现	crud.py:474-477 检测不存在抛 ObjectNotFoundError
2.27	Delete message class	❌未实现	messageclass 未注册
2.28	Delete lock object	❌未实现	lockobject 未注册

小计: 16/28 ✅, 7 ❌, 1 ⚠️

缺失对象类型汇总

以下 5 种对象类型在 spec 中列出但未在 types.py 中注册：

• messageclass — 无 ObjectTypeConfig、无 URI 模板、无 create/download/info/delete
• view — 无 ObjectTypeConfig、无 URI 模板
• searchhelp — 无 ObjectTypeConfig、无 URI 模板
• lockobject — 无 ObjectTypeConfig、无 URI 模板
• include — 无 ObjectTypeConfig（仅在 scanner.py 的 DIRECTORY_TYPE_MAP 中映射，但 parse_object_name 会报错）
• cdsview — 无 ObjectTypeConfig（CDS 通过独立命令 cds 子系统处理，不走通用 CRUD 流程）

---

3. Batch Operations (batch-ops/spec.md)

#	Scenario	状态	说明
3.1	Init new project	✅已实现	batch.py:19-96 扫描→查询→生成 manifest.json
3.2	Manifest tracks objects	✅已实现	manifest.py 完整 CRUD + to_dict/from_dict 持久化
3.3	Query pending objects	✅已实现	manifest.py:139-146 pending_objects() 方法
3.4	Scan standard directories	✅已实现	scanner.py:13-29 14 种目录映射 + _scan_flat_directory
3.5	Function directory structure	✅已实现	scanner.py:91-121 子目录=组名，文件名=模块名
3.6	Skip hidden files	✅已实现	scanner.py:77 filename.startswith(".") 跳过
3.7	Sort by dependency	✅已实现	sorter.py:40-109 Kahn 算法拓扑排序 + TYPE_PRIORITY
3.8	Detect cyclic dependency	✅已实现	sorter.py:100-105 抛 CyclicDependencyError 并显示循环链
3.9	Ignore external dependencies	✅已实现	sorter.py:63-65 dep not in names 时忽略
3.10	Sync all objects (--all)	✅已实现	batch.py:164-328 完整批量同步
3.11	Dry run mode (--dry-run)	✅已实现	batch.py:172,224-241 仅显示计划不执行
3.12	Fail fast mode (--fail-fast)	✅已实现	batch.py:173,287-289 失败立即 break
3.13	Refresh object status	✅已实现	batch.py:99-161 逐个查询 SAP 状态更新清单

小计: 13/13 ✅

---

4. Search and Browse (search-browse/spec.md)

#	Scenario	状态	说明
4.1	List by type with prefix	⚠️部分实现	search.py:31-71 命令层已实现，但调用 client.list_objects() — client.py 中缺少该方法定义
4.2	List without filter	⚠️部分实现	同上，命令层有，client 层缺失
4.3	Find references (whereused)	⚠️部分实现	search.py:74-109 命令层已实现，但调用 client.where_used() — client.py 中缺少该方法定义
4.4	No references found	⚠️部分实现	search.py:97-98 显示无引用信息，但依赖缺失的 client 方法
4.5	Search by keyword	⚠️部分实现	search.py:112-147 命令层已实现，但调用 client.search_code() — client.py 中缺少该方法定义
4.6	Search no results	⚠️部分实现	search.py:136-137 显示无结果信息，但依赖缺失的 client 方法
4.7	Diff with differences	⚠️部分实现	diff_cmd.py:16-90 命令层完整，但调用 client.read_source_for_diff() — client.py 中缺少该方法定义
4.8	Diff identical	⚠️部分实现	diff_cmd.py:70-72 检测无差异，但依赖缺失的 client 方法
4.9	Download CDS view	⚠️部分实现	cds.py:31-61 命令层完整，但调用 client.get_cds_source() — client.py 中缺少该方法定义
4.10	Create CDS view	⚠️部分实现	cds.py:130-171 命令层完整，但调用 client.create_cds() — client.py 中缺少该方法定义
4.11	Query package info	⚠️部分实现	package_cmd.py:56-77 命令层完整，但调用 client.get_package_info() — client.py 中缺少该方法定义
4.12	Create package	⚠️部分实现	package_cmd.py:29-53 命令层完整，但调用 client.create_package() — client.py 中缺少该方法定义

小计: 0/12 ✅, 12 ⚠️ (命令层均已完成，但 ADTClient 缺少对应的 API 方法)

client.py 缺失的方法清单

以下方法被 commands/ 调用但未在 client.py 中定义：

1. list_objects(obj_type, package, prefix) — 被 search.py, package_cmd.py 调用
2. where_used(name, obj_uri, adt_type) — 被 search.py 调用
3. search_code(query, obj_type) — 被 search.py 调用
4. read_source_for_diff(name, obj_type) — 被 diff_cmd.py 调用
5. get_cds_source(name) — 被 cds.py 调用
6. create_cds(name, description, ddl_source) — 被 cds.py 调用
7. create_package(name, description, superpackage) — 被 package_cmd.py 调用
8. get_package_info(name) — 被 package_cmd.py 调用

---

5. Transport Management (transport/spec.md)

#	Scenario	状态	说明
5.1	List transport requests	✅已实现	transport.py:32-56 + client.py:249-280 list_transport_requests()
5.2	Query transport info	⚠️部分实现	transport.py:59-79 命令层已实现，但调用 client.transport_info() — client.py 中缺少该方法定义
5.3	Release transport request	⚠️部分实现	transport.py:82-107 命令层已实现，但调用 client.transport_release() — client.py 中缺少该方法定义
5.4	List objects in transport	⚠️部分实现	transport.py:110-136 命令层已实现，但调用 client.transport_objects() — client.py 中缺少该方法定义

小计: 1/4 ✅, 3 ⚠️

client.py 缺失的方法（Transport）

1. transport_info(corr_nr) — 传输请求详情查询
2. transport_release(corr_nr) — 释放传输请求
3. transport_objects(corr_nr) — 传输请求中的对象列表

---

6. Code Quality (quality/spec.md)

#	Scenario	状态	说明
6.1	Check with findings	⚠️部分实现	quality.py:14-61 命令层完整，但调用 client.atc_check() — client.py 中缺少该方法定义
6.2	Check clean	⚠️部分实现	quality.py:38-39 显示通过信息，但依赖缺失的 client 方法
6.3	Format source code	⚠️部分实现	quality.py:64-132 命令层完整，但调用 client.pretty_print() — client.py 中缺少该方法定义
6.4	Analyze project dependencies	✅已实现	analyze.py:39-126 本地源码解析，正则匹配 TYPE REF TO / CALL FUNCTION 等模式
6.5	Scaffold from template	✅已实现	scaffold.py:198-239 4 种模板（alv-report/bapi-wrapper/interface-class/data-model）
6.6	List available templates	❌未实现	spec 要求不指定模板时列出可用模板，但 parser.py:207 --template 为 required=True，无法不指定

小计: 2/6 ✅, 3 ⚠️, 1 ❌

client.py 缺失的方法（Quality）

1. atc_check(name, obj_uri, variant) — ATC 代码检查
2. pretty_print(source) — ABAP Pretty Printer

---

7. Configuration Management (config/spec.md)

#	Scenario	状态	说明
7.1	Show current config	✅已实现	config_cmd.py:20-40 显示主机/客户端/用户名，密码掩码显示
7.2	Set config value	❌未实现	parser.py:123-126 未定义 config set 子命令，config_cmd.py 无 set 逻辑
7.3	List profiles	✅已实现	config_cmd.py:43-66 list-profiles 子命令
7.4	Use specific profile	❌未实现	--profile 参数已定义但 config.py 硬编码使用 [SAP] section
7.5	Save password to keyring	⚠️部分实现	auth.py 有 set_password() 和 cmd_auth_login()，但 auth 模块未集成到 app.py 命令路由，parser.py 也未注册 auth 子命令
7.6	Load password from keyring	⚠️部分实现	auth.py:resolve_password() 存在，但 未被 config.py 或 app.py 调用

小计: 2/6 ✅, 2 ❌, 2 ⚠️

---

汇总统计

Spec 领域	总需求	✅已实现	❌未实现	⚠️部分实现	覆盖率
Connection	9	8	1	0	88.9%
Object Lifecycle	28	16	7	1	57.1%
Batch Operations	13	13	0	0	100%
Search & Browse	12	0	0	12	0% (命令层100%，API层0%)
Transport	4	1	0	3	25%
Code Quality	6	2	1	3	33.3%
Config Management	6	2	2	2	33.3%
总计	78	42	11	21	53.8%

---

关键缺失点总结

A. client.py 缺失的 13 个 ADT API 方法

这些方法被 commands/ 层调用但未实现，是最关键的缺口：

方法	调用者	涉及 Spec
list_objects(obj_type, package, prefix)	search.py, package_cmd.py	search-browse
where_used(name, obj_uri, adt_type)	search.py	search-browse
search_code(query, obj_type)	search.py	search-browse
read_source_for_diff(name, obj_type)	diff_cmd.py	search-browse
get_cds_source(name)	cds.py	search-browse
create_cds(name, description, ddl_source)	cds.py	search-browse
create_package(name, description, superpackage)	package_cmd.py	search-browse
get_package_info(name)	package_cmd.py	search-browse
transport_info(corr_nr)	transport.py	transport
transport_release(corr_nr)	transport.py	transport
transport_objects(corr_nr)	transport.py	transport
atc_check(name, obj_uri, variant)	quality.py	quality
pretty_print(source)	quality.py	quality

B. types.py 缺失的 5 个对象类型注册

类型	Spec 要求	当前状态
messageclass	create/download/info/delete	❌ 未注册，无 URI
view	create/download/info	❌ 未注册，无 URI
searchhelp	create	❌ 未注册，无 URI
lockobject	create/delete	❌ 未注册，无 URI
include	(扫描可用)	❌ scanner.py 映射了目录但 types.py 未注册

C. 配置/认证缺口

缺失项	详情
--profile 不可用	parser.py 定义了参数但 config.py 忽略，始终读 [SAP] section
config set 子命令	spec 要求通过命令行设置配置项，parser.py 未注册，无实现
keyring 集成	auth.py 模块完整但未被 app.py/config.py 引入调用链
scaffold 无模板列表	--template 为 required，无法不指定来列出模板