Claude Code 系统设计

# Claude 帮助分析用户故事
claude --design --analyze-requirements

# 输入示例
"""
分析以下用户故事，识别关键需求和技术挑战：

用户故事 1：作为一个用户，我希望能够上传图片并自动生成缩略图
用户故事 2：作为一个用户，我希望能够分享我的相册给他人
用户故事 3：作为一个用户，我希望能够在评论中 @ 其他用户
"""

# Claude 会输出
## 需求分析

### 功能需求
1. 图片上传和存储
2. 图片处理（缩略图、水印）
3. 分享功能（链接、生成分享码）
4. 评论功能（@ 提及通知）

### 非功能需求
1. 性能：图片处理 < 5 秒
2. 存储：支持 10GB+ 存储
3. 安全：图片访问权限控制
4. 可用性：99.9% uptime

## 技术挑战

| 挑战 | 描述 | 优先级 | 建议方案 |
|------|------|--------|----------|
| 大文件上传 | 用户可能上传大图片 | 高 | 分片上传、断点续传 |
| 图片处理 | 实时生成多种规格 | 中 | 异步队列、预生成 |
| 存储成本 | 大量图片存储 | 高 | OSS、分层存储 |
| 并发访问 | 高并发场景 | 中 | CDN、缓存 |

# 帮助进行技术选型
claude --design --tech-selection

"""
为一个图片分享社交平台选择技术栈：
- 日活用户：10 万
- 日上传图片：50 万张
- 需要支持 1000 并发访问
- 预算：中等
"""

## 技术选型方案

### 前端
| 选项 | 推荐 | 理由 |
|------|------|------|
| React + Next.js | ✅ | SSR 友好 SEO |
| Vue + Nuxt |备选 | 团队熟悉度 |
| 框架 | Tailwind + Ant Design | 快速开发 |

### 后端
| 选项 | 推荐 | 理由 |
|------|------|------|
| Node.js + Express | ✅ | 生态丰富、团队熟悉 |
| Go | 备选 | 高性能需求 |
| Python + FastAPI | 备选 | AI 集成方便 |

### 数据库
| 选项 | 推荐 | 理由 |
|------|------|------|
| PostgreSQL | ✅ | 关系数据、主业务 |
| MongoDB | 备选 | 非结构化数据 |
| Redis | ✅ | 缓存、Session |

### 存储
| 选项 | 推荐 | 理由 |
|------|------|------|
| OSS | ✅ | 低成本、可扩展 |
| S3 | 备选 | 国际化需求 |
| 自建 | ❌ | 运维成本高 |

# 生成架构文档
claude --design --architecture

"""
设计一个图片分享平台的后端架构：

功能：
1. 用户认证和授权
2. 图片上传和处理
3. 相册管理
4. 分享功能
5. 评论和 @ 功能
6. 消息通知
"""

## 系统架构

# 生成 API 设计
claude --design --api

"""
设计图片分享平台的 API：

功能：
1. 用户认证（登录、注册、Token 刷新）
2. 图片上传和查询
3. 相册管理（创建、编辑、删除、分享）
4. 评论功能（发评论、回复、@）
5. 用户关注
"""

## API 文档

### 认证模块

#### POST /api/v1/auth/register
注册新用户

**请求**
```json
{
  "username": "string",
  "email": "string",
  "password": "string"
}

{
  "code": 0,
  "message": "success",
  "data": {
    "userId": "string",
    "token": "string"
  }
}

{
  "email": "string",
  "password": "string"
}

{
  "code": 0,
  "data": {
    "photoId": "string",
    "url": "string",
    "thumbnailUrl": "string"
  }
}

-- 用户表
CREATE TABLE users (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    username VARCHAR(50) NOT NULL UNIQUE,
    email VARCHAR(100) NOT NULL UNIQUE,
    password_hash VARCHAR(255) NOT NULL,
    avatar_url VARCHAR(500),
    bio TEXT,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- 图片表
CREATE TABLE photos (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    user_id UUID NOT NULL REFERENCES users(id),
    album_id UUID REFERENCES albums(id),
    url VARCHAR(500) NOT NULL,
    thumbnail_url VARCHAR(500),
    width INTEGER,
    height INTEGER,
    size INTEGER,
    format VARCHAR(20),
    view_count INTEGER DEFAULT 0,
    like_count INTEGER DEFAULT 0,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- 相册表
CREATE TABLE albums (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    user_id UUID NOT NULL REFERENCES users(id),
    name VARCHAR(100) NOT NULL,
    description TEXT,
    is_public BOOLEAN DEFAULT true,
    share_code VARCHAR(20) UNIQUE,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- 评论表
CREATE TABLE comments (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    photo_id UUID NOT NULL REFERENCES photos(id),
    user_id UUID NOT NULL REFERENCES users(id),
    parent_id UUID REFERENCES comments(id),
    content TEXT NOT NULL,
    mentioned_users UUID[],
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

-- 关注表
CREATE TABLE follows (
    follower_id UUID NOT NULL REFERENCES users(id),
    following_id UUID NOT NULL REFERENCES users(id),
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    PRIMARY KEY (follower_id, following_id)
);

-- 高频查询索引
CREATE INDEX idx_photos_user_id ON photos(user_id);
CREATE INDEX idx_photos_album_id ON photos(album_id);
CREATE INDEX idx_photos_created_at ON photos(created_at DESC);
CREATE INDEX idx_comments_photo_id ON comments(photo_id);
CREATE INDEX idx_follows_follower ON follows(follower_id);
CREATE INDEX idx_follows_following ON follows(following_id);

# 技术方案文档

## 1. 概述

### 背景
[项目背景和目标]

### 范围
- 功能范围
- 非功能范围
- 排除项

## 2. 技术方案

### 架构图
[架构图]

### 核心设计
[核心设计决策]

## 3. API 设计

### 接口列表
| 接口 | 描述 | 负责人 |
|------|------|--------|
| | | |

## 4. 数据库设计

### 表结构
[ER 图和表结构]

## 5. 存储设计

### 文件存储
[OSS 配置、目录结构]

### 缓存策略
[Redis 缓存设计]

## 6. 安全设计

### 认证授权
[JWT、权限控制]

### 数据安全
[加密、脱敏]

## 7. 性能设计

### 容量预估
[并发、存储量预估]

### 缓存设计
[缓存策略]

## 8. 部署方案

### 基础设施
[云服务、配置]

## 9. 监控告警

### 监控指标
[关键指标]

## 10. 风险评估

| 风险 | 影响 | 应对措施 |
|------|------|----------|
| | | |