agent_backend/app/module-catalog.ts

import {
  Code2,
  Database,
  Layers3,
  ListTodo,
  MemoryStick,
  Container,
  Server,
  Activity,
} 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 函数、列表与字典', '能创建虚拟环境、执行终端命令'],
    depends: [],
    outcomes: [
      '从空目录启动服务，用 /docs 和 curl 验证接口。',
      '完成 CRUD，正确处理状态码、输入校验与错误。',
      '消费 SSE 并释放连接，处理 WebSocket 断开。',
      '用自动化测试复现接口成功与失败路径。',
    ],
  },
  {
    slug: 'database',
    name: '数据库开发',
    icon: Database,
    count: 12,
    kicker: '数据与事务',
    stack: 'PostgreSQL 16 · SQL · psycopg 3',
    description:
      '建立有约束的数据模型，编写查询，在并发和故障下验证事务、锁、索引与数据恢复。',
    project: 'notes_lab 数据库',
    scope:
      '从表结构和 SQL 开始，完成查询计划分析、并发事务实验、最小权限与可恢复的备份。',
    prerequisites: [
      '已完成 API 服务开发',
      'PostgreSQL 16 与独立 notes_lab 练习库',
    ],
    depends: ['api'],
    outcomes: [
      '用数据库约束保护数据，而非仅依赖应用校验。',
      '使用两个会话复现隔离、锁等待和死锁。',
      '根据 EXPLAIN 与实际数据选择索引和查询方式。',
      '完成受限账户访问、备份与隔离恢复验收。',
    ],
  },
  {
    slug: 'api-database',
    name: 'API + 数据库',
    icon: Layers3,
    count: 12,
    kicker: '持久化服务',
    stack: 'SQLAlchemy 2 · Alembic · PostgreSQL',
    description:
      '把笔记接口接入数据库，明确会话与事务边界，处理并发更新、幂等请求和兼容性迁移。',
    project: 'notes-service 持久化 API',
    scope:
      '以请求生命周期组织连接、事务和错误；用版本字段、唯一约束与 outbox 处理跨请求及跨进程一致性。',
    prerequisites: ['REST 接口与 Pydantic 模型', 'SQL、事务和数据库连接'],
    depends: ['api', 'database'],
    outcomes: [
      '每个请求独立使用 Session，并在明确边界提交或回滚。',
      '验证连接池预算、超时、重复提交与并发修改。',
      '通过 Alembic 实施兼容性迁移并验证旧版本行为。',
      '以真实 PostgreSQL 测试约束、事务和故障路径。',
    ],
  },
  {
    slug: 'tasks',
    name: '异步任务开发',
    icon: ListTodo,
    count: 16,
    kicker: '并发与任务执行',
    stack: 'asyncio · threading · multiprocessing · Celery',
    description:
      '根据 I/O、CPU、隔离与持久性要求选择执行方式，把长任务变成可限流、可重试、可恢复的任务系统。',
    project: '笔记导出与长文处理任务',
    scope:
      '从事件循环、线程和进程开始，再引入任务队列、数据库状态、outbox、工作租约和故障恢复。',
    prerequisites: [
      'API 与数据库事务',
      'Linux / WSL2 运行 Celery worker；Redis 基本连接',
    ],
    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: 'notes-service 查询缓存',
    scope:
      '缓存只承载可重建数据；围绕更新失效、热点保护、并发控制、内存策略与故障降级设计实现。',
    prerequisites: ['持久化 API 与事务提交边界', '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: 'notes-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: 'notes-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: 'notes-service 故障演练环境',
    scope:
      '先定义影响范围，再观察指标、日志和追踪；在隔离环境复现故障，记录恢复操作与复发条件。',
    prerequisites: [
      'API、数据库、任务与缓存实现',
      'Linux 部署与独立故障演练环境',
    ],
    depends: ['linux'],
    outcomes: [
      '用请求 ID、日志与指标缩小问题范围。',
      '区分事件循环阻塞、CPU 饱和、内存增长和连接耗尽。',
      '定位慢 SQL、锁等待、缓存失效与任务堆积。',
      '验证恢复门槛、回滚、容量改进与复盘行动。',
    ],
  },
] 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);
}