# shop_log

**Repository Path**: XzcGroup/shop_log

## Basic Information

- **Project Name**: shop_log
- **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-07
- **Last Updated**: 2026-06-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Shoplog EV

![Shoplog EV Showcase](docs/screenshots/overview-showcase.svg)

一个面向二手电瓶车收车、整备、拆卖、售出与经营分析场景的账本系统。  
当前提供 `H5` 与 `微信小程序` 双端支持，并配套 `Gin + MySQL` 后端接口，同时提供基于 `vue-element-admin 4.4.0` 改造的独立管理后台。

> 这是一个偏实际经营场景的项目，不是单纯的静态展示页。

## 项目亮点

- 支持完整业务链路：收车、整备、拆卖、售出
- 支持车库管理与状态筛选
- 支持经营分析、趋势图和品牌占比分析
- 支持登录鉴权与后端数据同步
- 支持独立管理后台、全局经营看板和单用户经营分析
- 支持品牌、车型、改装项目独立维护
- 支持 H5 与微信小程序双端使用
- 前后端解耦，便于后续扩展部署

## 适用场景

适合以下类型的二手电动车 / 电瓶车经营场景：

- 个人收售
- 小型门店账本管理
- 二手车整备记录
- 拆卖配件收入记录
- 月度经营数据复盘

## 功能概览

### 1. 登录系统

- 账号密码登录
- Bearer Token 鉴权
- 会话本地持久化
- 重新进入页面后自动恢复登录态

### 2. 首页录入

首页包含 4 个核心录入模块：

- 收车录入
- 整备录入
- 拆卖录入
- 售出录入

收车支持：

- 品牌
- 型号
- 年月日联动选择
- 来源
- 是否改装
- 改装项目与具体内容
- 收车日期
- 收车价格
- 图片
- 备注

整备与拆卖支持：

- 多项明细录入
- 每项类型、金额、备注独立填写
- 日期统一记录

### 3. 车库管理

- 全部 / 未售出 / 已售出筛选
- 月份筛选
- 车辆卡片浏览
- 跳转详情页修改车辆资料
- 查看车辆业务日志

### 4. 经营分析

- 汇总数据
- 全年月度趋势
- 收车成本 / 售出收入 / 毛利分析
- 品牌占比
- 经营洞察

### 5. 独立管理后台

- 登录与业务前端分离
- 全局经营看板
- 用户管理与单用户经营分析
- 管理员独立维护
- 品牌 / 车型独立管理
- 改装项目独立管理
- 总车库信息与车辆详情查看

## 技术栈

### 前端

- `uni-app`
- `Vue 2`
- `ColorUI / ColorUI-Plus`

### 后端

- `Go`
- `Gin`
- `GORM`
- `MySQL`

## 项目结构

```text
shoplog/
├── admin/               # 独立管理后台（vue-element-admin 4.4.0 + Element UI）
├── frontend/src/
│   ├── pages/
│   │   ├── login/         # 登录页
│   │   ├── home/          # 首页录入
│   │   ├── garage/        # 车库
│   │   ├── analysis/      # 分析页
│   │   └── detail/        # 车辆详情
│   ├── common/
│   │   ├── config.js      # 前端固定接口配置
│   │   ├── api.js         # 统一请求层
│   │   ├── auth.js        # 登录态管理
│   │   ├── storage.js     # 数据访问层
│   │   └── date.js        # 日期工具
│   ├── components/        # 通用组件
│   ├── data/              # 业务选项数据
│   ├── static/            # 静态资源
│   └── pages.json
├── backend/
│   ├── cmd/api/           # 后端入口
│   ├── internal/
│   │   ├── config/        # 配置
│   │   ├── database/      # 数据库初始化
│   │   ├── httpapi/       # 接口实现
│   │   ├── models/        # 数据模型
│   │   └── router/        # 路由
│   ├── migrations/        # SQL 初始化脚本
│   ├── ACCOUNTS.md        # 登录账号说明
│   └── README.md
├── skills/                # 项目专属技能说明
├── AGENTS.md              # 项目接手说明
└── tools/start/
```

## 页面预览

> 当前仓库已预留 `docs/screenshots/` 目录，建议后续补充真实运行截图后直接替换以下路径。

### 登录页

![Login Preview](docs/screenshots/login-preview.svg)

### 首页录入

![Home Preview](docs/screenshots/home-preview.svg)

### 车库页

![Garage Preview](docs/screenshots/garage-preview.svg)

### 分析页

![Analysis Preview](docs/screenshots/analysis-preview.svg)

## 快速开始

### 1. 安装前端依赖

```bash
cd frontend
npm install
```

### 2. 启动前端

```bash
cd frontend
npm run dev:h5
```

### 3. 启动后端

```bash
cd backend
cp .env.example .env
go run -mod=mod ./cmd/api
```

### 4. 构建

```bash
# H5
cd frontend
npm run build:h5

# 微信小程序
cd frontend
npm run build:mp-weixin
```

## Docker Compose 部署

如果你想直接以容器方式部署整套系统，建议使用根目录的 `docker-compose.yml`。这会同时启动：

- `mysql`：数据库
- `backend`：Gin 后端 API
- `frontend`：H5 业务前端
- `admin`：管理后台

### 1. 准备环境变量

```bash
cp .env.example .env
```

### 2. 启动服务

```bash
docker compose up -d --build
```

### 3. 访问地址

- 业务前端：`http://localhost:8080`
- 后端接口：`http://localhost:8090`
- 管理后台：`http://localhost:8082`

### 4. 常用运维命令

```bash
docker compose logs -f
docker compose logs -f backend
docker compose up -d --build frontend
docker compose up -d --build backend
docker compose up -d --build admin
docker compose down
docker compose down -v
```

### 5. 更详细说明

- [DOCKER.md](DOCKER.md)

## 快捷启动脚本

项目根目录已经提供快捷启动文件：

### Windows

- `tools/start/start-frontend-windows.bat`
- `tools/start/start-backend-windows.bat`
- `tools/start/start-admin-windows.bat`

### Linux

- `tools/start/start-frontend-linux.sh`
- `tools/start/start-backend-linux.sh`
- `tools/start/start-admin-linux.sh`

## 管理后台

独立的管理后台位于 `admin/`，基于 `vue-element-admin 4.4.0` 改造，使用 Vue 2 + Element UI。

启动方式：

```bash
cd admin
npm install --legacy-peer-deps
npm run dev
```

生产构建：

```bash
cd admin
npm run build:prod
```

默认开发访问：

`http://localhost:9527`

## 后端接口说明

主要接口包括：

- `POST /api/v1/auth/login`
- `GET /api/v1/auth/me`
- `POST /api/v1/auth/logout`
- `GET /api/v1/state`
- `GET /api/v1/vehicles`
- `POST /api/v1/vehicles`
- `PUT /api/v1/vehicles/:id`
- `GET /api/v1/vehicles/:id/logs`
- `POST /api/v1/refurbishes`
- `POST /api/v1/part-sales`
- `POST /api/v1/sales`
- `GET /api/v1/analytics/summary`
- `GET /api/v1/admin/dashboard`
- `GET /api/v1/admin/users`
- `POST /api/v1/admin/users`
- `PUT /api/v1/admin/users/:id`
- `DELETE /api/v1/admin/users/:id`
- `GET /api/v1/admin/admins`
- `POST /api/v1/admin/admins`
- `PUT /api/v1/admin/admins/:id`
- `DELETE /api/v1/admin/admins/:id`
- `GET /api/v1/admin/brands`
- `POST /api/v1/admin/brands`
- `PUT /api/v1/admin/brands/:id`
- `DELETE /api/v1/admin/brands/:id`
- `POST /api/v1/admin/brands/:brandId/models`
- `PUT /api/v1/admin/brand-models/:id`
- `DELETE /api/v1/admin/brand-models/:id`
- `GET /api/v1/admin/modification-items`
- `POST /api/v1/admin/modification-items`
- `PUT /api/v1/admin/modification-items/:id`
- `DELETE /api/v1/admin/modification-items/:id`

## 当前项目特点

这个项目当前比较适合继续往“真实业务工具”方向演进，现阶段已经具备这些基础：

- 页面风格统一
- 登录体系已接入
- 前后端已打通
- 公共数据层已抽离
- 具备基础项目文档与接手文档

## 后续建议方向

- 图片上传改为后端存储
- 继续丰富后台经营分析和单用户分析
- 继续细化角色权限
- 增加部署文档与生产环境配置
- 增加自动化测试

## 维护说明

如果你是第一次接手这个项目，建议先阅读：

- [AGENTS.md](AGENTS.md)
- [backend/README.md](backend/README.md)
- [backend/ACCOUNTS.md](backend/ACCOUNTS.md)
- [skills/shoplog-ev-project/SKILL.md](skills/shoplog-ev-project/SKILL.md)

## License

MIT