批量更新功能

go/models/tenant_crm_project.go

@@ -16,18 +16,20 @@ type TenantCrmProject struct {
 	OwnerUserName string  `orm:"column(owner_user_name);size(128)" json:"owner_user_name"`
 	Industry      string  `orm:"column(industry);size(50)" json:"industry"`
 	// 项目类型：1=单一项目（只有上游客户） 2=上下游项目（上游客户 + 下游供应商）
+	// 3=上中游项目（上游 A 公司 + 中游 B 公司，下游固定为本公司）
 	ProjectType int8 `orm:"column(project_type);default(1)" json:"project_type"`
-	// 下游主体：可从供应商库或客户库选择（supplier_ref_type + supplier_id 标明来源），也允许手工填写名称
+	// 对方主体（2=上下游项目的下游 / 3=上中游项目的中游）：可从供应商库或客户库选择（supplier_ref_type + supplier_id 标明来源），也允许手工填写名称
 	SupplierID       *uint64 `orm:"column(supplier_id);null" json:"supplier_id"`
 	SupplierRefType  int8    `orm:"column(supplier_ref_type);default(0)" json:"supplier_ref_type"` // 0未关联 1客户 2供应商
 	SupplierName     string  `orm:"column(supplier_name);size(100)" json:"supplier_name"`
 	SupplierIndustry string  `orm:"column(supplier_industry);size(50)" json:"supplier_industry"`
-	// 金额拆分为上下游：上游=对客户的收入，下游=对供应商的成本（上下游项目毛利 = 上游 - 下游）
+	// 金额拆分为上下游：上游=对客户的收入，下游=对供应商的成本（上下游项目毛利 = 上游 - 下游）；
+	// 上中游项目：上游=上游 A 公司合同额，下游字段存中游 B 公司（与我方）合同额
 	UpstreamAmount   float64 `orm:"column(upstream_amount);digits(14);decimals(2);default(0)" json:"upstream_amount"`
 	DownstreamAmount float64 `orm:"column(downstream_amount);digits(14);decimals(2);default(0)" json:"downstream_amount"`
 	// Amount 为旧「项目金额」列，已由 UpstreamAmount 取代；写入时始终同步为上游金额，仅作历史兼容
 	Amount    float64    `orm:"column(amount);digits(14);decimals(2);default(0)" json:"amount"`
-	Status int8 `orm:"column(status);default(1)" json:"status"` // 1未开始/2进行中/3已完成/4已暂停
+	Status int8 `orm:"column(status);default(1)" json:"status"` // 1未开始/2进行中/3已完成/4已暂停/5异常
 	// StartDate / EndDate 为旧的手工维护列，已改由关联合同自动汇总，保留仅用于兼容历史数据
 	StartDate *time.Time `orm:"column(start_date);type(date);null" json:"start_date"`
 	EndDate   *time.Time `orm:"column(end_date);type(date);null" json:"end_date"`
@@ -39,6 +41,12 @@ type TenantCrmProject struct {
 	UpstreamPhone     string `orm:"column(upstream_phone);size(20)" json:"upstream_phone"`
 	DownstreamContact string `orm:"column(downstream_contact);size(50)" json:"downstream_contact"`
 	DownstreamPhone   string `orm:"column(downstream_phone);size(20)" json:"downstream_phone"`
+	// 项目联系人：从对应企业通讯录中挑选的联系人ID集合（JSON 数组字符串，如 [1,5,8]，空为未选）。
+	// 上游=客户方（yz_backend_erp_contact.company_type=customer & company_id=customer_id）；
+	// 下游/中游=对方主体方（company_type 按 supplier_ref_type：1=customer 2=supplier，company_id=supplier_id）。
+	// 单一项目只使用上游集合；联系人详情实时来自企业通讯录，此处仅存 ID 引用。
+	UpstreamContactIDs   string `orm:"column(upstream_contact_ids);type(text);null" json:"upstream_contact_ids"`
+	DownstreamContactIDs string `orm:"column(downstream_contact_ids);type(text);null" json:"downstream_contact_ids"`
 	// 以下为旧版单一对接人信息，已被上下游对接人取代，仅保留列以兼容历史数据
 	ContactPerson   string `orm:"column(contact_person);size(50)" json:"contact_person"`
 	ContactPosition string `orm:"column(contact_position);size(50)" json:"contact_position"` // 对接人职位（已废弃）