model

type Book struct {
	BookInfo  // 嵌入 BookInfo 结构体
	BookMarks // 书签信息
	PageInfos // 书籍内所有页面的信息
}

type BookInfo struct {
	// ===== 基本标识 =====
	BookID string          `json:"id"`     // 根据 BookPath 生成的唯一 ID
	Title  string          `json:"title"`  // 书名
	Author string          `json:"author"` // 作者
	Type   SupportFileType `json:"type"`   // 书籍类型

	// ===== 文件路径 =====
	BookPath     string `json:"-"` // 文件绝对路径，JSON 不解析
	ParentFolder string `json:"-"` // 父文件夹名称，JSON 不解析
	StoreUrl     string `json:"-"` // 在哪个子书库, JSON 不解析

	// ===== 远程存储 =====
	IsRemote        bool   `json:"is_remote"`              // 是否为远程书籍（WebDAV、Comigo 等）
	RemoteURL       string `json:"-"`                      // 远程存储的基础 URL，JSON 不解析
	RemoteBookID    string `json:"-"`                      // 远端 Comigo 中的原始 BookID，JSON 不解析
	RemoteStoreKey  string `json:"remote_store,omitempty"` // 远端 Comigo 书库公开标识，用于前端链接参数
	RemoteShelfKey  string `json:"-"`                      // 远端 Comigo 顶级书库内部标识，JSON 不解析
	RemoteShelfName string `json:"-"`                      // 远端 Comigo 顶级书库显示名，JSON 不解析

	// ===== 文件属性 =====
	FileSize  int64     `json:"file_size"`     // 文件大小
	Modified  time.Time `json:"modified_time"` // 修改时间
	PageCount int       `json:"page_count"`    // 总页数
	Cover     PageInfo  `json:"cover"`         // 封面图

	// ===== 出版信息 =====
	ISBN        string `json:"isbn"`         // ISBN
	Press       string `json:"press"`        // 出版社
	PublishedAt string `json:"published_at"` // 出版日期

	// ===== 书组相关 =====
	ChildBooksNum int      `json:"child_books_num"` // 子书籍数量，只统计直接的子书籍
	ChildBooksID  []string `json:"child_books_id"`  // 子书籍 BookID
	Depth         int      `json:"depth"`           // 书籍深度

	// ===== 压缩包相关 =====
	ExtractPath     string `json:"extract_path"`      // 解压路径，7z 用，JSON 不解析
	ExtractNum      int    `json:"extract_num"`       // 文件解压数
	NonUTF8Zip      bool   `json:"non_utf_8_zip"`     // 是否为特殊编码 zip
	ZipTextEncoding string `json:"zip_text_encoding"` // zip 文件编码

	// ===== 状态标记 =====
	InitComplete bool `json:"init_complete"` // 是否初始化完成（todo：7z解压）
	BookComplete bool `json:"book_complete"` // 书籍是否阅读完成
	Deleted      bool `json:"deleted"`       // 源文件是否已删除

	// ===== 元数据 =====
	CreatedByVersion string `json:"created_by_version"` // 生成数据的 Comigo 版本
}

type BookInfos []BookInfo

type BookMark struct {
	Type        MarkType  `json:"mark_type"`     // 书签类型，auto 表示自动书签，user 表示用户书签
	BookID      string    `json:"book_id"`       // 书籍 ID
	BookStoreID string    `json:"book_store_id"` // 书籍所属书库 ID
	PageIndex   int       `json:"page_index"`    // 书签页码，从 1 开始，理论上不会超过 PageCount，但是现实中可能会有旧数据
	Description string    `json:"description"`   // 用户添加的备注
	CreatedAt   time.Time `json:"created_at"`    // 创建时间
	UpdatedAt   time.Time `json:"updated_at"`    // 更新时间
}

type BookMarks []BookMark

type BookinfoWithBookMark struct {
	BookInfo BookInfo `json:"book_info"` // 书籍信息
	BookMark BookMark `json:"book_mark"` // 书签信息
}

type MarkType string

type PageInfo struct {
	Name       string    `json:"name"`     // 用于解压的压缩文件内文件路径，或图片名，为了适应特殊字符，经过一次转义
	Path       string    `json:"path"`     // 文件路径
	Size       int64     `json:"size"`     // 文件大小
	ModTime    time.Time `json:"mod_time"` // 修改时间
	Url        string    `json:"url"`      // 远程用户读取图片的URL，为了适应特殊字符，经过转义
	PageNum    int       `json:"page_num"` // 图片在原始文件中的页码位置，这个字段不解析。用来按照原始顺序排序
	Blurhash   string    `json:"-"`        // blurhash 占位符，扫描图片生成
	Height     int       `json:"-"`        // 图片高度，仅运行时分析使用
	Width      int       `json:"-"`        // 图片宽度，仅运行时分析使用
	ImgType    string    `json:"-"`        // 这个字段不解析
	InsertHtml string    `json:"-"`        // 这个字段不解析
}

type PageInfos []PageInfo

type StoreBookInfo struct {
	StoreUrl     string    `json:"-"` // 书库真实路径只用于服务端分组匹配，普通 JSON 不输出
	DisplayName  string    `json:"display_name"`
	IsRemote     bool      `json:"is_remote"`
	ChildBookNum int       `json:"child_book_num"`
	BookInfos    BookInfos `json:"book_infos"`
}

type StoreInterface interface {
	StoreBook(b *Book) error
	GetBook(id string) (*Book, error)
	DeleteBook(id string) error
	ListBooks() ([]*Book, error)
	GenerateBookGroup() error
	StoreBookMark(mark *BookMark) error
	GetBookMarks(bookID string) (*BookMarks, error)
	DeleteBookMark(bookID string, markType MarkType, pageIndex int) error
}

type SupportFileType string

type User struct {
	ID       int    `json:"id"`
	Username string `json:"username"`
	Password string `json:"password"`
	Role     string `json:"role"` // 角色: admin, user, guest
	Email    string `json:"email"`
	Key      string `json:"key"` // login key
	ExpireAt string `json:"expireAt"`
}