数据库设计
概述
Memesplora 使用 ent ORM 管理数据库，支持 SQLite（开发/单机）和 PostgreSQL（生产）。数据库仅存储元数据，实际文件内容存储在内存文件系统中。
ER 图
┌──────────┐ ┌──────────┐ ┌──────────┐
│ User │ │ Space │ │ File │
├──────────┤ ├──────────┤ ├──────────┤
│ ID │──┐ │ ID │──┐ │ ID │
│ Username │ │ │ Name │ │ │ Name │
│ Email │ │ │ OwnerID │◄─┘ │ Path │
│ Password │ │ │ TotalSize│ │ Size │
│ GroupID │ │ │ UsedSize │ │ Type │
│ Storage │ │ │ BlockSize│ │ SpaceID │◄──┐
│ Max │ │ │ DeviceID │ │ ParentID │ │
│ IsAdmin │ │ │ DeviceType│ │ InodeID │ │
│ Created │ │ │ Status │ │ Created │ │
│ Updated │ │ │ Created │ │ Updated │ │
└──────────┘ │ └──────────┘ │ Deleted │ │
│ └──────────┘ │
│ ┌──────────┐ │
│ │ Share │ │
│ ├──────────┤ │
│ │ ID │ │
└───►│ OwnerID │ │
│ SpaceID │◄──────────────────────┘
│ FileID │
│ ShareKey │
│ ExpireAt │
│ Password │
│ Created │
└──────────┘数据表定义
User（用户）
go
func (User) Fields() []ent.Field {
return []ent.Field{
field.String("username").Unique(),
field.String("email").Unique(),
field.String("password").Sensitive(),
field.String("nickname").Default(""),
field.Int("group_id"),
field.Int64("storage_used").Default(0),
field.Int64("max_storage").Default(0), // 0 = 无限制
field.Bool("is_admin").Default(false),
field.Time("created_at"),
field.Time("updated_at"),
}
}
func (User) Edges() []ent.Edge {
return []ent.Edge{
hasMany("spaces"),
hasMany("shares"),
}
}Space（存储空间）
go
func (Space) Fields() []ent.Field {
return []ent.Field{
field.String("name"),
field.String("description").Optional(),
field.Int64("total_size"),
field.Int64("used_size").Default(0),
field.Int("block_size").Default(4096),
field.String("device_id"),
field.Enum("device_type").Values("ram", "vram", "swap"),
field.Enum("status").Values("active", "inactive", "error"),
field.JSON("options", map[string]interface{}{}).Optional(),
field.Time("created_at"),
field.Time("updated_at"),
}
}
func (Space) Edges() []ent.Edge {
return []ent.Edge{
belongsTo("owner", User.Type),
hasMany("files"),
hasMany("shares"),
}
}File（文件元数据）
go
func (File) Fields() []ent.Field {
return []ent.Field{
field.String("name"),
field.String("path"),
field.Int64("size"),
field.Enum("type").Values("file", "directory"),
field.String("mime_type").Optional(),
field.Uint64("inode_id"),
field.String("parent_id").Optional(),
field.String("storage_key").Optional(),
field.Bool("is_shareable").Default(false),
field.Time("created_at"),
field.Time("updated_at"),
field.Time("deleted_at").Optional().Nillable(),
}
}
func (File) Edges() []ent.Edge {
return []ent.Edge{
belongsTo("space", Space.Type),
hasMany("shares"),
}
}Share（分享链接）
go
func (Share) Fields() []ent.Field {
return []ent.Field{
field.String("share_key").Unique(),
field.Int64("download_limit").Default(0),
field.Int64("download_count").Default(0),
field.Time("expire_at").Optional().Nillable(),
field.Bool("is_password").Default(false),
field.String("password").Optional().Sensitive(),
field.Time("created_at"),
}
}
func (Share) Edges() []ent.Edge {
return []ent.Edge{
belongsTo("owner", User.Type),
belongsTo("space", Space.Type),
belongsTo("file", File.Type),
}
}数据库选择
| 环境 | 数据库 | 说明 |
|---|---|---|
| 开发 | SQLite | 无需额外配置，文件数据库 |
| 单机部署 | SQLite | 适合单用户场景 |
| 生产部署 | PostgreSQL | 支持并发，适合多用户 |
索引设计
sql
-- 用户表
CREATE INDEX idx_user_username ON users(username);
CREATE INDEX idx_user_email ON users(email);
-- 空间表
CREATE INDEX idx_space_owner ON spaces(owner_id);
CREATE INDEX idx_space_device ON spaces(device_id);
-- 文件表
CREATE INDEX idx_file_space_path ON files(space_id, path);
CREATE INDEX idx_file_parent ON files(parent_id);
CREATE INDEX idx_file_deleted ON files(deleted_at);
-- 分享表
CREATE INDEX idx_share_key ON shares(share_key);
CREATE INDEX idx_share_owner ON shares(owner_id);