설명 없음

name: bill-purchase-plan description: 采购计划单据表 - 记录商品采购计划信息，用于指导采购活动 license: MIT compatibility: opencode metadata: category: database domain: retail-erp table_type: transaction

business_type: purchase_plan

采购计划单据表 (bill_purchase_plan)

表信息

表名: bill_purchase_plan
主键: id
时间字段: created_at, updated_at, sure_date, expected_delivery_date
查询日期字段: sure_date (默认查询日期字段)

关键字段

字段名	数据类型	查询用途
id	varchar(50)	主键ID
tenant_id	varchar(50)	租户ID，必须包含在查询条件中
bill_id	varchar(50)	单据编号
bill_type	varchar(20)	单据类型：PURCHASE_PLAN采购计划
bill_status	varchar(20)	单据状态：DRAFT/APPROVED/CONFIRMED/CLOSED/CANCELLED
from_store_id	varchar(50)	发货门店ID，关联master_store
to_store_id	varchar(50)	收货门店ID，关联master_store
from_company_id	varchar(50)	发货方公司ID，关联master_company
to_company_id	varchar(50)	收货方公司ID，关联master_company
product_id	varchar(50)	商品ID，关联master_product
settlement_qty	decimal(12,4)	结算数量，计划采购数量
settlement_price	decimal(12,2)	结算单价
discount_rate	decimal(5,4)	折扣率
settlement_amount	decimal(12,2)	结算金额 = qty × price × (1 - discount_rate)
expected_delivery_date	date	预计交货日期
sure_status	int	登账标识：0草稿/1已登账，查询必须为1
sure_date	date	登账日期，默认查询日期字段
created_at	datetime	创建时间

关联关系

父表关联:
- from_store_id → master_store.stor_id (发货门店)
- to_store_id → master_store.stor_id (收货门店)
- from_company_id → master_company.id (发货方公司)
- to_company_id → master_company.id (收货方公司)
- product_id → master_product.product_id (采购商品)

在查询拆解中的角色

查询部分：可查询采购计划数量、计划金额、折扣率等业务指标
where部分：可通过关联的店铺、商品、公司字段进行筛选，时间条件默认使用sure_date
from部分：作为采购计划数据的主表，需关联档案表获取维度信息
汇总部分：可按发货门店、收货门店、商品、时间等维度汇总采购计划数据
排序部分：通常按计划金额、计划数量或预计交货日期排序

关键查询规则

租户隔离: 必须包含tenant_id条件
单据状态: 必须检查sure_status=1 (已登账数据)
时间字段: 查询日期默认使用sure_date字段，也可按expected_delivery_date筛选
关联完整性: 必须正确关联店铺、商品、公司档案表
计划性质: 此为采购计划表，非实际采购单据，用于指导采购活动

多步骤查询支持

可作为数据源表，创建中间表保存采购计划明细数据
支持创建中间表格式：{userid}{datetime}_step{n}_purchase_plan
中间表关键字段：id, bill_id, from_store_id, to_store_id, product_id, settlement_qty, settlement_amount, sure_date, expected_delivery_date
通常作为查询的最后几步，先筛选档案数据再关联本表