# 致博的小屋物语

`致博的小屋物语` 是一个 Web 版 2D 开放世界经营游戏项目。游戏从一个唯美登录页开始，玩家登录或注册后，通过加载条和系统提示进入全屏 2D 世界，后续逐步扩展种植、采集、背包、商店、NPC、事件、存档和在线能力。

## 当前阶段

当前目录已经进入可运行 MVP 初段：前端有唯美登录页、加载条和全屏 Phaser 2D 世界壳；后端有 ASP.NET Core 登录、注册、SQL Server 存档和服务端权威采集接口；世界内已有第一批资源点、掉落、背包 UI 和资源恢复状态展示。

原始架构稿保留在 [致博庄园世界架构.md](./致博庄园世界架构.md)，后续开发以本文档和 `docs/` 下的工程化说明为入口。

## 项目目标

- 做成商业级 Web 游戏工程，而不是一次性 Demo。
- 前端负责表现、输入和 UI，后端负责权威逻辑、存档、经济和事件。
- 物品、掉落、事件、数值尽量数据驱动，方便长期迭代。
- 后期支持提交 GitLab，并具备一键部署发布能力。

## 技术方向

- 前端：Vue 3、Phaser 3、Pinia、Naive UI、Howler.js、localForage。
- 后端：ASP.NET Core、SQL Server、Garnet、SignalR、Serilog。
- 架构原则：前后端解耦、服务端权威、数据驱动、事件驱动、版本化存档。

## 文档导航

- [项目引导](./项目引导.md)
- [工程蓝图](./docs/工程蓝图.md)
- [MVP路线图](./docs/MVP路线图.md)
- [登录与加载体验](./docs/登录与加载体验.md)
- [目录结构约定](./docs/目录结构约定.md)
- [数据驱动规范](./docs/数据驱动规范.md)
- [GitLab与部署预案](./docs/GitLab与部署预案.md)
- [本地开发启动](./docs/本地开发启动.md)

## 本地启动

后端：

```powershell
dotnet run --project .\backend\Zhibo.Cottage.Api\Zhibo.Cottage.Api.csproj
```

前端：

```powershell
cd frontend
npm install
npm run dev
```

## 下一步建议

1. 将 Phaser 世界壳扩展为可滚动地图、角色动画和镜头跟随。
2. 增加背包详情、快捷栏、基础工具和采集动作反馈。
3. 将 `EnsureCreated` 改为正式 EF Core migrations。
4. 继续扩展数据驱动物品、掉落、事件、商店和小屋建设循环。