# FashTry
**Repository Path**: mtq851/fash-try
## Basic Information
- **Project Name**: FashTry
- **Description**: 面向电商与内容创作的 AI 虚拟试衣产品。本仓库开源 PC 桌面站、移动 H5、微信小程序前端；支持试穿、批量试衣、局部改款、出图套图等。Spring Boot 后端与管理后台需商业授权。https://fashtry.com
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-05-26
- **Last Updated**: 2026-05-26
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# FashTry · 前端开源版
一款面向电商与内容创作场景的 **AI 虚拟试衣 / 服装视觉生成** 产品。用户可上传模特图与服装图，一键生成试穿效果；支持批量试衣、局部改款、模特出图、商品套图等能力；平台方可通过管理后台完成用户、任务、订单与品牌运营。
**在线体验：** [https://fashtry.com](https://fashtry.com)
**移动 H5：** [https://fashtry.com/mobile/](https://fashtry.com/mobile/)
> **本仓库开源的是前端代码**（PC 桌面站、移动 H5、微信小程序）。
> **完整可运行项目** 包含 **Java（Spring Boot）后端**、AI 任务调度、MySQL / Redis、对象存储、微信支付、积分与品牌多租户等能力，需 **商业授权** 获取。
---
## 开源范围
| 模块 | 目录 | 说明 |
|------|------|------|
| PC 桌面站 | [`web/`](web/) | Vue 3 独立站，含试穿、批量试衣、局部改款、充值与个人中心等 |
| 移动 H5 | [`web/mobile/`](web/mobile/) | Vue 3 移动端，含试穿、服饰库、任务中心、充值与邀请等 |
| 微信小程序 | [`fashtry-app/`](fashtry-app/) | uni-app 小程序，含试穿、服饰库、任务、充值与分享等 |
| Java 后端 | `src/` | **不开源**，商业版提供 |
| 管理后台 | `web/admin/` | **不开源**，商业版提供 |
前端采用 **Vue 3 + Vite**，小程序采用 **uni-app**，通过 REST API 与后端通信。本地开发可通过 Vite 代理连接你自己的后端服务。
---
## 完整版（商业授权）
如需 **前后端一体、可上线运营** 的完整方案，请联系我们获取商业版，包含但不限于：
- **Java 17 + Spring Boot 3** 后端源码与部署文档
- MySQL 表结构与数据迁移
- AI 试穿 / 图像生成任务队列（RabbitMQ 等）
- 用户鉴权（手机验证码、邮箱、微信手机号登录）
- 积分体系、充值套餐、微信支付
- 品牌入驻、邀请裂变、多租户与 Open API
- 管理后台全套 API 与权限体系
- 腾讯云 COS 对象存储与 Nginx 生产部署示例
> 前端本仓库可自由学习、二次开发与对接自有后端；**完整 Java 后端、管理后台及配套工程仅对授权客户开放**。
**商业咨询**
| 渠道 | 信息 |
|------|------|
| 邮箱 | kerten@ketengwang.ntesmail.com |
| 在线联系 | [https://fashtry.com/contact](https://fashtry.com/contact) |
---
## 功能介绍
### PC 桌面站（`web/`）
- **一键试穿**：上传模特图与服装图，生成虚拟试衣效果
- **批量试衣**：多组模特 / 服装组合批量提交
- **局部改款**：对图像指定区域进行替换与优化
- **模特出图 / 服装套图**：商品展示图与营销素材生成
- **商品精修 / 人像工作室**：扩展 AI 图像编辑能力
- **账户体系**：登录注册、个人资料、积分钱包与充值
- **邀请奖励 / 品牌入驻**：裂变推广与品牌合作入口
- **中英文界面**：面向国内与跨境场景
### 移动 H5（`web/mobile/`）
- **试穿与创作中心**：首页试穿、局部改款、出图与套图
- **批量试衣**：移动端批量任务提交
- **服饰库 / 任务中心**：公共服装选择与历史任务查看
- **我的**：积分、充值、订单、邀请奖励
- **品牌入驻**：在线提交品牌合作申请
### 微信小程序（`fashtry-app/`）
- **试穿生成**：相册选图、示例模特、服饰库选款
- **试穿结果**：结果预览、保存相册、分享好友 / 朋友圈
- **服饰库 / 任务中心**：热门服装与任务状态跟踪
- **我的**：微信手机号登录、积分、充值与订单
- **邀请奖励 / 品牌入驻**：分享裂变与品牌合作
- **品牌定制**：支持品牌码与导航品牌展示
### 管理后台（`web/admin/` · 商业版）
- **数据概览**：用户、任务、订单等运营统计
- **用户管理**：用户搜索、积分记录、上传记录
- **任务管理**：试穿与 AI 生成任务列表与状态
- **订单 / 套餐**：充值订单与积分套餐配置
- **公共模特 / 服饰库**：平台示例素材管理
- **品牌管理**：品牌入驻审核、品牌用户与服饰
- **反馈处理**：用户意见与问题跟进
### 后端能力说明（Java · 商业版）
完整后端基于 **Java 17 + Spring Boot 3 + Spring Security + MyBatis Plus + MySQL + Redis + RabbitMQ** 构建，前端所调用的 `/api/*` 接口均由该后端实现，主要能力包括：
- 用户鉴权（JWT、手机 / 邮箱 / 微信登录）
- AI 试穿与图像生成任务提交、排队与回调
- 对象存储（腾讯云 COS）与图片上传
- 积分扣费、充值订单、微信支付
- 品牌多租户、邀请码与分销奖励
- 管理端权限与运营配置
- Open API（可选）
---
## 界面预览
### PC 桌面站
| 首页试穿 | 批量试衣 |
|:---:|:---:|
|  |  |
### 移动 H5
| 首页 | 我的 |
|:---:|:---:|
|  |  |
### 微信小程序
| 试穿页 | 试穿结果 |
|:---:|:---:|
|  |  |
### 管理后台
| 数据看板 | 任务管理 |
|:---:|:---:|
|  |  |
---
## 技术栈
| 层级 | 技术 |
|------|------|
| PC / H5 前端 | Vue 3、Vite 6、Vue Router、Tailwind CSS（H5） |
| 微信小程序 | uni-app、Vue 2 |
| 后端（商业版） | Java 17、Spring Boot 3、Spring Security、MyBatis Plus |
| 中间件（商业版） | MySQL、Redis、RabbitMQ |
| 第三方（商业版） | 腾讯云 COS、微信支付、AI 图像服务 |
---
## 项目结构
```
.
├── web/ # PC 桌面站（开源）
│ ├── src/
│ └── admin/ # 管理后台（商业版）
├── web/mobile/ # 移动 H5（开源）
├── fashtry-app/ # 微信小程序（开源）
├── docs/
│ ├── assets/contact/ # 微信二维码
│ └── screenshots/ # README 截图
└── src/ # Java 后端（商业版）
```
---
## 快速开始
### 环境要求
- Node.js 18+
- npm 或 pnpm
- 可访问的后端 API（商业版后端，或你自行实现的兼容接口）
- 微信小程序开发需 [微信开发者工具](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html) 与 [HBuilderX](https://www.dcloud.io/hbuilderx.html)
### 1. PC 桌面站
```bash
cd web
npm install
npm run dev
```
默认开发地址：http://localhost:5173
开发环境将 `/api` 代理到 `https://fashtry.com`（可在 `web/.env.development` 修改 `VITE_PROXY_TARGET`）。
### 2. 移动 H5
```bash
cd web/mobile
npm install
npm run dev
```
默认将 `/api` 代理到 `http://127.0.0.1:18888`，可通过环境变量 `VITE_PROXY_TARGET` 覆盖。
### 3. 微信小程序
1. 用 HBuilderX 打开 `fashtry-app/`
2. 修改 `fashtry-app/common/config.ts` 中的 `API_BASE` 为 HTTPS 后端地址
3. 在 `fashtry-app/manifest.json` 填写微信小程序 `appid`
4. 运行到微信开发者工具，并配置 request 合法域名
### 4. 对接后端
前端默认请求 `/api/*`。生产环境通常由 Nginx 将 API 反代到 Java 服务：
- PC 站点：`https://fashtry.com`
- 移动 H5：`https://fashtry.com/mobile/`
- API：与主站同域 `/api` 或独立 API 域名
**无商业版后端时**，你可以：
- 根据 `web/src/lib/api.js`、`web/mobile/src/lib/api.ts`、`fashtry-app/common/api.ts` 中的路径自行 Mock
- 或联系我们获取完整 Java 后端
---
## 生产构建
```bash
# PC 桌面站
cd web && npm run build
# 产物：web/dist/
# 移动 H5
cd web/mobile && npm run build
# 产物：web/mobile/dist/，部署到 /mobile/ 路径下
# 微信小程序
# 使用 HBuilderX 发行 → 微信小程序，产物在 fashtry-app/unpackage/
```
---
## 开源协议
- **前端与小程序**（`web/` 不含 `admin/`、`web/mobile/`、`fashtry-app/`）：[MIT License](LICENSE)
- **后端、管理后台及商业文档**：保留所有权利，未经授权不得复制、分发或用于生产环境
使用本前端连接第三方或自研后端时，请自行遵守微信平台、AI 服务提供商及相关法律法规。
---
## 常见问题
**Q：为什么只开源前端？**
A：核心业务逻辑、AI 调度、支付与数据安全依赖后端。我们开放 UI 与交互供学习与对接，完整运营能力通过商业授权提供。
**Q：能否只用前端 + 自己的后端？**
A：可以。请参考各端 API 模块实现兼容接口，或在此基础上二次开发。
**Q：后端用什么语言？**
A：**Java（Spring Boot）**，MySQL + Redis 存储，RabbitMQ 异步任务，提供 REST API 供本仓库前端调用。
**Q：管理后台开源吗？**
A：不开源。管理后台前端（`web/admin/`）与后端一并包含在商业版中。
---
## 联系我们
| 渠道 | 信息 |
|------|------|
| 邮箱 | kerten@ketengwang.ntesmail.com |
| 在线体验 | [https://fashtry.com](https://fashtry.com) |
| 在线联系 | [https://fashtry.com/contact](https://fashtry.com/contact) |