tic-tac-toe-game/README.md

井字过三关游戏 - 完整项目文档

项目概述

这是一个基于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 了解故障排除方法