┌─────────────────────────────────────────────────────────┐
│                      Caddy 反向代理                       │
│                  docs.ycapis.com :443                     │
└──────────────────────┬──────────────────────────────────┘
                       │
┌──────────────────────▼──────────────────────────────────┐
│                   Node.js + Express                      │
│                     Port 3100                            │
│                                                          │
│  ┌─────────┐  ┌──────────┐  ┌─────────┐  ┌───────────┐ │
│  │ Auth    │  │ Doc API  │  │ Task API│  │ Share API │ │
│  │MiddleW  │  │ CRUD+搜索 │  │ 看板CRUD │  │ 公开链接  │ │
│  └─────────┘  └──────────┘  └─────────┘  └───────────┘ │
│  ┌─────────┐  ┌──────────┐  ┌─────────────────────────┐ │
│  │ AI API  │  │ Project  │  │   Static File Server    │ │
│  │ Bearer  │  │ API      │  │   (Vue 3 SPA)           │ │
│  └─────────┘  └──────────┘  └─────────────────────────┘ │
└──────────────────────┬──────────────────────────────────┘
          ┌────────────┼────────────┐
          ▼            ▼            ▼
   ┌──────────┐ ┌──────────┐ ┌──────────┐
   │  SQLite  │ │ .md 文件  │ │ 全文索引  │
   │ 元数据DB │ │ 本地存储  │ │ (SQLite  │
   │          │ │          │ │  FTS5)   │
   └──────────┘ └──────────┘ └──────────┘

-- 用户表
CREATE TABLE users (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  username TEXT UNIQUE NOT NULL,
  password_hash TEXT NOT NULL,
  role TEXT NOT NULL DEFAULT 'viewer',  -- 'admin' | 'viewer'
  created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

-- 项目表
CREATE TABLE projects (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  name TEXT NOT NULL,
  slug TEXT UNIQUE NOT NULL,           -- URL 友好标识，如 'ycapi'
  description TEXT,
  icon TEXT DEFAULT '📁',              -- emoji 图标
  color TEXT DEFAULT '#3B82F6',        -- 主题色
  sort_order INTEGER DEFAULT 0,
  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

-- 文档表
CREATE TABLE documents (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  project_id INTEGER NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
  parent_id INTEGER REFERENCES documents(id) ON DELETE SET NULL,  -- 目录结构
  title TEXT NOT NULL,
  slug TEXT NOT NULL,                  -- 文件名（不含 .md）
  type TEXT DEFAULT 'doc',             -- 'folder' | 'doc'
  doc_type TEXT DEFAULT 'general',     -- 'requirement' | 'design' | 'api' | 'plan' | 'report' | 'meeting' | 'general'
  file_path TEXT,                      -- 相对于 data/ 的 .md 文件路径
  sort_order INTEGER DEFAULT 0,
  created_by INTEGER REFERENCES users(id),
  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

-- 全文搜索虚拟表
CREATE VIRTUAL TABLE documents_fts USING fts5(
  title, content,
  content=documents,
  content_rowid=id
);

-- 任务表
CREATE TABLE tasks (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  project_id INTEGER NOT NULL REFERENCES projects(id) ON DELETE CASCADE,
  title TEXT NOT NULL,
  description TEXT,
  status TEXT DEFAULT 'todo',          -- 'todo' | 'doing' | 'done'
  priority INTEGER DEFAULT 0,          -- 0=普通, 1=重要, 2=紧急
  sort_order INTEGER DEFAULT 0,
  due_date DATE,
  created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
  updated_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

-- 分享链接表
CREATE TABLE shares (
  id INTEGER PRIMARY KEY AUTOINCREMENT,
  document_id INTEGER NOT NULL REFERENCES documents(id) ON DELETE CASCADE,
  token TEXT UNIQUE NOT NULL,          -- UUID，用于公开访问
  password TEXT,                       -- 可选访问密码
  expires_at DATETIME,                 -- 可选过期时间
  view_count INTEGER DEFAULT 0,
  created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

-- 索引
CREATE UNIQUE INDEX idx_doc_project_slug ON documents(project_id, parent_id, slug);
CREATE INDEX idx_tasks_project_status ON tasks(project_id, status);
CREATE INDEX idx_shares_token ON shares(token);

/root/Projects/doc-system/
├── DESIGN.md              # 本文件
├── package.json
├── server/
│   ├── index.js           # 入口
│   ├── db.js              # SQLite 连接 + 初始化
│   ├── auth.js            # 认证中间件
│   ├── routes/
│   │   ├── auth.js        # POST /api/auth/login, /logout
│   │   ├── projects.js    # CRUD /api/projects
│   │   ├── documents.js   # CRUD /api/projects/:slug/docs
│   │   ├── tasks.js       # CRUD /api/projects/:slug/tasks
│   │   ├── shares.js      # 分享管理
│   │   ├── search.js      # GET /api/search?q=
│   │   └── ai.js          # AI 写入接口
│   └── utils/
│       ├── markdown.js    # 服务端 MD 渲染（用于搜索索引）
│       └── migrate.js     # 导入现有文档
├── client/                # Vue 3 SPA
│   ├── src/
│   │   ├── App.vue
│   │   ├── router.js
│   │   ├── views/
│   │   │   ├── Dashboard.vue      # 首页仪表板
│   │   │   ├── Project.vue        # 项目页（文档树+内容）
│   │   │   ├── DocView.vue        # 文档渲染
│   │   │   ├── DocEdit.vue        # 编辑器
│   │   │   ├── Kanban.vue         # 任务看板
│   │   │   ├── SharedDoc.vue      # 公开分享页
│   │   │   ├── Login.vue
│   │   │   └── Settings.vue
│   │   ├── components/
│   │   │   ├── Sidebar.vue
│   │   │   ├── DocTree.vue
│   │   │   ├── MarkdownRenderer.vue
│   │   │   ├── Editor.vue         # CodeMirror 封装
│   │   │   ├── TaskCard.vue
│   │   │   └── SearchModal.vue
│   │   └── composables/
│   │       ├── useAuth.js
│   │       └── useApi.js
│   └── vite.config.js
├── data/
│   ├── dochub.db          # SQLite 数据库
│   └── projects/
│       ├── ycapi/
│       │   └── docs/
│       │       ├── business-plan.md
│       │       └── api-design.md
│       ├── banxiang/
│       │   └── docs/
│       └── meet5-research/
│           └── docs/
└── ecosystem.config.js    # PM2 配置

POST /api/ai/docs
Authorization: Bearer <AI_TOKEN>
Content-Type: application/json

{
  "project": "ycapi",
  "title": "API 接口设计 v2",
  "slug": "api-design-v2",
  "doc_type": "api",
  "parent": "design",
  "content": "# API 接口设计 v2\n\n..."
}

{
  "ok": true,
  "doc": { "id": 15, "slug": "api-design-v2", "url": "/projects/ycapi/docs/api-design-v2" }
}

┌──────────────────────────────────────────────────┐
│  🏠 DocHub                    🔍 搜索    👤 范总  │
├──────────────────────────────────────────────────┤
│                                                  │
│  我的项目                                         │
│                                                  │
│  ┌────────────┐ ┌────────────┐ ┌────────────┐   │
│  │ 🚀 ycapi   │ │ 🤝 伴享     │ │ 🔍 Meet5   │   │
│  │            │ │ 银发社交    │ │ 调研       │   │
│  │ 12 文档    │ │ 8 文档     │ │ 5 文档     │   │
│  │ 3 进行中   │ │ 1 进行中   │ │ 0 任务     │   │
│  └────────────┘ └────────────┘ └────────────┘   │
│                                                  │
│  最近更新                                         │
│  • ycapi/商业计划书 v3        2h ago              │
│  • 伴享/竞品分析              昨天                │
│  • Meet5/调研报告             3天前               │
└──────────────────────────────────────────────────┘

┌──────────────────────────────────────────────────┐
│  ← DocHub / ycapi                 🔍  📋看板  ⚙️  │
├────────────┬─────────────────────────────────────┤
│ 📂 文档     │                                     │
│            │  # 商业计划书 v3                      │
│ ▼ 📁 商业   │                                     │
│   📄 计划书 │  ## 1. 项目概述                      │
│   📄 财务   │                                     │
│ ▼ 📁 设计   │  ycapi 是一个面向...                 │
│   📄 架构   │                                     │
│   📄 API   │  ```mermaid                         │
│ ▼ 📁 需求   │  graph LR                           │
│   📄 v1.0  │    A-->B                             │
│            │  ```                                 │
│ ──────────│                                      │
│ + 新建文档  │  [✏️ 编辑] [🔗 分享] [🗑️ 删除]       │
└────────────┴─────────────────────────────────────┘

┌──────────────────────────────────────────────────┐
│  编辑: 商业计划书 v3          [💾 保存] [✖ 取消]   │
├─────────────────────┬────────────────────────────┤
│ # 商业计划书 v3     │  商业计划书 v3（渲染）       │
│                    │                             │
│ ## 1. 项目概述      │  1. 项目概述                 │
│                    │                             │
│ ycapi 是一个面向... │  ycapi 是一个面向...         │
│                    │                             │
│ (CodeMirror 编辑器) │  (实时 Markdown 预览)       │
└─────────────────────┴────────────────────────────┘

┌──────────────────────────────────────────────────┐
│  ycapi 任务看板                        + 新建任务  │
├────────────────┬────────────────┬────────────────┤
│ 📋 待办 (3)    │ 🔄 进行中 (2)   │ ✅ 已完成 (5)  │
│                │                │                │
│ ┌────────────┐│ ┌────────────┐│ ┌────────────┐ │
│ │ 支付接口    ││ │ 用户注册    ││ │ 数据库设计  │ │
│ │ 🔴 紧急     ││ │ 🟡 重要     ││ │            │ │
│ │ 2/20 截止  ││ │            ││ │            │ │
│ └────────────┘│ └────────────┘│ └────────────┘ │
│ ┌────────────┐│ ┌────────────┐│                │
│ │ 商品管理    ││ │ API 文档    ││                │
│ └────────────┘│ └────────────┘│                │
│               │                │                │
│ (支持拖拽)     │                │                │
└────────────────┴────────────────┴────────────────┘

import MarkdownIt from 'markdown-it'
import hljs from 'highlight.js'
import mermaid from 'mermaid'

const md = new MarkdownIt({
  html: true,
  linkify: true,
  highlight: (str, lang) => {
    if (lang && hljs.getLanguage(lang)) {
      return hljs.highlight(str, { language: lang }).value
    }
    return ''
  }
})

// Mermaid 插件：将 ```mermaid 代码块渲染为图表
md.use(mermaidPlugin)
// 任务列表插件
md.use(taskListPlugin)
// 数学公式（可选）
md.use(katexPlugin)

// 更新索引
db.prepare(`
  INSERT INTO documents_fts(rowid, title, content)
  VALUES (?, ?, ?)
`).run(docId, title, plainTextContent)

// 搜索
db.prepare(`
  SELECT d.*, snippet(documents_fts, 1, '<mark>', '</mark>', '...', 30) as snippet
  FROM documents_fts f
  JOIN documents d ON d.id = f.rowid
  WHERE documents_fts MATCH ?
  ORDER BY rank
  LIMIT 20
`).all(query)

管理员 (admin)：所有操作
  ↓
访客 (viewer)：仅通过分享链接查看特定文档
  ↓
AI Token：通过 Bearer Token 访问 /api/ai/* 端点

// server/utils/migrate.js
const imports = [
  { source: '/root/Projects/business-plan/', project: 'ycapi', name: 'ycapi 商业计划' },
  { source: '/root/Projects/meet5-research/', project: 'meet5-research', name: 'Meet5 调研' },
]
// 遍历 .md 文件，创建项目 + 文档记录，复制文件到 data/projects/

docs.ycapis.com {
    reverse_proxy localhost:3100
}

// ecosystem.config.js
module.exports = {
  apps: [{
    name: 'dochub',
    script: 'server/index.js',
    env: {
      NODE_ENV: 'production',
      PORT: 3100,
      SESSION_SECRET: '<random-secret>',
      AI_API_TOKEN: '<ai-token-for-lulu>',
      ADMIN_PASSWORD: '<admin-password>'
    }
  }]
}

cd /root/Projects/doc-system
npm install
cd client && npm install && npm run build && cd ..
node server/utils/migrate.js   # 导入现有文档
pm2 start ecosystem.config.js

GET /api/shares/public/:token
  查询参数：?password=xxx（或 Header: X-Share-Password）
  
  响应 200：{ doc: { title, slug, project_name, content }, share: { view_count } }
  响应 401：{ error: "Password required", requires_password: true }
  响应 410：{ error: "Share link has expired" }
  响应 404：{ error: "Shared document not found" }

GET /api/ai/docs/:project/:docSlug
  Headers: Authorization: Bearer <AI_API_TOKEN>
  响应 200：{ doc: { id, title, slug, doc_type, content, project_slug } }
  
POST /api/ai/docs
  Headers: Authorization: Bearer <AI_API_TOKEN>
  Body: { project, title, slug?, doc_type?, parent?, content }
  行为：若 project+parent+slug 已存在则更新，否则创建
  响应 200/201：{ ok: true, doc: { id, slug, url } }
  
POST /api/ai/tasks
  Headers: Authorization: Bearer <AI_API_TOKEN>
  Body: { project, title, description?, status?, priority?, due_date? }
  响应 201：{ task: { id, title, status } }

PATCH /api/ai/tasks/:id
  Headers: Authorization: Bearer <AI_API_TOKEN>
  Body: { status?, title?, description?, priority?, due_date? }
  响应 200：{ task: { id, title, status } }

-- 项目更新时间自动维护
CREATE TRIGGER IF NOT EXISTS trg_projects_updated
AFTER UPDATE ON projects
BEGIN UPDATE projects SET updated_at = CURRENT_TIMESTAMP WHERE id = NEW.id; END;

-- 文档更新时间自动维护
CREATE TRIGGER IF NOT EXISTS trg_documents_updated
AFTER UPDATE ON documents
BEGIN UPDATE documents SET updated_at = CURRENT_TIMESTAMP WHERE id = NEW.id; END;

-- 任务更新时间自动维护
CREATE TRIGGER IF NOT EXISTS trg_tasks_updated
AFTER UPDATE ON tasks
BEGIN UPDATE tasks SET updated_at = CURRENT_TIMESTAMP WHERE id = NEW.id; END;

互联网用户 / AI（露露）
        │
        ▼ HTTPS :443
┌──────────────────┐
│  Caddy (反向代理)  │  docs.ycapis.com → localhost:3100
└────────┬─────────┘
         │ HTTP :3100
┌────────▼─────────┐
│  DocHub (PM2)     │  Express + Vue 3 SPA (静态文件)
│  ├─ API Server    │
│  └─ Static Files  │
└──┬──────┬──────┬─┘
   │      │      │
   ▼      ▼      ▼
SQLite  .md文件  FTS5索引
(dochub.db)  (data/projects/*)

# 推荐：每日备份脚本
#!/bin/bash
BACKUP_DIR="/root/backups/dochub/$(date +%Y%m%d)"
mkdir -p "$BACKUP_DIR"
cp /root/Projects/doc-system/data/dochub.db "$BACKUP_DIR/"
cp -r /root/Projects/doc-system/data/projects/ "$BACKUP_DIR/"
# 保留最近 30 天
find /root/backups/dochub/ -maxdepth 1 -mtime +30 -exec rm -rf {} \;