추적성 시스템 완전 가이드¶

# tests/test_auth.py

# @TEST:SPEC-001:login_success
def test_login_success():
    user = login("user@example.com", "pass123")
    assert user is not None

# @TEST:SPEC-001:register_success
def test_register_success():
    user = register("new@example.com", "pass123")
    assert user.email == "new@example.com"

# @TEST:SPEC-001:password_reset_success
def test_password_reset():
    token = request_reset("user@example.com")
    assert token is not None

# src/auth.py

# @CODE:SPEC-001:login
def login(email, password):
    """@TEST:SPEC-001:login_success 테스트 대상"""
    user = User.query.filter_by(email=email).first()
    if user and user.verify_password(password):
        return user
    return None

# @CODE:SPEC-001:register
def register(email, password):
    """@TEST:SPEC-001:register_success 테스트 대상"""
    if User.query.filter_by(email=email).first():
        return None
    user = User(email=email)
    user.set_password(password)
    db.session.add(user)
    db.session.commit()
    return user

# @CODE:SPEC-001:password_reset
def request_password_reset(email):
    """@TEST:SPEC-001:password_reset_success 테스트 대상"""
    user = User.query.filter_by(email=email).first()
    if user:
        token = generate_reset_token(user)
        return token
    return None

# ❌ 문제: SPEC이 없는 TAG
@CODE:SPEC-999:orphan_function
def some_function():
    pass

# 해결: SPEC-999 생성 또는 TAG 제거

# ❌ 문제: TEST와 CODE는 있지만 DOC 없음
@TEST:SPEC-001:test
def test_feature():
    pass

@CODE:SPEC-001:feature
def feature():
    pass

# 해결: @DOC:SPEC-001 생성

# ❌ 문제: 같은 TAG가 여러 파일에 있음
# file1.py:
@CODE:SPEC-001:register

# file2.py:
@CODE:SPEC-001:register  # 중복!

# 해결: 태그 이름 변경 또는 통합