품아이 전체 지도

2026-04-13 정리

📌 이 다이어그램은 4/13 시점 (비로그인 챗창 흐름). 4/14 4차 전환 이후 코어 3명은 Claude Code CLI 직결로 분기. 현행 챗창 구조는 poomasi.org 팩트시트 섹션 4-5 참조.

흐름

고객이 말을 건다
    ↓
[홈페이지 poomasi.org] ← Cloudflare + GitHub Pages
    ↓ 챗 위젯 (poomai-widget.js)
[GCP 서버] ← 품아이가 사는 집
    ├── seed_server.py  ← 고객 말 받는 문
    ├── engine.py       ← 품아이의 뇌 (여기서 판단)
    ├── ChromaDB        ← 품아이의 기억 (문서/Q&A)
    └── Gemini API 호출 ← 품아이의 말하기 능력
            ↑
    [Supabase] ← 품아이의 장부 (매출, 상품, 조합원)
            ↑
    [넷포스 POS] ← 매장에서 실제 팔린 데이터

각 공간의 역할

공간	비유	하는 일
GCP	품아이가 사는 집	서버, 코드 실행, 봇 가동
Supabase	장부 캐비닛	매출, 상품, 조합원 정보 저장
ChromaDB	기억 서랍	”이런 질문엔 이렇게 답해” Q&A
Gemini	말하기 능력	기억을 바탕으로 문장을 만드는 힘
홈페이지	가게 앞 간판	고객이 들어오는 입구
GitHub	설계도 보관소	코드 버전 관리, 배포 원본
Colab	훈련소	파인튜닝할 때 GPU 빌려서 훈련
Cloudflare	우체국/도로	도메인 연결, 트래픽 전달

핵심 관계

• 고객 → 홈페이지 → GCP → (ChromaDB에서 기억 찾고 + Supabase에서 데이터 찾고) → Gemini로 답변 생성 → 고객에게 전달
• Colab은 평소 안 씀. 품아이를 더 똑똑하게 만들 때만 (파인튜닝) 사용
• GitHub은 코드를 안전하게 보관하는 곳. 홈페이지 배포 원본이기도 함

연결

• 모델은 부품, 데이터가 본체 — Gemini(말하기 능력)는 부품, Supabase·ChromaDB(데이터)가 본체
• 품아이 4차 전환 — 지미가 곧 품아이 — 4차 이후 현행 몸: 지미(Claude)+Gemini(비로그인 보조)+데이터셋+하네스 하이브리드
• 품아이는 Gemini와 한 몸 — 초기 몸 정의 (2.5차, 히스토리)
• ChromaDB SEGV 복구 — 기억 서랍이 깨졌을 때의 경험
• 대량 DB 업데이트 — 장부 캐비닛에 데이터 넣는 법
• 사교원 — sakyowon.poomasi.org 품아이 연동 (site_map + ChromaDB Q&A 8건, 2026-04-16)
• poomasi.org 팩트시트 — 상위 프로젝트 정체성