Redis Key 定名规范文档（含图表与定名规则）

Redis Key 定名规范文档（含图表与定名规则）
一、定名规范与布局分析
同一 Redis Key 定名规范有助于：
✅ 快速定位缓存泉源模块
✅ 制止 Key 辩论与重复写入
✅ 支持多语言、多租户缓存隔离
✅ 方便同一监控与清算
定名布局：模块:子模块:业务:实体[:主键或语言]
构成部分        示例值        分析
模块        pms        产物模块，如 sys、mall、pms、wms、i18n
子模块        brand        品牌、分类、库存等子模块
业务        data / list / index        数据范例或业务功能
实体        id / lang        主键或语言代码，如 en-US
示例：
i18n:pms_brand:1001:en-US
sys:user:permissions:9527
二、模块定名约定
模块        定名空间前缀
体系模块        sys:
商城模块        mall:
产物模块        pms:
仓储模块        wms:
国际化模块        i18n:
供应链模块        scm:
三、常用 Key 示例
Key 名称        示例        范例        分析
体系验证码        sys:captcha:{uuid}        String        验证码缓存（5分钟）
用户权限        sys:user:permissions:{id}        Hash        用户权限缓存（24小时）
品牌信息        pms:brand:{id}        String        品牌主信息（默认语言）
品牌国际化        i18n:pms_brand:{id}:{lang}        Hash        品牌多语言缓存（按语言分离）
商品数据        pms:goods:data:{lang}        Hash        商品信息（含翻译）
库存快照        wms:inv:snapshot:{warehouseId}        Hash        堆栈库存快照（6小时）
四、Key 生命周期发起
范例        逾期时间        分析
临时缓存（验证码）        5-30分钟        短期缓存，防止重放攻击
分页效果缓存        10分钟        列表页/分页效果
品牌与商品缓存        24小时        根本主数据
多语言缓存        24小时        每语言单独缓存
库存快照        6小时        动态数据定期革新
五、定名层级布局图
sys
├── captcha:{uuid}
├── user:permissions:{id}
pms
├── brand:{id}
├── goods:data:{lang}
│     ├── category:{cid}
│     └── brand:{bid}
└── sku:list
i18n
├── pms_brand:{id}:{lang}
└── pms_category:{id}:{lang}
六、规范总结
1️⃣ Key 全小写，利用 ":" 分隔层级
2️⃣ 层级不高出 5 级，包管查询性能
3️⃣ 多语言字段需带 lang 后缀
4️⃣ 范例与布局在定名中体现（如 list、data）
5️⃣ 模块前缀唯一对应业务体系