设计一个企业内部的知识库问答系统

【离线】数据源（Wiki / 网盘 / 工单）→ 增量同步 → 解析清洗 → 切块 → Embedding
       → 写入向量库和全文索引（元数据：来源、权限、更新时间）

【在线】用户提问 → 鉴权 → 问题改写 → 混合检索（按权限过滤）→ 重排
       → 模型生成（附引用）→ 返回答案 → 记录日志和用户反馈

CREATE TABLE documents (
  id           BIGINT PRIMARY KEY,
  source       VARCHAR(32) NOT NULL,   -- wiki / drive / ticket
  source_id    VARCHAR(128) NOT NULL,  -- 源系统里的 ID，增量同步靠它对应
  title        VARCHAR(500),
  content_hash CHAR(64) NOT NULL,      -- 内容没变就不重新切块、不重新向量化
  acl_groups   JSON NOT NULL,          -- 允许访问的用户组，从源系统同步
  updated_at   DATETIME NOT NULL,
  deleted_at   DATETIME,               -- 源文档删除后标记，并删除对应的向量
  UNIQUE KEY uk_source (source, source_id)
);

CREATE TABLE chunks (
  id           BIGINT PRIMARY KEY,
  document_id  BIGINT NOT NULL,
  seq          INT NOT NULL,
  heading_path VARCHAR(500),           -- 所属章节，引用时展示
  content      TEXT NOT NULL,
  INDEX idx_doc (document_id, seq)
);