​
数据来源

Projects 主要来源于数据库表 Project 和 ProjectFeature。 当前项目提供了种子脚本：scripts/projects-seed.ts。

​
快速初始化项目数据

cd ~/web/gump-website
npx tsx scripts/projects-seed.ts
执行后会 upsert 多个示例项目，并重建对应 features。

​
详情页正文来源

lib/projects/repository.ts 会尝试读取： content/projects/<slug>/index.mdx 如果文件不存在，会用数据库字段生成兜底正文。

​
推荐实践

即使项目核心数据在数据库，也建议为每个项目补充 index.mdx，这样你可以维护更完整的故事化内容。 示例结构： 
content/projects/
  nexus-queue/
    index.mdx
    assets/

​
注意事项

  • 没有 DATABASE_URL 时，Projects 页面会回退到内置 fallback 数据
  • 这意味着你在纯前端模式下也能看到示例项目，但与生产数据库可能不一致
如果你新增了项目字段，请同步更新 prisma/schema.prisma、seed 脚本和 /reference/routes 的相关说明。