产品概述与角色权限

平台定位

灵鲸算力指数平台（WhaleIndex）是一个算力指数平台，围绕三个核心场景设计：

1. 公开浏览：首页向所有访客展示 AI 服务器、算力卡、内存、固态存储、处理器、光互联等算力指数的趋势与最新点位。
2. 后台数据维护：管理员通过 Excel 导入每日 specification / weight / price 明细，系统自动计算整体加权价格与指数点位。
3. 数据调用：非公开数据通过可删除、可限流的 API Key 查询，提供稳定的统一查询接口。

四类角色

角色	获取方式	主要能力
访客	无需注册	浏览公开指数（延迟行情，默认 7 个交易日）
免费用户	自助注册（可被管理员关闭）或管理员创建	浏览行情、创建 API Key、购买会员、兑换激活码
管理员	由超级管理员设置	免费用户全部能力 + 数据导入、指数维护、用户管理、充值记录
超级管理员	首次初始化创建（每个实例至少一个）	管理员全部能力 + 全局配置、会员/支付配置、审计日志、全局调用日志

内测账户不是角色

「内测账户」是超级管理员为免费用户开启的支付联调标记（is_test_account）， 不是权限角色。它只影响会员中心是否展示「仅内测账户」的低金额套餐，不带来任何管理权限。 详见 用户管理 → 内测账户。

权限矩阵

功能	访客	免费用户	专业会员	管理员	超级管理员
浏览公开指数	✅ 延迟	✅ 延迟	✅ 最新	✅ 最新	✅ 最新
指数覆盖	7 个公开指数	7 个公开指数	+1 会员指数	8 个指数系列	8 个指数系列
注册 / 登录	注册视开关	✅	✅	✅	✅
手机验证码登录	视短信开关	视短信开关	视短信开关	视短信开关	视短信开关
创建 API Key	❌	✅ 上限 1 个	✅ 数量不限	✅	✅
数据查询最新数据	❌	❌	✅	✅	✅
单 Key 调用频率 / 每日额度	—	10 次/分 · 10 次/日	10000 次/分 · 10000 次/日	同会员	同会员
IP 白名单	❌	❌	✅	✅	✅
Excel 导入 / 导出	❌	❌	❌	✅	✅
指数管理	❌	❌	❌	✅（删除仅超管）	✅
历史报价整日修正	❌	❌	❌	❌	✅
用户管理	❌	❌	❌	免费用户	全部
会员 / 支付配置	❌	❌	❌	仅订单	✅
审计日志	❌	❌	❌	❌	✅
全局调用日志	❌	❌	❌	❌	✅

会员权益边界

会员解锁会员专享指数（Hardware_Index）、最新数据、更高的 Key 数量与调用额度、IP 白名单， 但不会跳过 API Key 的 scope、指数授权、有效期与限流检查。 指数公开范围由平台统一决定，与会员身份无关。

数据时效规则（重要）

• 免费用户与游客按北京时间交易日历延迟，默认 7 个交易日（后台可配置为 0 至 3650 个交易日）。
• 系统从最近交易日向前回退配置的交易日数量；周末与休市日不计入延迟。截止日无数据时返回此前最近一次发布的数据，不伪造当天行情。
• 有效专业会员、正常状态的管理员与超级管理员可查询最新已发布数据。
• 会员到期或账户被禁用后，新请求立即失去最新数据权限，不依赖定时任务。
• 时效限制同时作用于：首页列表、单指数最新值、历史日线、规格报价、数据 API 的 index_daily / index_quote。
• 指定 trade_date、start_date/end_date、省略日期以及分页均不能放宽日期上限；日期被过滤时返回空结果而非报错。
• index_basic（指数基本信息）与 trade_calendar（交易日历）不受行情延迟限制。

指数体系

平台内置 7 个可维护指数 与 1 个系统派生指数，共 8 个指数系列：

指数代码	名称	公开范围	说明
Server_Index	AI 服务器售价指数	aggregate	整机市场售价
Server_Rental_Index	AI 服务器租赁指数	aggregate	整机市场租赁价格
GPU_Index	算力卡指数	index_only	GPU 与 AI 加速卡
DRAM_Index	内存指数	index_only	服务器 DRAM
SSD_Index	固态存储指数	index_only	企业级 SSD/NAND
CPU_Index	处理器指数	index_only	数据中心处理器
OI_Index	光互联指数	index_only	数据中心光模块
Hardware_Index	算力硬件指数	member	系统派生，仅会员与管理员可见

• 前 7 个为可维护指数，需要由管理员导入规格报价；其中 AI 服务器售价与租赁是两个独立的报价组。
• Hardware_Index 由系统自动派生，不接受独立报价，也不能编辑或删除。
• 实际指数数量与公开范围以当前实例的 指数管理 为准。

关键概念

• 指数（Index）：如 Server_Index，以 index_code 唯一标识；所有指数共享统一表结构。
• 报价明细（Quote）：某交易日某指数下每个规格的 specification / weight / price 记录。
• 加权价格：按当日各规格权重加权计算的整体价格。
• 指数点位：链式公式 今日点位 = 昨日点位 × 今日加权价 ÷ 昨日加权价，从基准日的 1000 点起逐日计算。
• 算力硬件指数：会员指数，代码为 Hardware_Index；仅在 6 个基础指数（售价、算力卡、内存、固态存储、处理器、光互联）均有当日数据时生成，当日涨跌幅取这 6 个基础指数日涨跌幅的算术平均值，并从 1000 点连续计算。注意：租赁指数不参与该计算。
• API Key：数据查询凭证，格式 tokease_<hex12>_<secret>，本人可在密钥列表中按需查看或复制。