datawhale/whale-town-front
3
2
Fork 2
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
28 Commits 4 Branches 0 Tags
e657cfce0eadc3c8014f58b6789bd20d3b9ac6d1
Commit Graph

28 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
moyin
e657cfce0e Merge pull request 'refactor：重构项目架构为分层结构' (#3) from qbb0530/whale-town-front:refactor/项目结构重构 into main 
Reviewed-on: #3
 2025-12-31 16:35:24 +08:00
王浩
b9182bbc2e docs：完善 CLAUDE.md 为 AI 开发规范文档 
## 🎯 主要改进

### 1. 明确项目定位
- 清晰定义 "WhaleTown" 为 2D 俯视像素风 RPG
- 指定 Godot 4.2+ 引擎（禁止 3.x 语法）
- 强调分层架构：`_Core`（框架）、`Scenes`（玩法）、`UI`（界面）

### 2. 完善开发规范
- ✅ 添加 Input Map 配置（WASD、交互键、暂停键）
- ✅ 明确文件路径规则（STRICT LOWERCASE）
- ✅ 添加 EventNames.gd 示例代码
- ✅ 完善测试代码示例（GUT 框架）
- ✅ 优化代码模板（分区注释）

### 3. 强化技术约束
- 📋 严格类型系统（强制静态类型）
- 🏛 事件驱动架构（EventSystem 解耦）
- 🚫 禁止模式列表（yield、Linear Filter 等）
- ✅ 必须测试覆盖（所有 Core 管理器）

### 4. 代码模板改进
- 添加结构化注释（Exports、References、Lifecycle、Methods）
- 展示最佳实践（@onready、%UniqueName、私有方法前缀）
- 包含完整的玩家移动示例

### 5. AI 指令优化
- 直接对 AI 说话（"Claude: Root folders MUST be lowercase"）
- 明确的优先级（STRICT、The Law、MANDATORY）
- 提供决策指南（Area2D vs Body、Enum vs StateChart）

## 📊 文档结构
- 90 行，精炼完整
- Emoji 视觉层级（🛠 命令、📂 文件、📋 标准、🏛 架构）
- 覆盖：文件组织、编码标准、架构设计、测试要求、代码模板

## ✨ 质量提升
- 统一路径大小写（tests/ 而非 Tests/）
- 添加 EventNames.gd 完整示例
- 完善测试代码（watch_signals、assert_signal_emitted）
- 明确 Godot 版本约束（4.2+）

## 🎯 目标
为 AI 提供清晰、严格、可执行的开发规范，
确保代码质量和架构一致性。

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2025-12-31 16:32:54 +08:00
王浩
642a99970c docs：添加项目开发规范文档 CLAUDE.md 
## 📋 新增内容

添加了完整的 Claude Code 开发规范文档，包括：

### 核心规范
- **项目概述**: 2D 俯视像素风 RPG 游戏架构
- **编码标准**:
  - 严格类型系统
  - 统一命名规范（PascalCase, snake_case, SCREAMING_SNAKE_CASE）
  - 节点访问规范（@onready, %UniqueName）
  - 最佳实践（await, Callable, Signal Up/Call Down）

### 架构规则
- **解耦原则**: 低层级实体通过 EventSystem 通信
- **场景管理**: 统一使用 SceneManager.change_scene()
- **组件化**: 可复用逻辑封装到 Scenes/Components/

### 实现规范
- **实体结构**:
  - Player: CharacterBody2D + Camera2D
  - NPC: StaticBody2D/CharacterBody2D + InteractionArea
  - Interactables: 共享 InteractableComponent
- **交互系统**: 通过 EventSystem.notify_interaction_triggered()
- **TileMap 规则**: 分层设计（地面、障碍、装饰）

### 文件组织
- 地图: Scenes/Maps/[map_name].tscn
- 实体: Scenes/Entities/[entity_name]/[entity_name].tscn
- 脚本: 与场景文件同目录
- 资源: res://Assets/Sprites/

### 测试标准
- 使用 GUT 测试框架
- 测试文件位置: res://test/unit/ 或 res://test/integration/
- 文件命名: test_*.gd
- 核心逻辑必须有单元测试
- 玩家移动和 NPC 交互需要集成测试

### 开发理念
- 简约至上：函数单一职责
- "栅栏后规则": 即使不可见的代码也要干净优美
- 反馈循环：每个交互都要有特效/音效占位
- 零硬编码：所有路径和配置使用常量或 @export
- "自动工作"的相机：自动检测 TileMap 边界

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2025-12-31 16:07:54 +08:00
王浩
0b533189ec refactor：重构项目架构为分层结构 
## 🏗️ 主要变更

### 目录结构重构
- 将 core/ 迁移到 _Core/（框架层）
- 将 scenes/ 重构为 Scenes/（玩法层）和 UI/（界面层）
- 将 data/ 迁移到 Config/（配置层）
- 添加 Assets/ 资源层和 Utils/ 工具层
- 将 scripts/ 迁移到 tools/（开发工具）

### 架构分层
- **_Core/**: 框架层 - 全局单例和管理器
- **Scenes/**: 玩法层 - 游戏场景和实体
- **UI/**: 界面层 - HUD、窗口、对话系统
- **Assets/**: 资源层 - 精灵图、音频、字体
- **Config/**: 配置层 - 游戏配置和本地化
- **Utils/**: 工具层 - 通用辅助脚本

### 文件更新
- 更新 project.godot 中的所有路径引用
- 更新自动加载脚本路径
- 更新测试文件的引用路径
- 添加 REFACTORING.md 详细说明
- 添加 MIGRATION_COMPLETE.md 迁移完成标记
- 更新 README.md 反映新架构

### 设计原则
- ✅ 清晰的分层（框架/玩法/界面）
- ✅ 场景内聚（脚本紧邻场景文件）
- ✅ 组件化设计（可复用组件）
- ✅ 职责单一（每个目录职责明确）

## 📋 详细信息
查看 REFACTORING.md 了解完整的重构说明和迁移映射表

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
 2025-12-31 11:36:01 +08:00
moyin
b1f3c0feff Merge pull request 'feature/网络管理和Web部署系统' (#2) from feature/网络管理和Web部署系统 into main 
Reviewed-on: #2
 2025-12-25 23:17:30 +08:00
moyin
021c8623f8 docs：更新主要项目文档 
- 更新README添加Web部署说明
- 精简API文档，移除冗余内容
- 添加新功能使用指南
- 完善项目架构说明
 2025-12-25 23:14:29 +08:00
moyin
a1b867dfd7 chore：清理废弃的网络测试文件 
- 删除旧的NetworkTest.gd测试文件
- 移除对应的UID文件
- 统一使用新的ApiTestScript替代
 2025-12-25 23:14:09 +08:00
moyin
d17c766246 test：增强认证模块测试覆盖 
- 添加认证UI自动化测试
- 实现增强型Toast消息测试
- 完善用户交互测试用例
- 提高测试代码覆盖率
 2025-12-25 23:13:49 +08:00
moyin
92c4eaed07 refactor：重构认证场景和网络集成 
- 重构AuthScene脚本，集成新的NetworkManager
- 优化用户界面布局和交互逻辑
- 改进错误处理和用户反馈机制
- 统一网络请求处理流程
 2025-12-25 23:12:49 +08:00
moyin
abd683c766 config：更新项目配置支持Web导出 
- 启用Web导出功能
- 配置中文字体支持
- 更新项目设置和资源路径
- 优化Web版本性能配置
 2025-12-25 23:10:28 +08:00
moyin
a05bac6f05 docs：添加完整的项目文档体系 
- 添加Web部署完整指南和更新日志
- 创建网络管理器配置文档
- 完善项目设置和测试指南
- 添加API更新日志和清理总结
- 更新脚本使用说明文档
 2025-12-25 23:09:59 +08:00
moyin
77af0bda39 test：完善API测试框架 
- 添加Godot内置API测试脚本
- 实现Python API客户端测试套件
- 添加快速测试和完整测试脚本
- 支持跨平台测试运行(Windows/Linux)
- 更新测试文档和使用指南
 2025-12-25 23:09:12 +08:00
moyin
8980e3d558 feat：添加字符串工具类 
- 实现邮箱格式验证功能
- 添加密码强度检查
- 提供字符串清理和格式化方法
- 支持中文字符处理
 2025-12-25 23:07:47 +08:00
moyin
1294529d13 asset：添加UI资源和中文字体支持 
- 添加微软雅黑字体文件支持中文显示
- 导入Datawhale官方Logo图标
- 创建中文主题配置文件
- 完善游戏图标资源目录
 2025-12-25 23:06:50 +08:00
moyin
0935c5fd76 feat：添加Web版本自动化部署系统 
- 实现跨平台Web导出脚本(Windows/Linux/macOS)
- 添加本地测试服务器启动脚本
- 配置Godot Web导出预设
- 创建Web资源目录结构
- 支持一键导出和本地测试
 2025-12-25 23:06:29 +08:00
moyin
405710bdde feat：实现统一网络请求管理系统 
- 添加NetworkManager核心网络管理器
- 实现ResponseHandler统一响应处理
- 支持GET、POST、PUT、DELETE、PATCH请求类型
- 完善错误处理和超时机制
- 提供统一的信号回调接口
 2025-12-25 23:05:49 +08:00
moyin
7413574672 Merge pull request 'fix/verification-code-button-state' (#1) from fix/verification-code-button-state into main 
Reviewed-on: #1
 2025-12-24 20:58:43 +08:00
moyin
8d071cb2ed chore：清理空目录占位文件 
- 删除不再需要的.gitkeep文件
- 目录结构已通过实际文件维护，无需占位符
 2025-12-24 20:40:26 +08:00
moyin
370cffbdd8 config：更新项目配置和文档 
- 更新Godot项目配置，添加自动加载脚本
- 完善.gitignore文件，排除不必要的文件
- 更新README文档，添加项目介绍和使用说明
- 更新主场景配置，集成认证系统
- 添加开发规范文档和项目结构说明
 2025-12-24 20:39:33 +08:00
moyin
5b67771bbc asset：添加游戏资源目录和测试框架 
- 创建音频、字体、材质、着色器等资源目录
- 添加精灵图片资源管理结构
- 建立集成测试、性能测试、单元测试框架
- 为后续资源导入和测试开发做准备
 2025-12-24 20:39:14 +08:00
moyin
73478c0500 chore：完善项目目录结构和基础框架 
- 添加核心系统框架目录结构
- 创建游戏模块化组织架构
- 添加数据配置和本地化支持
- 建立脚本分类管理体系
- 创建场景预制件管理目录
 2025-12-24 20:38:57 +08:00
moyin
15548ebb52 docs：添加API接口文档 
- 详细记录认证相关API接口规范
- 包含请求参数、响应格式和错误代码说明
- 提供完整的使用示例和测试用例
- 涵盖登录、注册、验证码等核心功能接口
 2025-12-24 20:38:40 +08:00
moyin
47cfc14f68 test：添加认证系统测试套件 
- 添加UI测试场景，支持模拟各种认证场景
- 实现API测试脚本，覆盖登录、注册、验证码等接口
- 添加测试文档，说明测试用例和预期结果
- 支持自动化测试和手动测试验证
 2025-12-24 20:37:33 +08:00
moyin
c6bcca4e7f feat：实现用户认证系统核心功能 
- 实现用户登录和注册的完整流程
- 添加邮箱验证码发送和验证功能
- 实现基于邮箱地址的验证码冷却机制
- 添加表单验证和错误提示系统
- 集成Toast消息提示系统
- 支持网络请求处理和错误处理
- 实现按钮状态管理和加载状态显示
 2025-12-24 20:37:00 +08:00
moyin
f11479f2cc scene：创建用户认证场景和UI资源 
- 添加认证场景 auth_scene.tscn，包含登录和注册界面
- 添加认证相关的UI背景图片和框架素材
- 实现响应式布局，支持登录/注册界面切换
- 包含完整的表单输入控件和验证码输入区域
 2025-12-24 20:36:35 +08:00
moyin
8ed260b413 docs：补充git提交发生多类型改动的处理流程 2025-12-08 16:28:03 +08:00
moyin
4285b25323 docs：创建git提交指导文档与命名规则指导文档，更新readme内容 2025-12-08 16:14:15 +08:00
moyin
5acfa7f42b init：项目初始化，搭建Godot文件结构 2025-12-08 16:03:47 +08:00