diff --git "a/\346\232\221\346\234\237\351\233\206\350\256\255/07\351\241\271\347\233\256\346\226\207\346\241\243/API\350\256\276\350\256\241\346\226\207\346\241\243.md" "b/\346\232\221\346\234\237\351\233\206\350\256\255/07\351\241\271\347\233\256\346\226\207\346\241\243/API\350\256\276\350\256\241\346\226\207\346\241\243.md"
new file mode 100644
index 0000000000000000000000000000000000000000..738e77f6722741fc894213ff7977707c984c332f
--- /dev/null
+++ "b/\346\232\221\346\234\237\351\233\206\350\256\255/07\351\241\271\347\233\256\346\226\207\346\241\243/API\350\256\276\350\256\241\346\226\207\346\241\243.md"
@@ -0,0 +1,346 @@
+# 📘 多人实时涂色抢地盘游戏 — API 设计文档
+
+---
+
+## 🎮 一、项目概述
+
+### 项目名称：
+**多人实时涂色抢地盘游戏**
+
+### 项目类型：
+基于 Web 的多人实时竞技休闲类 Canvas 游戏
+
+### 核心玩法：
+2~6 名玩家在同一画布上使用各自分配的专属颜色进行涂色，**不能覆盖其他玩家已涂区域**，最终根据**占领画布面积最大**来决定胜负。
+
+---
+
+## 🏗️ 二、技术架构简述
+
+| 层级 | 技术栈 |
+|------|--------|
+| **前端** | Vue 3 + Canvas API + Socket.io-client / HTTP |
+| **后端** | ASP.NET Core 8 (Minimal APIs) + SignalR + Redis + PostgreSQL |
+| **通信协议** | HTTP（RESTful API，用于房间管理）<br>WebSocket（SignalR，用于实时绘图、状态同步、倒计时、游戏流程控制） |
+
+---
+
+## 📡 三、API 分类
+
+本文档包含以下两类 API 设计：
+
+1. **HTTP RESTful API**（主要用于房间管理、游戏状态查询、用户管理等）
+2. **WebSocket 实时 API（SignalR Hub）**（主要用于实时绘图同步、倒计时推送、游戏流程控制、玩家状态同步）
+
+---
+
+# 🌐 第一部分：HTTP RESTful API 设计（后端）
+
+> 主要用于：房间管理、游戏配置、基础信息查询等 **非实时操作**
+
+### 基础信息
+
+- **Base URL**: `https://yourdomain.com/api/` （可配置）
+- **Content-Type**: `application/json`
+- **认证方式**: 暂未设计（可后续加入 JWT / Token，当前假设为开放式房间）
+
+---
+
+## 1. 🏠 房间管理 API
+
+### 1.1 创建房间
+
+**POST** `/api/rooms`
+
+#### 请求参数（JSON Body）:
+
+```json
+{
+  "roomCode": "ABC123",         // 可选，玩家自定义房间号
+  "playerName": "Alice",        // 玩家昵称
+  "password": "123456"          // 可选，房间密码
+}
+```
+
+#### 响应（成功 200 Created）:
+
+```json
+{
+  "roomId": 1,
+  "roomCode": "ABC123",
+  "playerId": 101,
+  "playerName": "Alice",
+  "status": "Waiting",
+  "message": "房间创建成功，请等待其他玩家加入"
+}
+```
+
+#### 错误情况：
+
+- 400：参数无效 / 房间号已存在
+- 500：服务器错误
+
+---
+
+### 1.2 加入房间
+
+**POST** `/api/rooms/join`
+
+#### 请求参数（JSON Body）:
+
+```json
+{
+  "roomCode": "ABC123",
+  "playerName": "Bob",
+  "password": "123456"  // 如果房间设置了密码
+}
+```
+
+#### 响应（成功 200 OK）:
+
+```json
+{
+  "roomId": 1,
+  "roomCode": "ABC123",
+  "playerId": 102,
+  "playerName": "Bob",
+  "status": "Waiting",
+  "message": "成功加入房间"
+}
+```
+
+#### 错误码：
+
+- 404：房间不存在
+- 403：房间已满 / 密码错误 / 游戏已开始
+- 400：参数错误
+
+---
+
+### 1.3 获取房间信息（可选）
+
+**GET** `/api/rooms/{roomId}`
+
+#### 响应示例：
+
+```json
+{
+  "roomId": 1,
+  "roomCode": "ABC123",
+  "players": [
+    { "playerId": 101, "playerName": "Alice", "isReady": false },
+    { "playerId": 102, "playerName": "Bob", "isReady": true }
+  ],
+  "gameStatus": "Waiting", // Waiting / Playing / Finished
+  "timeLeft": 30
+}
+```
+
+---
+
+## 2. 📊 游戏结果 API（可选，也可通过 WebSocket 推送）
+
+### 2.1 获取游戏结果（房间结束后调用）
+
+**GET** `/api/games/result?roomId=1`
+
+#### 响应示例：
+
+```json
+{
+  "roomId": 1,
+  "roomCode": "ABC123",
+  "winningPlayerName": "Alice",
+  "winningScore": 42,
+  "players": [
+    { "playerName": "Alice", "score": 42, "isWinner": true },
+    { "playerName": "Bob", "score": 23, "isWinner": false }
+  ],
+  "playedAt": "2024-06-01T12:00:00Z"
+}
+```
+
+> 🎯 **推荐：游戏结果更推荐通过 SignalR 实时推送，此接口可作为备选或重播查询使用**
+
+---
+
+# 🔄 第二部分：WebSocket 实时 API（SignalR Hub）
+
+> 主要用于：**实时绘图同步、游戏状态管理、倒计时推送、玩家加入/离开、绘制动作广播**
+
+---
+
+## 🧩 SignalR Hub 路径
+
+- **Hub URL（前端连接地址）**: `/gameHub` （可配置）
+- **通信协议**: WebSocket（通过 SignalR）
+
+> 前端使用 https://docs.microsoft.com/en-us/aspnet/core/signalr/javascript-client 与后端 Hub 通信
+
+---
+
+## 1. 🧩 Hub 方法 / 事件概览
+
+| 类型 | 名称 | 说明 |
+|------|------|------|
+| ✅ 客户端 → 服务端 | `JoinRoom` | 玩家加入房间 |
+| ✅ 客户端 → 服务端 | `SendDrawAction` | 发送绘制点（坐标、颜色、玩家ID） |
+| ✅ 服务端 → 客户端 | `BroadcastDrawAction` | 广播其他玩家的绘制动作 |
+| ✅ 服务端 → 客户端 | `GameStateChanged` | 推送游戏状态变更（准备/游戏中/结算） |
+| ✅ 服务端 → 客户端 | `CountdownUpdated` | 推送倒计时更新 |
+| ✅ 服务端 → 客户端 | `GameResultAnnounced` | 推送游戏结果（排名、获胜者） |
+| ✅ 服务端 → 客户端 | `PlayerJoined` / `PlayerLeft` | 玩家进入 / 离开房间通知 |
+
+---
+
+## 2. 📡 详细实时事件设计
+
+### 2.1 玩家加入房间
+
+#### 客户端调用（示例）：
+
+```javascript
+connection.invoke("JoinRoom", {
+  roomId: 1,
+  playerName: "Alice",
+  playerId: 101
+});
+```
+
+#### 服务端广播：
+
+- 事件名：`PlayerJoined`
+- 内容：`{ playerName: "Alice", playerId: 101 }`
+- 推送给房间内其他所有玩家
+
+---
+
+### 2.2 玩家绘制动作（实时同步）
+
+#### 客户端发送绘制点：
+
+```javascript
+connection.invoke("SendDrawAction", {
+  x: 100,
+  y: 200,
+  color: "#FF0000",
+  playerId: 101
+});
+```
+
+#### 服务端广播给其他玩家：
+
+- 事件名：`BroadcastDrawAction`
+- 内容：
+```json
+{
+  "x": 100,
+  "y": 200,
+  "color": "#FF0000",
+  "playerId": 101
+}
+```
+
+---
+
+### 2.3 游戏状态变更
+
+#### 服务端推送：
+
+- 事件名：`GameStateChanged`
+- 内容：
+```json
+{
+  "gameState": "Playing" // 或 "Waiting", "Finished"
+}
+```
+
+---
+
+### 2.4 倒计时更新
+
+#### 服务端推送：
+
+- 事件名：`CountdownUpdated`
+- 内容：
+```json
+{
+  "phase": "Game",         // "Preparing", "Game", "Finishing"
+  "timeLeftSeconds": 25
+}
+```
+
+---
+
+### 2.5 游戏结果推送
+
+#### 服务端推送：
+
+- 事件名：`GameResultAnnounced`
+- 内容：
+```json
+{
+  "winningPlayerName": "Alice",
+  "winningScore": 42,
+  "players": [
+    { "playerName": "Alice", "score": 42, "isWinner": true },
+    { "playerName": "Bob", "score": 23, "isWinner": false }
+  ]
+}
+```
+
+---
+
+## 3. 🧩 SignalR 客户端连接示例（前端）
+
+```javascript
+const connection = new signalR.HubConnectionBuilder()
+  .withUrl("https://yourdomain.com/gameHub")
+  .build();
+
+await connection.start();
+await connection.invoke("JoinRoom", { roomId: 1, playerName: "Alice", playerId: 101 });
+
+connection.on("BroadcastDrawAction", (data) => {
+  // 在 Canvas 上绘制其他玩家的点
+});
+
+connection.on("GameStateChanged", (state) => {
+  console.log("游戏状态变更为:", state);
+});
+
+connection.on("CountdownUpdated", (data) => {
+  console.log(`倒计时 - ${data.phase}: ${data.timeLeftSeconds}s`);
+});
+```
+
+---
+
+## ✅ 四、安全与扩展建议
+
+| 类别 | 建议 |
+|------|------|
+| 🔐 **认证与授权** | 当前为开放式设计，可后续接入 JWT / Token 验证玩家身份 |
+| 🧩 **扩展 API** | 可增加聊天系统 API、观战模式接口、房间设置接口等 |
+| 📊 **数据持久化 API** | 可提供游戏历史记录查询、玩家排行榜接口 |
+| 🌍 **跨域支持** | 确保 API 支持 CORS，特别是前端与后端域名不同的情况 |
+| 🧪 **接口测试** | 推荐使用 Swagger / OpenAPI 文档 + Postman 进行测试 |
+
+---
+
+## 📌 五、总结
+
+| 类型 | 协议 | 用途 |
+|------|------|------|
+| **HTTP RESTful API** | HTTPS | 房间管理、游戏信息查询、结果获取 |
+| **WebSocket 实时 API** | SignalR over WebSocket | 实时绘图同步、游戏状态、倒计时、玩家同步 |
+
+---
+
+🚀 **通过本 API 设计文档，前端与后端团队可以清晰对接：**
+
+- 如何创建 / 加入房间（HTTP）
+- 如何同步绘制动作、游戏状态、倒计时、结果（SignalR / WebSocket）
+- 如何扩展功能如聊天、观战、历史记录等
+
+---
\ No newline at end of file
diff --git "a/\346\232\221\346\234\237\351\233\206\350\256\255/07\351\241\271\347\233\256\346\226\207\346\241\243/Git\345\267\245\344\275\234\346\265\201\350\247\204\350\214\203.md" "b/\346\232\221\346\234\237\351\233\206\350\256\255/07\351\241\271\347\233\256\346\226\207\346\241\243/Git\345\267\245\344\275\234\346\265\201\350\247\204\350\214\203.md"
new file mode 100644
index 0000000000000000000000000000000000000000..0e6bda60e79d526d1bf6007f620199edcea92c67
--- /dev/null
+++ "b/\346\232\221\346\234\237\351\233\206\350\256\255/07\351\241\271\347\233\256\346\226\207\346\241\243/Git\345\267\245\344\275\234\346\265\201\350\247\204\350\214\203.md"
@@ -0,0 +1,22 @@
+# Git工作流规范
+
+## 分支管理
+- 主分支（master）：仅用于发布正式版本
+- 开发分支（dev）：日常开发集成，所有功能分支合并到此
+- 功能分支（feature/xxx）：开发新功能，完成后合并到 dev
+- 修复分支（fix/xxx）：修复 bug，完成后合并到 dev
+- 发布分支（release/xxx）：预发布测试，合并到 main 和 dev
+
+## 提交规范
+- 格式：<类型>: <描述>
+- 类型示例：feat（新功能）、fix（修复）、docs（文档）、refactor（重构）、test（测试）、chore（杂项）
+- 示例：feat: 新增角色管理页面
+
+## 合并流程
+1. 功能开发完成后，提交 Pull Request 到 dev 分支
+2. 由团队成员进行代码评审
+3. 通过后合并，删除功能分支
+
+## 代码审查
+- 每次合并需至少一人审核
+- 重点关注安全、性能、可维护性
diff --git "a/\346\232\221\346\234\237\351\233\206\350\256\255/07\351\241\271\347\233\256\346\226\207\346\241\243/\345\274\200\345\217\221\346\214\207\345\215\227.md" "b/\346\232\221\346\234\237\351\233\206\350\256\255/07\351\241\271\347\233\256\346\226\207\346\241\243/\345\274\200\345\217\221\346\214\207\345\215\227.md"
new file mode 100644
index 0000000000000000000000000000000000000000..1bfc351c71a5d3aef29eea35d817a2290a53bda3
--- /dev/null
+++ "b/\346\232\221\346\234\237\351\233\206\350\256\255/07\351\241\271\347\233\256\346\226\207\346\241\243/\345\274\200\345\217\221\346\214\207\345\215\227.md"
@@ -0,0 +1,267 @@
+当然！以下是为你的多人实时涂色抢地盘游戏项目，基于你提供的详细需求与技术架构，整理出的：
+
+---
+
+# 📘 **多人实时涂色抢地盘游戏 — 开发指南**
+
+---
+
+## 🧩 文档结构
+
+- #-一项目概述
+- #-二技术架构总览
+- #-三前端开发指南
+  - #31-技术栈
+  - #32-核心功能模块
+  - #33-开发任务分解
+  - #34-推荐开发流程
+- #-四后端开发指南
+  - #41-技术栈
+  - #42-核心功能模块
+  - #43-开发任务分解
+  - #44-推荐开发流程
+- #-五前后端交互与通信
+- #-六开发计划建议4天冲刺
+- #-七附录与扩展
+
+---
+
+## 🎮 一、项目概述
+
+### 项目名称：
+**多人实时涂色抢地盘游戏**
+
+### 目标用户：
+喜欢轻度竞技、实时互动、简单策略的休闲游戏玩家
+
+### 游戏类型：
+多人实时协作/竞技类 Canvas 涂色游戏
+
+### 核心玩法：
+多名玩家（2~6人）在同一个画布上使用各自分配的颜色进行涂色，**不能覆盖他人已涂区域**，最终根据**占领画布面积最大**来决定胜负。
+
+---
+
+## 🔧 二、技术架构总览
+
+| 层级 | 前端技术栈 | 后端技术栈 |
+|------|-------------|-------------|
+| **框架** | Vue 3 + Composition API | ASP.NET Core 8 (Minimal APIs) |
+| **实时通信** | Socket.io-client | SignalR |
+| **Canvas绘图** | 原生 Canvas API | - |
+| **UI组件库** | Element Plus | - |
+| **状态管理** | Pinia | - |
+| **数据存储** | - | Redis（会话/实时数据）、PostgreSQL（持久化） |
+| **架构模式** | - | 简洁 DDD + CQRS |
+
+---
+
+## 📱 三、前端开发指南
+
+### 3.1 技术栈
+
+- **框架**: Vue 3（Composition API + `<script setup>`）
+- **UI组件**: https://element-plus.org/
+- **状态管理**: https://pinia.vuejs.org/
+- **实时通信**: https://socket.io/docs/v4/client-installation/
+- **绘图**: 原生 https://developer.mozilla.org/en-US/docs/Web/API/Canvas_API
+- **构建工具**: Vite（默认 Vue 项目脚手架）
+
+---
+
+### 3.2 核心功能模块
+
+| 模块 | 功能点 | 说明 |
+|------|--------|------|
+| 🎨 **绘图模块** | 画笔绘制、颜色分配、实时渲染 | 固定笔刷大小，玩家只能涂自己的颜色 |
+| 🧩 **Canvas模块** | Canvas 画布管理、点击/拖拽绘制、区域保护 | 边界中性区、最小涂色单位、冷却机制 |
+| 📊 **统计模块** | 实时计算各玩家占领面积 | 像素级统计或区域聚合 |
+| 🎮 **游戏流程控制** | 准备阶段倒计时、游戏阶段、结算阶段 | 控制各阶段状态与 UI |
+| ⏰ **倒计时模块** | 准备(30s) → 游戏(3-5m) → 结算(30s) | 倒计时显示与阶段切换 |
+| 👥 **房间系统** | 创建/加入房间、玩家列表、房主权限 | 房间号、密码（可选）、实时同步 |
+| 🏆 **结算模块** | 面积排名、获胜者展示、游戏结果 UI | 展示最终画布 + 排行榜 |
+| 🔌 **实时通信** | 通过 Socket.io-client 与后端 SignalR 通信 | 同步绘制、状态、倒计时、结果 |
+
+---
+
+### 3.3 开发任务分解（建议按优先级排序）
+
+#### 🚀 第1天：基础框架 + 房间系统 + 绘图基础
+
+- [ ] 搭建 Vue 3 + Pinia + Element Plus 项目
+- [ ] 实现 **房间创建 / 加入**（输入房间号，Socket 连接）
+- [ ] 实现基础 **Canvas 画布**（可绘制、固定笔刷）
+- [ ] 实现玩家颜色分配（模拟或通过 Socket 接收）
+- [ ] 基础通信：连接 SignalR / Socket.io 后端
+
+#### 🧩 第2天：游戏流程 + 实时同步
+
+- [ ] 实现 **准备阶段倒计时（30s）**
+- [ ] 实现 **游戏阶段倒计时（3~5分钟）**
+- [ ] 实现多玩家 **实时绘制同步**（Socket 同步绘制点）
+- [ ] 实现 **区域保护**（不能覆盖他人颜色）
+- [ ] 实现 **冷却机制**（0.1s 绘制间隔）
+- [ ] 实现 **实时玩家列表 & 在线状态**
+
+#### 📈 第3天：统计 + 排行榜 + 结算
+
+- [ ] 实现 **实时面积统计**（像素统计 / 区块统计）
+- [ ] 实时显示 **各玩家占领面积排行榜**
+- [ ] 实现 **结算阶段倒计时（30s）**
+- [ ] 实现 **面积计算算法**（谁占领最多）
+- [ ] 展示 **最终排名 & 获胜者**
+- [ ] 渲染 **最终画布效果（可截图/展示）**
+
+#### ✅ 第4天：优化 + 扩展 + 测试
+
+- [ ] 优化绘制性能与 UI 响应
+- [ ] 完善 **UI 提示**（如“游戏结束”、“计算中”）
+- [ ] 添加 **音效 / 动画（可选）**
+- [ ] 实现 **观战模式（可选）**
+- [ ] 联调测试、bug 修复
+- [ ] 部署预览 / 演示
+
+---
+
+### 3.4 推荐开发流程
+
+1. **先搭前端基础框架**（Vue + Pinia + Canvas）
+2. **实现房间系统 & Socket 连接**
+3. **绘制功能先行，保证本地可画**
+4. **接入实时同步，多玩家可同时绘制**
+5. **加入倒计时 & 游戏阶段控制**
+6. **统计面积 → 排行榜 → 结算展示**
+7. **优化体验，添加提示、动画、音效**
+8. **整体联调 & 测试**
+
+---
+
+## ⚙️ 四、后端开发指南
+
+### 4.1 技术栈
+
+- **框架**: ASP.NET Core 8（使用 Minimal APIs）
+- **实时通信**: https://docs.microsoft.com/en-us/aspnet/core/signalr/introduction
+- **数据存储**:
+  - **Redis**: 存储游戏会话、房间状态、玩家信息、实时数据
+  - **PostgreSQL**: 持久化存储房间记录、玩家成绩、历史数据
+- **架构模式**: 简洁 **DDD（领域驱动设计）** + **CQRS（读写分离，可选）**
+
+---
+
+### 4.2 核心功能模块
+
+| 模块 | 功能点 | 说明 |
+|------|--------|------|
+| 🏠 **房间管理** | 创建房间、加入房间、房间状态 | 房间号、密码、玩家列表 |
+| 🎮 **游戏流程控制** | 准备 → 游戏 → 结算 阶段管理 | 倒计时逻辑、状态切换 |
+| 🖌️ **绘图同步** | 接收前端绘制点，广播给其他玩家 | SignalR 实时推送绘图事件 |
+| 🧮 **面积计算** | 统计每个玩家的像素占领数 | 可使用二维数组 / 区块聚合 |
+| 📊 **排行榜 & 结算** | 计算排名、获胜者、最终展示数据 | 推送至前端展示 |
+| 👥 **玩家管理** | 玩家连接/断开、角色（房主）、颜色分配 | Socket 身份绑定 |
+| ⏱️ **倒计时服务** | 游戏各阶段倒计时逻辑 | 可用后台任务 / 定时器 / SignalR 消息 |
+
+---
+
+### 4.3 开发任务分解
+
+#### 第1天：项目初始化 + 房间系统
+
+- [ ] 搭建 ASP.NET Core 8 项目，配置 SignalR Hub
+- [ ] 实现 **房间创建 / 加入 API**
+- [ ] 玩家连接管理（SignalR 连接 ID 绑定）
+- [ ] 房间状态管理（Redis 存储）
+
+#### 第2天：绘图同步 + 游戏流程
+
+- [ ] 实现 SignalR Hub 接收前端绘制点并广播
+- [ ] 实现 **准备阶段倒计时逻辑**
+- [ ] 游戏阶段控制（开始绘图、限制覆盖）
+- [ ] 区域保护 & 冷却机制后端逻辑
+
+#### 第3天：统计 + 结算
+
+- [ ] 实现像素统计（谁占领了哪些区域）
+- [ ] 计算每个玩家面积，排序
+- [ ] 推送排名 & 获胜者信息
+- [ ] 结算阶段倒计时与结果展示数据
+
+#### 第4天：优化 + 联调
+
+- [ ] 优化绘图同步性能
+- [ ] 增强异常处理 / 断线重连
+- [ ] Redis & PostgreSQL 数据持久化
+- [ ] 联合前端联调测试
+- [ ] 部署测试环境
+
+---
+
+### 4.4 推荐开发流程
+
+1. **搭建 SignalR Hub + 房间管理**
+2. **实现玩家连接与房间状态**
+3. **绘图点接收与广播**
+4. **游戏阶段控制（倒计时、状态机）**
+5. **面积统计与胜负判定**
+6. **结果推送 & 前端展示对接**
+7. **优化与测试**
+
+---
+
+## 🤝 五、前后端交互与通信
+
+| 功能 | 前端 → 后端 | 后端 → 前端 |
+|------|-------------|-------------|
+| 加入/创建房间 | Socket / HTTP | 房间信息、玩家列表 |
+| 绘图操作 | 发送绘制点坐标 + 颜色 | 广播给其他玩家 |
+| 游戏状态 | 监听阶段变化 | 推送准备/游戏/结算状态 |
+| 倒计时 | 接收倒计时更新 | 推送当前剩余时间 |
+| 结算信息 | - | 推送排名、获胜者、画布快照 |
+| 玩家列表 | 请求或接收 | 实时更新在线玩家 |
+
+🔗 **推荐通信方式：**
+- **实时绘图 / 状态同步** → **SignalR (WebSocket)**
+- **房间管理 / 创建 / 加入** → **HTTP API 或 Socket**
+
+---
+
+## 📅 六、开发计划建议（4天冲刺）
+
+| 天数 | 目标 |
+|------|------|
+| **第1天** | 前后端基础框架搭建<br>房间创建/加入<br>Canvas 基础绘图 |
+| **第2天** | 实时绘制同步<br>倒计时与游戏阶段<br>区域保护 / 冷却 |
+| **第3天** | 面积统计 / 排行榜<br>结算流程<br>最终展示 UI |
+| **第4天** | 优化体验、联调测试、Bug 修复、部署准备 |
+
+---
+
+## 📌 七、附录与扩展
+
+### ✅ 必做功能（核心）：
+- [x] 多人实时绘制（同步）
+- [x] 房间系统
+- [x] 倒计时与阶段控制
+- [x] 面积统计与获胜判定
+- [x] 游戏结果展示
+
+### 🔧 可选扩展（时间允许）：
+- [ ] 观战模式
+- [ ] 房间密码 / 自定义设置
+- [ ] 音效与动画反馈
+- [ ] 聊天系统
+- [ ] 成绩排行榜（历史记录）
+
+---
+
+## ✅ 总结
+
+通过本开发指南，可以：
+
+- 清晰了解 **前后端技术选型与职责划分**
+- 按模块 **分阶段高效开发**
+- 通过 **实时通信 + Canvas 交互** 打造流畅的多人竞技体验
+- 在 **4天内完成核心玩法并具备可玩性 & 展示性**
+
+---
+
diff --git "a/\346\232\221\346\234\237\351\233\206\350\256\255/07\351\241\271\347\233\256\346\226\207\346\241\243/\346\212\200\346\234\257\350\256\276\350\256\241\346\226\207\346\241\243.md" "b/\346\232\221\346\234\237\351\233\206\350\256\255/07\351\241\271\347\233\256\346\226\207\346\241\243/\346\212\200\346\234\257\350\256\276\350\256\241\346\226\207\346\241\243.md"
new file mode 100644
index 0000000000000000000000000000000000000000..a7f5fc49c18c91e2a67b9139b80158040c02201d
--- /dev/null
+++ "b/\346\232\221\346\234\237\351\233\206\350\256\255/07\351\241\271\347\233\256\346\226\207\346\241\243/\346\212\200\346\234\257\350\256\276\350\256\241\346\226\207\346\241\243.md"
@@ -0,0 +1,221 @@
+# 📘 多人实时涂色抢地盘游戏 — 技术设计文档
+
+---
+
+## 🎮 一、项目概述
+
+### 项目名称：
+**多人实时涂色抢地盘游戏**
+
+### 项目类型：
+基于 Web 的多人实时竞技休闲类 Canvas 游戏
+
+### 目标用户：
+喜欢轻度竞技、实时互动、简单策略的休闲游戏玩家
+
+### 核心玩法：
+2~6 名玩家在同一画布上使用各自分配的专属颜色进行涂色，**不能覆盖其他玩家已涂区域**，最终根据**占领画布面积最大**来决定胜负。
+
+---
+
+## 🏗️ 二、技术架构总览
+
+本项目采用 **前后端分离 + 实时通信** 的架构模式，整体技术栈如下：
+
+---
+
+### 📱 前端技术栈
+
+| 技术 | 用途 | 说明 |
+|------|------|------|
+| **Vue 3** | 前端框架 | 使用 Composition API + `<script setup>` 语法糖 |
+| **Canvas API** | 绘图引擎 | 原生 HTML5 Canvas，用于实现玩家绘制与画布渲染 |
+| **Element Plus** | UI 组件库 | 提供按钮、倒计时、卡片、表格、弹窗等交互组件 |
+| **Pinia** | 状态管理 | 管理游戏状态、房间信息、玩家数据、倒计时等 |
+| **Socket.io-client** 或 **SignalR JS Client** | 实时通信 | 用于与后端实时同步绘制动作、游戏状态、倒计时等 |
+| **Vite** | 构建工具 | Vue 官方推荐的构建工具，快速热重载与打包 |
+
+---
+
+### ⚙️ 后端技术栈
+
+| 技术 | 用途 | 说明 |
+|------|------|------|
+| **ASP.NET Core 8** | 后端 Web 框架 | 使用 Minimal APIs 或 Controller 风格组织代码 |
+| **SignalR** | 实时通信框架 | 用于实现实时绘制同步、游戏状态广播、倒计时推送等 |
+| **C# / .NET 8** | 编程语言 | 服务端逻辑、游戏规则、数据处理 |
+| **Redis** | 内存数据库 / 缓存 | 存储游戏会话、房间状态、玩家信息、实时数据（如绘制点、倒计时） |
+| **PostgreSQL** | 持久化数据库 | 存储游戏结果、历史记录、排行榜、用户信息等 |
+| **依赖注入 / 中间件** | 框架机制 | 用于组织服务、认证、日志、异常处理等 |
+
+---
+
+### 🏗️ 整体架构模式
+
+| 架构概念 | 说明 |
+|----------|------|
+| **DDD（领域驱动设计，可选）** | 按领域划分：房间领域、玩家领域、游戏流程领域、绘图领域等，便于代码组织与扩展 |
+| **CQRS（命令查询职责分离，可选）** | 可用于读写分离，如绘制命令与查询当前画布状态分离（视复杂度而定） |
+| **实时通信层** | SignalR / Socket.io 负责所有实时数据同步 |
+| **前后端交互** | HTTP RESTful API（房间管理、静态信息查询）、WebSocket（实时同步） |
+
+---
+
+## 🧩 三、模块设计
+
+---
+
+### 3.1 前端模块设计
+
+| 模块 | 功能 | 技术实现 |
+|------|------|----------|
+| **游戏画布模块** | 提供可绘制区域，响应鼠标/触摸事件，调用 Canvas API 绘制 | HTML5 Canvas + Vue 组件 |
+| **绘图控制模块** | 控制是否允许绘制、笔刷颜色、冷却机制、最小绘制单位限制 | 前端逻辑 + SignalR 同步 |
+| **房间系统模块** | 创建 / 加入房间，显示房间号，管理玩家进入 / 离开 | HTTP API + WebSocket |
+| **倒计时模块** | 显示准备 / 游戏 / 结算阶段倒计时，驱动游戏状态切换 | Pinia + SignalR 推送 |
+| **实时同步模块** | 接收其他玩家的绘制动作，实时渲染到本地画布 | SignalR Client / Socket.io |
+| **游戏状态管理模块** | 管理当前游戏处于哪个阶段（准备 / 游戏 / 结算），控制 UI 显示 | Pinia Store |
+| **UI 界面模块** | 使用 Element Plus 提供友好的用户交互界面 | Vue + Element Plus 组件 |
+| **游戏结果展示模块** | 游戏结束后展示获胜者、排行榜、最终画布 | Vue 组件 + 后端推送 / HTTP 查询 |
+
+---
+
+### 3.2 后端模块设计
+
+| 模块 | 功能 | 技术实现 |
+|------|------|----------|
+| **房间管理模块** | 创建房间、加入房间、分配玩家ID与颜色、管理房间状态 | ASP.NET Core + SignalR Hub |
+| **绘图同步模块** | 接收玩家绘制点，广播给房间内其他玩家，确保实时同步 | SignalR Hub 方法（如 `SendDrawAction` / `BroadcastDrawAction`） |
+| **游戏流程控制模块** | 管理准备 → 游戏 → 结算 的状态流转，驱动倒计时逻辑 | C# 定时器 / 后台任务 / SignalR 消息推送 |
+| **面积计算模块** | 游戏结束时统计每个玩家占领的画布区域面积，用于排名 | 像素统计 / 区块聚合算法 |
+| **排行榜与结算模块** | 计算排名，确定获胜者，生成游戏结果数据 | C# 逻辑 + 数据结构排序 |
+| **实时通信模块（SignalR Hub）** | 提供绘制同步、倒计时推送、游戏状态广播、玩家加入/离开通知等功能 | SignalR Hub（`GameHub.cs`） |
+| **数据访问模块** | 与 Redis / PostgreSQL 交互，存储 / 查询房间信息、游戏记录 | Entity Framework Core（PostgreSQL）、StackExchange.Redis |
+| **API 模块（HTTP RESTful）** | 提供房间创建、加入、查询、结果获取等非实时接口 | ASP.NET Core Minimal APIs 或 Controllers |
+
+---
+
+## 🧠 四、核心机制设计
+
+---
+
+### 4.1 实时绘图同步机制
+
+- **前端**：监听鼠标/触摸事件，在 Canvas 上绘制，并通过 SignalR 发送绘制点信息（坐标、颜色、玩家ID）
+- **后端（SignalR Hub）**：接收绘制点，广播给同一房间内的其他所有客户端
+- **前端**：收到其他玩家的绘制点后，在本地 Canvas 上渲染对应颜色点
+- **限制**：玩家只能绘制自己的颜色，不能覆盖他人已涂区域（通过逻辑判断或像素标记实现）
+
+---
+
+### 4.2 游戏流程控制机制
+
+| 阶段 | 控制方式 | 说明 |
+|------|----------|------|
+| **准备阶段** | 倒计时 30 秒 | 玩家进入房间，不可绘制，等待其他玩家加入 |
+| **游戏阶段** | 倒计时 3~5 分钟 | 开始绘制，实时同步，统计面积 |
+| **结算阶段** | 倒计时 30 秒 | 统计各玩家面积 → 排名 → 展示结果 |
+
+- 后端通过 **状态机 / 枚举** 管理当前游戏阶段
+- 通过 **SignalR 消息推送** 通知所有客户端阶段变更、倒计时更新
+
+---
+
+### 4.3 防作弊 & 策略限制机制
+
+| 机制 | 说明 | 实现思路 |
+|------|------|----------|
+| **不能覆盖他人颜色** | 每个像素/区域只能被第一个玩家绘制 | 前端/后端做颜色标记或区域锁定 |
+| **最小绘制单位** | 限制笔刷最小尺寸，避免逐像素争夺 | 前端限制绘制粒度 |
+| **绘制冷却时间** | 每次绘制有短暂间隔（如 0.1s） | 前端限制频繁操作 |
+| **边界保护** | 画布边缘留出一定区域，不计入有效得分或降低权重 | 可配置边界逻辑 |
+
+---
+
+### 4.4 面积计算算法（结算阶段）
+
+- 方法一：**像素级统计**
+  - 遍历画布每个像素，统计属于每个玩家的颜色区域
+  - 适用于小画布，精度高
+- 方法二：**区块聚合**
+  - 将画布分为多个小格子/区块，统计每个区块的主要颜色，累加面积
+  - 适用于大画布，性能更好
+
+> 🎯 推荐使用 **区块聚合算法**，平衡性能与准确性，后端统计后返回各玩家面积用于排名
+
+---
+
+## 🗃️ 五、数据模型设计（后端 - 概念级）
+
+### 5.1 核心实体
+
+| 实体 | 属性 | 说明 |
+|------|------|------|
+| **Room（房间）** | Id, RoomCode, Password(可选), 状态, 创建时间, 当前阶段 | 游戏房间的基本信息 |
+| **Player（玩家）** | Id, PlayerName, 房间Id, 颜色, 是否房主, 连接Id | 每个玩家的个人信息与状态 |
+| **GameSession（游戏会话）** | Id, 房间Id, 开始时间, 结束时间, 游戏状态 | 记录一场完整游戏过程 |
+| **DrawAction（绘制动作）** | Id, 玩家Id, X, Y, 颜色, 时间戳 | 可选：记录绘制历史，用于回放或统计 |
+| **GameResult（游戏结果）** | 房间Id, 玩家排名列表, 获胜者, 各玩家面积, 游戏结束时间 | 游戏结束后统计信息 |
+
+---
+
+## 🛡️ 六、安全与性能考虑
+
+| 类别 | 设计要点 |
+|------|----------|
+| **实时通信安全** | SignalR 支持身份绑定（连接ID ↔ 玩家ID），防止伪造消息 |
+| **数据一致性** | Redis 保证实时数据高性能读写，PostgreSQL 保证结果持久化 |
+| **断线重连** | 前端支持 SignalR 断线自动重连，重新同步状态 |
+| **性能优化** | 限制绘制频率、使用区块统计、异步计算面积、缓存热点数据 |
+| **扩展性** | 模块化设计，便于后续增加观战、聊天、房间设置等功能 |
+
+---
+
+## 🧪 七、开发与测试建议
+
+### 7.1 开发阶段
+
+- 按模块拆分任务，优先实现 **房间管理 + Canvas 绘图 + 实时同步**
+- 使用 Mock 数据先行开发 UI 与流程
+- 逐步接入 SignalR，验证多人绘制同步效果
+
+### 7.2 测试阶段
+
+- 单元测试：游戏逻辑、面积算法、状态机
+- 集成测试：前后端通信、实时同步、房间流程
+- 压力测试：多用户同时绘制、SignalR 并发性能
+- 用户测试：验证游戏规则清晰度与交互友好性
+
+---
+
+## 📦 八、部署与运维
+
+| 环境 | 技术建议 |
+|------|----------|
+| **开发环境** | 本地运行 ASP.NET Core + Vue，使用 SignalR 自连接测试 |
+| **测试环境** | Docker 容器化部署，独立 Redis + PostgreSQL 实例 |
+| **生产环境** | 云服务器（如 Azure / AWS / 阿里云）<br>负载均衡 + 多实例 SignalR<br>Redis 集群 + 数据库读写分离（可选） |
+
+---
+
+## ✅ 九、总结
+
+| 设计目标 | 是否达成 |
+|----------|----------|
+| [x] 支持多人实时绘制同步 | ✅ 通过 SignalR 实现 |
+| [x] 游戏流程清晰（准备 → 游戏 → 结算） | ✅ 状态驱动 + 倒计时控制 |
+| [x] 公平的绘图规则（不能覆盖他人颜色） | ✅ 逻辑/像素级限制 |
+| [x] 实时通信稳定可靠 | ✅ SignalR + WebSocket |
+| [x] 前后端分离，职责清晰 | ✅ Vue 前端 + ASP.NET Core 后端 |
+| [x] 可扩展架构，支持后续功能迭代 | ✅ 模块化 + DDD 可选 |
+
+---
+
+🚀 **通过本技术设计文档，开发团队可以清晰地了解：**
+
+- 系统的整体架构与技术选型
+- 前后端各模块职责与交互方式
+- 实时通信、游戏流程、绘图同步等核心机制设计
+- 数据模型、安全策略、部署运维等关键要素
+
+---
\ No newline at end of file
diff --git "a/\346\232\221\346\234\237\351\233\206\350\256\255/07\351\241\271\347\233\256\346\226\207\346\241\243/\347\224\250\346\210\267\346\211\213\345\206\214.md" "b/\346\232\221\346\234\237\351\233\206\350\256\255/07\351\241\271\347\233\256\346\226\207\346\241\243/\347\224\250\346\210\267\346\211\213\345\206\214.md"
new file mode 100644
index 0000000000000000000000000000000000000000..c05ee693035719dfce8e4df3081125e898f053ff
--- /dev/null
+++ "b/\346\232\221\346\234\237\351\233\206\350\256\255/07\351\241\271\347\233\256\346\226\207\346\241\243/\347\224\250\346\210\267\346\211\213\345\206\214.md"
@@ -0,0 +1,185 @@
+# 📘 多人实时涂色抢地盘游戏 — 用户手册
+
+---
+
+## 🎮 一、文档概述
+
+### 🎯 目标读者：
+本手册面向 **普通玩家用户**，旨在帮助用户快速了解如何进入游戏、创建或加入房间、进行实时绘制、查看游戏状态与最终结果，获得流畅、友好的游戏体验。
+
+---
+
+## 🧩 二、游戏简介
+
+### 🎯 游戏名称：
+多人实时涂色抢地盘游戏
+
+### 🎮 游戏类型：
+多人在线实时竞技休闲类 Canvas 绘图游戏
+
+### 🧠 游戏核心玩法：
+2~6 名玩家在同一画布上使用各自分配的**专属颜色进行涂色**，**不能覆盖其他玩家已涂区域**，最终根据**占领画布面积最大**的玩家来决定胜负。
+
+---
+
+## 🏁 三、游戏目标
+
+在有限的时间内（3~5 分钟），与其他玩家一起在共享画布上绘制涂色，尽可能多地占领画布区域。游戏结束后，系统将根据每位玩家所占领的画布面积进行排名，**占领面积最大的玩家获胜！**
+
+---
+
+## 📱 四、如何开始游戏
+
+### 4.1 进入游戏
+
+1. 打开游戏网页（由开发团队提供访问链接，如：https://yourgame.com）
+2. 你将看到如下主要界面：**房间创建 / 房间加入界面**（或游戏大厅）
+
+---
+
+### 4.2 创建房间（房主）
+
+**适合：你想自己创建一个房间，邀请朋友加入**
+
+#### 操作步骤：
+1. 点击 **“创建房间”** 按钮
+2. 输入你的 **玩家昵称**（如：Alice）
+3. （可选）设置 **房间密码**（如果希望限制他人随意加入）
+4. 点击 **“创建”**
+5. 系统将为你分配一个 **房间号（如：ABC123）**，请妥善保存并分享给你的朋友
+6. 进入房间后，等待其他玩家加入
+
+---
+
+### 4.3 加入房间（玩家）
+
+**适合：你的朋友邀请你加入某个房间一起游戏**
+
+#### 操作步骤：
+1. 在首页点击 **“加入房间”** 按钮
+2. 输入 **房间号**（如：ABC123，由房主提供）
+3. 输入你的 **玩家昵称**（如：Bob）
+4. （如有设置）输入 **房间密码**
+5. 点击 **“加入”**
+6. 成功后进入游戏房间，等待游戏开始
+
+---
+
+## 🎮 五、游戏流程说明
+
+### 5.1 准备阶段（30秒）
+
+- 进入房间后，你将进入 **准备阶段**
+- 系统为每位玩家自动分配一个**专属颜色**
+- 你**暂时无法进行绘制**
+- 屏幕上会显示 **倒计时（30秒）**，提示当前处于准备阶段
+- 你可以查看其他已加入的玩家昵称与状态
+
+> ✅ 提示：这是为了让所有玩家都进入房间，并同步初始信息
+
+---
+
+### 5.2 游戏阶段（3~5分钟）
+
+- 倒计时结束后，自动进入 **游戏阶段**
+- 你现在可以开始在画布上**使用你的专属颜色进行涂色**
+- **绘图规则：**
+  - 你只能涂自己的颜色，**不能覆盖其他玩家已经涂过的区域**
+  - 画布有 **最小笔刷限制** 和 **绘制冷却时间**，防止恶意刷屏
+  - 画布边缘有 **边界保护**，防止先手优势过大
+- 实时显示：
+  - 当前游戏倒计时
+  - 各玩家的实时占领面积
+  - 实时排行榜（谁暂时领先）
+- 所有玩家的绘制内容将**实时同步显示**在每个人画布上
+
+> ✅ 目标：尽可能多地占领画布区域，争取成为面积最大的玩家！
+
+---
+
+### 5.3 结算阶段（30秒）
+
+- 游戏时间结束后，进入 **结算阶段**
+- 系统将统计每位玩家最终占领的画布 **面积**
+- 自动进行排名，确定 **获胜者（占领面积最大者）**
+- 你将看到如下信息：
+  - 🥇 获胜者是谁，以及他的得分/面积
+  - 📊 所有玩家的排名与得分
+  - 🖼️ 最终画布效果（所有玩家绘制内容的汇总）
+  - 🏆 可能还有胜利动画 / 提示
+
+> ✅ 你可以截图保存最终画面，或分享游戏结果
+
+---
+
+## 🛠️ 六、游戏界面说明
+
+以下为游戏主界面常见功能区域说明（具体以实际 UI 设计为准）：
+
+| 区域 | 功能说明 |
+|------|----------|
+| **顶部倒计时栏** | 显示当前阶段（准备/游戏/结算）与剩余时间 |
+| **玩家列表** | 显示当前房间内所有玩家的昵称与颜色 |
+| **游戏画布区域** | 你可以在该区域进行涂色绘制（游戏阶段才可操作） |
+| **我的颜色** | 系统自动分配，显示你当前使用的颜色 |
+| **实时排行榜** | 实时显示各玩家当前占领面积与排名 |
+| **游戏结果弹窗 / 区域** | 游戏结束后展示获胜者、排名、画布等信息 |
+
+---
+
+## 🎯 七、游戏规则总结
+
+| 规则项 | 说明 |
+|--------|------|
+| 玩家人数 | 2 ~ 6 人 |
+| 胜利条件 | 游戏结束时，占领画布面积最大的玩家获胜 |
+| 涂色规则 | 每位玩家只能使用自己的专属颜色，不能覆盖他人已涂区域 |
+| 绘图限制 | 有最小笔刷大小、绘制冷却时间，防止刷屏和过度竞争 |
+| 特殊机制 | 边界保护、区域不可覆盖、公平竞争 |
+
+---
+
+## ❓ 八、常见问题 FAQ
+
+### Q1: 我可以覆盖其他玩家的颜色吗？
+> ❌ 不可以！系统规则禁止覆盖其他玩家已涂区域，只能涂自己的颜色。
+
+### Q2: 游戏开始后我能退出吗？
+> ⚠️ 可以退出，但可能会影响房间内其他玩家的体验，建议游戏结束后再离开。
+
+### Q3: 如果网络断开怎么办？
+> 🔄 系统支持自动重连（如前端实现该功能），你将尝试重新连接并同步当前游戏状态。
+
+### Q4: 能否重新开始一局？
+> ✅ 可以！游戏结束后通常提供“再来一局”或“重新创建房间”按钮。
+
+### Q5: 房间密码是必须的吗？
+> ❌ 不是必须的，只有房主设置了密码时才需要输入。
+
+---
+
+## 📞 九、技术支持与反馈
+
+### 如你遇到以下问题：
+- 游戏无法正常加载 / 卡顿
+- 绘制不同步 / 无法加入房间
+- 提示错误或异常退出
+
+### 你可以：
+- 刷新页面重试
+- 检查网络连接
+- 联系游戏客服或开发团队反馈问题（提供房间号、玩家昵称、问题现象）
+
+---
+
+## ✅ 十、总结
+
+| 项目 | 说明 |
+|------|------|
+| 🎮 游戏目标 | 占领画布面积最大者获胜 |
+| 👥 支持人数 | 2 ~ 6 名玩家同时在线 |
+| 🖌️ 核心玩法 | 实时绘制 + 区域保护 + 排名竞技 |
+| 🎯 操作简单 | 进入房间 → 等待开始 → 自由涂色 → 查看结果 |
+| 🤝 社交互动 | 与朋友一起竞技，支持实时同步与排名 |
+
+---
\ No newline at end of file
diff --git "a/\346\232\221\346\234\237\351\233\206\350\256\255/07\351\241\271\347\233\256\346\226\207\346\241\243/\347\273\264\346\212\244\346\214\207\345\215\227.md" "b/\346\232\221\346\234\237\351\233\206\350\256\255/07\351\241\271\347\233\256\346\226\207\346\241\243/\347\273\264\346\212\244\346\214\207\345\215\227.md"
new file mode 100644
index 0000000000000000000000000000000000000000..207176ca2e1126e79c21afdfdfa3cd8ddc4ce931
--- /dev/null
+++ "b/\346\232\221\346\234\237\351\233\206\350\256\255/07\351\241\271\347\233\256\346\226\207\346\241\243/\347\273\264\346\212\244\346\214\207\345\215\227.md"
@@ -0,0 +1,223 @@
+# 📘 多人实时涂色抢地盘游戏 — 维护指南
+
+---
+
+## 🎮 一、文档概述
+
+本文档旨在为开发团队、运维团队以及技术支持人员提供关于**多人实时涂色抢地盘游戏**项目在生产环境中的维护指导，包括：
+
+- 系统架构简要回顾
+- 日常运维操作
+- 监控与日志管理
+- 故障排查与常见问题
+- 性能优化建议
+- 版本升级与迭代流程
+- 备份与灾备策略（可选）
+- 安全维护建议
+
+---
+
+## 🏗️ 二、系统架构回顾（简要）
+
+本项目采用 **前后端分离 + 实时通信** 的架构，主要技术栈如下：
+
+### 📱 前端技术栈
+- **框架**: Vue 3 + Composition API
+- **UI组件库**: Element Plus
+- **状态管理**: Pinia
+- **绘图引擎**: HTML5 Canvas API
+- **实时通信**: SignalR JavaScript Client 或 Socket.io-client
+- **构建工具**: Vite
+
+### ⚙️ 后端技术栈
+- **框架**: ASP.NET Core 8 (Minimal APIs)
+- **实时通信**: SignalR
+- **数据存储**:
+  - **Redis**: 缓存 / 实时数据（如房间状态、绘制动作、倒计时）
+  - **PostgreSQL**: 持久化存储（游戏记录、房间信息、排行榜、用户数据）
+- **架构模式**: 简洁 DDD（领域驱动设计，可选）+ CQRS（可选）
+
+---
+
+## 🛠️ 三、日常运维操作
+
+### 3.1 服务部署与启动
+
+#### 后端服务（ASP.NET Core 8）
+- **运行方式**:
+  ```bash
+  dotnet YourGameBackend.dll
+  ```
+  或通过 Docker 容器启动：
+  ```bash
+  docker-compose up -d
+  ```
+- **生产部署建议**:
+  - 使用 **反向代理**（如 Nginx、Caddy）做 HTTPS 终结与负载均衡
+  - 配置 **进程守护**（如 systemd、supervisor、Kubernetes）
+  - 多实例部署 SignalR 服务时，确保使用 **Redis Backplane** 实现横向扩展时的消息广播
+
+#### 前端服务
+- **构建命令**:
+  ```bash
+  npm run build
+  ```
+- **部署方式**:
+  - 打包后部署至 **Nginx / Apache / 静态托管服务（如 Vercel、Netlify、阿里云 OSS + CDN）**
+  - 或与后端部署在同一域名下（避免跨域问题）
+
+---
+
+### 3.2 服务监控
+
+#### 后端监控建议
+- **日志记录**:
+  - 使用 `ILogger` 记录关键操作（如玩家加入/离开、房间创建、游戏状态变更、异常信息）
+  - 日志输出到文件 / 控制台 / ELK（Elasticsearch + Logstash + Kibana）/ Seq 等集中式日志系统
+- **应用性能监控 (APM)**:
+  - 可接入 **Application Insights**（Azure）、**New Relic**、**Prometheus + Grafana**、**Sentry** 等
+  - 监控：请求延迟、异常率、内存/CPU 使用率、SignalR 连接数等
+- **健康检查接口（可选）**:
+  - 提供 `/health` 或 `/status` 接口，用于容器编排平台（如 Kubernetes）做存活检查
+
+#### 前端监控（可选）
+- 接入前端错误监控：**Sentry**、**TrackJS** 等，收集 JS 异常、页面加载失败、API 请求错误
+- 可使用 **Google Analytics** / **Matomo** 统计访问量、用户行为（可选）
+
+---
+
+### 3.3 日志管理
+
+| 日志类型 | 建议存储位置 | 说明 |
+|----------|--------------|------|
+| 后端应用日志 | 文件 / ELK / Seq / Console | 记录游戏逻辑、SignalR 事件、异常信息 |
+| SignalR 连接日志 | 日志文件 / 应用日志 | 记录玩家连接、断开、房间分配情况 |
+| 访问日志（Nginx / 反向代理） | Nginx 日志目录 | 用于分析流量、请求来源、错误码分布 |
+| 数据库日志（可选） | PostgreSQL 日志 / Redis 日志 | 仅在排查数据问题时开启详细日志 |
+
+> ✅ 建议对日志进行**分级（Info / Warning / Error）**，并定期归档与清理，避免磁盘爆满
+
+---
+
+## 🧪 四、故障排查与常见问题
+
+### 4.1 常见问题及解决办法
+
+| 问题现象 | 可能原因 | 解决方案 |
+|---------|----------|----------|
+| **玩家无法连接 / 进入房间** | 后端服务未启动 / 房间服务异常 / 跨域问题 | 检查后端运行状态、CORS 配置、网络策略 |
+| **绘制内容不同步** | SignalR 连接断开 / 消息未广播 / 客户端未监听事件 | 检查 SignalR Hub 逻辑、客户端事件绑定、网络延迟 |
+| **游戏状态不更新** | 倒计时服务未启动 / 状态未正确推送 | 检查后端游戏流程控制模块、SignalR 状态推送 |
+| **Canvas 卡顿 / 绘制延迟** | 前端绘制逻辑性能差 / 浏览器兼容性问题 | 优化绘制代码、限制绘制频率、测试多浏览器 |
+| **Redis / PostgreSQL 连接失败** | 数据库服务未启动 / 连接字符串配置错误 | 检查数据库运行状态、连接池、防火墙设置 |
+| **SignalR 连接数过多 / 性能下降** | 单机 SignalR 承载过高 / 未使用 Redis Backplane | 部署多实例 + Redis 消息总线、横向扩展 |
+
+---
+
+### 4.2 日志排查步骤
+
+1. **查看后端日志**
+   - 搜索关键字：`ERROR`、`Exception`、`PlayerJoin`、`DrawAction`、`GameStateChanged`
+   - 定位问题模块：房间管理、绘图同步、游戏流程控制
+2. **查看 SignalR 日志**
+   - 确认玩家连接 ID、房间分配、消息广播是否正常
+3. **查看前端控制台**
+   - 打开浏览器开发者工具（F12 → Console），查看是否有 JS 报错、API 请求失败、SignalR 连接异常
+4. **检查网络**
+   - 使用浏览器 Network 面板，确认 API 请求 / WebSocket 连接是否成功建立
+
+---
+
+## ⚙️ 五、性能优化建议
+
+### 5.1 后端优化
+
+| 优化点 | 建议 |
+|--------|------|
+| **SignalR 横向扩展** | 使用 Redis 作为 SignalR Backplane，支持多实例部署时的消息同步 |
+| **Redis 缓存优化** | 合理设置过期时间，避免内存泄漏，使用 Pipeline / 批处理提升效率 |
+| **数据库索引优化** | 为玩家、房间、游戏记录表建立合适索引，加速查询 |
+| **异步处理** | 游戏结果计算、日志写入、通知推送等采用异步任务，避免阻塞主线程 |
+| **限制绘制频率** | 后端可做频率限制，防止恶意高频绘制请求 |
+
+---
+
+### 5.2 前端优化
+
+| 优化点 | 建议 |
+|--------|------|
+| **Canvas 渲染优化** | 避免频繁重绘，使用离屏 Canvas 或批量绘制点 |
+| **事件防抖 / 节流** | 控制玩家绘制事件触发频率，提升性能与体验 |
+| **按需加载组件** | Vue 3 异步组件 / 路由懒加载，提升页面加载速度 |
+| **减少 HTTP 请求数** | 合并静态资源、使用雪碧图、启用 Gzip / Brotli 压缩 |
+
+---
+
+## 🔄 六、版本升级与迭代流程
+
+### 6.1 版本管理
+- 使用 **Git** 进行代码版本控制，推荐分支模型：`main` / `develop` / `feature/*` / `hotfix/*`
+- 发布版本号遵循 https://semver.org/：`MAJOR.MINOR.PATCH`
+
+### 6.2 升级流程
+1. **测试环境验证**
+   - 在测试环境部署新版本，验证功能、性能、兼容性
+   - 进行多玩家联调测试、压力测试
+2. **灰度发布（可选）**
+   - 生产环境先对部分用户/房间启用新版本
+3. **正式发布**
+   - 停止旧服务（或蓝绿部署）
+   - 部署新版本前端 & 后端服务
+   - 更新数据库 Schema（如有变更，需做迁移脚本）
+4. **回滚策略**
+   - 如新版本出现问题，快速回退到上一稳定版本
+   - 数据库回滚需提前备份
+
+### 6.3 数据迁移（如有）
+- 使用 **EF Core Migrations**（后端）管理数据库结构变更
+- 前端如涉及本地存储变更，做好兼容处理
+
+---
+
+## 🛡️ 七、安全维护建议
+
+| 安全项 | 建议 |
+|--------|------|
+| **通信安全** | 生产环境必须启用 HTTPS，SignalR 使用 `wss://`（WebSocket Secure）|
+| **身份验证（可选）** | 当前为开放式房间，后续可增加用户登录 / JWT 验证 |
+| **防止恶意操作** | 服务端校验绘制点合法性，防止覆盖、刷屏、高频攻击 |
+| **数据安全** | 敏感配置（如数据库连接字符串、Redis 密码）必须使用环境变量或密钥管理服务 |
+| **依赖安全** | 定期更新前端 / 后端依赖包，使用工具（如 npm audit、NuGet、Snyk）检测漏洞 |
+
+---
+
+## 💾 八、备份与灾备策略（可选）
+
+| 数据 | 备份建议 |
+|------|----------|
+| **PostgreSQL 数据（游戏记录、用户信息）** | 定期自动备份（每日/每周），异地存储，测试恢复流程 |
+| **Redis 数据（实时状态）** | Redis 一般为临时数据，可不做长期备份，但重要状态建议持久化（AOF/RDB）|
+| **前端静态资源** | 托管于 CDN 或对象存储，版本控制，便于快速回滚 |
+| **数据库与 Redis 高可用** | 生产环境建议 Redis 集群 / 主从，PostgreSQL 主从复制 / 读写分离 |
+
+---
+
+## ✅ 九、总结
+
+| 维护目标 | 措施 |
+|----------|------|
+| [x] 系统稳定运行 | 监控 + 日志 + 告警 + 自动化部署 |
+| [x] 快速故障定位 | 结构化日志 + 分模块监控 + 前后端排查流程 |
+| [x] 高效版本迭代 | Git 分支管理 + 测试验证 + 灰度发布 |
+| [x] 良好用户体验 | 性能优化 + 错误边界处理 + 安全防护 |
+| [x] 可扩展架构 | 模块化设计 + SignalR 横向扩展 + 微服务友好 |
+
+---
+
+🚀 **通过本维护指南，团队可以：**
+
+- 保障多人实时涂色游戏在生产环境中的稳定运行
+- 快速响应问题、定位故障、实施更新与优化
+- 为后续功能迭代、用户增长、技术演进打下坚实基础
+
+---
\ No newline at end of file
diff --git "a/\346\232\221\346\234\237\351\233\206\350\256\255/07\351\241\271\347\233\256\346\226\207\346\241\243/\347\274\226\347\240\201\350\247\204\350\214\203.md" "b/\346\232\221\346\234\237\351\233\206\350\256\255/07\351\241\271\347\233\256\346\226\207\346\241\243/\347\274\226\347\240\201\350\247\204\350\214\203.md"
new file mode 100644
index 0000000000000000000000000000000000000000..12990374ca340cfe5f288cf5aec61baa6926031f
--- /dev/null
+++ "b/\346\232\221\346\234\237\351\233\206\350\256\255/07\351\241\271\347\233\256\346\226\207\346\241\243/\347\274\226\347\240\201\350\247\204\350\214\203.md"
@@ -0,0 +1,37 @@
+# 编码规范
+
+## 命名规范
+- 变量、函数、类命名统一采用有意义的英文单词，避免拼音
+- 前端：驼峰命名（isReady, handleJoin）
+- 后端：C# PascalCase 类名，camelCase 变量名
+- 常量全大写，单词下划线分隔（MAX_COUNT）
+
+## 注释规范
+- 重要业务逻辑、复杂算法必须有注释
+- 注释内容简明扼要，避免无意义注释
+- 代码块、函数需有功能说明
+
+## 代码格式
+- 统一使用 2 或 4 空格缩进，不混用 Tab
+- 每行不超过 120 字符，避免过长
+- 结尾统一保留换行
+
+## 前端规范
+- 强制使用 ESLint + Prettier 自动格式化
+- 组件、文件命名统一 PascalCase
+- Vue 文件结构：template、script、style 顺序
+- 禁止直接操作 DOM，优先用 Vue 机制
+
+## 后端规范
+- 遵循 C# 官方编码规范
+- 控制器、服务、仓储等命名清晰（如 CommandController,RedisService）
+- 接口以 I 开头（如 IRoomService）
+- 业务逻辑分层清晰，禁止冗余代码
+
+## 代码审查
+- 所有合并需通过代码审查
+- 检查命名、注释、格式、逻辑安全
+
+## 其它
+- 禁止提交敏感信息（如密码、密钥）
+- 及时清理无用代码和注释
diff --git "a/\346\232\221\346\234\237\351\233\206\350\256\255/07\351\241\271\347\233\256\346\226\207\346\241\243/\351\234\200\346\261\202\346\226\207\346\241\243.md" "b/\346\232\221\346\234\237\351\233\206\350\256\255/07\351\241\271\347\233\256\346\226\207\346\241\243/\351\234\200\346\261\202\346\226\207\346\241\243.md"
new file mode 100644
index 0000000000000000000000000000000000000000..dce44c7f5a7e3c51321011f81f4ab4fbf29b8c71
--- /dev/null
+++ "b/\346\232\221\346\234\237\351\233\206\350\256\255/07\351\241\271\347\233\256\346\226\207\346\241\243/\351\234\200\346\261\202\346\226\207\346\241\243.md"
@@ -0,0 +1,215 @@
+# 📘 多人实时涂色抢地盘游戏 — 需求文档
+
+---
+
+## 🎮 一、项目概述
+
+### 项目名称：
+**多人实时涂色抢地盘游戏**
+
+### 项目类型：
+基于 Web 的多人实时竞技休闲类 Canvas 游戏
+
+### 目标用户：
+喜欢轻度竞技、实时互动、简单策略和社交娱乐的 Web 游戏玩家
+
+### 游戏平台：
+Web 浏览器（支持 PC / 移动端）
+
+### 核心特色：
+- 多人同屏实时绘制
+- 策略性占领画布面积
+- 实时同步与互动
+- 轻松休闲，易于上手
+
+---
+
+## 🧩 二、游戏背景与愿景
+
+在快节奏的现代生活中，用户渴望轻松、有趣、具备一定社交互动与轻度竞技性的小游戏。  
+**多人实时涂色抢地盘游戏**以“协作+竞争”为核心，让玩家在同一个虚拟画布上，使用各自专属颜色进行涂色，通过策略与速度占领尽可能多的画布区域，最终根据占领面积决定胜负。
+
+该游戏适用于：
+
+- 朋友对战
+- 在线聚会娱乐
+- 团队建设小游戏
+- 教学演示 / Web 技术原型展示
+
+---
+
+## 🎯 三、核心玩法
+
+### 3.1 基础规则
+
+| 项目 | 规则说明 |
+|------|----------|
+| **玩家人数** | 2 ~ 6 人 |
+| **游戏时长** | 总时长约 **3~5 分钟**<br>（准备阶段 30 秒 + 游戏阶段 3~5 分钟 + 结算阶段 30 秒） |
+| **胜利条件** | 游戏结束时，**占领画布面积最大**的玩家获胜 |
+| **涂色规则** | 每位玩家拥有**专属颜色**，只能涂自己的颜色，**不能覆盖其他玩家已涂区域** |
+| **画布机制** | 画布具备**边界保护**（边缘有中性区域）、**最小涂色单位限制**、**绘制冷却机制**，防止恶意刷屏与先手优势过大 |
+
+---
+
+### 3.2 游戏流程
+
+#### 🟡 1. 准备阶段（30 秒）
+
+- 玩家进入指定房间
+- 系统为每位玩家分配一个**专属颜色**
+- 显示倒计时，提示玩家准备
+- 所有玩家**不可进行绘制操作**
+- 实时显示当前在线玩家列表
+
+#### 🟢 2. 游戏阶段（3 ~ 5 分钟）
+
+- 倒计时结束后，进入正式游戏阶段
+- 所有玩家可在画布上**自由绘制涂色**
+- 实时显示每个玩家的**实时占领面积**
+- **不能覆盖其他玩家已涂区域**
+- 实时同步所有玩家的绘制动作（多人协作/竞技）
+- 包含**冷却机制、最小笔刷、边界保护**等策略限制
+
+#### 🔴 3. 结算阶段（30 秒）
+
+- 游戏结束后，系统统计各玩家的**最终占领面积**
+- 按面积大小进行**排名**
+- 展示**获胜者**信息
+- 展示**排行榜（各玩家得分/面积）**
+- 展示**最终画布效果**（可截图 / 回放）
+
+---
+
+### 3.3 特殊机制
+
+| 机制 | 说明 |
+|------|------|
+| **边界保护** | 画布边缘有一部分为中性区域，防止先手玩家通过边缘大量涂色获得不公平优势 |
+| **最小涂色单位** | 设置最小笔刷大小，避免玩家进行过于精细的“像素点争夺”，提升策略性 |
+| **绘制冷却** | 每次绘制有短暂冷却时间（如 0.1 秒），防止恶意高频刷屏 |
+| **区域锁定** | 已被某玩家涂色的区域，其他玩家无法覆盖（颜色隔离，保护原创区域） |
+
+---
+
+## 🛠️ 四、功能需求
+
+### 4.1 核心功能（必须实现）
+
+| 模块 | 功能点 | 说明 |
+|------|--------|------|
+| **绘图系统** | 画笔工具、实时绘制、颜色固定 | 每位玩家只能用自己的颜色绘制，笔刷大小固定 |
+| **Canvas 画布** | 绘制区域、实时渲染、交互响应 | 支持鼠标 / 触摸绘制，实时同步到其他玩家 |
+| **房间系统** | 创建房间、加入房间、房间号匹配 | 支持 2~6 名玩家进入同一房间进行游戏 |
+| **倒计时系统** | 准备阶段（30s）、游戏阶段（3~5m）、结算阶段（30s） | 游戏流程的三大阶段，倒计时驱动状态切换 |
+| **实时同步** | 多人绘制同步、玩家列表同步、状态同步 | 基于 WebSocket / SignalR 实现实时通信 |
+| **面积统计** | 实时计算每个玩家占领的画布面积 | 用于实时排行榜 & 最终胜负判定 |
+| **结算系统** | 排名展示、获胜者公布、最终画布展示 | 游戏结束后展示结果 |
+
+---
+
+### 4.2 扩展功能（可选 / 时间允许）
+
+| 模块 | 功能点 | 说明 |
+|------|--------|------|
+| **观战模式** | 允许其他用户观看正在进行的游戏 | 增强社交与观摩体验 |
+| **房间密码** | 房主可设置房间密码，限制加入 | 提升私密性 |
+| **自定义房间设置** | 房间名称、游戏时长、地图大小等 | 更丰富的房间配置能力 |
+| **音效系统** | 涂色音效、胜利提示音、倒计时提示音 | 提升沉浸感与反馈 |
+| **聊天系统** | 房间内文字交流 | 支持玩家间简单社交 |
+| **排行榜** | 历史游戏得分 / 胜率统计 | 持久化存储玩家成绩 |
+| **成就系统** | 首次获胜、占领最高面积等成就 | 增加游戏粘性 |
+
+---
+
+## 🗃️ 五、非功能需求
+
+| 类别 | 要求 |
+|------|------|
+| **性能** | 支持 2~6 人同时实时绘制，低延迟同步（<300ms），流畅运行于主流浏览器 |
+| **兼容性** | 支持现代浏览器（Chrome、Firefox、Safari、Edge），支持 PC 和移动端浏览器 |
+| **可靠性** | 玩家断线重连机制，异常状态恢复，游戏数据一致性 |
+| **安全性** | 防止恶意绘制、刷屏、覆盖他人区域，房间访问控制（可扩展认证） |
+| **可扩展性** | 模块化设计，便于后续增加房间管理、用户系统、社交功能等 |
+| **用户体验** | 界面简洁直观，操作简单，实时反馈明确（如倒计时、提示信息） |
+
+---
+
+## 🏗️ 六、技术架构需求
+
+### 前端技术栈
+
+- **框架**: Vue 3 + Composition API
+- **UI组件库**: https://element-plus.org/
+- **状态管理**: https://pinia.vuejs.org/
+- **绘图引擎**: 原生 HTML5 Canvas API
+- **实时通信**: Socket.io-client 或 SignalR JavaScript Client
+- **构建工具**: Vite
+
+### 后端技术栈
+
+- **框架**: ASP.NET Core 8（使用 Minimal APIs）
+- **实时通信**: https://docs.microsoft.com/en-us/aspnet/core/signalr/introduction
+- **数据存储**:
+  - **Redis**: 存储游戏会话、房间状态、实时数据
+  - **PostgreSQL**: 持久化存储游戏记录、玩家数据、排行榜
+- **架构模式**: 简洁 DDD（领域驱动设计）+ CQRS（可选）
+
+---
+
+## 📋 七、用户角色
+
+| 角色 | 说明 |
+|------|------|
+| **玩家** | 进入房间进行实时涂色、参与竞技、查看结果 |
+| **房主** | 创建房间，邀请他人加入，可能具备额外权限（如设置密码） |
+| **观众（可选）** | 观看正在进行的游戏（观战模式，扩展功能） |
+
+---
+
+## 📈 八、游戏指标与成功标准（可选）
+
+| 指标 | 目标 |
+|------|------|
+| 🎮 DAU / 用户参与度 | 日活跃玩家数量，平均游戏次数/日 |
+| ⏱️ 平均游戏时长 | 3~5 分钟，符合休闲游戏定位 |
+| 🏆 玩家胜率分布 | 胜负分布合理，无显著偏向性，保证公平性 |
+| 👥 房间创建/加入率 | 高并发房间支持，支持快速匹配或自定义房间 |
+| 📱 用户设备兼容性 | 支持主流移动端与桌面端浏览器 |
+
+---
+
+## 📌 九、项目交付物（建议）
+
+| 交付内容 | 说明 |
+|----------|------|
+| 前端项目 | Vue 3 + Canvas + 实时通信 + UI 界面 |
+| 后端服务 | ASP.NET Core + SignalR + 游戏逻辑 + 房间管理 |
+| 数据存储 | Redis（实时数据）、PostgreSQL（历史数据） |
+| API 文档 | HTTP 接口文档 + SignalR 实时事件说明 |
+| 部署指南 | 本地开发、测试环境、生产部署方案 |
+| 用户手册 | 玩家操作说明 / 游戏规则介绍 |
+
+---
+
+## ✅ 十、总结
+
+**多人实时涂色抢地盘游戏**是一款兼具休闲性、策略性与轻度竞技性的多人在线 Canvas 游戏。通过实时绘制与同步机制，为玩家提供简单易懂但富有互动与竞技乐趣的游戏体验。
+
+---
+
+🎯 **核心目标：**
+- 实现多玩家实时绘制与同步
+- 公平的面积占领判定与胜负机制
+- 流畅的实时交互与用户体验
+- 可扩展的架构，支持后续功能迭代
+
+---
+
+🚀 **适用场景：**
+- 朋友娱乐对战
+- 在线聚会小游戏
+- 教学 / 技术原型展示
+- 轻量级 SNS / 社交平台小游戏集成
+
+---
diff --git "a/\346\232\221\346\234\237\351\233\206\350\256\255/08\351\241\271\347\233\256\346\210\252\345\233\276/\351\241\271\347\233\256\346\210\252\345\233\276.md" "b/\346\232\221\346\234\237\351\233\206\350\256\255/08\351\241\271\347\233\256\346\210\252\345\233\276/\351\241\271\347\233\256\346\210\252\345\233\276.md"
new file mode 100644
index 0000000000000000000000000000000000000000..cfafd9e5e9a821f574c16fda8c40879cd7b3509a
--- /dev/null
+++ "b/\346\232\221\346\234\237\351\233\206\350\256\255/08\351\241\271\347\233\256\346\210\252\345\233\276/\351\241\271\347\233\256\346\210\252\345\233\276.md"
@@ -0,0 +1,14 @@
+# 注册
+![](https://lusiyi-picgo.oss-cn-beijing.aliyuncs.com/images/注册页.png)
+# 登录
+![](https://lusiyi-picgo.oss-cn-beijing.aliyuncs.com/images/登录页.png)
+# 创建房间
+![](https://lusiyi-picgo.oss-cn-beijing.aliyuncs.com/images/创建房间.png)
+# 加入房间
+![](https://lusiyi-picgo.oss-cn-beijing.aliyuncs.com/images/进入房间.png)
+# 玩家踢出房间
+![](https://lusiyi-picgo.oss-cn-beijing.aliyuncs.com/images/踢出房间.gif)
+# 开始游戏
+![](https://lusiyi-picgo.oss-cn-beijing.aliyuncs.com/images/游戏开始.gif)
+# 游戏结束
+![](https://lusiyi-picgo.oss-cn-beijing.aliyuncs.com/images/游戏结束.png)
\ No newline at end of file
diff --git "a/\346\232\221\346\234\237\351\233\206\350\256\255/09\345\216\237\345\236\213\350\256\276\350\256\241/\345\216\237\345\236\213/\351\241\265\351\235\2421.png" "b/\346\232\221\346\234\237\351\233\206\350\256\255/09\345\216\237\345\236\213\350\256\276\350\256\241/\345\216\237\345\236\213/\351\241\265\351\235\2421.png"
new file mode 100644
index 0000000000000000000000000000000000000000..705c1b1e7fca9853601e5a698e02ca6cfd6303c0
Binary files /dev/null and "b/\346\232\221\346\234\237\351\233\206\350\256\255/09\345\216\237\345\236\213\350\256\276\350\256\241/\345\216\237\345\236\213/\351\241\265\351\235\2421.png" differ