地基阶段先跑通基础件再谈抽象

更新于 2026-06-25

**做地基阶段（数据层 / 后端基础件）时，先把基础件跑通，不要过早为每个业务做抽象分层。** 地基任务本身价值在「跑通」，此时加很多抽象会拖慢，而且后面真正接业务时更难用。同理，前端也先把**全路由静态骨架**落地，让后续接真实 API 时不需要再改页面结构。

基础件形态：数据库为中心，其他做成薄薄一层

  • packages/db —— 最核心：schema、client、notes/clips/feeds/tags 的 CRUD
  • packages/shared —— 公共校验（环境变量、创建/更新笔记、订阅源的 Zod schema）
  • packages/auth —— 只负责登录配置，不写业务数据逻辑
  • packages/queue —— 只定义队列与 addJob()
  • packages/storage / packages/email —— 只负责上传删除 / 发信

执行顺序：先写实施 plan → 先写测试 → 再实现基础件 → 最后跑验证，如实说明哪些受环境变量或 Docker 影响没跑通。

前端骨架：全路由先落地

所有路由都建出来（marketing / auth / app 三组），登录后布局含左侧导航、顶部栏、右侧面板；列表页用 mock 数据验证虚拟滚动；编辑页集成主编辑器入口并留备选切换位。好处是后续接 API 不需要再改页面结构。 反面做法是先做一堆没被真实页面验证过的 UI 组件。

相关