# TruCodeShop

**Repository Path**: szxm_1/TruCodeShop

## Basic Information

- **Project Name**: TruCodeShop
- **Description**: 基于 TruAdmin 的一物一码潮流电商 C 端（uni-app x 用户端商城小程序）是一套面向服装、潮牌、洗护标签与包装场景的一物一码溯源 + 社交电商 C 端解决方案。每一件商品都配有唯一溯源码，消费者微信扫码即可验证真伪、查看产品故事、领取营销权益；同时支持限量发售、预售抽签、积分会员等玩法，帮助品牌把「吊牌」变成「流量入口」。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-08-11
- **Last Updated**: 2026-08-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TruCodeShop · 一物一码潮流电商 C 端

<p align="center">
  <b>扫码溯源 · 正品直达 · 会员营销 · 潮流衣橱</b>
</p>

<p align="center">
  基于 <a href="https://gitee.com/yilianba/truadmin" target="_blank"> TruAdmin </a> 框架孵化的 uni-app x 用户端商城小程序。
</p>

---

## 项目简介

**TruCodeShop** 是一套面向服装、潮牌、洗护标签与包装场景的一物一码溯源 + 社交电商 C 端解决方案。每一件商品都配有唯一溯源码，消费者微信扫码即可验证真伪、查看产品故事、领取营销权益；同时支持限量发售、预售抽签、积分会员等玩法，帮助品牌把「吊牌」变成「流量入口」。

> 本项目为 C 端用户端源码（H5 + 微信小程序），配套 B 端管理后台与溯源服务请见 [TruAdmin](https://gitee.com/yilianba/truadmin)。

---

## 核心亮点

- **一物一码溯源** —— 每件商品独立溯源码，扫码可查真伪、生产信息、品牌故事。
- **潮流电商闭环** —— 首页、探索、购物袋、个人中心，覆盖浏览 → 加购 → 下单 → 支付全链路。
- **多元营销玩法** —— 翻牌抽奖、集卡中心、扫码红包、1 元换购、优惠券、积分中心、每日签到、预售抽签。
- **会员成长体系** —— 积分、等级、订单、抽签记录、地址管理、尺码助手一站式管理。
- **高颜值轻量化** —— 采用荧光绿 + 暗黑高级灰品牌色，年轻化视觉，uni-app x 编译到 H5 / 小程序一端双发。

---

## 界面速览

### C 端小程序

| 首页推荐 | 探索衣橱 | 购物袋 |
| --- | --- | --- |
| ![首页推荐](./截图/6ccb6786729c3403fb1d3db94ab9e7eb.jpg) | ![探索衣橱](./截图/49e6d1e1d4a9aead63719fb9c78a033e.jpg) | ![购物袋](./截图/a32ad88bc37e60eb804e20e9e3816802.jpg) |

| 预售抽签 | 商品详情 | 个人中心 |
| --- | --- | --- |
| ![预售抽签](./截图/809b3b1b54ba1affea5b51623430340d.jpg) | ![商品详情](./截图/0f2e7e69d8f47f0604e61912467244a4.jpg) | ![个人中心](./截图/098560e98704f7aa80034cb3ab589e68.jpg) |

### B 端管理后台

| 数据看板 | 营销中心 | 码包管理 |
| --- | --- | --- |
| ![数据看板](./截图/11.png) | ![营销中心](./截图/22.png) | ![码包管理](./截图/33.png) |

### 联系我们

| 微信客服二维码 |
| --- |
| ![微信客服](./截图/contact.jpg) |

---

## 技术栈

| 层 | 技术 |
| --- | --- |
| C 端框架 | uni-app x + Vue 3 + UTS |
| 管理后台 | Arco Design React + Vite |
| 后端服务 | ThinkPHP 8 + MySQL |
| 一物一码 | 自定义加密溯源码 + 扫码解析 |

---

## 快速开始

### 环境要求

- [HBuilderX](https://www.dcloud.io/hbuilderx.html)（建议最新版，uni-app x 开发依赖）
- Node.js ≥ 18
- 配套 [TruAdmin](https://gitee.com/yilianba/truadmin) 后端服务

### 本地运行

```bash
# 1. 克隆本仓库
git clone https://gitee.com/yilianba/TruCodeShop.git

# 2. 用 HBuilderX 打开 urban-label-app 目录

# 3. 配置接口域名
# 修改 utils/config.uts 中的 BASE_URL 为你部署的 TruAdmin 后端地址

# 4. 运行到浏览器或微信小程序模拟器
# HBuilderX → 运行 → 运行到浏览器 / 运行到小程序模拟器
```

### H5 发布

```bash
# 通过 HBuilderX CLI 发布 web
/Applications/HBuilderX.app/Contents/MacOS/cli publish web --project <urban-label-app 绝对路径>

# 产物位于 unpackage/dist/build/web，部署到后端 public/mobile/ 即可
```

---

## 项目结构

```
urban-label-app/
├── App.uvue                 # 应用入口
├── main.uts                 # 全局入口
├── manifest.json            # uni-app 应用配置
├── pages.json               # 页面路由与导航栏配置
├── pages/                   # 页面目录
│   ├── index/               # 首页
│   ├── explore/             # 探索
│   ├── cart/                # 购物袋
│   ├── user/                # 个人中心
│   ├── product/             # 商品详情
│   └── trace/               # 扫码溯源
├── components/              # 公共组件
├── api/                     # 接口封装
├── utils/                   # 工具函数
├── store/                   # 状态管理
├── static/                  # 静态资源
└── 截图/                     # 项目截图
```

---

## 配套项目

- **TruAdmin（后端 + 管理后台）**：<https://gitee.com/yilianba/truadmin>

本项目用户端接口、营销活动、订单支付、一物一码溯源能力均由 TruAdmin 提供，部署时请确保后端版本匹配。

---

## 许可证

本项目基于 [TruAdmin](https://gitee.com/yilianba/truadmin) 进行开发，具体开源协议请参照 TruAdmin 主仓库。

---

<p align="center">
  Made with ❤️ by 小觅优品 · Urban Label
</p>