@alanwang-merit/meritdata-platform-skill-package 1.0.10 → 1.0.11

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

@@ -1,151 +0,0 @@
-# 消息中心基础指南（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

@@ -1,55 +0,0 @@
-# 消息中心攻略索引
-
-> **来源**：研发版 `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

@@ -1,208 +0,0 @@
-# 消息可靠性保障（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

@@ -1,44 +0,0 @@
----
-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

@@ -1,53 +0,0 @@
-# 配置项（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