@alanwang-merit/meritdata-platform-skill-package 1.0.0

package/skills/meritdata-platform-message-center/references/guide.md

@@ -0,0 +1,151 @@
+# 消息中心基础指南（message-center）
+
+> 统一发送接口 / 模板管理 / 多通道。
+
+---
+
+## 1. 核心接口
+
+```java
+@Resource
+private IMessageService messageService;
+
+// 统一发送入口
+SendResult send(MessageDTO message);
+
+// 模板方式发送
+SendResult sendByTemplate(String templateCode, String userId, Map<String, Object> params);
+
+// 异步发送（不阻塞）
+CompletableFuture<SendResult> sendAsync(MessageDTO message);
+```
+
+## 2. 消息类型
+
+| 类型 | 通道 |
+|------|------|
+| `INNER` | 站内信 |
+| `SMS` | 短信 |
+| `EMAIL` | 邮件 |
+| `PUSH` | App 推送 |
+| `DINGTALK` | 钉钉 |
+| `WECHAT_WORK` | 企业微信 |
+| `WEBHOOK` | Webhook |
+
+```java
+MessageDTO msg = MessageDTO.builder()
+    .type(MessageType.INNER)
+    .userId("10001")
+    .title("订单审批结果")
+    .content("您的订单 ORD001 已审批通过")
+    .build();
+
+SendResult result = messageService.send(msg);
+```
+
+## 3. 模板方式（推荐）
+
+### 3.1 配置模板
+
+```
+模板编码: ORDER_APPROVED
+通道: INNER + EMAIL
+标题模板: 订单 ${orderNo} 审批${result}
+内容模板: 您的订单 ${orderNo} 已${result}，金额：${amount} 元
+```
+
+### 3.2 业务代码
+
+```java
+Map<String, Object> params = new HashMap<>();
+params.put("orderNo", "ORD001");
+params.put("result", "审批通过");
+params.put("amount", 1500);
+
+messageService.sendByTemplate("ORDER_APPROVED", "10001", params);
+```
+
+### 3.3 模板优势
+
+| 维度 | 直接 send | 模板方式 |
+|------|----------|---------|
+| 内容管理 | 代码硬编码 | 平台配置 |
+| 多语言 | 难做 | 支持 |
+| 内容审核 | 无 | 可审核后发布 |
+| 改文案 | 改代码上线 | 平台改完即生效 |
+
+## 4. 多通道组合
+
+```yaml
+# 模板配置：ORDER_APPROVED 模板
+template:
+  code: ORDER_APPROVED
+  channels:
+    - INNER           # 站内信（必发）
+    - EMAIL           # 邮件（按用户偏好）
+  channel-policy:     # 用户偏好
+    EMAIL: user_preference
+```
+
+## 5. 接收人
+
+### 5.1 按 userId
+
+```java
+.setUserId("10001")
+```
+
+### 5.2 按角色
+
+```java
+.setRoleCode("ORDER_ADMIN")  // 给所有订单管理员发
+```
+
+### 5.3 按组织
+
+```java
+.setOrgId("D001")  // 给组织下所有人发
+```
+
+### 5.4 多接收人
+
+```java
+.setUserIds(List.of("10001", "10002", "10003"))
+```
+
+## 6. ❌ 反模式
+
+### 6.1 ❌ 直接调短信供应商
+
+```java
+// ❌ 错：业务代码直接调阿里云短信
+SmsClient.send("13812345678", "您的验证码是 1234");
+```
+
+✅ 用平台统一接口 → 配置化、监控、审计。
+
+### 6.2 ❌ 模板里拼字符串
+
+```java
+// ❌ 错
+String content = "您的订单" + orderNo + "已审批通过";
+messageService.send(...)
+```
+
+✅ 用模板 + 变量。
+
+### 6.3 ❌ 同步阻塞发送
+
+```java
+// ❌ 错
+messageService.send(msg);  // 阻塞业务
+return Result.success();
+```
+
+✅ 用 `sendAsync` 或自动异步。
+
+## 7. 关联阅读
+
+- [channels.md](channels.md) — 多通道配置
+- [reliability.md](reliability.md) — 可靠性（重试/补偿/统计）
+- [SKILL.md](../SKILL.md)

package/skills/meritdata-platform-message-center/references/message-/346/224/273/347/225/245/INDEX.md

@@ -0,0 +1,55 @@
+# 消息中心攻略索引
+
+> **来源**：研发版 `meritdata-platform-config-integration`（v2.3.1 拆分整合）
+> **实际内容位置**：[`meritdata-dev-docs-file-finder/references/dev-docs/攻略-12-消息中心-*.md`](../../../meritdata-dev-docs-file-finder/references/dev-docs/)
+> **策略**：**索引 + 指向**（不复制文件）——所有章节内容均在 dev-docs/ 维护。
+
+---
+
+## 一、攻略-12 总览
+
+| 项目 | 值 |
+|------|-----|
+| **攻略名** | 消息中心 |
+| **章节数** | 4 |
+| **总览入口** | [攻略-12-消息中心-00_总览.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-12-消息中心-00_总览.md) |
+| **典型场景** | 业务系统发通知给用户；用平台消息中心页面查询历史消息 |
+
+---
+
+## 二、章节清单
+
+| 章节 | 标题 | 路径 |
+|:-:|------|------|
+| 00 | 总览 | [攻略-12-消息中心-00_总览.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-12-消息中心-00_总览.md) |
+| 01 | 消息中心使用场景 | [攻略-12-消息中心-章节01_消息中心使用场景.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-12-消息中心-章节01_消息中心使用场景.md) |
+| 02 | 消息中心页面功能使用 | [攻略-12-消息中心-章节02_消息中心页面功能使用.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-12-消息中心-章节02_消息中心页面功能使用.md) |
+| 03 | 消息中心接口功能使用 | [攻略-12-消息中心-章节03_消息中心接口功能使用.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-12-消息中心-章节03_消息中心接口功能使用.md) |
+| 04 | 附：附件上传下载删除接口 | [攻略-12-消息中心-章节04_附：附件上传下载删除接口.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-12-消息中心-章节04_附：附件上传下载删除接口.md) |
+
+---
+
+## 三、按场景快速匹配
+
+| 我想做什么 | 看哪个章节 |
+|-----------|----------|
+| 什么场景下用消息中心 | 章节01 使用场景 |
+| 平台消息中心页面怎么用 | 章节02 页面功能使用 |
+| 通过 API 发送消息（`CloudFeignMessageClient`）| 章节03 接口功能使用 |
+| 消息附件上传/下载/删除 | 章节04 附件上传下载删除接口 |
+
+---
+
+## 四、相关平台 API
+
+| 能力 | 类 / 接口 | 来源 |
+|------|----------|------|
+| 5 种消息发送（角色 / 资源 / 用户角色 / 权限分派 / 应用）| `CloudFeignMessageClient`（sendRoleMessage / sendResourceMessage / sendUserRoleMessage / sendAssignMessage / sendAppMessage）| dev-docs/11_三平台服务-3.6服务通知-CloudFeignMessageClient.md |
+| 1.10 消息发送 HTTP 接口 | `1.10 保存和发送消息` | dev-docs/20_1.7-1.10基础配置-页面与消息类.md |
+| 1.11/1.12 消息中心 HTTP 接口 | `1.11 已读未读 / 1.12 发送信息详情` | dev-docs/21_1.11-1.15基础配置-消息与配置类.md |
+| 业务附件管理（上传/下载/删除）| — | dev-docs/攻略-12-章节04 |
+
+---
+
+**最后更新**：2026-09-08（v2.3.1 P1 补齐）
+**来源**：研发版 `meritdata-platform-config-integration` 攻略-12

package/skills/meritdata-platform-message-center/references/reliability.md

@@ -0,0 +1,208 @@
+# 消息可靠性保障（message-center）
+
+> 失败重试 / 补偿机制 / 发送记录 / 监控告警。
+
+---
+
+## 1. 发送状态
+
+| 状态 | 含义 |
+|------|------|
+| `PENDING` | 待发送 |
+| `SENT` | 已发（供应商回执成功）|
+| `FAILED` | 发送失败 |
+| `RETRYING` | 重试中 |
+| `DEAD_LETTER` | 重试耗尽，进入死信 |
+
+## 2. 重试机制
+
+### 2.1 默认重试策略
+
+```yaml
+message:
+  retry:
+    max-attempts: 3               # 最大重试 3 次
+    backoff: exponential           # 指数退避
+    initial-interval-ms: 1000      # 首次重试间隔 1s
+    max-interval-ms: 60000         # 最大间隔 60s
+```
+
+退避序列：1s → 2s → 4s → 8s ...
+
+### 2.2 自定义重试
+
+```java
+MessageDTO msg = MessageDTO.builder()
+    .type(MessageType.SMS)
+    .userId("10001")
+    .templateCode("VERIFY_CODE")
+    .retryPolicy(new RetryPolicy(
+        maxAttempts = 5,
+        backoff = Backoff.exponential(1, 60, TimeUnit.SECONDS)
+    ))
+    .build();
+```
+
+## 3. 失败补偿
+
+### 3.1 死信队列
+
+```
+3 次重试失败
+   ↓
+进入 DLQ（dead-letter-queue）
+   ↓
+定时扫描 DLQ
+   ↓
+人工处理 / 二次重试 / 退款
+```
+
+### 3.2 补偿任务
+
+```java
+@Scheduled(fixedDelay = 300_000)  // 5 分钟一次
+public void processDeadLetters() {
+    List<MessageRecord> deadLetters = messageRecordRepository.findDeadLetters();
+    for (MessageRecord record : deadLetters) {
+        // 人工补偿：发邮件 / 退款 / 告警
+        alertService.send("MESSAGE_DEAD_LETTER", record);
+    }
+}
+```
+
+## 4. 幂等性
+
+### 4.1 业务幂等
+
+```java
+// 业务侧保证幂等
+@PostMapping("/orders/{id}/approve")
+public Result approve(@PathVariable String id, @RequestHeader String idempotentKey) {
+    if (idempotentService.exists(idempotentKey)) {
+        return Result.success();  // 已处理过
+    }
+    orderService.approve(id);
+    idempotentService.mark(idempotentKey);
+    // ... 发消息
+}
+```
+
+### 4.2 消息侧去重
+
+```java
+MessageDTO msg = MessageDTO.builder()
+    .type(MessageType.SMS)
+    .userId("10001")
+    .templateCode("VERIFY_CODE")
+    .bizId("verifyCode:" + userId)   // 业务 ID（用于去重）
+    .build();
+```
+
+5 分钟内同一 bizId 只发一次。
+
+## 5. 发送记录
+
+### 5.1 表结构
+
+```sql
+CREATE TABLE t_message_record (
+    id BIGINT PRIMARY KEY,
+    message_id VARCHAR(50),         -- 消息 ID（幂等键）
+    biz_id VARCHAR(100),            -- 业务 ID
+    type VARCHAR(20),               -- 通道类型
+    user_id VARCHAR(50),
+    template_code VARCHAR(50),
+    content TEXT,
+    status VARCHAR(20),
+    retry_count INT,
+    provider VARCHAR(50),           -- 实际发送的供应商
+    provider_msg_id VARCHAR(100),   -- 供应商回执 ID
+    error_code VARCHAR(50),
+    error_msg TEXT,
+    send_time DATETIME,
+    create_time DATETIME,
+    INDEX idx_user_create (user_id, create_time),
+    INDEX idx_biz (biz_id),
+    INDEX idx_status (status, create_time)
+);
+```
+
+### 5.2 查询
+
+```java
+@GetMapping("/admin/messages")
+public PageResult<MessageRecord> query(MessageQuery query) {
+    return messageRecordService.query(query);
+}
+
+public class MessageQuery {
+    private String userId;
+    private String type;
+    private String templateCode;
+    private String status;
+    private LocalDateTime startTime;
+    private LocalDateTime endTime;
+}
+```
+
+## 6. 监控告警
+
+### 6.1 关键指标
+
+```
+message_sent_total{type, status}    发送总数
+message_send_failed_total           失败总数
+message_send_duration_ms            发送耗时
+message_retry_total                 重试总数
+message_dead_letter_total           死信总数
+```
+
+### 6.2 告警规则
+
+```yaml
+alerts:
+  - name: message_send_failure_rate_high
+    condition: rate(message_send_failed_total[5m]) > 0.1
+    severity: warning
+    message: "消息发送失败率 > 10%"
+  - name: message_dead_letter_accumulation
+    condition: message_dead_letter_total > 100
+    severity: critical
+```
+
+## 7. ❌ 反模式
+
+### 7.1 ❌ 失败无重试
+
+```java
+// ❌ 错：失败就丢
+messageService.send(msg);  // 失败 → 用户收不到，无重试
+```
+
+✅ 配置重试 + 死信。
+
+### 7.2 ❌ 重试无限
+
+```java
+// ❌ 错：无限重试
+while (true) {
+    send(msg);  // 失败一直重
+}
+```
+
+✅ 最大次数 + 死信。
+
+### 7.3 ❌ 无幂等校验
+
+```java
+// ❌ 错：同一验证码发 5 次（用户投诉）
+messageService.sendByTemplate("VERIFY_CODE", userId, params);
+```
+
+✅ bizId 去重。
+
+## 8. 关联阅读
+
+- [guide.md](guide.md) — 消息中心基础
+- [channels.md](channels.md) — 多通道配置
+- [SKILL.md](../SKILL.md)

package/skills/meritdata-platform-nacos-config/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: meritdata-platform-nacos-config
+description: |
+  Nacos 配置中心接入。@NacosValue/@NacosConfigurationProperties 用法、配置监听、动态刷新、多环境隔离、敏感配置加密、灰度发布。
+  触发场景：需要从 Nacos 读配置；配置变更需要动态生效；多环境配置管理。
+  何时不用：Redis 缓存 → 用 cache；纯配置文件 → 直接 application.yml。
+metadata:
+  version: "1.0.0"
+  author: petroleum+rd
+  source: petroleum+rd
+  date_added: "2026-09-07"
+  last_modified: "2026-09-07"
+  risk: medium
+  layer: L3
+  sub-layer: L3-C
+  stack: java
+allowed-tools: Read, Grep, Glob, Bash
+---
+
+# Nacos 配置中心（nacos-config）
+
+## 触发
+- 需要从 Nacos 读配置（替代硬编码）
+- 配置变更需要**动态生效**（不重启应用）
+- 多环境（dev/test/prod）配置隔离
+- 敏感配置需要加密
+
+## 不触发
+- Redis 缓存 → 用 `meritdata-platform-cache`
+- 纯静态配置 → 直接放 application.yml
+- 业务常量 → 放代码（@Value 不适合）
+
+## 前置约束
+- 敏感配置（数据库密码 / API key）必须加密（详见 [rules/security-rules.md §三](../../rules/security-rules.md)）
+- 配置变更通过 Nacos 控制台，不直接改 yml
+- 动态刷新有延迟（@RefreshScope），关键路径要评估
+
+## 路由
+- 接入 + @NacosValue 用法 → [references/guide.md](references/guide.md)
+- 动态刷新 + @RefreshScope → [references/dynamic-refresh.md](references/dynamic-refresh.md)
+- `@ConfigurationProperties` 业务配置组 → [references/configuration-properties.md](references/configuration-properties.md)
+- 多环境隔离 + 灰度 → [references/env-and-gray.md](references/env-and-gray.md)
+- 敏感配置加密 → [references/encryption.md](references/encryption.md)
+- 攻略-11 配置项使用 → [references/config-item-攻略/INDEX.md](references/config-item-攻略/INDEX.md)

package/skills/meritdata-platform-nacos-config/references/config-item-/346/224/273/347/225/245/INDEX.md

@@ -0,0 +1,53 @@
+# 配置项（Nacos / @ConfigurationProperties）攻略索引
+
+> **来源**：研发版 `meritdata-platform-config-integration`（v2.3.1 拆分整合）
+> **实际内容位置**：[`meritdata-dev-docs-file-finder/references/dev-docs/攻略-11-配置项-*.md`](../../../meritdata-dev-docs-file-finder/references/dev-docs/)
+> **策略**：**索引 + 指向**（不复制文件）——所有章节内容均在 dev-docs/ 维护。
+
+---
+
+## 一、攻略-11 总览
+
+| 项目 | 值 |
+|------|-----|
+| **攻略名** | 配置项 |
+| **章节数** | 3 |
+| **总览入口** | [攻略-11-配置项-00_总览.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-11-配置项-00_总览.md) |
+| **典型场景** | 二开项目用 `@ConfigurationProperties` 注入配置；Nacos 动态配置读写 |
+
+---
+
+## 二、章节清单
+
+| 章节 | 标题 | 路径 |
+|:-:|------|------|
+| 00 | 总览 | [攻略-11-配置项-00_总览.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-11-配置项-00_总览.md) |
+| 01 | 应用配置项相关 | [攻略-11-配置项-章节01_应用配置项相关.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-11-配置项-章节01_应用配置项相关.md) |
+| 02 | 配置中心配置项说明 | [攻略-11-配置项-章节02_配置中心配置项说明.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-11-配置项-章节02_配置中心配置项说明.md) |
+| 03 | 配置项的使用 | [攻略-11-配置项-章节03_配置项的使用.md](../../../meritdata-dev-docs-file-finder/references/dev-docs/攻略-11-配置项-章节03_配置项的使用.md) |
+
+---
+
+## 三、按场景快速匹配
+
+| 我想做什么 | 看哪个章节 |
+|-----------|----------|
+| 用 `@ConfigurationProperties` 接收应用配置 | 章节01 应用配置项相关 |
+| 看 Nacos 上的配置项规范 / 命名 | 章节02 配置中心配置项说明 |
+| 怎么读 Nacos 配置（`NacosUtils.getProperty`）| 章节03 配置项的使用 |
+| 怎么改 Nacos 配置（运维发布）| 攻略-11 + `meritdata-nacos-importer` |
+
+---
+
+## 四、相关平台 API
+
+| 能力 | 类 / 接口 | 来源 |
+|------|----------|------|
+| 10 个 Nacos API | `NacosUtils`（getConfigList / getConfigValue / updateConfig / addConfig / publishConfig / getNacosToken ...）| dev-docs/04_一基础设施-1.2配置中心-NacosUtils.md |
+| 配置项实体 | `MeritdataCloudProperties` | 攻略-11 章节01 |
+| 灰度发布流程 | — | `meritdata-nacos-importer/references/gray-publish.md` |
+
+---
+
+**最后更新**：2026-09-08（v2.3.1 P1 补齐）
+**来源**：研发版 `meritdata-platform-config-integration` 攻略-11