​
常用命令

# 本地开发
npm install
npm run db:up
npm run db:generate
npm run db:migrate
npm run content:sync
npm run dev

# 提交前检查
npm run lint
npm run test
npm run build

​
内容更新最短路径

  1. 修改 content/* 下对应文件
  2. 执行 npm run content:sync:dry
  3. 执行 npm run content:sync
  4. 验证前台页面与后台列表

​
后台入口

  • 登录：/admin/login
  • 管理总览：/admin
  • Blog 管理：/admin/posts
  • Reading 管理：/admin/reading
  • Travel 管理：/admin/travel
  • Projects 管理：/admin/projects

​
API 入口

  • POST /api/admin/login
  • POST /api/admin/logout
  • POST /api/admin/sync

​
故障排查顺序

  1. 看环境变量（DATABASE_URL、ADMIN_PASSWORD）
  2. 看数据库状态（容器、连接、迁移）
  3. 看内容格式（frontmatter、JSON）
  4. 看同步结果（dry-run 与正式同步）
  5. 看页面与 API 响应

​
发布动作

  1. npm run lint
  2. npm run test
  3. npm run build
  4. 执行迁移（生产用 prisma migrate deploy）
  5. 验证 /、/blog、/admin/login

​
术语约定

  • 文档统一用“后台”指代 admin area
  • 文档统一用“文章”指代 blog post
  • 文档统一用“内容同步”指代 content:sync

​
进一步查看

  • 全量代码路径与功能：/reference/repo-file-map