用途:为多租户应用实现生产级双认证,将会话式(有状态)认证与 JWT 式(无状态)认证结合,并在两者之上统一应用 RBAC 与多租户隔离。核心原则是不同客户端采用不同认证策略:Web UI 适合会话,API/移动端适合无状态令牌,RBAC 需在两种方式下一致生效。
主要能力:支持多租户 SaaS 的 Web 与 API 双通道访问;Web UI 与移动端认证;带租户隔离的角色权限;令牌吊销;同一用户多设备会话;三层面板架构(超级管理员、加盟商管理员、成员门户)。产出物包括认证与 RBAC 决策记录、RBAC 权限矩阵等。
使用方式:先阅读 SKILL.md,按需加载 references/ 下的深入文件;按有序指引、检查清单与决策规则执行,避免只挑孤立片段。需先收集项目上下文、约束与具体问题,并确认交付物类型(设计、代码、审查、迁移计划、审计或文档)。数据库架构变更须遵循 mysql-best-practices 技能的迁移清单;部署环境为 Windows 开发(MySQL 8.4.7)、Ubuntu 预发布(MySQL 8.x)、Debian 生产(MySQL 8.x),使用 utf8mb4_unicode_ci 排序规则,并确保文件路径与 require 语句大小写完全匹配以兼容 Linux。
适用场景:多租户 SaaS、Web + API、Web + 移动端、需要租户隔离的角色权限、需要令牌吊销、多设备会话、三层面板架构。
限制:不适用于简单单租户应用(过度设计)、只读公共 API、内部工具(更简单的认证足够);若任务与双认证 RBAC 无关或已有更具体的配套技能,则不应使用。可选辅助插件不得视为必需。具体实现细节(如 9 张表的 schema.sql 等)暂未在给定资料中完整提供。