강의 계획 레슨 250개 중 221번째 · 프로젝트: 문서 인텔리전스 서비스
프로젝트: 문서 인텔리전스 서비스

업무 규칙으로 대조하기

기록이 완벽하게 모양을 갖추고도 틀릴 수 있어요. 항목은 합쳐서 $118인데 적힌 합계는 $128이에요. 날짜가 2026-13-40이에요. 합계가 음수예요. 스키마 검증은 이 중 아무것도 잡지 못해요 -> 이건 업무 규칙 위반이고, 그것을 잡는 게 장난감과 회계 팀이 실제로 믿을 서비스를 가르는 거예요.

reconcile(record)를 쓰세요 -> 불일치 문자열의 리스트. 빈 리스트는 기록이 깔끔하게 대조된다는 뜻이에요. 실패한 규칙마다 사람이 읽을 수 있는 문자열 하나를 더해요. 규칙 세 개:

  • 항목의 합은 total이어야 해요(1센트 안). line_items의 모든 항목의 amount를 더해 total과 비교해요. 0.01보다 많이 다르면 "total mismatch: items sum to X but total is Y"를 덧붙여요(메시지에서 둘 다 소수점 2자리로 반올림). float는 부정확하니 언제나 ==가 아니라 허용치로 비교하세요.
  • 날짜는 파싱되어야 해요, YYYY-MM-DD 형태의 진짜 달력 날짜로. try/except ValueError 안에서 datetime.strptime(record["date"], "%Y-%m-%d")를 쓰고, 실패하면 "bad date: <value>"를 덧붙여요. (strptime이 13월 같은 불가능한 날짜를 알아서 거부해요.)
  • total은 양수여야 해요. total <= 0이면 "non-positive total: <value>"를 덧붙여요.

테스트에는 순서가 중요해요: 먼저 합, 그다음 날짜, 그다음 total의 부호를 확인하고 그 순서로 덧붙여서, 여러 규칙을 어긴 기록이 예측 가능하게 나열되게 하세요.

from datetime import datetime

def reconcile(record):
    issues = []
    items_sum = sum(it["amount"] for it in record["line_items"])
    if abs(items_sum - record["total"]) > 0.01:
        issues.append(...)
    # then the date, then the sign
    return issues

이게 모든 송장, 경비, 원장 시스템이 감히 행을 쓰기 전에 돌리는 대조 단계예요. Run을 눌러 깨끗한 기록과 망가진 기록을 대조하고 불일치가 줄지어 나오는 걸 보세요.

내 차례

line_items(각각 {"desc", "amount"}), total, date가 있는 기록에 대해 불일치 문자열의 리스트를 돌려주는 reconcile(record)를 쓰세요. 이 순서로 덧붙이세요: 항목의 합이 1센트 안에서 total이 아니면 "total mismatch: items sum to X but total is Y" 문자열(값은 소수점 2자리 반올림), 날짜가 진짜 YYYY-MM-DD 날짜가 아니면 "bad date: <value>" 문자열, total <= 0이면 "non-positive total: <value>" 문자열. 깨끗한 기록은 []를 돌려줘요.

이 레슨에서 문제를 발견했나요? 알려 주세요 · 이 레슨에 대해 묻기

이 연습은 곧 열려요

앞의 레슨을 마치면 이 레슨이 열려요. 강좌 전체가 무료이고 계정도 필요 없으며, 이 레슨은 지금 바로 읽을 수 있어요.