# linli-admin

**Repository Path**: xrlnewman/linli-admin

## Basic Information

- **Project Name**: linli-admin
- **Description**: linli 后台管理端 Vue3+ElementPlus
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-30
- **Last Updated**: 2026-06-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# linli-admin · 邻里平台 后台管理端

> 邻里社区服务平台（社区团购 + 同城跑腿 + 搭子）的 **PC 后台管理端**，
> 对接后端 [`linli-server`](https://gitee.com/xrlnewman/linli-server) 的 `admin` API（JWT + RBAC）。

---

## 技术栈

| 分类 | 选型 |
|---|---|
| 框架 | **Vue 3** + `<script setup>` |
| 构建 | **Vite** |
| UI | **Element Plus** + @element-plus/icons-vue |
| 路由 | Vue Router（hash 模式，路由守卫做登录态 + 权限） |
| 状态 | Pinia |
| 请求 | Axios（统一 `{code,message,data}` 信封拦截器 + JWT 注入 + 401 跳登录） |
| 图表 | ECharts |
| 时间 | dayjs |

---

## 功能模块

### 系统
- **登录**：账号密码登录（JWT admin guard），登录态持久化
- **工作台 / 统计大屏**：今日单量、成交额、各模块概览（ECharts）
- **角色权限**：角色列表 + 按模块分组的权限树勾选分配，新建/删除自定义角色
- **后台账号**：账号 CRUD + 分配角色 + 重置密码，超管保护
- **系统设置**：微信小程序 / 微信支付 / 支付宝 / 短信（阿里云·腾讯云）/ 快递（快递100·快递鸟）等第三方密钥可视化配置 + 平台模式开关（团长制 / 商家入驻 / 团长上货 / 送货上门），保存即生效、无需改代码重启

### 业务
- **卖家管理**：平台/商家/团长 三类卖家 CRUD、审核、启停
- **商品管理**：SPU + 多 SKU 增删改、上下架
- **团购管理**：开团（选商品+设各 SKU 团购价/库存）、发布、截单
- **订单管理**：多条件查询、详情（含物流单号）、**发货（填快递公司+单号）/ 到货（单个+按团批量）/ 退款**
- **自提点管理**：CRUD、指派团长
- **分类管理**：分类树
- **跑腿管理**：跑腿订单列表 / 详情 / 统计
- **搭子管理**：活动列表 / 详情 / 违规下架 / 统计
- **钱包流水**：全站充值/消费/退款/佣金流水查看（按用户/类型/时间筛选）

> 按钮级权限：依据登录返回的 `permissions` 控制按钮显隐。

---

## 目录结构

```
src/
├─ api/          各模块接口封装
├─ utils/        request.js（信封拦截器）
├─ stores/       pinia（user 登录态/权限）
├─ router/       路由 + 守卫
├─ layouts/      主框架（侧边菜单 + 顶栏）
├─ views/        各模块管理页
└─ components/   StatCard 等通用组件
```

## 快速开始

```bash
pnpm install
# .env 配 VITE_API_BASE 指向后端，如 http://127.0.0.1:8000
pnpm dev          # 浏览器打开后台
pnpm build        # 生产构建
```

## 演示账号

`admin / admin123`（super 全权限）、`operator1 / admin123`（只读）

---

## 生产部署

纯静态站点：`pnpm build` 出 `dist/`，交给 Nginx 托管即可。

### 1. 构建

```bash
git clone https://gitee.com/xrlnewman/linli-admin.git
cd linli-admin
pnpm install
pnpm build                 # 产物在 dist/
```

### 2. 关于 API 地址（重要）

本项目请求层用的是**相对路径** `baseURL: '/api'`（见 `src/utils/request.js`），**不会**把后端绝对地址打进构建产物。
`.env` 里的 `VITE_API_BASE` **只在本地开发时**用于 Vite dev-server 的代理目标（`vite.config.js` 的 `server.proxy['/api']`），构建后不生效，**无需配置 `.env.production`**。

> 因此生产部署方式是：**同一个 Nginx 既托管 `dist/` 静态文件，又把 `/api` 反代到后端**（同源，无跨域）。若后台与后端必须分不同域名，则改为后端开 CORS + 自行调整请求 baseURL，本项目默认走同源方案。

### 3. 路由模式

后台用 **hash 路由**（`createWebHashHistory`，URL 形如 `/#/dashboard`），刷新不会 404，**静态托管无需任何 rewrite 规则**，部署最省心。（如日后改 history 模式，才需要给 Nginx 加 `try_files ... /index.html` 兜底。）

### 4. Nginx 示例（托管 dist/ + 反代 /api 到后端）

把 `dist/` 上传到服务器（如 `/www/wwwroot/linli-admin/dist`）：

```nginx
server {
    listen 80;
    server_name admin.your-domain.com;
    # 生产建议同样上 HTTPS，此处略，可参照 linli-server 的 443 配置

    root /www/wwwroot/linli-admin/dist;
    index index.html;

    # 静态资源带长缓存
    location /assets/ {
        expires 30d;
        add_header Cache-Control "public, immutable";
    }

    # 前端路由（hash 模式其实只需命中 index.html）
    location / {
        try_files $uri $uri/ /index.html;
    }

    # 关键：/api 反代到后端（PHP），与前端同源，免跨域
    location /api/ {
        proxy_pass http://127.0.0.1:8001;        # 后端地址；若后端独立域名则填其内网地址
        proxy_set_header Host              $host;
        proxy_set_header X-Real-IP         $remote_addr;
        proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}
```

> 若后端已用独立域名（如 `api.your-domain.com`）单独部署，把 `proxy_pass` 指到该地址即可；前端仍只认 `/api`，由这台 Nginx 统一转发。

---

## 功能截图

> 全部由真实浏览器自动化登录 `admin/admin123` 实测后截取（`docs/screenshots/` 下共 40+ 张，覆盖每页每按钮每分支）。

| 工作台 | 卖家管理 | 商品（多 SKU） |
|---|---|---|
| ![工作台](docs/screenshots/admin-02-dashboard.png) | ![卖家](docs/screenshots/admin-03-sellers.png) | ![多SKU商品](docs/screenshots/admin-06-products-create-multisku.png) |

| 开团（设各 SKU 团购价） | 订单详情 + 时间线 | 订单发货（填快递） |
|---|---|---|
| ![开团](docs/screenshots/admin-07-groupbuys-create-skus.png) | ![订单详情](docs/screenshots/admin-08-order-detail.png) | ![发货](docs/screenshots/admin-08-order-ship.png) |

| 角色权限 | 后台账号 | 系统设置（密钥配置） |
|---|---|---|
| ![角色权限](docs/screenshots/admin-11-roles.png) | ![账号](docs/screenshots/admin-12-accounts.png) | ![系统设置](docs/screenshots/admin-13-settings.png) |