技术架构
技术栈与运行时
了解框架、数据、AI 和 Cloudflare 部署之间的关系。
技术组成
| 层次 | 当前实现 | 主要职责 |
|---|---|---|
| 页面与服务端 | Next.js 16、React 19、TypeScript | App Router、页面、服务端处理 |
| 样式与组件 | Tailwind CSS 4、Radix UI、Lucide | 共享界面、交互与图标 |
| 简历富文本 | TipTap | 经历编辑与事务撤销 |
| 国际化 | next-intl | 路由、消息模块与语言选择 |
| 文档 | Fumadocs、MDX | 文件内容、导航树与搜索 |
| 认证 | Better Auth | 会话、登录与账户能力 |
| 数据 | Drizzle ORM、Cloudflare D1 | 业务持久化与迁移 |
| AI | AI SDK、Google、兼容协议适配 | 结构化生成、流式对话与图片 |
| 部署 | OpenNext、Cloudflare Workers | 将 Next.js 构建为 Worker |
| 质量 | Biome、TypeScript、Node 测试 | 格式、类型与核心行为验证 |
精确版本以 package.json 与锁文件为准。
运行时边界
浏览器负责编辑状态、预览以及本地模型配置。服务端负责认证、业务校验、按账户访问数据库、模型请求和平台计费。
Next.js 本地开发与 Cloudflare Worker 预览不是同一种环境。D1 通过 OpenNext 的 Cloudflare context 获取;新增仅支持 Node 的依赖前,要验证 Worker 兼容性。
开发前阅读
仓库所安装的 Next.js 文档位于 node_modules/next/dist/docs/。新增路由、缓存或服务端 API 前阅读对应版本说明;不要直接沿用旧版本同步读取 params、cookies 等写法。
实现入口
next.config.ts与open-next.config.ts:构建与部署适配。src/integrations/database/client.ts:D1 context。src/ai/index.ts:平台模型注册表。
继续阅读项目结构。