用途:为 Go JSON API + React SPA 的全栈项目提供统一架构与开发流程约定,适用于搭建新应用、添加功能、修复缺陷和本地运行。
主要能力:后端采用 Go 标准库 net/http 路由、pgx/v5 连接 Postgres、sqlc 生成查询、slog 日志、go:embed 嵌入 SQL 迁移;前端采用 React + TypeScript、shadcn/ui、Tailwind CSS,React Router 框架模式并设 ssr: false,运行时为纯 SPA,Vite 作为开发服务器与打包器。前后端由单个 Go 二进制提供,部署为单一容器。
使用方式:项目分为 backend、frontend、e2e、Dockerfile 等目录。本地通过 .env 提供连接串与密钥,启动前用 set -a && . .env && set +a 加载,Go 侧统一用 os.Getenv 读取。密钥不得在对话中索取或粘贴:代理生成的密钥可直接写入,用户提供的密钥先写 REPLACE_WITH_ 占位符,再用编辑器打开 .env 填写并校验。文档需维护 docs/PRD.md、docs/TASKS.md、docs/adr/、docs/INFRASTRUCTURE.md。公开页面在 react-router.config.ts 的 prerender 中列出,构建时生成静态 HTML,供搜索引擎与 AI 爬虫读取;每个公开路由需导出 meta 提供标题、描述与 OG 标签。
限制:ssr: false 下服务端 loader/action 仅允许用于预渲染路由;运行时无 Node 服务器。静态资源与 SPA 回退需按资料给出的处理方式,避免 MIME 错误与目录列表暴露。robots.txt、sitemap.xml、llms.txt 应由 Go 处理器基于 BASE_URL 动态生成。资料未提供具体收费、价格与效果信息。