Mina Choi
6784e59ca5
git 저장소가 없어 히스토리·협업 기반이 아예 없던 상태를 연다.
함께 문서를 재편했다. 그동안 문서가 있어도 "이 제품이 뭘 푸는가"와
"어떻게 도는가"를 담은 문서가 없어서, 목표 문장이 backend/frontend
README 두 곳에 복붙돼 있었다 — 상위 문서가 없어 아래로 샌 것이다.
신설
README.md 레포 진입점 + 문서 지도 + 문서 규칙 4가지
AGENTS.md 에이전트·신규 합류자용 함정 목록과 규약
(CLAUDE.md 는 여기로 걸린 심볼릭 링크)
docs/PRODUCT.md 제품 정의 — 문제·사용자·원칙·**non-goals**·성공 기준
docs/ARCHITECTURE.md payload 경계·발행 파이프라인·서빙 결정·앱 분리 설계
이동
backend/docs/DECISIONS.md → docs/DECISIONS.md
백엔드만의 결정이 아니다. 게다가 코드 주석 ~25곳이 이미
`docs/DECISIONS.md` 로 적고 있어 레포 루트 기준으로는 그게 맞다.
갱신
docs/DEPLOY.md 서빙 결정 반영 — nginx 정적 서빙이 지금 경로(3절),
Azure 는 나중에 켤 때(4절)로 분리
docs/ARCHITECTURE.md 사이트 = 한 장(2026-08-31) 구조 반영
docs/COLLECTION_SEO_AEO_FLOW.md
robots.txt·sitemap.xml 은 오리진 루트에만 굽는다는 점 명시
frontend/site/scripts/prerender.ts
헤더 주석의 렌더 보고서 경로가 실제(422줄)와 달라 수정
.gitignore
★ CLAUDE.md 를 더 이상 무시하지 않는다. 에이전트 지침은 팀과 모든
에이전트가 공유하는 규약이라 커밋해야 한다 — 무시하면 클론한 사람이
"배포 후 republish_all.py 필수" 같은 함정을 전달받지 못한다.
개인용 오버라이드는 ~/.claude/CLAUDE.md 에 둔다.
79 lines
3.9 KiB
Python
79 lines
3.9 KiB
Python
"""업종 스키마 — 4개 업종 파일이 규약대로 로드되는지.
|
|
|
|
업종 추가 = resources/ 에 JSON 1개 + PlaceCategory 코드 1줄. 이 테스트는 그 규약이 깨지면 잡는다.
|
|
"""
|
|
import pytest
|
|
|
|
from common.category_schema import CategorySchemaError, all_schemas, get_schema, is_valid_key
|
|
from common.enums import PlaceCategory
|
|
|
|
|
|
def test_all_categories_have_schema():
|
|
"""검증: PlaceCategory 의 모든 업종에 스키마 파일이 있는지.
|
|
기대결과: 4개 업종(숙박·카페·음식점·관광체험)이 모두 로드되고 code 가 1:1로 맞는다."""
|
|
schemas = all_schemas()
|
|
assert set(schemas) == {c.value for c in PlaceCategory}
|
|
for code, schema in schemas.items():
|
|
assert schema.code == code
|
|
assert schema.category == PlaceCategory(code)
|
|
assert schema.fields, f"{schema.name}: 필드가 비었다"
|
|
|
|
|
|
def test_keys_unique_within_category():
|
|
"""검증: 업종 안에서 fact key 가 유일한지.
|
|
기대결과: 중복 없음 (facts 의 (place,unit,key) 유니크가 의미를 가지려면 필수)."""
|
|
for schema in all_schemas().values():
|
|
keys = list(schema.fields)
|
|
assert len(keys) == len(set(keys)), f"{schema.name}: key 중복"
|
|
|
|
|
|
def test_place_and_unit_scopes_exist():
|
|
"""검증: 업종마다 place 스코프 필드가 있는지.
|
|
기대결과: 전 업종에 place 필드 존재. unit 필드는 업종별로 있을 수도 없을 수도 있다."""
|
|
for schema in all_schemas().values():
|
|
assert schema.keys_by_scope("place"), f"{schema.name}: place 스코프 필드가 없다"
|
|
|
|
|
|
def test_lodging_has_claim_critical_fields():
|
|
"""검증: 숙박 업종에 예약 클레임 직결 항목이 critical 로 잡혀 있는지.
|
|
기대결과: 체크인·체크아웃·취사·반려동물·취소규정이 모두 critical=True 이고 LLM 이 못 쓴다."""
|
|
schema = get_schema(PlaceCategory.LODGING)
|
|
for key in ("check_in_time", "check_out_time", "cooking_allowed", "pet_allowed", "cancel_policy"):
|
|
spec = schema.get(key)
|
|
assert spec is not None, f"숙박 스키마에 {key} 가 없다"
|
|
assert spec.critical is True, f"{key} 는 critical 이어야 한다"
|
|
assert spec.allow_llm is False, f"{key} 는 LLM 이 값을 만들면 안 된다"
|
|
|
|
|
|
def test_llm_writable_fields_are_sentences_only():
|
|
"""검증: LLM 이 값을 만들 수 있는 필드가 '문장' 필드뿐인지 (절대규칙 7 — LLM 은 사실을 만들지 않는다).
|
|
기대결과: allow_llm=True 인 필드는 전부 type=text 이고 critical 이 아니다."""
|
|
for schema in all_schemas().values():
|
|
for key in schema.llm_writable_keys():
|
|
spec = schema.get(key)
|
|
assert spec.type == "text", f"{schema.name}.{key}: LLM 이 쓸 수 있는 필드는 text 여야 한다"
|
|
assert spec.critical is False, f"{schema.name}.{key}: critical 필드를 LLM 이 쓰면 안 된다"
|
|
|
|
|
|
def test_required_fields_are_never_llm_written():
|
|
"""검증: 발행 필수 항목을 LLM 이 채우지 못하는지.
|
|
기대결과: required=True 인 필드는 전부 allow_llm=False."""
|
|
for schema in all_schemas().values():
|
|
for key in schema.required_keys():
|
|
assert schema.get(key).allow_llm is False, f"{schema.name}.{key}: 필수 항목을 LLM 이 채우면 안 된다"
|
|
|
|
|
|
def test_is_valid_key_rejects_cross_category_key():
|
|
"""검증: 업종에 없는 key 를 걸러내는지 (facts 쓰기 전 FACT_INVALID_KEY 판정).
|
|
기대결과: 숙박의 check_in_time 은 카페 스키마에서 거부된다."""
|
|
assert is_valid_key(PlaceCategory.LODGING, "check_in_time") is True
|
|
assert is_valid_key(PlaceCategory.CAFE, "check_in_time") is False
|
|
assert is_valid_key(PlaceCategory.CAFE, "break_time") is True
|
|
|
|
|
|
def test_unknown_category_raises():
|
|
"""검증: 지원하지 않는 업종 코드 조회.
|
|
기대결과: CategorySchemaError."""
|
|
with pytest.raises(CategorySchemaError):
|
|
get_schema(99)
|