Offer快帮开发者文档
技术架构

技术栈与运行时

了解框架、数据、AI 和 Cloudflare 部署之间的关系。

技术组成

层次当前实现主要职责
页面与服务端Next.js 16、React 19、TypeScriptApp Router、页面、服务端处理
样式与组件Tailwind CSS 4、Radix UI、Lucide共享界面、交互与图标
简历富文本TipTap经历编辑与事务撤销
国际化next-intl路由、消息模块与语言选择
文档Fumadocs、MDX文件内容、导航树与搜索
认证Better Auth会话、登录与账户能力
数据Drizzle ORM、Cloudflare D1业务持久化与迁移
AIAI 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:平台模型注册表。

继续阅读项目结构。

本页目录