API REFERENCE 4.1.1.1local.read.POS-02
台位图读取(本地页面投影)SP-API-PAGE-REVIEW-20261015-r2
现有组件读取原型状态/选择器的页面投影;这是源码能力登记,没有同名HTTP处理器、完整DTO或服务端权限验收。
契约状态:契约未定义 · 待签收实现状态:仅本地页面投影 · 无HTTP实现验证状态:仅来源核对真实接口验收:真实接口未验收
本地逻辑
HTTP 路径未定义LOCAL SOURCE · NO HTTPi
完整字段契约尚待签收
来源尚未提供完整可生成样例的 HTTP 契约。保留已记录的方法、路径、业务说明及待补项,不从交互样稿补造字段或错误码。
- 仅本地源码登记,HTTP方法、路径及DTO待签收;不生成调用示例或提供执行控件。
01接口说明
业务端 / 模块收银端 / 台位
请求格式来源未定义
鉴权与权限来源未定义
技术服务归属(元信息)本地原型模型
台位图 · 操作与权限说明 SP-API-PAGE-REVIEW-20261015-r2
已核对页面源码、菜单登记和已有契约。下面分别列出候选契约、本地模型及尚待签收的部分;目录可见不授予调用权。
- 读取边界
- 有效同店收银身份及store.operations授权;按当前班次、台位和订单精确解析。
- 写入边界
- 有效License及当前班次;资金与商品操作分别核对。离线现金仅既有已锁商品的原8小时窗口。
- 数据范围
- 当前账号、门店、班次及原订单/支付尝试;未知先查原次,不借目录重放。
- 页面主动作
- 刷新台位。主动作来自页面登记;导航、筛选、预览和禁用占位不因此成为HTTP接口。命令条目只证明本地源码存在;候选关联沿用原实现状态。
- 页面对象
- TableSession
本页未从源码提取新的统一权限键,沿用上方身份与范围守卫。页面范围守卫与接口候选权限分别核对;参与键不代表必须同时持有,也不由目录显示授予。
| 当前编号 / 操作 | 来源与实现边界 | 原契约权限说明 |
|---|---|---|
4.1.1.1 台位图读取(本地页面投影)local.read.POS-02 | 本地源码逻辑 · HTTP未定义local_ui_projection_only · 真实接口未验收 | 未登记独立HTTP权限键,按页面源码守卫核对;不得从角色名推导授权。 |
源码与权限依据
navigation/pos-pages.ts:9当前菜单页面、对象类型与主动作登记features/pos/PosPage.tsx:237case POS-02features/pos/selectors.ts:19原型权限来源,非服务端验收navigation/product-state-flows.ts:1原型权限来源,非服务端验收
仅文档登记;读取浏览器原型状态或本地命令类型。正式HTTP、DTO和服务端权限尚未签收。目录引用不授予调用权限。
来源业务约束
- 主动作来自页面登记;导航、筛选、预览和禁用占位不因此成为HTTP接口。命令条目只证明本地源码存在;候选关联沿用原实现状态。
02请求头 0 个字段
来源没有可展开的字段定义。完整约束可在「来源与状态」查看。
03请求参数 字段待签收
来源中的请求说明 · 字段类型待签收
本页数据由现有组件/选择器投影原型状态;未声明同名HTTP查询或响应DTO。
来源没有可展开的字段定义。完整约束可在「来源与状态」查看。
04响应参数
来源中的响应说明 · 字段类型待签收
没有已签收的HTTP响应契约。本地命令回执、页面状态和真实后端结果分开。
来源没有可展开的字段定义。完整约束可在「来源与状态」查看。
05错误码 沿用来源定义
来源没有完整错误响应定义,保留待补;Mock 场景不补造正式错误码。
06来源与状态
契约状态:契约未定义 · 待签收实现状态:仅本地页面投影 · 无HTTP实现验证状态:仅来源核对真实接口验收:真实接口未验收
sourceVersion
SP-API-PAGE-REVIEW-20261015-r2sourcePath
features/integration/api-docs/local-model-operations.jsonevidence
{
"file": "navigation/pos-pages.ts",
"line": 9,
"symbol": "",
"claim": "当前菜单页面、对象类型与主动作登记",
"sha256": "65d35f872cfba8065388749312f14c946e4fe7fd0dcf734543c571107921ce5b"
} · {
"file": "features/pos/PosPage.tsx",
"line": 237,
"symbol": "",
"claim": "case POS-02",
"sha256": "f9e0055fb6f6d0d15b6ed64159ecd318b7d97e71eb1f70cb243a9021c3a100ed"
}notes
保留原270条记录;新增项只证明本地页面投影/命令源码存在,不能记为已实现HTTP接口。查看原始契约、引用与状态记录
{
"contract": {
"parameters": [],
"requestBody": null,
"responses": {},
"security": [],
"schemaState": "undefined_pending_signoff",
"documentation": [
{
"requestText": "本页数据由现有组件/选择器投影原型状态;未声明同名HTTP查询或响应DTO。",
"responseText": "没有已签收的HTTP响应契约。本地命令回执、页面状态和真实后端结果分开。"
}
]
},
"status": {
"contract": "undefined_pending_signoff",
"implementation": "local_ui_projection_only",
"verification": "source_only",
"realApiAcceptance": "not_verified",
"productionVerified": false,
"callable": false,
"note": "本地源码能力登记;没有注册或执行HTTP;当前路由与历史源码变体不作为浏览器验收。"
},
"provenance": {
"sourceVersion": "SP-API-PAGE-REVIEW-20261015-r2",
"sourcePath": "features/integration/api-docs/local-model-operations.json",
"pageRefs": [
"POS-02"
],
"evidence": [
{
"file": "navigation/pos-pages.ts",
"line": 9,
"symbol": "",
"claim": "当前菜单页面、对象类型与主动作登记",
"sha256": "65d35f872cfba8065388749312f14c946e4fe7fd0dcf734543c571107921ce5b"
},
{
"file": "features/pos/PosPage.tsx",
"line": 237,
"symbol": "",
"claim": "case POS-02",
"sha256": "f9e0055fb6f6d0d15b6ed64159ecd318b7d97e71eb1f70cb243a9021c3a100ed"
}
],
"notes": "保留原270条记录;新增项只证明本地页面投影/命令源码存在,不能记为已实现HTTP接口。"
},
"diagnostics": {
"transport": "documentation-only",
"networkEnabled": false,
"documentationOnly": true
},
"businessRules": [
{
"statement": "主动作来自页面登记;导航、筛选、预览和禁用占位不因此成为HTTP接口。命令条目只证明本地源码存在;候选关联沿用原实现状态。"
}
]
}