node-resource-utils 0.0.0-stage → 1.1.7

package/resources/src/lib/features.ts

@@ -0,0 +1,69 @@
+/**
+ * 功能模块开关。
+ *
+ * ## 默认策略：业务能力默认关，反馈通道默认开
+ *
+ * AI 中心、知识图谱、文件中心、部门管理默认 `false`。题目的组织维度、要不要 AI、
+ * 要不要图谱，只有读过题目的人才知道；默认关着，写业务代码前必须**明确改一次**，
+ * 于是"这个模块到底要不要"变成一次有意识的决定，而不是默认跟着模板走。
+ *
+ * 问题反馈是例外：它是任何系统都成立的兜底通道，也是待办与消息中心的示例来源，
+ * 所以默认 `true`。题目明确不需要反馈时再关掉。
+ *
+ * ## 关掉的影响（改之前先知道）
+ *
+ * 关掉的模块会从**侧边栏**（`(admin)/layout.tsx` 里的 `toSidebarTree`）、
+ * **面包屑**、**侧边栏徽标**、**全局搜索**（`buildSearchEntries`）和
+ * **菜单管理 / 角色授权抽屉**（`getFullMenuTree`）里一起消失 ——
+ * 四处都吃同一棵菜单树，摘一次全摘干净，不会留下"点得到、搜不到、授不了权"的中间态。
+ * 目录节点下的子项全被摘掉时，目录本身也一并去掉，不留空分组。
+ *
+ * ## 它不控制什么
+ *
+ * **不是权限**：直接敲 URL 仍然能进页面，真正的拦截靠角色菜单权限（RoleMenu）。
+ * 要藏一个没做完的模块，正解是别登记菜单，而不是靠关开关。
+ *
+ * 新增模块时在这里加一个开关，并在 GATED_PATHS 里登记它对应的路由前缀，
+ * 侧边栏、面包屑、徽标和全局搜索会自动跟随，不需要改别的地方。
+ */
+
+export const FEATURES = {
+  /** AI 中心：对话面板、工具调用、报告生成 */
+  aiCenter: false,
+  /** 知识图谱：本体视图、节点编辑、关联跳转 */
+  knowledgeGraph: false,
+  /** 文件中心：上传下载演示 */
+  fileCenter: false,
+  /** 问题反馈：提交、处理、回复（通用兜底通道，默认开启） */
+  feedback: true,
+  /** 部门管理：树形组织架构维护 */
+  department: false,
+} as const;
+
+export type FeatureKey = keyof typeof FEATURES;
+
+/**
+ * 路由前缀 → 开关名。
+ *
+ * 用前缀匹配（不是完全相等），因为一个模块通常有列表页、详情页、子路由。
+ * 顺序有意义：更长的前缀要排在前面，避免被短的抢先命中。
+ */
+const GATED_PATHS: Array<{ prefix: string; key: FeatureKey }> = [
+  { prefix: '/ai', key: 'aiCenter' },
+  { prefix: '/graph', key: 'knowledgeGraph' },
+  { prefix: '/demo/files', key: 'fileCenter' },
+  { prefix: '/feedback', key: 'feedback' },
+  { prefix: '/system/depts', key: 'department' },
+];
+
+/** 该路径是否启用（未登记的路径一律视为启用） */
+export function isPathEnabled(pathname: string | null | undefined): boolean {
+  if (!pathname) return true;
+  const hit = GATED_PATHS.find((g) => pathname === g.prefix || pathname.startsWith(g.prefix + '/'));
+  return hit ? FEATURES[hit.key] : true;
+}
+
+/** 某个开关当前是否打开 */
+export function isEnabled(key: FeatureKey): boolean {
+  return FEATURES[key];
+}

package/resources/src/lib/feedback-access.ts

@@ -0,0 +1,17 @@
+import type { SessionUser } from '@/auth';
+
+/**
+ * 反馈模块的管理员判定。
+ *
+ * 为什么单独一个文件：反馈接口（能不能改状态/删）和侧边栏徽标（要不要显示全量待处理数）
+ * 必须用**同一套判定**。两处各写一份正则，改了一处忘了另一处，
+ * 就会出现"徽标说 8 条待处理、点进去普通用户只看见 0 条"的诡异对不上账。
+ *
+ * 规则故意保持宽松（超管，或角色码里带 admin / super / manager）：
+ * 骨架里没有"反馈管理员"这种细分角色，用一个占位规则比硬编码角色 id 更耐改。
+ * 真实项目接了完整 RBAC 后，把它换成 hasPerm(P.feedbackManage) 即可，调用方不用动。
+ */
+export function isFeedbackAdmin(user: SessionUser): boolean {
+  if (user.isSuper) return true;
+  return (user.roleCodes ?? []).some((c) => /admin|super|manager/i.test(c));
+}