users/lib/documentation/page-registry.ts

/**
 * 页面注册表
 * 包含应用程序中所有需要文档化的页面
 */

interface AppPage {
  path: string
  title: string
  description: string
}

/**
 * 获取所有需要文档化的页面
 */
export function getAllPages(): AppPage[] {
  return [
    // 主要页面
    {
      path: "/",
      title: "系统概览",
      description:
        "用户数据资产中台的主页面，展示系统整体运行状况、关键指标和快速入口。提供数据概览、用户增长趋势、价值分布等核心信息的可视化展示。",
    },

    // 用户管理
    {
      path: "/user-portrait",
      title: "用户画像",
      description:
        "全面展示用户的基本信息、行为特征、兴趣偏好和价值评估。通过多维度数据分析，帮助深入了解用户特征，支持精准营销和个性化服务。",
    },
    {
      path: "/user-pool",
      title: "用户池",
      description:
        "集中管理所有用户数据，提供高级筛选、分组和批量操作功能。支持基于多种条件的用户查询和导出，便于进行用户分析和营销活动。",
    },
    {
      path: "/user-value",
      title: "用户价值评估",
      description:
        "基于RFM模型和AI算法评估用户价值，识别高价值用户群体。提供用户生命周期价值预测和流失风险评估，支持制定差异化运营策略。",
    },

    // 数据管理
    {
      path: "/data-platform",
      title: "数据中台",
      description:
        "数据管理和分析的核心平台，提供数据集成、质量监控、关联分析等功能。支持多数据源接入，实现数据的统一管理和价值挖掘。",
    },
    {
      path: "/data-integration",
      title: "数据集成",
      description:
        "配置和管理外部数据源的接入，支持API、数据库、文件等多种数据源类型。提供数据映射、转换和同步功能，确保数据的准确性和实时性。",
    },
    {
      path: "/database-structure",
      title: "数据库结构",
      description:
        "可视化展示系统数据库的表结构、字段关系和索引信息。帮助开发人员和数据分析师理解数据模型，优化查询性能。",
    },
    {
      path: "/data-dictionary",
      title: "数据字典",
      description:
        "提供系统中所有数据字段的详细定义、类型、取值范围和业务含义说明。作为数据标准化的参考文档，确保数据使用的一致性。",
    },

    // 标签系统
    {
      path: "/tag-management",
      title: "标签管理",
      description:
        "创建和管理用户标签体系，支持手动标签和自动标签。提供标签分类、层级管理和标签组合功能，构建完整的用户标签画像。",
    },
    {
      path: "/tag-rules",
      title: "标签规则",
      description:
        "设置自动标签生成规则，基于用户行为和属性自动打标。支持复杂的条件组合和定时执行，提高标签覆盖率和准确性。",
    },
    {
      path: "/tag-tasks",
      title: "标签任务",
      description: "管理批量标签处理任务，监控任务执行状态和结果。支持定时任务和手动触发，提供任务日志和错误处理机制。",
    },

    // 营销工具
    {
      path: "/scenarios",
      title: "营销场景",
      description: "管理各类营销场景和活动，包括拉新、促活、留存等。提供场景模板和效果分析，支持快速复制成功经验。",
    },
    {
      path: "/traffic-pool",
      title: "流量池",
      description:
        "管理和分配营销流量资源，监控流量使用情况和转化效果。支持流量预算管理和ROI分析，优化营销投入产出比。",
    },
    {
      path: "/conversion",
      title: "转化分析",
      description: "分析用户转化漏斗，识别转化瓶颈和优化机会。提供多维度转化率对比和归因分析，指导营销策略优化。",
    },

    // 设备管理
    {
      path: "/devices",
      title: "设备管理",
      description:
        "管理接入系统的所有设备，监控设备状态和性能。支持设备分组、远程控制和批量操作，确保营销活动的正常执行。",
    },
    {
      path: "/wechat-accounts",
      title: "微信账号",
      description: "管理微信营销账号，包括个人号和公众号。提供账号状态监控、好友管理和消息发送功能，支持微信私域运营。",
    },

    // 内容管理
    {
      path: "/content",
      title: "内容库",
      description: "集中管理营销内容素材，包括文案、图片、视频等。支持内容分类、标签和版本管理，提高内容复用效率。",
    },

    // 工作空间
    {
      path: "/workspace",
      title: "工作空间",
      description: "个人工作台，集成常用功能和快捷操作。提供任务管理、数据看板和协作工具，提升工作效率。",
    },

    // AI功能
    {
      path: "/ai-assistant",
      title: "AI智能助手",
      description:
        "基于人工智能的智能分析和决策支持系统。提供数据洞察、趋势预测和策略建议，辅助制定数据驱动的业务决策。",
    },

    // API接口
    {
      path: "/api-interface",
      title: "API接口",
      description: "系统对外API接口文档和测试工具。提供接口说明、参数定义和调用示例，支持第三方系统集成。",
    },
  ]
}

/**
 * 根据路径获取页面信息
 */
export function getPageByPath(path: string): AppPage | null {
  const pages = getAllPages()
  return pages.find((page) => page.path === path) || null
}

/**
 * 获取页面分类
 */
export function getPageCategories(): Record<string, AppPage[]> {
  const pages = getAllPages()
  const categories: Record<string, AppPage[]> = {
    系统概览: pages.filter((p) => p.path === "/"),
    用户管理: pages.filter((p) => p.path.includes("user") || p.path.includes("portrait")),
    数据管理: pages.filter((p) => p.path.includes("data") || p.path.includes("database")),
    标签系统: pages.filter((p) => p.path.includes("tag")),
    营销工具: pages.filter(
      (p) =>
        p.path.includes("scenario") ||
        p.path.includes("traffic") ||
        p.path.includes("conversion") ||
        p.path.includes("content"),
    ),
    设备管理: pages.filter((p) => p.path.includes("device") || p.path.includes("wechat")),
    其他功能: pages.filter((p) => p.path.includes("workspace") || p.path.includes("ai") || p.path.includes("api")),
  }

  return categories
}