docs(deployment): 更新部署手册和业务架构说明

- 更新MES和WMS服务端口配置说明
- 详细说明产线工位设备配置（扫码枪+拧紧枪）
- 明确AGV配送和接驳台的模拟模式与真实对接方案
- 更新WMS中AGV配送默认模拟模式说明
- 完善厂内物流（AGV/接驳台）的业务架构约束
- 修订临时文档为详细的项目问题和解决方案规划

bj_power_wms/schema/inventory.go

@@ -95,6 +95,9 @@ func (Inventory) Fields() []ent.Field {
 		field.Int64("recorded_at").Optional().Comment("记录日期(unix 秒)"),
 		// 半成品/成品出库原因（客户诉求 L224：包装/继续生产/检验试验/其他）
 		field.String("outbound_reason").Optional().Comment("出库原因(半成品/成品出库用)"),
+		// 盘点冻结标记（盘点15问 问题2 最严重）：非空=本行正被该盘点单锁定，盘点期间禁止出库/入库/锁定，
+		// 保证「库存量/锁定量/可用量」在盘点期间冻结，差异只反映盘盈盘亏而非业务变动。发起时置盘点单号，完成/取消时清空。
+		field.String("stocktake_no").Default("").MaxLen(64).Comment("盘点冻结标记(进行中盘点单号；空=未冻结)"),
 		// 备注。
 		field.String("remark").Optional().Comment("备注"),
 

bj_power_wms/schema/stocktake.go

@@ -14,9 +14,21 @@ type StocktakeOrder struct {
 func (StocktakeOrder) Fields() []ent.Field {
 	return []ent.Field{
 		field.String("stocktake_no").Unique().Comment("盘点单号"),
-		field.String("status").Default("进行中").Comment("进行中/已完成"),
+		// 状态机（盘点15问 问题10）：进行中(已锁定库存) → 已完成(仅出结论) / 已写回(差异已修正库存) / 已取消
+		field.String("status").Default("进行中").Comment("进行中/已完成/已写回/已取消"),
 		field.String("operator").Optional().Comment("发起人"),
-		field.Int("total_targets").Default(0).Comment("快照目标数"),
+		field.Int("total_targets").Default(0).Comment("快照目标数(本次盘点覆盖的批次/SN总数)"),
+		// 差异项数（问题13）：完成时统计 diff!=0 的明细行数，便于历史列表一眼看出盘盈盘亏规模。
+		field.Int("diff_count").Default(0).Comment("差异项数(diff!=0 的明细数)"),
+		// 是否写回 + 调整单号 + 写回时间/操作人（问题4/13）：写回走盘点调整单，留痕可追溯。
+		field.Bool("adjusted").Default(false).Comment("差异是否已写回库存"),
+		field.String("adjust_no").Optional().Comment("盘点调整单号(写回时生成)"),
+		field.Int64("written_at").Optional().Comment("写回时间(unix 秒)"),
+		field.String("written_by").Optional().Comment("写回操作人"),
+		// 未盘项处理方式（问题5）：keep=按账面保留 / zero=盘亏为0
+		field.String("uncounted_mode").Optional().Comment("未盘项处理 keep=按账面保留/zero=盘亏为0"),
+		// 取消原因（问题9）：取消盘点时记录，便于追溯。
+		field.String("cancel_reason").Optional().Comment("取消原因"),
 		field.Int64("created_at").DefaultFunc(nowUnix),
 		field.Int64("finished_at").Optional().Comment("完成时间"),
 	}
@@ -48,6 +60,9 @@ func (StocktakeItem) Fields() []ent.Field {
 		field.Int("scanned_qty").Default(-1).Comment("实盘数量，-1=未盘"),
 		field.Int("diff_qty").Default(0).Comment("差异 = 实盘 - 账面"),
 		field.Bool("counted").Default(false).Comment("是否已扫码"),
+		// 实盘人/实盘时间（问题14）：导出盘点明细时「操作人」取实盘扫码人，而非发起人。
+		field.String("counted_by").Optional().Comment("实盘人(扫码录入者)"),
+		field.Int64("counted_at").Optional().Comment("实盘时间(unix 秒)"),
 		field.Int64("updated_at").DefaultFunc(nowUnix),
 	}
 }