docs: document product archive wide view contract

furniture-3d-system/docs/架构设计/外部只读视图字段字典-v1.md

@@ -229,6 +229,27 @@
 | `tax_included_unit_price` | 产品定厂含税单价 |
 | `lead_time` | 产品定厂交期 |
 | `install_method` | 产品定厂安装方式 |
+| `jst_product_pushed_at` | 商品资料成功推送聚水潭的时间；未成功推送时为空 |
+| `is_external_intake` | 是否由外部录入人员创建 |
+| `supply_chain_archive_eligible` | 是否满足供应链产品全量档案当前入档规则 |
+| `source_pricing_row_id` | 产品开发核价记录 ID，用于追踪原始业务记录 |
+| `source_product_id` | 产品开发产品 ID，用于定向增量同步和排查 |
+| `source_sku_item_id` | 产品开发结构化 SKU 行 ID |
+| `product_development_created_at` | 产品首次录入产品开发系统的时间，作为档案创建时间口径 |
+| `product_development_updated_at` | 产品开发系统最近更新时间 |
+| `archive_spu / archive_sku` | 产品全量档案使用的 SPU、SKU 口径 |
+| `archive_product_name` | 产品全量档案商品名称，来自条码对应规格名称 |
+| `archive_image` | 产品开发条码/SKU 图片原值 |
+| `sales_category_name` | 一级类目，例如桌类、柜类 |
+| `archive_product_category_name` | 二级类目原值，档案同步时补住宅家具/商业办公/其他前缀 |
+| `sku_sales_status` | 销售状态原值；档案只接受销售、停产、退市 |
+| `brand_name` | 产品开发品牌 |
+| `sample_weight_kg` | 样包测量重量（千克） |
+| `package_length_cm / package_width_cm / package_height_cm` | 样包长宽高（厘米） |
+| `package_volume_cm3` | 样包体积（立方厘米） |
+| `package_set_count` | 套件量；档案转换为非双包、双包至九包 |
+| `purchase_order_method` | 叫货/采购方式 |
+| `archive_shipping_method` | 产品全量档案的入仓/代发口径 |
 | `warehouse_location_code` | 仓库库位编码 |
 | `warehouse_zone / warehouse_aisle / warehouse_shelf / warehouse_bin` | 库位物理位置 |
 | `warehouse_location_status` | 库位状态：`ACTIVE` / `INACTIVE` |
@@ -267,6 +288,10 @@
 
 注意：
 
+- 产品全量档案只读取本宽表中 `supply_chain_archive_eligible = true` 的记录，不再由同步程序直接关联产品开发业务表或解析 `payload`。
+- 当前入档规则为：产品开发系统创建、商品资料已成功推送聚水潭、创建人不是外部录入人员。
+- 同一条码即使最终目录行优先采用正式商品，产品开发的入档字段仍按条码附加在该行末尾，避免来源标记被正式行覆盖。
+
 - 该视图保持一条码一行，适合外部系统做商品目录同步；同一 SKU 下多个条码会输出多行。
 - 如果外部系统只想读一张表，优先使用该宽表；它已经覆盖正式 SKU 与可消费的 non-integrated ready SKU，以及产品资料、库存库位摘要、包装库存摘要和最新质检摘要。
 - 需要逐条素材或逐条 BOM 时，仍读取 `external.product_assets_v1 / external.product_bom_v1`；这两张明细视图是否对外授权，以当前 `external_core_reader` 白名单为准。