BUYO MVP
임상 진입 전 사업성 진단. 2026년 10월 13일 발표용.
0. 이 폴더에 뭐가 들었나
buyo/
├─ db/schema.sql 테이블 3개 (chunks · records · runs)
├─ lib/
│ ├─ types.ts 청크 스키마 + 검사 규칙 V-00~V-10
│ └─ store.ts DB 접근은 전부 여기만 거침
├─ scripts/
│ ├─ load.ts 청크 1,746개 적재
│ └─ check-case-a.ts 첫날 목표 확인
├─ data/chunks/*.jsonl 카드 1,746개 ← 이미 들어 있음
├─ design/시안-B.html 화면 시안 (그대로 열어 보면 됨)
└─ reference/ 파이썬 원본·규칙 yaml·원본 CSV (읽기용, 실행 안 함)
1. 처음 한 번만
① 패키지 설치
cd buyo
npm install
② Supabase 프로젝트 만들기
- supabase.com 가입 → New project
- 만들어지면 SQL Editor 열기
db/schema.sql 내용을 통째로 붙여넣고 Run
③ 접속 정보 넣기
.env.example을 복사해 .env.local로 만들고 채웁니다.
cp .env.example .env.local
Supabase 대시보드 → Project Settings → API 에서 두 개를 복사합니다.
SUPABASE_URL=https://xxxx.supabase.co ← Project URL
SUPABASE_SERVICE_KEY=eyJhbGci... ← service_role key (secret)
⚠️ service_role 키는 절대 화면 코드에 넣지 마세요. 서버에서만 씁니다.
2. 카드 적재
npm run db:load
이렇게 나오면 성공입니다.
읽음 C_chunks_v1.jsonl 285건
읽음 F04_chunks_v0.jsonl 241건
...
총 1746건 · 검사 지적 0건
적재 중…
500 / 1746
1000 / 1746
1500 / 1746
1746 / 1746
✅ 적재 완료 — chunks 1746건
3. 첫날 목표 확인
npm run db:check
케이스 A(에이비엘바이오 ABL503) 조건으로 카드를 꺼내서,
C01 세 행이 나오는지 확인합니다.
카드 총 1746건 ✅
mapping 1050 · parameter 490 · rule 133 · method 73
━ 목표 카드 3개 ━
✅ C01-0092 54.7% P1→P2 modality=antibody_mAb
✅ C01-0096 12.1% P1→approved modality=antibody_mAb
✅ C01-0012 5.3% P1→approved ind=항암
━ 판정 ━
✅ 목표 카드 3개가 모두 조회됩니다. 첫날 목표 달성.
여기까지 되면 나머지는 같은 패턴의 반복입니다.
4. 다음 순서
| 스프린트 | 기간 | 만드는 것 | 끝났다는 증거 |
|---|
S0 적재 | 9/25~26 | 테이블 + 적재 | 1,746건 ✅ |
| S1 조회·정규화 | 9/27~28 | lib/normalize.ts · 우선순위 정렬 | 케이스 A → 54.7 / 12.1 / 5.3 순서대로 |
| S2 계산 엔진 | 9/29~30 | lib/engines/ 12개 | 런웨이 11.4개월 · RCR 0.15 · 최소 600만 달러 |
| S3 수집 | 10/1 | ctgov · dart · kipris | 임상 42건 이상 |
| S4 조립·API | 10/2~3 | lib/assemble.ts · app/api/diagnose | 명세 문장과 일치 |
| S5 화면·마감 | 10/5~8 | 시안 B를 컴포넌트로 | 새 환경에서 README만으로 실행 |
5. 꼭 지킬 규칙 다섯
- 문장을 지어내지 않는다. 화면에 나가는 글은 청크
text 그대로이거나, 미리 정한 문장 틀에 엔진 숫자를 끼운 것. 둘 중 하나뿐.
- 엔진 코드에 숫자 상수를 쓰지 않는다. 값은 전부 청크 ID로 꺼낸다. 꺼낸 ID는
basis_chunks에 남긴다.
- 재료가 없으면 계산하지 않는다. 0이나 평균으로 채우지 않고
status=partial 또는 no_evidence.
- DB 접근은
lib/store.ts만 거친다. 화면에서 supabase를 직접 부르지 않는다.
- 시연 3건은 파일로도 내장한다. 발표장 네트워크가 끊겨도 돌아가야 한다.
6. 알려진 함정
DART 고유번호 앞의 0이 날아가 있습니다
reference/source-data/ref/companies_v2_0.csv의 DART고유번호가
엑셀을 거치며 앞자리 0을 잃었습니다. 508사 전부입니다.
에이비엘바이오 "1256864" ← 7자리 (잘못)
정답 "01256864" ← 8자리
읽을 때 반드시 8자리로 채우세요.
const corpCode = String(row.DART고유번호).padStart(8, "0");
화면 모달리티 목록을 T01 등록부에 맞추세요
lib/types.ts의 MODALITIES가 T01 등록부 22개 기준입니다.
시안 B의 12종 목록과 다릅니다. 화면을 만들 때 이쪽으로 맞춰야 합니다.
antibody_bispecific → 값 미확보. antibody_mAb 값 + 배지cell_therapy → 하위 태그 선택 요청- TPD · RNA · 방사성 · 톡신 →
other. 값 없음
재무 갭은 자동 계산하지 않습니다
F01-10 규칙: MVP는 자동 갭(원화) 계산 없음.
필요 자금은 원문 통화로 표시하고, 아래 문구를 답니다.
"필요 자금은 원문 통화로 표시되며 원화 환산·갭 계산은 정식 버전에서 제공됩니다"
7. 아직 못 받은 것
전부 10월 1일 수집일에 필요합니다.
8. 기술 스택
화면 + API + 엔진 Next.js (TypeScript)
DB Supabase (Postgres)
시연 3건 백업 앱에 JSON 파일 내장
파이썬 reference/ 에 읽기용으로만. 실행하지 않음
도커 사용 안 함
설계서 v4는 파이썬 파일명으로 적혀 있습니다. 하는 일과 순서는 같고 확장자만 다릅니다.
| 설계서 | 이 프로젝트 |
|---|
db/load.py | scripts/load.ts |
db/query.py | lib/store.ts |
engines/*.py | lib/engines/*.ts |
api/main.py | app/api/diagnose/route.ts |
| Streamlit 화면 | app/ (시안 B) |
