🎯🔒
전제는 자료 종류에 따라 공개 범위가 달라야 한다는 것이었다
도시계획 실기 카드는 누구나 봐야 하지만, HIERO 내부 조직 용어가 섞인 카드는 공개되면 안 된다. 그래서 폴더를 스캔하는 단계에 종류별 분류(층 배정)와 비공개 판정(키워드 필터)을 같이 넣었다.
🔍⚠️
근거 — 실제로 오탐 사고가 났었다
카드 템플릿의 JS 주석에 특정 담당자 이름이 그대로 들어간 적이 있었다. 비공개 필터가 카드 본문뿐 아니라 코드 주석까지 훑고 있어서, 그 이름 하나 때문에 정상적인 도시계획 카드 여러 장이 잘못 비공개로 묶였다. 필터를 '보이는 글만·좁은 범위만' 보게 고쳐 해결했다.
📊🔁
지금 — 층 배정 기준도 계속 바뀌고 있다
처음엔 도시계획 관련 키워드가 있으면 1층, 없으면 2층으로 단순하게 나눴다. 그런데 AI·기술 카드가 늘면서 이 기준만으로는 부족해졌고, 실기 자료(1층)와 기술 자료(2층)를 별도 키워드 목록으로 관리하는 방식으로 다시 나눴다. 한계: 이 분류가 완벽하지 않아, 새 카드가 추가될 때마다 목록을 계속 다듬어야 한다.
한 줄로:
이 기록은 공개 범위를 폴더 스캔 단계에 같이 넣은 이유, 실제로 났던 오탐 사고, 아직도 계속 다듬어지고 있는 분류 기준까지 남긴 구현 기록이다.
출처: urbanplan-ai/site/build_site.mjs 실제 동작 및 개정 이력 (2026-09-05)