Claude Code Plan Mode 워크플로우, 설계 계획 수립, 활용 팁

# 주로 사용하는 탐색 도구들
- Glob: 파일 패턴 검색
- Grep: 코드 내용 검색
- Read: 파일 읽기

# 인증 관련 기존 코드 확인
- Glob로 auth 관련 파일 찾기: **/auth*.js, **/user*.js
- Grep으로 session 관련 코드 검색
- Read로 주요 파일 내용 확인

## 사용자 인증 시스템 설계 계획

### 파일 구조
- src/auth/authenticate.js (새 파일) - 인증 로직
- src/auth/middleware.js (새 파일) - Express 미들웨어
- src/models/User.js (수정) - 비밀번호 해싱 메서드 추가
- src/routes/auth.js (새 파일) - 로그인/로그아웃 라우트

### 주요 설계 결정
1. bcrypt를 사용한 비밀번호 해싱
2. JWT 토큰 기반 세션 관리
3. 기존 User 모델 확장 (재작성 불필요)

### 구현 순서
1. User 모델에 comparePassword 메서드 추가
2. authenticate.js에 로그인 로직 구현
3. 미들웨어로 보호된 라우트 처리
4. 라우트 통합 및 테스트

// 1. 기존 User 모델 확인 (Glob + Read)
// src/models/User.js
const mongoose = require('mongoose');

const userSchema = new mongoose.Schema({
  email: { type: String, required: true, unique: true },
  username: { type: String, required: true },
  passwordHash: String,
  createdAt: { type: Date, default: Date.now }
});

module.exports = mongoose.model('User', userSchema);

// 2. Express 앱 구조 확인 (Grep "app.use")
// src/app.js에서 라우트 구조 파악

## 인증 시스템 구현 계획

### 새로운 의존성
- jsonwebtoken (JWT 생성/검증)
- bcrypt (비밀번호 해싱)

### 파일 변경사항

1. src/models/User.js (수정)
   - comparePassword 인스턴스 메서드 추가
   - hashPassword pre-save 훅 추가

2. src/middleware/auth.js (새 파일)
   - authenticateToken 미들웨어 구현

3. src/routes/auth.js (새 파일)
   - POST /auth/login
   - POST /auth/logout

4. src/app.js (수정)
   - auth 라우트 연결

### 보안 고려사항
- JWT secret은 환경변수로 관리
- 비밀번호는 bcrypt로 해싱 (saltRounds: 10)
- 토큰 만료 시간: 24시간

// src/models/User.js (수정)
const bcrypt = require('bcrypt');

userSchema.methods.comparePassword = async function(candidatePassword) {
  return bcrypt.compare(candidatePassword, this.passwordHash);
};

userSchema.pre('save', async function(next) {
  if (!this.isModified('passwordHash')) return next();
  this.passwordHash = await bcrypt.hash(this.passwordHash, 10);
  next();
});

// src/middleware/auth.js (새 파일)
const jwt = require('jsonwebtoken');

function authenticateToken(req, res, next) {
  const authHeader = req.headers['authorization'];
  const token = authHeader && authHeader.split(' ')[1];

  if (!token) return res.sendStatus(401);

  jwt.verify(token, process.env.JWT_SECRET, (err, user) => {
    if (err) return res.sendStatus(403);
    req.user = user;
    next();
  });
}

module.exports = { authenticateToken };

// src/routes/auth.js (새 파일)
const express = require('express');
const jwt = require('jsonwebtoken');
const User = require('../models/User');

const router = express.Router();

router.post('/login', async (req, res, next) => {
  try {
    const { email, password } = req.body;
    const user = await User.findOne({ email });

    if (!user || !(await user.comparePassword(password))) {
      return res.status(401).json({ error: 'Invalid credentials' });
    }

    const token = jwt.sign(
      { userId: user._id, email: user.email },
      process.env.JWT_SECRET,
      { expiresIn: '24h' }
    );

    res.json({ token, user: { id: user._id, email: user.email } });
  } catch (error) {
    next(error);
  }
});

module.exports = router;