`archive/list`接口返回的`price`和`stock`字段，对电商类文档模型有何意义？
在安企CMS中，当您通过archive/list接口获取文档列表时，返回数据中包含的price和stock这两个字段，对于构建电商类型的网站模型来说，具有至关重要的意义。它们不仅仅是简单的数值，而是支撑商品展示、交易流程和库存管理的核心要素。
奠定商品基础：价格与库存的直观表达
首先，price（价格）和stock（库存）直接将任何“文档”转化为具备商业属性的“商品”。在电商场景中，无论是实体商品还是虚拟服务，价格都是用户进行消费决策的首要因素，而库存量则直接决定了商品的可购买性。安企CMS将这两个字段内置到文档模型中，意味着您无需进行复杂的自定义开发，就能为您的商品设定最基本的交易属性。
值得注意的是，price字段以“分”为单位存储，这在电商系统中是常见的做法，目的是为了避免浮点数计算可能带来的精度问题。在前端展示时，您只需将其除以100即可得到以“元”为单位的金额。而stock字段则清晰地展示了商品的当前剩余数量，这对于消费者了解商品稀缺性、促成购买行为有着直接影响。
精细化运营：库存管理的艺术
从网站运营的角度来看，stock字段是实现精细化库存管理的关键。通过archive/list获取到的库存数据，可以帮助我们实现多种运营策略：
- 防止超卖： 在用户下单前，系统可以实时查询商品的
stock，确保有足够的库存来完成交易。一旦商品被成功购买，库存量也会相应减少，有效避免了超卖现象，维护了商家信誉。 - 库存预警与补货： 当商品库存量低于某一阈值时，运营人员可以根据
stock数据及时收到预警通知，安排采购或生产，确保商品不断货。 - 促销策略： 针对库存紧张的商品，可以采取限时限量、秒杀等促销手段，利用商品的稀缺性激发用户的购买欲望。相反，对于库存积压的商品，也可以通过降价促销来快速清理库存。
优化用户体验：透明与决策的基石
对于消费者而言，price和stock字段的透明展示极大地优化了购物体验：
- 快速决策： 用户可以在商品列表中一目了然地看到价格，快速筛选出符合预算的商品。同时，明确的库存信息（例如“有货”、“仅剩5件”、“已售罄”）能帮助用户判断是否需要立即购买，减少犹豫时间。
- 筛选与排序： 尽管
archive/list的请求参数中未直接列出按价格或库存筛选的选项，但作为返回数据的一部分，前端开发者可以根据这些字段实现自定义的价格区间筛选、按价格高低排序、按库存多少排序等功能，极大地提升了用户查找商品的效率。 - 减少误解： 清晰的价格和库存信息避免了因信息不对称而产生的误解或纠纷，提升了用户的信任感和满意度。
拓展与整合：构建全面的电商解决方案
安企CMS将price和stock作为核心文档属性，也为更复杂的电商功能提供了良好的拓展基础。例如，结合archive/detail接口，用户可以查看某个商品的详细信息，包括其具体价格和库存。当用户进行购买时，orderCreate接口会根据goods_id（商品ID）和quantity（数量）来创建订单，并在这个过程中处理库存扣减逻辑。后续通过orders接口可以查询到包含这些商品价格和库存快照的订单列表。
此外，如果您的商品存在多种规格（如不同颜色、尺寸），且每种规格的价格和库存不同，您可以利用安企CMS的“文档模型”的灵活性，通过“额外字段（extra）”来为不同的SKU（库存量单位）设置更详细的价格、库存信息，甚至结合自定义逻辑来处理。
总之，archive/list接口返回的price和stock字段，是安企CMS为电商类文档模型提供的一对开箱即用的强大属性。它们不仅是商品信息展示的基础，更是驱动商品销售、优化库存管理和提升用户购物体验不可或缺的核心要素。合理利用和管理这两个字段，能让您的安企CMS电商网站发挥出更大的商业价值。
常见问题 (FAQ)
Q1: price字段的单位为什么是“分”？在前端显示时如何处理？
A1: price字段以“分”为单位是为了在计算机内部存储和计算时避免浮点数（例如12.99元）可能导致的精度问题。这是许多电商系统通用的做法。在前端页面展示时，您只需要将获取到的price值除以100，即可转换为以“元”为单位的金额，例如将9900显示为99.00。
Q2: 如果我的商品有多种规格（如不同颜色、尺寸，对应不同的价格和库存），price和stock字段如何体现？
A2: archive/list或archive/detail接口中直接返回的price和stock通常代表了该“文档”（即商品）的主价格和总库存，或者某一个默认规格的价格和库存。如果您的商品有复杂的规格体系，每种规格都有独立的价格和库存，建议利用安企CMS的“文档模型”中的“额外字段（extra）”功能。您可以自定义字段来存储不同规格的SKU信息，包括每个SKU的价格和库存。在前端展示时，您可以根据这些额外字段动态渲染不同规格的选择器，并在用户选择不同规格后，实时更新显示的价格和库存。
Q3: 当商品库存为零时，商品会从列表中自动消失吗？如何设置？
A3: archive/list接口本身并不会在stock为零时自动过滤掉该商品。它只会返回真实的库存数量。如果您希望库存为零的商品不显示在列表中，或者显示为“已售罄”但不可购买，这需要您在前端开发时，根据stock字段的值来编写相应的判断逻辑。例如，可以在获取到商品列表后，遍历数据，当stock为0时，不渲染该商品，或者将“加入购物车”按钮置灰并显示“已售罄”文本。这种灵活性使得您可以根据实际运营需求来控制零库存商品的展示方式。