# 管理员操作指南（ADMIN_GUIDE）

> 本指南只讲在 NocoDB 里怎么点。不需要懂技术，照着做即可。
> 所有操作都在 NocoDB 的 `AlistAccess` 工作区里完成，系统会自动处理后续。

---

## 第一部分：给顾客开账号 + 授权（3 步）

> 顺序：先建顾客 → 再建购买记录 → 再挂产品。

### 第 1 步 — 建顾客（Customers 表）

打开 `Customers` 表，点「＋新增记录」，**按顺序填**：

| 顺序 | 栏位 | 必填 | 怎么填 |
|---|---|---|---|
| 1 | `username` | ✅ | 顾客登录用的账号名，**不能重复** |
| 2 | `password` | ✅ | 顾客的登录密码 |
| 3 | `display_name` | 选填 | 顾客显示名（顾客姓名等）|
| 4 | `email` | 选填 | 顾客邮箱 |
| 5 | `status` | ✅ | 先选 `active`（顾客马上能用）|

> **填完会看到**：保存后，下面几个栏位（`alist_user_id`、`alist_role_id`、`sync_status`）
> 会被系统自动填上，`sync_status` 变成 `synced`。这是正常的，不用管。
>
> **注意**：如果 `status` 先选 `pending`（还没决定卖什么），系统不会建账号。
> 等你后面改成 `active` 才会正式开账号。

### 第 2 步 — 记购买（Purchases 表）

打开 `Purchases` 表，点「＋新增记录」，**期望填写**：

| 栏位 | 必填 | 怎么填 |
|---|---|---|
| `customer` | ✅ | 选第 1 步那个顾客 |
| `product` | ✅ | 选顾客买的产品 |
| `purchase_date` | 选填 | 购买日期 |
| `amount` | 选填 | 金额 |
| `payment_method` | 选填 | 付款方式 |
| `order_id` | 选填 | 订单号 |
| `notes` | 选填 | 备注 |

> 这份是**记账留档**用，填不填都不影响顾客能不能看文件。

### 第 3 步 — 挂产品（CustomerProducts 表）

> **这步才是真正让顾客「看得到文件」的关键。**

打开 `CustomerProducts` 表，点「＋新增记录」，**按顺序填**：

| 顺序 | 栏位 | 必填 | 怎么填 |
|---|---|---|---|
| 1 | `customer` | ✅ | 选第 1 步那个顾客 |
| 2 | `product` | ✅ | 选他买的产品 |
| 3 | `start_at` | 选填 | 开始日期 |
| 4 | `expires_at` | ✅ | 到期日期（**到期当天就失效**）|
| 5 | `status` | ✅ | 选 `active` |

> **填完会看到**：顾客登录后就能看到这个产品对应的文件夹。
> 到了 `expires_at` 那天，权限自动失效。
>
> **一个顾客可以有多条** CustomerProducts：买几个产品就建几条，权限会全加起来。

---

## 第二部分：准备产品（Products + Resources，2 步）

> 顺序：先建资源（文件夹）→ 再建产品（打包）。

### 第 1 步 — 建资源（Resources 表）

打开 `Resources` 表，点「＋新增记录」，**按顺序填**：

| 顺序 | 栏位 | 必填 | 怎么填 |
|---|---|---|---|
| 1 | `name` | ✅ | 给人看的名字（如「Forex 课程」）|
| 2 | `alist_path` | ✅ | 文件夹路径，以 `/` 开头，如 `/Class/Forex` |

> **注意**：`alist_path` 必须是真实存在的文件夹路径，填错顾客会打不开。

### 第 2 步 — 建产品（Products 表）

打开 `Products` 表，点「＋新增记录」，**按顺序填**：

| 顺序 | 栏位 | 必填 | 怎么填 |
|---|---|---|---|
| 1 | `name` | ✅ | 产品名（如「Python Basic」）|
| 2 | `status` | ✅ | 选 `active` |
| 3 | `Resources` | ✅ | 勾选这个产品**包含**的资源（可勾多个）|

> **填完会看到**：以后在「第一部分第 3 步」给顾客挂这个产品时，
> 产品里勾选的资源路径会一次性算给顾客。

---

## 附：Customers 的 status 怎么选

| status | 意思 | 顾客能看文件吗 | 什么时候用 |
|---|---|---|---|
| `pending` | 还没正式开通 | ❌ | 刚建顾客、还没卖产品时 |
| `active` | 正常使用 | ✅ | 顾客在使用中 |
| `suspended` | 暂时停权 | ❌ | 欠费 / 有问题暂时停 |
| `expired` | 整户到期 | ❌ | 顾客服务整体结束 |
| `deleted` | 停用（保留记录）| ❌ | 不合作了但想留历史 |

- 只要不是 `active`，顾客就登不进去、也看不到文件。
- 改回 `active`，系统会自动算**现在还有效**的产品权限（已经过期的不会回来）。