01. 课程介绍
项目概述
sco-commit 是一个基于 Go + React 构建的全栈应用，用于分析 Gitea 代码仓库的提交数据。它能帮助你：
- 了解团队的代码贡献情况
- 分析项目提交趋势和健康度
- 追踪贡献者的活动
- 通过 AI 智能生成周报和分析
核心功能
| 功能模块 | 说明 |
|---|---|
| 总览仪表盘 | 展示总提交数、贡献者数量、仓库数量等关键指标 |
| 提交分析 | 趋势图、热力图、代码变更统计、语言分布 |
| 成员贡献 | 贡献者排行、对比分析、活跃趋势 |
| 仓库分析 | 健康指标、活跃度、贡献者分层 |
| AI 助手 | 智能问答、自动生成周报 |
| 实时同步 | 从 Gitea 实时同步数据，支持 SSE 进度推送 |
技术架构
技术栈一览
后端技术
- Go 1.25 - Go 语言 runtime
- Fiber v2 - 高性能 Web 框架
- Bun ORM - 数据库 ORM
- PostgreSQL - 关系型数据库
- Asynq - 任务队列
- Cloudwego EINO - AI LLM 框架
前端技术
- React 19 - UI 框架
- TypeScript - 类型安全
- Vite 7 - 构建工具
- TanStack Router - 文件路由
- Zustand - 状态管理
- React Query - 服务端状态管理
- shadcn/ui - UI 组件库
- Tailwind CSS 4 - 样式框架
- Recharts - 图表库
什么是 Gitea？
Gitea 是一个开源的轻量级 Git 服务，类似于 GitHub 或 GitLab。你可以使用 Gitea 托管自己的代码仓库。
本项目通过 Gitea Open API 获取仓库、提交、分支等数据，进行分析和可视化。
为什么学习这个项目？
- 全栈实战 - 涵盖前端、后端、数据库、AI 集成
- 现代技术栈 - 紧跟技术发展趋势
- 真实业务场景 - 企业级的代码分析需求
- 最佳实践 - 清晰的代码结构和架构设计
课程目标
完成本教程后，你将能够：
- ✅ 理解 Go + React 全栈项目的架构设计
- ✅ 掌握 Fiber 框架构建 RESTful API
- ✅ 学会 React 现代开发模式（Hooks、状态管理）
- ✅ 实现与第三方 API（Gitea）的集成
- ✅ 了解 AI Agent 的基本原理和实现
- ✅ 掌握 Docker 部署技能
接下来
下一节我们将学习如何搭建开发环境，安装所需的工具和依赖。
