# GeoStudy

**Repository Path**: zh520_kh/geo-study

## Basic Information

- **Project Name**: GeoStudy
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-02
- **Last Updated**: 2026-03-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🌟 Geo-Study 地理空间大冒险 🌟

🧙‍♂️ 欢迎来到这个充满魔法的地理空间学习与可视化项目！这里有会跳舞的地图、会说话的坐标，还有一群努力工作的代码小精灵～

## 📁 项目结构 - 魔法学院的分院制度

我们采用了 **Monorepo 魔法架构**（没错，就是那个能让多个项目和谐共处的神奇咒语），使用 pnpm 工作区作为我们的魔法管理工具：

```
🧙‍♂️ geo-study/ (魔法学院)
├── packages/ (分院)
│   ├── app/ 🏰 (前端城堡) - Vue 3 小姐姐的家
│   ├── core/ ✨ (核心魔法) - Three.js 魔法师的实验室
│   └── server/ 🚀 (后端火箭) - NestJS 技术宅的基地
├── package.json (学院规则)
└── pnpm-workspace.yaml (分院通行证)
```

### 🏰 前端城堡 (packages/app)
- 由 Vue 3 小姐姐和 TypeScript 小哥哥共同守护
- Vite 魔法使负责快速传送（构建）
- UnoCSS 时尚师负责城堡的外观设计

### ✨ 核心魔法 (packages/core)
- Three.js 大魔法师主导的 3D 魔法研究
- t3d-ez.gl 小精灵帮忙简化复杂咒语
- TypeScript 结界保护代码安全

### 🚀 后端火箭 (packages/server)
- NestJS 工程师搭建的 API 发射台
- TypeScript 导航系统确保飞行安全
- Express 引擎提供动力

## 🧰 技术栈 - 魔法师的工具箱

| 分类 | 工具 | 用途 | 可爱指数 |
|------|------|------|----------|
| 前端 | Vue 3 + TypeScript | 构建会撒娇的用户界面 | 🥰 100%
| 前端 | Vite (rolldown-vite) | 让代码飞起来 | ⚡ 95%
| 前端 | UnoCSS | 给界面穿漂亮衣服 | 👗 90%
| 核心 | Three.js | 创造会旋转的 3D 世界 | 🌀 98%
| 核心 | t3d-ez.gl | 简化复杂魔法 | 🧪 85%
| 后端 | NestJS | 搭建坚固的 API 城堡 | 🏰 92%
| 后端 | Express | 提供动力支持 | 🚂 88%

## 🛠️ 安装指南 - 成为魔法师的第一步

### 前置要求
- Node.js 16.0+ (会跑的魔法能量)
- pnpm (会管理魔法包的小精灵)

### 安装步骤

1. **召唤项目**
```bash
# 用 git 魔法把项目拉到本地
git clone <repository-url>
# 进入魔法学院
cd geo-study
```

2. **唤醒依赖**
```bash
# 让 pnpm 小精灵去收集所有魔法材料
pnpm install
```

3. **锻造核心魔法**
```bash
# 把核心模块炼成可用的魔法晶体
pnpm build:core
```

## 🚀 启动咒语

### 启动前端城堡
```bash
# 唤醒 Vue 3 小姐姐
pnpm dev:app
```

### 启动后端火箭
```bash
# 点燃 NestJS 引擎
pnpm dev:server
```

## ✨ 项目功能 - 魔法清单

- **3D 地理可视化**：让地图像芭蕾舞演员一样旋转跳跃 💃
- **交互式界面**：点击一下，地图就会对你笑 😊
- **后端 API**：像快递员一样准时送达数据 📦

## 🎨 开发指南 - 魔法师的修炼手册

### 代码格式化
```bash
# 让代码变得整整齐齐，像魔法书一样漂亮
pnpm format
```

### 检查代码格式
```bash
# 检查代码是否符合魔法学院的规范
pnpm format:check
```

## 🏗️ 项目架构 - 魔法城堡的设计图

我们的魔法学院采用了**Monorepo 架构**，这意味着：

1. **共享魔法**：所有分院可以共享核心魔法，不用重复发明咒语
2. **统一管理**：在一个地方管理所有魔法包，方便又高效
3. **协同施法**：前端、核心、后端可以同时施法，互不干扰
4. **快速传送**：修改核心魔法后，前端和后端能立即感受到变化

## 🤝 贡献指南 - 加入魔法学院

如果你也想成为我们的魔法师：
1. 提交 Issue 告诉我们你发现的魔法bug 🐛
2. 发送 Pull Request 分享你的新魔法 ✨
3. 和我们一起让这个项目变得更有趣！

## 📄 许可证

本项目采用 MIT 许可证 - 就像魔法一样自由分享！

---

🌈 感谢你来到 Geo-Study 魔法学院！希望你在这里玩得开心，学到更多地理空间的魔法知识～ 🌟