create-windy 0.6.21 → 0.7.0

package/template/docs/adapters/ruoyi-vue-compatibility.md

@@ -1,93 +0,0 @@
-# RuoYi-Vue 兼容与迁移设计
-
-## 背景
-
-Windy Platform Template 需要替代两个现有 RuoYi-Vue 项目。存量项目为 Vue2 版本，运行依赖 MySQL 和 Redis。迁移目标以一次性导入新库为主，但在客户单机服务器场景中，仍需要具备连接旧 MySQL / Redis 运行的能力。
-
-密码不要求兼容旧 hash，迁移后可以统一重置密码。兼容重点是系统数据、权限链路、菜单路由、日志审计和后台能力闭环。
-
-## 设计结论
-
-采用“新平台 canonical schema + 可插拔 RuoYi-Vue Adapter”的方案。
-
-新项目默认不启用 RuoYi-Vue 兼容能力。旧项目通过独立 Adapter 接入迁移或运行时兼容，业务模块不得直接依赖旧 `sys_*` 表，也不得把 RuoYi-Vue 字段设计扩散到平台核心模型。
-
-## 兼容层职责
-
-RuoYi-Vue 兼容层是一个独立 Module，向平台暴露小而稳定的 Interface，内部隐藏旧库结构、字段差异、状态映射和迁移细节。
-
-兼容层至少包含三类 Adapter：
-
-- `import adapter`：从旧 MySQL 一次性导入用户、角色、部门、菜单、权限、字典、参数、通知、日志和任务数据。
-- `legacy runtime adapter`：在客户单机服务器过渡期连接旧 MySQL / Redis；本轮只允许只读能力，受控写入明确延期。
-- `report adapter`：输出 dry-run、迁移差异、失败行、权限映射、菜单树映射和回滚建议。
-
-## 迁移对象
-
-第一阶段迁移 RuoYi-Vue 的系统基础表：
-
-- 用户、角色、用户角色关系。
-- 部门、岗位、用户岗位关系。
-- 菜单、按钮权限、角色菜单关系。
-- 角色部门关系和数据权限范围。
-- 字典类型、字典数据。
-- 参数配置、通知公告。
-- 登录日志、操作日志。
-- 定时任务定义和任务执行日志。
-
-任务执行器、在线用户、服务监控、缓存监控不能直接迁移实现，只迁移必要配置和历史记录，运行时能力由新平台重新实现。
-
-## 权限与菜单
-
-权限链路是迁移验收重点。迁移后，同一个用户应尽量保持原有菜单可见性、按钮权限和部门数据范围。
-
-兼容层必须显式处理：
-
-- 超级管理员规则。
-- 用户启用/停用/删除状态。
-- 角色启用/停用状态。
-- 目录、菜单、按钮三类菜单节点。
-- 路由路径、组件路径、权限标识、图标、排序、显示/隐藏。
-- 角色菜单授权和角色部门数据范围。
-
-新平台内部可以拆分导航、权限、路由绑定、模块绑定和功能开关，但迁移报告必须能追踪到原始 RuoYi-Vue 行。
-
-## 运行时兼容
-
-运行时兼容只服务旧项目过渡，不作为新项目默认路径。
-
-在客户单机服务器上允许配置旧 MySQL / Redis 连接，用于：
-
-- 读取旧系统基础数据。
-- 对比新旧权限和菜单差异。
-- 迁移前 dry-run。
-- 必要时短期读取旧日志或旧配置。
-
-默认不允许新业务直接写旧库。旧库运行时受控写入、双写、补偿和 Redis 运行态兼容已明确延期；当前只保留未来 Adapter 边界，不实现写接口。
-
-## 若依能力吸收
-
-新底座应吸收 RuoYi-Vue 的产品闭环思路，而不是复刻其实现。
-
-优先吸收：
-
-- 用户、部门、岗位、角色、菜单、字典、参数、通知公告。
-- 操作日志、登录日志、在线用户。
-- 服务监控、缓存监控、数据库连接状态。
-- 定时任务和执行日志。
-- 代码生成或 CRUD 生成。
-- 系统接口文档。
-
-每个业务 Module 默认具备列表、查询、详情、新增、编辑、删除、导入、导出、权限、审计和错误闭环。
-
-当前平台已提供 `/api/system/operations` 和 Web 端 `/system/operations` 运维总览入口，用于承接在线用户、服务监控、缓存监控、定时任务、代码生成和系统接口这些闭环能力的产品位置。平台 Redis 探活、任务调度执行器、canonical CRUD 代码生成器和基于已注册 Module Manifest 的接口权限明细已接入；它们属于平台 canonical 能力，不等于启用本轮明确延期的 RuoYi 旧库运行时受控写入或旧 Redis 兼容。
-
-## 验收标准
-
-- 新项目可以完全不安装、不配置 RuoYi-Vue 兼容层。
-- 旧项目可以从 RuoYi-Vue MySQL 执行 dry-run，并得到迁移报告。
-- 用户、角色、部门、菜单、按钮权限和数据权限可以一次性导入新库。
-- 迁移后可对比指定用户在新旧系统中的菜单树和权限标识。
-- 迁移过程不要求兼容旧密码 hash，可统一重置密码。
-- 单机部署时可以配置旧 MySQL / Redis 连接用于过渡兼容。
-- 当前所有兼容读取必须经过 Adapter，并写入审计日志；受控写入重新立项后另行定义验收标准。

package/template/packages/shared/src/ruoyi.ts

@@ -1,98 +0,0 @@
-import type { AuditEvent, AuditLogWriter } from "./audit.js";
-import type { LegacyTableMapping } from "./database.js";
-import type { EntityId, ISODateTime } from "./primitives.js";
-import type {
-  MenuNode,
-  PermissionDefinition,
-  RoleDefinition,
-  UserAccount,
-} from "./rbac.js";
-
-export type RuoYiCoreTable =
-  | "sys_user"
-  | "sys_role"
-  | "sys_user_role"
-  | "sys_dept"
-  | "sys_post"
-  | "sys_user_post"
-  | "sys_menu"
-  | "sys_role_menu"
-  | "sys_role_dept"
-  | "sys_dict_type"
-  | "sys_dict_data"
-  | "sys_config"
-  | "sys_notice"
-  | "sys_logininfor"
-  | "sys_oper_log"
-  | "sys_job"
-  | "sys_job_log";
-
-export interface RuoYiConnectionConfig {
-  mysqlDsn: string;
-  redisDsn?: string;
-  readonly: boolean;
-}
-
-export interface RuoYiMigrationPlan {
-  id: EntityId;
-  createdAt: ISODateTime;
-  tables: RuoYiCoreTable[];
-  dryRun: boolean;
-  resetPasswords: boolean;
-}
-
-export interface RuoYiMigrationReport {
-  planId: EntityId;
-  startedAt: ISODateTime;
-  finishedAt?: ISODateTime;
-  importedRows: Record<RuoYiCoreTable, number>;
-  failedRows: Record<RuoYiCoreTable, number>;
-  warnings: string[];
-  auditEvents: AuditEvent[];
-}
-
-export interface RuoYiPermissionSnapshot {
-  user: UserAccount;
-  roles: RoleDefinition[];
-  menus: MenuNode[];
-  permissions: PermissionDefinition[];
-}
-
-export interface RuoYiImportAdapter {
-  dryRun(plan: RuoYiMigrationPlan): Promise<RuoYiMigrationReport>;
-  import(
-    plan: RuoYiMigrationPlan,
-    audit: AuditLogWriter,
-  ): Promise<RuoYiMigrationReport>;
-}
-
-export interface RuoYiLegacyRuntimeAdapter {
-  connect(config: RuoYiConnectionConfig): Promise<void>;
-  disconnect(): Promise<void>;
-  readPermissionSnapshot(userId: EntityId): Promise<RuoYiPermissionSnapshot>;
-}
-
-export interface RuoYiReportAdapter {
-  compareUserPermissions(userId: EntityId): Promise<RuoYiMigrationReport>;
-  tableMappings(): LegacyTableMapping[];
-}
-
-export const ruoyiCoreTables: RuoYiCoreTable[] = [
-  "sys_user",
-  "sys_role",
-  "sys_user_role",
-  "sys_dept",
-  "sys_post",
-  "sys_user_post",
-  "sys_menu",
-  "sys_role_menu",
-  "sys_role_dept",
-  "sys_dict_type",
-  "sys_dict_data",
-  "sys_config",
-  "sys_notice",
-  "sys_logininfor",
-  "sys_oper_log",
-  "sys_job",
-  "sys_job_log",
-];