DocBase

企业知识库 MVP — 面向团队的内部文档平台，支持登录访问、空间/分类组织、文档编辑、标签筛选、基础搜索，以及 OpenAPI/Swagger 接入。

技术栈

• Framework: TanStack Start + React 19 + TypeScript
• Database: PostgreSQL 16 + Drizzle ORM
• Cache: Redis 7
• Auth: better-auth
• Editor: TipTap + sanitize-html
• UI: shadcn/ui + Radix UI + Tailwind CSS v4
• Tests: Vitest + Playwright
• Deploy: Aliyun FC 3.0

快速开始

cp .env.example .env
# edit .env for host-based local dev:
# DATABASE_URL=postgres://docbase:change_me_in_production@localhost:5432/docbase
# REDIS_URL=redis://localhost:6379
# DOCBASE_INSTALLED=true
pnpm install
# start PostgreSQL 16 and Redis 7 locally before continuing
pnpm db:migrate
pnpm db:seed
pnpm dev

访问 http://localhost:3000。

如果希望体验 Web 安装向导，请不要设置 DOCBASE_INSTALLED=true，也不要执行 pnpm db:seed，改为直接访问 /install。

种子用户：

• admin / admin123
• alice@example.com / Password123!
• bob@example.com / Password123!

当前 MVP

• 内部登录后访问知识内容
• 管理员/成员角色
• 空间、分类、文档、标签
• 文档草稿与发布
• 全局基础搜索
• OpenAPI / Swagger 文档
• 中文企业产品风格布局

文档

• 项目宪章
• Feature 规范
• 实现计划
• 数据模型
• Server Function 契约
• 任务列表
• Restish + OpenAPI 接入
• 部署运维手册