7 Commits

Author SHA1 Message Date
imbytecat 393ff406a3 docs(readme): 强调 PostgreSQL 18+ 要求并提供 escape hatch
代码 schema 用了 PG 原生 uuidv7() 函数,PG <18 会炸。在技术栈行里把
PostgreSQL 改成 PostgreSQL 18+,快速开始顶部加 callout 说明改回
Bun.randomUUIDv7() 的方式以兼容老版本。
2026-04-25 17:34:43 +08:00
imbytecat 27e5f3c76f chore(vite): remove server block (no need to pin port 3000 strict)
vite default already binds 3000 if available; no real requirement to
strict-port. AGENTS.md / README.md synced.
2026-04-25 17:19:27 +08:00
imbytecat d206a3315f docs(readme): 重写为面向人类用户的版本
原版本以工程术语堆砌(强约定 / 契约优先 / 不变量等)开篇,对新人不友好。重写以"是什么 → 为什么 → 怎么跑 → 怎么扩 → 怎么部署 → 参考"为线索:

- 开篇一句话讲清单二进制部署的核心卖点
- 新增"为什么用这个"突出 4 条价值点
- 新增"目录结构"帮助导航
- "加功能"步骤补充粗体小标题,每步意图一目了然
- 部署、脚本、端点全部表格化,便于扫读
- 删除对 AGENTS.md 的引用(人类读者无关)
2026-04-25 15:34:48 +08:00
imbytecat c6027590a7 docs(readme): 全文中文化
保持原结构与技术准确性,仅做语言切换。技术术语(RPC、OpenAPI、migrate、Drizzle Studio 等)保留英文。
2026-04-25 15:30:36 +08:00
imbytecat 7e27640a26 feat(deploy): migrations 嵌入二进制,实现真单文件部署
- embed-migrations.ts:扫 ./drizzle/meta/_journal.json,生成 src/server/db/migrations.gen.ts,每条 SQL 通过 `import sql_<idx> from '../../../drizzle/<tag>.sql' with { type: 'text' }` 在 bun build --compile 时被静态嵌入二进制
- migrate.ts 重写:runtime 用 createHash('sha256') 计算迁移哈希,仅用 db.execute(sql) + db.transaction() 公开 API 写入 drizzle.__drizzle_migrations 簿记表(不依赖 @internal 的 db.dialect/db.session)
- db:generate 链 db:embed,保证 SQL 改动总是同步到 migrations.gen.ts
- Dockerfile 删 COPY drizzle/,binary 是部署唯一 artifact
- 同步 README / AGENTS / biome.json
2026-04-25 14:05:58 +08:00
imbytecat 20104a6d53 docs(readme): 补 test 脚本与 query helper 步骤
- scripts 表加 `bun run test`
- Add a feature 拆出 `src/client/queries/<feature>.ts` 步骤,与 AGENTS.md 对齐
2026-04-25 13:37:05 +08:00
imbytecat a3a62c24b9 docs: 新增 README,AGENTS 同步至当前架构
- README: 用户向 quick-start、scripts 表、add-a-feature checklist、deploy 流程
- AGENTS:
  - 修订 stale 文案(VITE_APP_TITLE/experimental_defaults/.gitkeep/route 组件风格)
  - 新增 Testing 段(bun test 约定)和 Endpoints 段(/, /health, /api/*)
  - Layout 补 logger.ts、health.ts、components/、styles.css、根 drizzle/
  - 追加 10 条 room-to-grow 纪律(client query / middleware / interceptor / 测试等扩展边界)
2026-04-25 13:31:45 +08:00