5.7 KiB
管理员操作指南（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，系统会自动算现在还有效的产品权限（已经过期的不会回来）。
附 2：到期后会发生什么（重要）
系统每 5 分钟自动扫一次所有顾客的到期日（CustomerProducts.expires_at），
到期当天（当天就算到期）就会把这些产品对应的文件夹权限从顾客身上移除——
这一步是全自动的，不用管理员做任何操作（2026-08-28 定案：维持此行为，不做自动停用/通知）。
| 项目 | 实际行为 |
|---|---|
| 文件权限 | 到期当天自动移除，顾客再也打不开任何文件夹 ✅ |
| 账号 | 不冻结——顾客仍能登录，但登录进去目录是空的、什么都看不到 |
Customers.status |
不会自动改，仍显示 active（正常现象，权限其实已移除） |
| 通知 | 不会自动发任何通知，管理员自行留意 expires_at 即可 |
要连登录都不让他进（退款 / 违规 / 明确不续约）： 手动把
Customers.status改成suspended或expired，系统马上冻结账号（登不进去）。
续费 / 恢复：把
CustomerProducts.expires_at改到新日期（或新增一条记录），权限自动恢复。 若之前手动冻结过（status 不是active），记得先把 status 改回active。
顾客反馈「能登录但里面什么都没有」：先查他的
CustomerProducts.expires_at， 十有八九是到期了。要么改expires_at续费，要么说明服务已结束。 如果expires_at还没到但看不到东西：查该产品Products.status是否active、 Resource 的alist_path是否填对（必须真实存在的/开头路径）。