> For the complete documentation index, see [llms.txt](https://eurekabusiness.caiziii.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://eurekabusiness.caiziii.com/mo-kuai-can-kao/retail-module.md).

# Retail 零售模块与扩展点

Retail 在 Core 契约上实现首发零售玩法。

## 功能边界

Retail 负责：

* 店铺边界、入口、出口与营业状态。
* 陈列基座、商品库存和价格牌。
* 商品价值目录与四档价格反应。
* 顾客生成、购物计划、浏览、购物篮和结算。
* 零售交易记录、发现同步和状态恢复。

## 商品定义

`CatalogItemDefinition` 包含物品 ID、四档 `PriceBand` 和 `List<CatalogElement>`。`CatalogElement` 使用元素完整键和 `1..9` 等级。目录配置由服务端加载并发布为快照。

## 公开价格与成交

顾客根据基座公开价格选择供给。同款商品的低价基座优先，但最终结算仍必须验证基座 revision、库存、价格和完整物品数据。任何失败都不能产生部分交易结果。

## 附属集成建议

附属模组可以消费 Core 的元素与顾客变体公共契约，并在自己的模块注册内容。不要让 Retail 反向依赖附属模组，也不要直接修改 Retail 的内部快照。需要新的零售能力时，优先通过公开 API 或独立适配层提出契约。

## 当前限制

商品目录是配置驱动的服务端能力，不是任意数据包文件的通用导入接口。未在公开 API 或当前配置契约中声明的字段不能视为受支持的整合包扩展点。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://eurekabusiness.caiziii.com/mo-kuai-can-kao/retail-module.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.