|
|
@@ -0,0 +1,399 @@
|
|
|
+# 数据中台模块扩展指南（S1-S3 经验版）
|
|
|
+
|
|
|
+## 1. 适用目标
|
|
|
+
|
|
|
+本文面向后续 S4-S8 等模块扩展，目标是让团队成员可以基于本指南，使用 Cursor 快速生成目标模块的具体扩展任务列表，并按小步闭环完成：
|
|
|
+
|
|
|
+- 新数据中台分层：`mdp_stg_*`、`mdp_std_*`、`dwd_*`、`ado_s9_kpi_value_*`。
|
|
|
+- KPI 报表扩展：指标主数据、计算写入、看板聚合接口、前端展示。
|
|
|
+- 后端作业与刷新：`*MdpSyncTransformService`、`*MdpSyncTransformJob`、手动 refresh API、运行日志。
|
|
|
+- 前端看板动态化：API 类型、图表、异常日志、刷新、导出、无数据兜底。
|
|
|
+- 文档、验收 SQL、版本号和提交闭环。
|
|
|
+
|
|
|
+本指南不是替代详细业务方案，而是把 S1、S2、S3 已验证的工程路径整理成可复制的任务模板。
|
|
|
+
|
|
|
+## 2. 总体分层范式
|
|
|
+
|
|
|
+```mermaid
|
|
|
+flowchart LR
|
|
|
+ Source["旧系统表 / 新系统运行表 / 外部接口"] --> Stg["mdp_stg_* 贴源层"]
|
|
|
+ Stg --> Std["mdp_std_* 标准层"]
|
|
|
+ Std --> Dwd["dwd_* 主题宽表"]
|
|
|
+ Dwd --> Kpi["ado_s9_kpi_value_* KPI结果"]
|
|
|
+ Kpi --> Api["看板聚合 API"]
|
|
|
+ Dwd --> Api
|
|
|
+ Api --> Web["智慧运营看板 / KPI报表 / 诊断"]
|
|
|
+ Job["*MdpSyncTransformJob"] --> Stg
|
|
|
+ Job --> Std
|
|
|
+ Job --> Dwd
|
|
|
+ Job --> Kpi
|
|
|
+ Job --> Log["mdp_sync_log / mdp_transform_run_log"]
|
|
|
+```
|
|
|
+
|
|
|
+### 2.1 各层职责
|
|
|
+
|
|
|
+| 层级 | 典型表 | 职责 | S1-S3 经验 |
|
|
|
+|------|--------|------|------------|
|
|
|
+| 贴源层 | `mdp_stg_*` | 保留源表关键字段和 `raw_data`，便于追溯 | 每个源实体在 `mdp_entity` 登记，批次写 `mdp_sync_log` |
|
|
|
+| 标准层 | `mdp_std_*` | 清洗字段、统一编码、日期、数量和状态口径 | 标准层要做空值兜底和类型转换，避免脏数据中断批次 |
|
|
|
+| 明细宽表 | `dwd_*` | 面向看板、诊断、ChatBI 的稳定读取面 | 页面不要长期直查贴源表或旧系统接口 |
|
|
|
+| KPI 层 | `ado_s9_kpi_value_*` | 存 L1/L2/L3 指标结果、状态和趋势 | 指标口径跟 `ado_smart_ops_kpi_master` 对齐 |
|
|
|
+| 日志层 | `mdp_transform_run_log`、`mdp_sync_log` | 记录批次、行数、状态和异常 | 看板顶部同步状态优先读这里 |
|
|
|
+
|
|
|
+### 2.2 命名约定
|
|
|
+
|
|
|
+- 作业编码：`Sx_MDP_SYNC_TRANSFORM`，例如 `S3_MDP_SYNC_TRANSFORM`。
|
|
|
+- 手动刷新接口：`POST /api/AidopKanban/sx-mdp/refresh` 或模块专用 refresh API。
|
|
|
+- 指标编码：`Sx_L1_001`、`Sx_L2_001`、`Sx_L3_001`。
|
|
|
+- 看板聚合：优先复用 `module-detail?moduleCode=Sx`；复杂模块可新增专用聚合接口。
|
|
|
+- 文档：放入 `doc/plan/数据库迁移/Sx/` 或 `doc/plan/`，并在 `doc/README.md` 加索引。
|
|
|
+
|
|
|
+## 3. 小步闭环任务模板
|
|
|
+
|
|
|
+团队成员让 Cursor 扩展新模块时，应先让 Cursor 基于本模板生成具体任务列表，再逐项执行。每一步都要形成“输入明确、改动可控、验收可查”的闭环。
|
|
|
+
|
|
|
+### 3.1 Cursor 任务生成 Prompt
|
|
|
+
|
|
|
+```text
|
|
|
+请基于《doc/plan/数据中台模块扩展指南-S1至S3经验版.md》，为 <目标模块> 生成小步闭环扩展任务列表。
|
|
|
+
|
|
|
+目标模块：<S4/S5/S6/S7/S8>
|
|
|
+业务范围：<一句话说明模块要解决什么>
|
|
|
+参考模块：<优先选择 S1/S2/S3 中最相近的模块>
|
|
|
+已知源表/旧接口：<列出源表、旧 API、存储过程，可为空>
|
|
|
+目标看板：<首页九宫格 / 详情页 / KPI报表 / 监控页>
|
|
|
+本轮边界：<只读看板 / 含刷新作业 / 含业务动作 / 不接外部系统>
|
|
|
+
|
|
|
+请按以下闭环拆分任务：
|
|
|
+1. 现状审计：源表、旧接口、前端静态区、已有 KPI、已有 DWD。
|
|
|
+2. 方案确认：拟改文件、跨模块影响、DDL/API/前端/验证范围。
|
|
|
+3. DDL 与版本脚本：新增或确认 `mdp_stg_*`、`mdp_std_*`、`dwd_*`、索引、`mdp_entity`。
|
|
|
+4. 后端转换：实现 `*MdpSyncTransformService`，完成 STG -> STD -> DWD -> KPI。
|
|
|
+5. 作业与刷新：实现 `*MdpSyncTransformJob` 和手动 refresh API。
|
|
|
+6. 看板聚合接口：补 `module-detail` 或模块专用聚合接口。
|
|
|
+7. 前端动态化：API 类型、页面数据绑定、图表、刷新、导出、兜底。
|
|
|
+8. 验证闭环：构建、接口、数据库验收 SQL、手动刷新、日志检查。
|
|
|
+9. 文档闭环：新增验收文档、README 索引、遗留风险。
|
|
|
+10. 提交闭环：按实际改动递增版本号，提交并推送。
|
|
|
+
|
|
|
+每一步必须输出：
|
|
|
+- 目标
|
|
|
+- 输入
|
|
|
+- 拟改文件
|
|
|
+- 完成标准
|
|
|
+- 验收 SQL/API/页面检查
|
|
|
+- 是否需要用户确认
|
|
|
+
|
|
|
+如果改动会影响其他模块、公共接口、菜单种子、数据库结构、外部系统事务或任务流，请先单独列出“跨模块影响”，等待确认后再执行。
|
|
|
+```
|
|
|
+
|
|
|
+### 3.2 任务表格式模板
|
|
|
+
|
|
|
+| 顺序 | 任务 | 输入 | 拟改文件 | 完成标准 | 验收方式 | 是否需确认 |
|
|
|
+|------|------|------|----------|----------|----------|------------|
|
|
|
+| 1 | 现状审计 | 模块名、页面、旧接口、源表 | 只读 | 明确现状、差距和风险 | 输出审计清单 | 否 |
|
|
|
+| 2 | 方案确认 | 审计结果 | 只读 | 明确文件、接口、表和边界 | 用户确认 | 是 |
|
|
|
+| 3 | DDL/实体 | 目标分层表 | `UpdateScripts`、`mdp_entity` | 表、索引、实体登记完整 | `SHOW TABLES`、`COUNT` | 是 |
|
|
|
+| 4 | 转换服务 | 源表和口径 | `*MdpSyncTransformService` | STG/STD/DWD/KPI 全链路完成 | 手动运行、日志成功 | 否 |
|
|
|
+| 5 | 作业刷新 | 转换服务 | `*Job`、Controller | 定时与手动刷新可用 | refresh API 返回批次 | 否 |
|
|
|
+| 6 | 聚合接口 | DWD/KPI | Controller/Service | 看板所需字段一次返回 | API 调用检查 | 否 |
|
|
|
+| 7 | 前端动态化 | 聚合接口 | API TS、Vue 页面 | 图表、KPI、日志、刷新、导出动态化 | 页面检查、build | 否 |
|
|
|
+| 8 | 验收文档 | 实际结果 | `doc/plan/...` | 记录 SQL、批次、风险 | 文档可复核 | 否 |
|
|
|
+| 9 | 提交闭环 | 所有改动 | 版本文件、Git | 版本号符合规则，推送完成 | `git status` 干净 | 是 |
|
|
|
+
|
|
|
+## 4. 标准扩展步骤
|
|
|
+
|
|
|
+### 4.1 现状审计
|
|
|
+
|
|
|
+先不要写代码。让 Cursor 只读审计：
|
|
|
+
|
|
|
+- 当前模块页面是否存在静态 KPI、假趋势、假异常日志、不可用按钮。
|
|
|
+- 后端是否已有 `module-detail`、详情接口、监控接口或 KPI 查询。
|
|
|
+- 数据库是否已有 `mdp_stg_*`、`mdp_std_*`、`dwd_*`、`ado_s9_kpi_value_*`。
|
|
|
+- 是否有旧 `api/business`、存储过程、外部系统事务、定时任务。
|
|
|
+- 是否会影响其他模块，例如 S8 预警、S6 执行、公共看板组件、统一查询栏。
|
|
|
+
|
|
|
+输出格式建议：
|
|
|
+
|
|
|
+```text
|
|
|
+模块：<Sx>
|
|
|
+已存在能力：
|
|
|
+- 前端：
|
|
|
+- 后端：
|
|
|
+- 数据库：
|
|
|
+- 作业：
|
|
|
+
|
|
|
+缺口：
|
|
|
+- 数据中台：
|
|
|
+- KPI：
|
|
|
+- 看板：
|
|
|
+- 刷新/监控：
|
|
|
+- 文档/验收：
|
|
|
+
|
|
|
+跨模块影响：
|
|
|
+- <影响模块>：<影响内容>
|
|
|
+
|
|
|
+建议任务顺序：
|
|
|
+1. ...
|
|
|
+```
|
|
|
+
|
|
|
+### 4.2 方案确认
|
|
|
+
|
|
|
+涉及以下任一项时，Cursor 必须先列清单并等确认：
|
|
|
+
|
|
|
+- 新增或修改数据库结构、`UpdateScripts`。
|
|
|
+- 修改公共 Controller、公共 API 类型、公共看板组件。
|
|
|
+- 修改菜单种子、权限、调度器、任务流。
|
|
|
+- 调用或替代旧系统写入动作。
|
|
|
+- 会影响 S1-S3 已有看板口径。
|
|
|
+
|
|
|
+确认清单至少包含：
|
|
|
+
|
|
|
+- 目标。
|
|
|
+- 将改动的文件。
|
|
|
+- 可见行为变化。
|
|
|
+- 跨模块影响。
|
|
|
+- 风险/回滚点。
|
|
|
+- 本轮明确不做的事。
|
|
|
+
|
|
|
+### 4.3 DDL 与数据分层
|
|
|
+
|
|
|
+优先复用已存在的 `doc/db/mdp/` 和 `UpdateScripts`。如果目标模块缺少表，应按以下顺序补：
|
|
|
+
|
|
|
+1. `mdp_stg_*`：贴源表或通用贴源结构。
|
|
|
+2. `mdp_std_*`：清洗后的业务标准表。
|
|
|
+3. `dwd_*`：看板主题宽表。
|
|
|
+4. `ado_smart_ops_kpi_master`：指标主数据。
|
|
|
+5. `ado_s9_kpi_value_*`：指标结果表，通常已存在，不要重复造表。
|
|
|
+6. `mdp_entity`：源实体登记，保证同步任务可观测。
|
|
|
+
|
|
|
+DDL 应满足：
|
|
|
+
|
|
|
+- `CREATE TABLE IF NOT EXISTS`。
|
|
|
+- 必要唯一键支持 `ON DUPLICATE KEY UPDATE`。
|
|
|
+- 常用查询字段有索引，如 `tenant_id`、`factory_id`、`stat_date`、`module_code`、`metric_code`。
|
|
|
+- 脏数据风险字段允许合理兜底，避免批次因历史空值中断。
|
|
|
+
|
|
|
+### 4.4 后端转换服务
|
|
|
+
|
|
|
+参考 S1-S3，转换服务建议包含：
|
|
|
+
|
|
|
+- `RunFullAsync`：统一入口。
|
|
|
+- `SyncStagingAsync`：贴源。
|
|
|
+- `BuildStandardCommands`：标准层 SQL。
|
|
|
+- `BuildDwdCommands`：DWD 宽表 SQL。
|
|
|
+- `BuildKpiValuesAsync`：KPI 计算写入。
|
|
|
+- `mdp_transform_run_log`：记录批次状态、行数、错误。
|
|
|
+- `mdp_sync_log`：记录单实体同步状态。
|
|
|
+
|
|
|
+关键要求：
|
|
|
+
|
|
|
+- 每个批次必须有 `batchId`。
|
|
|
+- 每层写入行数要汇总。
|
|
|
+- `catch` 中必须标记失败日志。
|
|
|
+- 空字符串、`NULL`、非法数字、非法日期要在标准层兜底。
|
|
|
+- KPI 目标值、状态色、趋势要尽量复用 `ado_smart_ops_kpi_master`。
|
|
|
+
|
|
|
+### 4.5 作业与刷新接口
|
|
|
+
|
|
|
+每个模块建议同时具备：
|
|
|
+
|
|
|
+- 定时作业：`SxMdpSyncTransformJob`。
|
|
|
+- 手动刷新：`POST /api/AidopKanban/sx-mdp/refresh`。
|
|
|
+- 最近状态：`mdp_transform_run_log` 最新一条。
|
|
|
+- 监控页或统一 MDP 监控入口。
|
|
|
+
|
|
|
+刷新接口返回建议：
|
|
|
+
|
|
|
+```json
|
|
|
+{
|
|
|
+ "ok": true,
|
|
|
+ "batchId": "Sx_MDP_FULL_yyyyMMddHHmmss",
|
|
|
+ "stageRows": 0,
|
|
|
+ "standardRows": 0,
|
|
|
+ "dwdRows": 0,
|
|
|
+ "kpiRows": 0
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+### 4.6 KPI 报表与聚合 API
|
|
|
+
|
|
|
+看板不要直接拼多个表。后端应提供聚合 API：
|
|
|
+
|
|
|
+- L1/L2/L3 KPI。
|
|
|
+- 同步状态。
|
|
|
+- 趋势数据。
|
|
|
+- 分布数据。
|
|
|
+- 异常日志。
|
|
|
+- 明细表格或可导出数据。
|
|
|
+- 模块特有的分解卡片、分支 KPI、健康度等。
|
|
|
+
|
|
|
+聚合数据优先来源：
|
|
|
+
|
|
|
+1. `ado_s9_kpi_value_*`。
|
|
|
+2. `dwd_*`。
|
|
|
+3. `mdp_std_*`。
|
|
|
+4. 只有在过渡期才读旧业务运行表。
|
|
|
+
|
|
|
+### 4.7 前端看板动态化
|
|
|
+
|
|
|
+前端扩展至少包含：
|
|
|
+
|
|
|
+- API 类型：在 `kanbanData.ts` 或模块 API 文件中补接口类型。
|
|
|
+- 页面状态：`syncStatus`、`isRefreshing`、`lastSyncTime`。
|
|
|
+- KPI：顶部 KPI、分支 KPI、明细 KPI 使用接口数据。
|
|
|
+- 图表：趋势、分布、健康度图表使用接口数据。
|
|
|
+- 异常日志：来自后端聚合，不再硬编码。
|
|
|
+- 操作：刷新、导出、策略模拟或只读提示。
|
|
|
+- 兜底：接口未部署或无数据时保持页面可用。
|
|
|
+
|
|
|
+前端验收：
|
|
|
+
|
|
|
+- `pnpm build` 通过。
|
|
|
+- 页面无新增 linter 错误。
|
|
|
+- 刷新按钮能触发后端。
|
|
|
+- 图表在空数据和有数据时都不报错。
|
|
|
+- 导出内容与当前页面数据一致。
|
|
|
+
|
|
|
+### 4.8 文档与验收
|
|
|
+
|
|
|
+每个模块完成后应新增验收文档，建议位置：
|
|
|
+
|
|
|
+```text
|
|
|
+doc/plan/数据库迁移/Sx/Sx数据中台与看板动态化验收.md
|
|
|
+```
|
|
|
+
|
|
|
+文档应包括：
|
|
|
+
|
|
|
+- 目标范围。
|
|
|
+- 后端接口。
|
|
|
+- 数据来源。
|
|
|
+- 前端验收点。
|
|
|
+- 验收 SQL。
|
|
|
+- 实际验收记录。
|
|
|
+- 边界说明和遗留风险。
|
|
|
+
|
|
|
+## 5. 模块类型适配建议
|
|
|
+
|
|
|
+| 模块 | 常见重点 | 扩展注意点 |
|
|
|
+|------|----------|------------|
|
|
|
+| S4 采购执行 | PR/PO/收货/在途/供应商执行 | 谨慎处理采购单写入、审批、外部事务；看板优先只读 DWD |
|
|
|
+| S5 质量协同 | 检验、让步、缺陷、返工 | 注意质检状态枚举、批次追溯、S8 异常联动 |
|
|
|
+| S6 生产执行 | 工单、工序、报工、产线 | 可能影响 S2 排程和 S8 预警，需先列跨模块影响 |
|
|
|
+| S7 仓储物流 | 库存、出入库、配送、周转 | 数量口径和库存快照要稳定，避免直接读实时散表 |
|
|
|
+| S8 异常监控 | 告警、流程、任务、通知 | 既是独立模块也是其他模块的异常消费端，公共能力改动需确认 |
|
|
|
+
|
|
|
+## 6. 版本号与提交规则
|
|
|
+
|
|
|
+执行提交时按实际纳入文件判断：
|
|
|
+
|
|
|
+- 改 `Web/` 前端代码或配置：递增 `Web/package.json` patch。
|
|
|
+- 改 `server/` 后端代码或配置：递增 `server/Admin.NET.Web.Entry/Admin.NET.Web.Entry.csproj` 三处版本 patch。
|
|
|
+- 同时改前后端：两个版本都递增。
|
|
|
+- 只改文档：不递增前后端版本号。
|
|
|
+- 提交后如用户要求“提交修改”，默认还要推送到跟踪远端。
|
|
|
+
|
|
|
+## 7. 验收 SQL 模板
|
|
|
+
|
|
|
+```sql
|
|
|
+-- 1. 最近转换日志
|
|
|
+SELECT job_code, status, stage_rows, standard_rows, dwd_rows, start_time, end_time, error_message
|
|
|
+FROM mdp_transform_run_log
|
|
|
+WHERE job_code = '<Sx_MDP_SYNC_TRANSFORM>'
|
|
|
+ORDER BY start_time DESC, id DESC
|
|
|
+LIMIT 5;
|
|
|
+
|
|
|
+-- 2. KPI 写入情况
|
|
|
+SELECT module_code, metric_code, COUNT(*) AS rows_count, MAX(biz_date) AS latest_biz_date
|
|
|
+FROM ado_s9_kpi_value_l1_day
|
|
|
+WHERE module_code = '<Sx>' AND is_deleted = 0
|
|
|
+GROUP BY module_code, metric_code
|
|
|
+ORDER BY metric_code;
|
|
|
+
|
|
|
+-- 3. DWD 最新日期
|
|
|
+SELECT MAX(stat_date) AS latest_stat_date, COUNT(*) AS rows_count
|
|
|
+FROM <dwd_table>;
|
|
|
+
|
|
|
+-- 4. 异常/风险分布
|
|
|
+SELECT stat_date, risk_level, COUNT(*) AS risk_count
|
|
|
+FROM <dwd_or_alert_table>
|
|
|
+GROUP BY stat_date, risk_level
|
|
|
+ORDER BY stat_date DESC;
|
|
|
+```
|
|
|
+
|
|
|
+## 8. Cursor 执行 Prompt 模板
|
|
|
+
|
|
|
+### 8.1 只生成任务，不改文件
|
|
|
+
|
|
|
+```text
|
|
|
+请只读分析本仓库，基于《doc/plan/数据中台模块扩展指南-S1至S3经验版.md》为 <目标模块> 生成完整扩展任务列表。
|
|
|
+
|
|
|
+要求：
|
|
|
+- 不改文件。
|
|
|
+- 任务必须小步闭环。
|
|
|
+- 每个任务写明目标、输入、拟改文件、完成标准、验收方式、是否需确认。
|
|
|
+- 单独列出跨模块影响。
|
|
|
+- 参考 S1/S2/S3 已完成范式。
|
|
|
+```
|
|
|
+
|
|
|
+### 8.2 确认后执行
|
|
|
+
|
|
|
+```text
|
|
|
+请按刚才确认的任务列表执行 <目标模块> 扩展。
|
|
|
+
|
|
|
+要求：
|
|
|
+- 按任务顺序推进。
|
|
|
+- 每完成一个任务更新 TODO。
|
|
|
+- 改代码前先列拟改文件和影响面。
|
|
|
+- 涉及跨模块影响、数据库结构、公共 API、外部系统副作用时先停下等确认。
|
|
|
+- 完成后执行后端构建、前端构建、数据库验收 SQL。
|
|
|
+- 如包含前端或后端代码提交，按规则递增版本号。
|
|
|
+- 最后补验收文档。
|
|
|
+```
|
|
|
+
|
|
|
+### 8.3 只补看板动态化
|
|
|
+
|
|
|
+```text
|
|
|
+请参照 S1/S2/S3 的智慧运营看板动态化经验，只补 <目标模块> 看板动态化。
|
|
|
+
|
|
|
+范围：
|
|
|
+- 后端聚合接口。
|
|
|
+- 前端 API 类型。
|
|
|
+- 顶部 KPI、趋势图、分布图、异常日志、刷新、导出、兜底。
|
|
|
+- 验收文档。
|
|
|
+
|
|
|
+不做：
|
|
|
+- 不新增业务写入动作。
|
|
|
+- 不接外部系统。
|
|
|
+- 不改其他模块公共口径，除非先列影响并等确认。
|
|
|
+```
|
|
|
+
|
|
|
+## 9. 自检清单
|
|
|
+
|
|
|
+- [ ] 是否先完成只读审计并列出差距。
|
|
|
+- [ ] 是否明确本轮边界和不做事项。
|
|
|
+- [ ] 是否列出跨模块影响并获得确认。
|
|
|
+- [ ] 是否有 `mdp_stg_*`、`mdp_std_*`、`dwd_*`、KPI 层设计。
|
|
|
+- [ ] 是否登记 `mdp_entity` 或明确数据来源。
|
|
|
+- [ ] 是否有 `mdp_transform_run_log` 和 `mdp_sync_log`。
|
|
|
+- [ ] 是否实现手动 refresh API。
|
|
|
+- [ ] KPI 是否写入 `ado_s9_kpi_value_*`，而非新造孤立指标表。
|
|
|
+- [ ] 看板是否优先读 DWD/KPI 聚合接口。
|
|
|
+- [ ] 前端是否去除硬编码 KPI、假趋势、假日志。
|
|
|
+- [ ] 是否有无数据兜底。
|
|
|
+- [ ] 是否有导出、刷新或明确的只读提示。
|
|
|
+- [ ] 是否补验收 SQL 和实际验收记录。
|
|
|
+- [ ] 构建是否通过。
|
|
|
+- [ ] 版本号是否按实际提交范围递增。
|
|
|
+
|
|
|
+## 10. 参考文件
|
|
|
+
|
|
|
+- `server/Plugins/Admin.NET.Plugin.AiDOP/Order/S1MdpSyncTransformService.cs`
|
|
|
+- `server/Plugins/Admin.NET.Plugin.AiDOP/Production/S2MdpSyncTransformService.cs`
|
|
|
+- `server/Plugins/Admin.NET.Plugin.AiDOP/Supply/S3MdpSyncTransformService.cs`
|
|
|
+- `server/Plugins/Admin.NET.Plugin.AiDOP/Controllers/AidopKanbanController.cs`
|
|
|
+- `Web/src/views/aidop/api/kanbanData.ts`
|
|
|
+- `Web/src/views/aidop/kanban/s2.vue`
|
|
|
+- `Web/src/views/aidop/kanban/s3.vue`
|
|
|
+- `doc/plan/数据库迁移/S2/S2数据中台与KPI扩展验收.md`
|
|
|
+- `doc/plan/数据库迁移/S3/S3数据中台与看板动态化验收.md`
|
skygu