Files
bj_power/bj_power_wms/schema/attachment.go
T

67 lines
3.3 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
package schema
import (
"entgo.io/ent"
"entgo.io/ent/dialect/entsql"
"entgo.io/ent/schema"
"entgo.io/ent/schema/field"
"entgo.io/ent/schema/index"
)
// Attachment 附件(挂载在业务单据/档案上的文件)
//
// 客户诉求(问题记录 L30):"列表可以查看附件、上传附件"——入库单/物料档案/检验记录
// 都要能挂图纸 PDF、检验报告、成品资料。故用统一单表,biz_type 区分挂载对象:
//
// biz_type=inbound biz_id=入库单号(inbound_no)
// biz_type=material biz_id=物料编码(material.code)
// biz_type=inspection biz_id=检验记录ID(inspection_records.id)
// biz_type=semi biz_id=半成品 SN
// biz_type=outbound biz_id=出库单号
//
// 磁盘落盘约定(2026-09-19 重构):<根目录>/年/月/日/<文件类型大写>/<uuid>.<ext>,
// file_path 存相对路径(如 2026/09/19/INSPECTION_PHOTO/xxx.jpg),不存绝对路径;
// 根目录由 etc/*.yaml 的 Attachment.RootDir 提供,不硬编码。
// 预览/下载走 GET /uploads/<相对路径>(服务端限根目录内,阻断穿越)。
// 文件类型(file_type,大写枚举)决定所在目录:PROCESS_PDF/INSPECTION_PHOTO/INSPECTION_PDF/
// DRAWING/PROCESS_CARD/PACKAGE_PHOTO/EXCEL_IMPORT/OTHER;biz_type 仍表示挂载的业务对象类型。
type Attachment struct {
ent.Schema
}
func (Attachment) Annotations() []schema.Annotation {
return []schema.Annotation{entsql.Table("attachments"), entsql.WithComments(true), schema.Comment("Attachment 附件(挂载在业务单据/档案上的文件)")}
}
func (Attachment) Fields() []ent.Field {
return []ent.Field{
field.String("biz_type").Comment("业务类型 inbound/material/inspection/semi/outbound"),
field.String("biz_id").Comment("业务对象标识(单号/编码/ID)"),
field.String("file_name").Comment("原始文件名(含扩展名)"),
// file_path 现为相对路径(年/月/日/文件类型/uuid.ext),历史扁平文件名仍兼容
field.String("file_path").Comment("磁盘相对路径(年/月/日/文件类型/uuid.ext)"),
// 文件类型(大写枚举),决定存储目录;与 biz_type(业务对象)正交
field.String("file_type").Optional().Comment("文件类型大写枚举 PROCESS_PDF/INSPECTION_PHOTO/..."),
field.String("file_ext").Optional().Comment("扩展名(小写,不含点)"),
field.String("file_md5").Optional().Comment("文件MD5(秒传/去重)"),
field.Int64("file_size").Default(0).Comment("文件大小(字节)"),
field.String("mime_type").Optional().Comment("MIME 类型"),
field.String("uploaded_by").Optional().Comment("上传人"),
field.Bool("deleted").Default(false).Comment("逻辑删除标记"),
field.Int64("deleted_at").Optional().Comment("删除时间(unix秒)"),
field.String("deleted_by").Optional().Comment("删除人"),
field.String("deleted_reason").Optional().Comment("删除说明(删除弹窗填写,警示留痕)"),
field.Int64("purged_at").Optional().Comment("彻底清除时间(unix秒,仅删文件留索引)"),
field.String("purged_by").Optional().Comment("彻底清除操作人"),
field.Int64("created_at").DefaultFunc(nowUnix),
}
}
func (Attachment) Indexes() []ent.Index {
return []ent.Index{
index.Fields("biz_type", "biz_id"),
index.Fields("file_type"),
index.Fields("file_md5"),
index.Fields("created_at"),
}
}