Kodev 官方网站建设 (Next.js + Tailwind)

# 技术方案

## 架构

前端 React SPA (Vite + React + TypeScript + Tailwind CSS) + 后端 Go REST API (Gin + GORM) + PostgreSQL

## 基础设施

| 类型 | 镜像 | 别名 |

|------|------|------|

| postgres | postgres:15-alpine | postgres |

## 子任务

### 1. 首页模块开发

开发网站首页，包含 Hero 区域展示产品核心价值主张、核心特性卡片展示（3-4个主要特性）、产品截图/演示区域、CTA 行动号召按钮（如'立即开始'、'查看文档'）、页脚导航。UI设计要求：采用现代简约风格，渐变色主色调（推荐蓝紫色系），响应式布局适配移动端和桌面端，支持深色/浅色主题切换，首页加载时需要有平滑的入场动画效果。

分支后缀: `frontend-homepage`

### 2. 功能页模块开发

开发功能展示页面，包含功能列表网格布局、每个功能项的详细描述和图标、功能截图/动图展示区域、功能对比表格（可选）。UI设计要求：采用卡片式布局展示各功能模块，鼠标悬停时有微动效反馈，支持锚点导航到具体功能区块，图片支持懒加载优化性能，响应式设计确保移动端可正常浏览。

分支后缀: `frontend-features`

### 3. 文档页模块开发

开发技术文档页面，包含左侧文档目录导航、Markdown 内容渲染区域、代码高亮显示、文档搜索功能、页面内锚点跳转、文档版本切换（可选）。UI设计要求：采用三栏布局（移动端收起为单栏），代码块支持复制按钮和行号显示，文档目录支持折叠/展开，阅读进度指示器，支持深色主题代码块样式。

分支后缀: `frontend-docs`

### 4. 关于页模块开发

开发团队介绍页面，包含团队成员卡片展示、团队使命/愿景陈述、联系方式区域、社交媒体链接。UI设计要求：团队成员采用头像+姓名+职位的卡片布局，卡片悬停时有轻微上浮动效，整体风格与首页保持一致，响应式布局适配不同屏幕尺寸。

分支后缀: `frontend-about`

### 5. 后端 API 服务开发

开发 Go 后端 REST API 服务，包含：1) 内容管理 API（首页内容、功能列表、团队信息等 CRUD 接口）；2) 文档管理 API（文档列表、文档内容获取）；3) 健康检查接口；4) CORS 配置支持前端跨域访问。使用 Gin 框架构建 API，GORM 操作 PostgreSQL 数据库，提供 Swagger 文档。数据库初始化脚本需包含基础内容数据。

分支后缀: `backend-api`

### 6. 通用组件与主题系统

开发前端通用组件库和主题系统，包含：1) 主题切换功能（深色/浅色模式，使用 Tailwind dark: 前缀）；2) 通用导航栏组件（响应式菜单、移动端汉堡菜单）；3) 通用页脚组件；4) 按钮、卡片、表单等基础 UI 组件；5) SEO 优化（react-helmet 管理页面 meta tags）。UI设计要求：导航栏固定在顶部，滚动时添加阴影效果，主题切换按钮放置在导航栏右侧。

分支后缀: `frontend-common`