agent_backend/app/module-catalog.ts

import {
  Code2,
  Database,
  Layers3,
  ListTodo,
  MemoryStick,
  Container,
  Server,
  Activity,
  Network,
  ClipboardCheck,
} from 'lucide-react';
export const modules = [
  {
    slug: 'api',
    name: 'API 服务开发',
    icon: Code2,
    count: 16,
    kicker: '接口与通信',
    stack: 'FastAPI · HTTP · SSE · WebSocket',
    description:
      '从 Python 函数到可调用的服务，完成参数校验、REST 接口、异步调用、流式响应与双向通信。',
    project: '电商商品服务',
    scope:
      '用商品名称、描述、价格和上架状态练习内存版接口，后续逐步补齐持久化、缓存和商品清单导出。业务围绕商品目录展开。',
    prerequisites: [
      'Python 函数、列表与字典',
      '已安装 Python，能用编辑器保存文件',
    ],
    depends: [],
    outcomes: [
      '从空目录启动服务，用 /docs 和 curl 验证接口。',
      '完成 CRUD，正确处理状态码、输入校验与错误。',
      '消费 SSE 并释放连接，处理 WebSocket 断开。',
      '用自动化测试复现接口成功与失败路径。',
    ],
  },
  {
    slug: 'database',
    name: '数据库开发',
    icon: Database,
    count: 12,
    kicker: '数据与事务',
    stack: 'MySQL 8.4 LTS · InnoDB · PyMySQL',
    description:
      '从商品与分类的需求推导表结构，选择字段类型、主外键和约束，再验证查询、事务、索引与数据恢复。',
    project: 'shop_lab 商品与分类数据库',
    scope:
      '从表结构和 SQL 开始，完成查询计划分析、并发事务实验、最小权限与可恢复的备份。',
    prerequisites: [
      '已完成 API 服务开发',
      '已安装并可运行 Docker；第 01 课会创建 MySQL 练习库',
    ],
    depends: ['api'],
    outcomes: [
      '从读写需求设计商品表、分类表和关联表，解释金额、主外键与删除策略。',
      '用数据库约束保护数据，而非仅依赖应用校验。',
      '使用两个会话复现隔离、锁等待和死锁。',
      '根据 EXPLAIN 与实际数据选择索引和查询方式。',
      '完成受限账户访问、备份与隔离恢复验收。',
    ],
  },
  {
    slug: 'api-database',
    name: 'API + 数据库',
    icon: Layers3,
    count: 12,
    kicker: '持久化服务',
    stack: 'SQLAlchemy 2 · Alembic · MySQL',
    description:
      '把商品接口接入数据库，明确会话与事务边界，处理并发更新、幂等请求和兼容性迁移。',
    project: 'shop-service 持久化 API',
    scope:
      '以请求生命周期组织连接、事务和错误；用版本字段、唯一约束与 outbox 处理跨请求及跨进程一致性。',
    prerequisites: ['REST 接口与 Pydantic 模型', 'SQL、事务和数据库连接'],
    depends: ['api', 'database'],
    outcomes: [
      '每个请求独立使用 Session，并在明确边界提交或回滚。',
      '验证连接池预算、超时、重复提交与并发修改。',
      '通过 Alembic 实施兼容性迁移并验证旧版本行为。',
      '以真实 MySQL 测试约束、事务和故障路径。',
    ],
  },
  {
    slug: 'tasks',
    name: '异步任务开发',
    icon: ListTodo,
    count: 16,
    kicker: '并发与任务执行',
    stack: 'asyncio · threading · multiprocessing · Celery',
    description:
      '根据 I/O、CPU、隔离与持久性要求选择执行方式，把长任务变成可限流、可重试、可恢复的任务系统。',
    project: '商品清单导出与描述统计任务',
    scope:
      '从事件循环、线程和进程开始，再引入任务队列、数据库状态、outbox、工作租约和故障恢复。',
    prerequisites: [
      'API 与数据库事务',
      '前 07 课使用本机 Python；第 08 课起准备 Linux / WSL2 与 Docker',
    ],
    depends: ['api-database'],
    outcomes: [
      '为 I/O 与 CPU 工作选择有界的协程、线程池或进程池。',
      '区分进程内后台任务与可持久化任务队列。',
      '处理重复投递、超时、取消、重试与 worker 退出。',
      '验证状态机、幂等、背压、调度与任务积压告警。',
    ],
  },
  {
    slug: 'redis',
    name: 'Redis 缓存',
    icon: MemoryStick,
    count: 10,
    kicker: '缓存与协调',
    stack: 'Redis 7 · redis-py · Cache Aside',
    description:
      '为读请求引入缓存，明确数据真源、失效窗口和容量边界，复现穿透、击穿、雪崩与 Redis 故障。',
    project: 'shop-service 查询缓存',
    scope:
      '缓存只承载可重建数据；围绕更新失效、热点保护、并发控制、内存策略与故障降级设计实现。',
    prerequisites: [
      '已完成持久化商品接口',
      '可用的 Docker；第 01 课会创建 Redis 练习实例',
    ],
    depends: ['api-database'],
    outcomes: [
      '实现包含 TTL 与键版本的缓存读取和更新失效。',
      '在并发下验证缓存击穿、过期抖动与热点保护。',
      '设置内存预算、连接超时与可用的失败降级。',
      '明确锁、计数器、会话与队列各自的可靠性边界。',
    ],
  },
  {
    slug: 'docker',
    name: 'Docker 容器化',
    icon: Container,
    count: 10,
    kicker: '构建与运行',
    stack: 'Docker Engine · Compose · OCI Images',
    description:
      '构建可复现镜像，组合 API、数据库、缓存与 worker，管理数据、网络、资源、健康检查与升级。',
    project: 'shop-service 容器运行环境',
    scope:
      '区分镜像、容器和持久卷；用非 root 运行、固定依赖、资源上限、迁移作业与可回滚发布管理服务。',
    prerequisites: [
      'API、数据库、Redis 与任务进程的职责',
      'Docker Engine / Docker Desktop 与 Compose',
    ],
    depends: ['tasks', 'redis'],
    outcomes: [
      '构建分层合理、非 root 运行的应用镜像。',
      '使用服务名、健康检查和持久卷组织多容器系统。',
      '验证优雅退出、资源限制、密钥注入与日志输出。',
      '在保留数据库数据的条件下完成升级与回滚。',
    ],
  },
  {
    slug: 'linux',
    name: 'Linux 部署',
    icon: Server,
    count: 10,
    kicker: '交付与运维',
    stack: 'Linux · systemd · Nginx · TLS',
    description:
      '把本地可运行服务部署到 Linux，建立权限边界、进程管理、反向代理、发布回滚与备份恢复流程。',
    project: 'shop-service Linux 部署',
    scope:
      '以独立练习主机为环境，验证服务启动、网络入口、流式代理、凭证权限、发布检查与恢复手册。',
    prerequisites: ['容器与服务网络', '独立 Linux 练习机，使用普通账户与 sudo'],
    depends: ['docker'],
    outcomes: [
      '建立最小权限运行账户、目录权限与网络入口。',
      '管理 systemd 服务并验证重启和停止行为。',
      '为 HTTP、SSE 和 WebSocket 配置代理与 TLS。',
      '执行有健康门槛的发布、回滚及隔离恢复演练。',
    ],
  },
  {
    slug: 'troubleshooting',
    name: '线上问题排查',
    icon: Activity,
    count: 12,
    kicker: '观测与故障恢复',
    stack: 'Logs · Metrics · Traces · Runbooks',
    description:
      '从请求症状建立证据链，定位 CPU、内存、连接、数据库、缓存与队列问题，验证止损和修复效果。',
    project: 'shop-service 故障演练环境',
    scope:
      '先定义影响范围，再观察指标、日志和追踪；在隔离环境复现故障，记录恢复操作与复发条件。',
    prerequisites: [
      'API、数据库、任务与缓存实现',
      'Linux 部署与独立故障演练环境',
    ],
    depends: ['linux'],
    outcomes: [
      '用请求 ID、日志与指标缩小问题范围。',
      '区分事件循环阻塞、CPU 饱和、内存增长和连接耗尽。',
      '定位慢 SQL、锁等待、缓存失效与任务堆积。',
      '验证恢复门槛、回滚、容量改进与复盘行动。',
    ],
  },
  {
    slug: 'distributed',
    name: '分布式系统设计',
    icon: Network,
    count: 12,
    kicker: '架构原理与面试推演',
    stack: '架构模式 · 一致性 · 可靠性 · 容量设计',
    description:
      '从商品查询与清单导出的跨进程链路出发，理解常见分布式架构、失败模式和解决方案。用场景推演与面试问答练习设计取舍。',
    project: '电商商品服务系统设计案例',
    scope:
      '纯理论模块，无环境安装和实战代码。围绕组件职责、故障时间线、方案代价与适用边界进行分析；能说清为什么选择，何时需要调整。',
    prerequisites: [
      '了解 API、数据库、缓存与队列各自的职责',
      '建议先阅读课程总览与相关模块图解',
    ],
    depends: ['api-database', 'tasks', 'redis'],
    outcomes: [
      '根据业务约束比较模块化单体、微服务和事件驱动架构。',
      '用具体故障解释一致性、重复消息、未知结果与缓存失效。',
      '说明幂等、事务、租约锁、重试与熔断各自解决的问题及边界。',
      '围绕容量、可观测性、RPO 与 RTO 完成有依据的系统设计回答。',
    ],
  },
  {
    slug: 'review',
    name: '复盘与自测',
    icon: ClipboardCheck,
    count: 9,
    kicker: '掌握标准与回学',
    stack: '理解问题 · 情境推演 · 掌握证据',
    description:
      '逐一回顾前面九个模块：先独立回答核心问题，再对照思考要点，以可验证的成果判断是否掌握，并找到需要回学的课时。',
    project: '电商商品服务 · 九模块能力复盘',
    scope:
      '每个单元对应一个技术模块，包含六个理解问题、两个情境推演和四项掌握标准。先作答后展开要点，自评与回答保存在当前浏览器，可按薄弱项返回原课时。',
    prerequisites: [
      '完成想要自测的对应模块即可进入',
      '准备自己的练习记录；先闭卷回答，再核对参考要点',
    ],
    depends: [],
    outcomes: [
      '能够独立解释各模块的核心机制，并用商品服务举例。',
      '条件改变或出现故障时，能推演结果、说明取舍和验证方法。',
      '每个模块的四项掌握标准都有实际操作或设计推演证据。',
      '将未掌握的问题对应到具体课时，补学后重新闭卷自测。',
    ],
  },
] as const;
export type ModuleSlug = (typeof modules)[number]['slug'];
export type ModuleInfo = (typeof modules)[number];
export function getModule(slug: string) {
  return modules.find((m) => m.slug === slug);
}