↑

后台管理系统模块开发v1.0.2

admin-module-dev16 KB

按「先文档后代码」标准流程,为任意后台域(CRM、基础数据、资讯等)生成接口文档、类型定义、API、权限配置与管理页面。用户要求新建 /admin/{domain}/{mod} 模块或对齐现有模块规范时触发。

0 0 0 0 更新于 2026-10-29 00:00

免责声明:本站部分 Skill 来源于公开渠道,使用前请注意识别相关风险,内容版权归原作者所有,如 Skill 涉及版权问题,请在线反馈,核实后予以下架处理。

概述

本 Skill 面向需要在本仓库后台新增或补齐管理模块的场景,提供从文档到页面的完整落地链路。开发前必须先确定业务域与模块类型(标准 CRUD 或内容型),再按固定顺序执行:接口文档 → TypeScript 类型 → API 路由 → 权限配置 → Service 层 → 管理页。内容型模块自动套用状态审核、发布者、回收站等扩展字段;标准 CRUD 则保持精简,避免错套信息模块的字段包。全程约束 Ant Design 5 默认样式为主,禁止为列表页重复编写 page.module.scss 布局壳,确保与现有后台视觉与交互一致。

技能包含

  • SKILL.md(本文件):模块开发主流程、类型判定、工作流与铁律
  • references/domain-map.md:全域路径映射,确定 domain、集合名与目录习惯
  • references/information-module.md:内容型模块专章(状态、VIP、回收站、restore 等)
  • references/doc-template.md:接口文档固定章节模板
  • references/api-patterns.md:API 响应封装、分页、权限校验与内容型扩展细则
  • references/admin-page-patterns.md:管理页目录结构与页面骨架
  • references/shared-components.md:可复用组件与 hooks 清单
  • references/file-checklist.md:模块文件完整性检查项

核心能力

  • 域与类型判定:查 domain-map 确定业务域,区分标准 CRUD(抄 crm/customer 骨架)与内容型(抄 information/document 骨架)
  • 文档先行:按模板输出含表结构、API 列表、删除策略的系统接口设计文档
  • 全栈代码生成:依次产出类型定义、authRequest 封装的 API 路由、Service 层、AdminLayout 管理页
  • 权限对齐:permissionBase 优先与管理页 URL 一致,支持种子脚本写入菜单权限
  • 样式强制约束:Ant Design 5 默认 + globals.scss 补充,禁止列表页额外堆砌 page.module.scss,禁用 Tailwind / css-in-js
  • 联调清单:按类型 A/B 分别校验 CRUD、筛选、权限、删除策略、回收站、状态字典等

应用场景

用户怎么说本技能做什么
"我要在后台加一个客户管理模块"判定为 CRM 域标准 CRUD,按骨架生成文档、类型、API、权限、Service、管理页全套代码
"资讯下面要新增一个文档类型,需要审核和回收站"判定为内容型 B,套用 information-module 扩展字段,补齐状态流转、发布者、restore API 与预览弹窗
"这个模块的页面样式怎么和现有后台统一"强制使用 AdminLayout + 现有共享组件,列表页禁止自建 module 布局壳,仅保留组件必要局部样式
"先写接口文档再写代码"触发 Step 0 定域,按 doc-template 输出接口文档,后续代码以文档字段为准逐层落地