cave87/medical-agent

docker compose up -d --build
# 메인:                            http://localhost:8501
# Lovable 양식 (Sapphire Glass):  http://localhost:8501/lovable_home
# 프로젝트 워크스페이스:           http://localhost:8501/project_workspace
# 로그: docker compose logs -f

ANTHROPIC_API_KEY=sk-ant-...
OPENAI_API_KEY=sk-proj-...
GOOGLE_API_KEY=AIzaSy...   # Gemini (무료 폴백)

┌─────────────────────────────────────────────────────────────┐
│  UI Layer        app/streamlit_app.py                       │
│                  ↳ 논문 작업실 · 통계 코드 · 인용/레퍼런스   │
├─────────────────────────────────────────────────────────────┤
│  Tool Registry   src/tools/__init__.py                      │
│                  ↳ TOOLS dict + render_result(st.dialog)    │
├─────────────────────────────────────────────────────────────┤
│  Domain Logic    src/data/      ↳ KYRBS/KNHANES loader      │
│                  src/research/  ↳ paper_writer, peer review │
│                  src/export/    ↳ figure/table/citation     │
│                  src/llm/       ↳ failover client + budget  │
├─────────────────────────────────────────────────────────────┤
│  Runtime Layer   src/runtime/   ↳ events/tasks/idempotency/ │
│                                   heartbeat (SQLite WAL)    │
│                  src/memory/    ↳ router/scorer/lifecycle/  │
│                                   gate/conversation         │
├─────────────────────────────────────────────────────────────┤
│  Persistence     data/raw/      ↳ KYRBS 2005~2025 .sav      │
│                  data/runtime/  ↳ events.db/tasks.db/...    │
│                  data/exports/  ↳ Figure*.png/.docx/.xml    │
│                  data/chromadb/ ↳ 10k+ paper chunks (RAG)   │
├─────────────────────────────────────────────────────────────┤
│  MCP Server      mcp_server.py — Claude Desktop·외부 agent  │
│                  공통 backend (memory/task/events/budget)   │
└─────────────────────────────────────────────────────────────┘

# 1. 실 KYRBS 2025 → 모든 분석 데이터 계산
docker compose exec learner python scripts/compute_all_figure_data.py

# 2. 4 figure 생성 (Stata v2.4 캐노니컬 매칭)
docker compose exec learner python scripts/build_paper_figures.py

# 3. EndNote CWYW 필드 임베드 Word docx
docker compose exec learner python scripts/build_endnote_docx.py \
    data/exports/ZCB_paper_v2.4_FINAL.md ZCB_paper_endnote

python mcp_server.py --port 8765

{
  "mcpServers": {
    "medical-agent": {
      "url": "http://localhost:8765/mcp",
      "headers": { "Authorization": "Bearer ma-YOUR_API_KEY" }
    }
  }
}

from src.export.word_exporter import WordExporter
WordExporter().export(
    topic={"title": "...", "authors": [...], "affiliations": [...]},
    sections={"Abstract": {"Background": "...", "Methods": "...", ...},
              "Introduction": "...", "Methods": {...subsection...}, ...},
    keywords=["zero-calorie beverage", "depression", ...],
    figures=[{"bytes": ..., "caption": "...", "n": 1}, ...],
    tables=[{"type": "baseline", "data": [...], "caption": "...", "n": 1}],
    references=[{"authors": "...", "title": "...", "journal": "...",
                 "year": "2025", "volume": "385", "pages": "445-449"}],
    back_matter={"Ethics approval": "...", "Funding": "...", ...},
)

python scripts/auto_sync.py
# 또는 Windows hidden: wscript scripts/run_sync_hidden.vbs

.
├── app/                    Streamlit UI + Sapphire Glass theme
│   ├── pages/              ez_home·project_workspace·backlog·dashboard·memory_explorer
│   ├── styles/             sapphire_glass (Lovable-style 글래스모피즘)
│   ├── agentic_loop.py     23 tools agentic loop
│   ├── sapphire_actions.py 부가기능 모달 (10 actions)
│   └── streamlit_app.py
├── src/
│   ├── data/               KYRBS/KNHANES loader, StatBridge
│   ├── research/           paper_writer, peer_reviewer, pipeline
│   ├── export/             figure_builder, citation_workflow, table_builder
│   ├── llm/                failover client (Claude/OpenAI/Gemini), budget
│   ├── memory/             router, scorer, lifecycle, gate, conversation
│   ├── runtime/            events, tasks, idempotency, heartbeat
│   ├── tools/              TOOLS registry + render_result
│   ├── agent/              persona, MedicalAgent
│   ├── knowledge/          medical_seed, trend_learner, research_wiki
│   ├── rag/                ChromaDB pipeline
│   └── config/             models, env, logging
│   ├── library/            ComponentLibrary (CONTENT/STYLE kinds) + extractor v2
│   ├── ingestion/          OA bulk fetcher (Europe PMC) + hierarchical chunker
│   ├── safety/             7-gate (citation_grounding/truth_hierarchy/physician_review/
│   │                        audit_trail/consistency/causal/figure_validator)
│   └── diagnostics/        capability_bench + longitudinal_eval + prompt_ab + self_consistency
├── prompts/                medical_core / safety_constraints / yoosun_style (versioned md)
├── scripts/
│   ├── test_rag_smoke.py   ① 임포트 + RAG · audit_wiring.py · e2e_diagnose.py
│   ├── eval_benchmark.py   5축 metric (memory/hallucination/stat/figure/citation)
│   ├── replay_task.py      events 시간순 재구성
│   ├── bootstrap_oa_learning.py  180 시드 query (5만편 cover 가능)
│   ├── rebuild_components.py     기존 12K paper 재추출 (정규식 v2)
│   ├── enrich_assets.py    ontology mapping + citation graph + seed enrichment
│   └── auto_sync.py        v3 commit-first 데몬
├── data/
│   ├── raw/                KYRBS/KNHANES .sav (gitignore)
│   ├── runtime/            SQLite (events/tasks/idempotency/lifecycle/procedural/notifications)
│   ├── oa_papers/          12K+ Europe PMC OA 풀텍스트 + manifest
│   ├── library/            components.db (131K+ reusable microcomponent)
│   ├── exports/            논문 산출물 (zcb_dep_v5 양식)
│   ├── chromadb/           RAG 벡터 인덱스 (20K+ chunks)
│   ├── knowledge_graph/    medical_graph.json (19K+ nodes)
│   ├── templates/          manuscript_template.json (단일 진실원본)
│   ├── agent_self/         persona, insights, change_log
│   └── author_profiles/    yoosun_cho + oa_curated_top{N} (auto)
├── mcp_server.py           MCP backend (30+ tools 공통)
├── docker-compose.yml      medical-agent + learner + sapphire-ui
├── AGENTS.md               에이전트 책임 맵 + EstreGenesis pace_mode
├── ARCHITECTURE.md         14 sections 모듈 레지스트리 (★새 모듈 전 필독)
├── DESIGN.md               디자인 토큰 + Sapphire Glass v2
└── CLAUDE.md               작업 표준 12 규칙 + 단일 코어 공유 원칙