# motion-trajectory

**Repository Path**: zing-dev/motion-trajectory

## Basic Information

- **Project Name**: motion-trajectory
- **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-06-01
- **Last Updated**: 2026-06-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 运动轨迹

轻量化运动轨迹展示应用，支持 GPX、TCX、Fit 等主流格式轨迹文件上传、管理与多轨迹对比分析。

## 项目简介

运动轨迹是一款前后端分离的轻量化运动轨迹展示 App，基于 Vue 3 + TypeScript + Go 开发。主要功能包括：

- 支持主流格式轨迹文件上传（GPX、TCX、Fit、KML）
- 多格式自动解析：根据文件后缀名自动选择解析器
- 轨迹时间信息：提取开始/结束时间，支持时间重叠检测
- 多轨迹共存展示与对比分析
- 基于天地图和高德地图的双地图支持
- 用户体系（登录注册、游客模式）
- 运动数据统计分析
- 轨迹动画回放与倍速播放
- 数据导入导出备份功能

## 技术栈

### 前端

- Vue 3 + TypeScript
- Vite
- Pinia (状态管理)
- Vue Router
- 天地图 API + 高德地图 API

### 后端

- Go
- Gin (HTTP 框架)
- MySQL (数据存储)
- MongoDB (轨迹数据)
- Redis (缓存)

## 项目结构

```
motion-trajectory/
├── backend/                 # 后端服务
│   ├── internal/
│   │   ├── config/         # 配置
│   │   ├── dao/            # 数据访问层
│   │   ├── handler/        # HTTP 处理函数
│   │   ├── logic/          # 业务逻辑
│   │   ├── model/          # 数据模型
│   │   └── service/        # 服务层
│   ├── pkg/
│   │   └── parser/         # 轨迹文件解析器
│   └── server.go           # 主入口
├── frontend/               # 前端应用
│   ├── src/
│   │   ├── api/           # API 调用
│   │   ├── components/     # 组件
│   │   ├── router/        # 路由
│   │   ├── stores/         # 状态管理
│   │   ├── views/          # 页面
│   │   └── types/          # 类型定义
│   └── ...
├── docs/                   # 文档
├── data/                   # 测试数据
└── ...
```

## 快速开始

### 前置条件

- Go 1.21+
- Node.js 18+
- MySQL 8.0+
- MongoDB 5.0+
- Redis 7.0+

### 后端启动

```bash
cd backend

# 初始化数据库
mysql -u root -p < etc/init.sql

# 修改配置
vim etc/motion.yaml

# 运行
go run server.go
```

### 前端启动

```bash
cd frontend

# 安装依赖
npm install

# 开发模式
npm run dev

# 构建生产版本
npm run build
```

### Docker 部署

```bash
# 开发环境
docker-compose -f docker-compose-dev.yaml up -d

# 生产环境
docker-compose -f docker-compose.yaml up -d
```

## 功能演示

- **轨迹上传**：支持单文件和批量上传，自动识别文件格式
- **轨迹列表**：支持按类型、时间、距离等条件筛选，运动类型快速筛选
- **轨迹详情**：地图展示、运动数据统计，支持分享、编辑和删除功能
- **轨迹对比**：多轨迹叠加对比分析
- **轨迹回放**：支持轨迹动画播放，实时显示运动时间、距离、速度
- **个人中心**：用户信息管理、快捷入口，数据导出导入
- **设置页面**：个性化设置、数据管理，支持服务器端数据持久化
- **账户操作**：设置页面提供退出登录功能，支持二次确认
- **版本信息**：显示当前版本号和更新日志
- **用户体验优化**：
  - 骨架屏加载状态：数据加载过程中显示优雅的加载动画
  - 响应式设计：适配移动端和桌面端
  - 主题切换：支持浅色和深色主题
  - 地图交互：支持自动跟随运动点、自由移动地图视角
  - 倍速播放：支持 0.5x 到 10x 多档倍速选择
  - 时间重叠检测：上传时自动检测轨迹时间冲突
  - 双地图支持：天地图和高德地图可随时切换

## 版本历史

查看 [CHANGELOG.md](./CHANGELOG.md) 获取详细版本更新记录。

## License

MIT