moltbot
926cb007a5
Some checks failed
Complete CI/CD Pipeline / build-and-test (push) Has been cancelled
Complete CI/CD Pipeline / security-scan (push) Has been cancelled
Complete CI/CD Pipeline / deploy-dev (push) Has been cancelled
Complete CI/CD Pipeline / deploy-prod (push) Has been cancelled
Complete CI/CD Pipeline / cleanup (push) Has been cancelled
69 lines
2.3 KiB
Markdown
69 lines
2.3 KiB
Markdown
# 井字过三关游戏 - 完整项目文档
|
||
|
||
## 项目概述
|
||
这是一个基于Web的井字过三关游戏（Tic-Tac-Toe），具有直观的用户界面和流畅的游戏体验。项目实现了完整的CI/CD自动化流程。
|
||
|
||
## 功能特性
|
||
- 直观的3x3游戏棋盘
|
||
- 实时玩家切换（X/O）
|
||
- 胜利条件自动检测
|
||
- 分数统计与持久化存储
|
||
- 响应式设计适配不同设备
|
||
- 胜利路径高亮动画
|
||
- 新游戏和重置分数功能
|
||
|
||
## 技术架构
|
||
- **前端**: HTML5, CSS3, JavaScript (ES6+)
|
||
- **无后端**: 纯前端实现
|
||
- **响应式设计**: 支持桌面和移动设备
|
||
- **本地存储**: 使用LocalStorage保存游戏统计数据
|
||
|
||
## CI/CD 流水线
|
||
|
||
### 自动化流程
|
||
1. **触发**: 每次推送到main分支时自动触发
|
||
2. **构建与测试**: 验证代码完整性和安全性
|
||
3. **开发部署**: 自动部署到开发环境
|
||
4. **生产部署**: 经验证后部署到生产环境
|
||
5. **清理**: 清理临时文件
|
||
|
||
### 部署路径
|
||
- **开发环境**: `http://<server-ip>/tic-tac-toe-dev/`
|
||
- **生产环境**: `http://<server-ip>/tic-tac-toe/`
|
||
|
||
### 配置文件
|
||
- `.gitea/workflows/cicd.yml` - CI/CD工作流配置
|
||
- `CICD_SETUP_GUIDE.md` - CI/CD配置指南
|
||
|
||
## 文件结构
|
||
```
|
||
tic-tac-toe-game/
|
||
├── index.html # 主页面
|
||
├── styles.css # 样式文件
|
||
├── script.js # 游戏逻辑
|
||
├── README.md # 项目介绍
|
||
├── PROJECT_PLAN.md # 项目计划
|
||
├── DEPLOYMENT.md # 部署文档
|
||
├── DOCKER_DEPLOY.md # Docker部署说明
|
||
├── PROJECT_SUMMARY.md # 项目总结
|
||
├── CICD_SETUP_GUIDE.md # CI/CD配置指南
|
||
├── deploy.sh # 部署脚本
|
||
└── .gitea/workflows/
|
||
└── cicd.yml # CI/CD工作流配置
|
||
```
|
||
|
||
## 部署要求
|
||
要使CI/CD流水线正常工作，需要：
|
||
1. 在目标服务器上配置Gitea Actions Runner
|
||
2. 确保Runner有权限写入Web目录
|
||
3. 设置适当的文件权限
|
||
|
||
## 后续步骤
|
||
1. 配置Gitea Actions Runner以执行部署任务
|
||
2. 验证开发和生产环境部署
|
||
3. 扩展游戏功能（如AI对手、在线对战等）
|
||
|
||
## 维护
|
||
- 游戏数据存储在用户浏览器中 (LocalStorage)
|
||
- 更新只需推送代码到main分支即可自动部署
|
||
- 查看 `CICD_SETUP_GUIDE.md` 了解故障排除方法 |