book-mcp/db/schema_doc.md

MongoDB Schema — book-mcp

3 个 collection（无固定 schema，字段约束在 db/models.py）：

book（教辅）

字段	类型	索引
_id	int	PK（自增，counters.book_id）
name	str	uk_name_version 一部分
subject	str | null
grade	str | null
version	str | null	uk_name_version 一部分
type	str | null
zip_path	str
zip_sha256	str	uk_book_zip_sha 唯一
zip_size	int
status	enum	idx_book_status
total_count	int
success_count	int
failed_count	int
error_msg	str | null
created_at	datetime	idx_book_created
updated_at	datetime
created_by	str | null
is_deleted	int (0/1)	uk_name_version 一部分

book_document（教辅文档）

字段	类型	索引
_id	str (16 字符 sha1)	uk_doc_id 唯一
book_id	int	idx_book_order
original_filename	str
original_path	str
title	str | null
doc_type	enum
order_index	int	idx_book_order
status	enum	idx_doc_status
error_msg	str | null
created_at	datetime
updated_at	datetime

document_file（文档文件）

字段	类型	索引
_id	int	PK（自增，counters.file_id）
doc_id	str	uk_doc_type 联合唯一 + idx_bucket_key
file_type	enum	uk_doc_type 联合唯一
object_key	str	idx_bucket_key
object_bucket	str	idx_bucket_key
size	int
checksum	str | null
url	str | null
meta	object | null
created_at	datetime

counters（自增 ID 模拟）

_id (name)	seq
book_id	int
file_id	int

初始化

# 自动建所有索引（幂等）
/tmp/wordparse_venv/bin/python book_mcp_server.py --init-db

输出：

✓ MongoDB 已就绪（db: book_mcp, collections: ['book', 'book_document', 'document_file']）
  ✓ 8 个索引创建完成