Taiwan-Health-MCP: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Language

用台灣正體中文回答, 程式碼和註解使用英文

文件網站是雙語的 —— 改內容時兩份一起改

docs/ 底下的 MkDocs 網站（發佈於 GitHub Pages）為繁體中文 + 英文雙語。 每一頁都以兩個檔案存在：

檔案	語言	發佈路徑
docs/<path>/<page>.md	繁體中文（預設）	/<path>/<page>/
docs/<path>/<page>.en.md	英文	/en/<path>/<page>/

任何文件內容變更都必須同時套用到兩個檔案，並放在同一個 commit 裡。 只改一邊會讓兩種語言悄悄發散——mkdocs-static-i18n 的 fallback_to_default 會讓 缺漏的翻譯默默顯示中文版而不報錯，問題會被隱藏很久。

新增頁面時：一次建立 .md 與 .en.md，在 mkdocs.yml 的 nav 加入口， 並在 plugins.i18n 的 nav_translations 補上英文標題。

檢查漏翻：

comm -23 \
  <(find docs -name '*.md' ! -name '*.en.md' | sed 's/\.md$//' | sort) \
  <(find docs -name '*.en.md' | sed 's/\.en\.md$//' | sort)

（目前預期輸出：docs/datasets、docs/MinerU-vs-OpenAI、docs/ocr-test-setup —— 這三頁 不在 nav 內、無任何連結指向，尚未翻譯。其餘任何項目出現都代表漏翻。）

細節見 docs/WEBSITE.md。

Project Overview

Backend runtime — READ FIRST. The backend is 100% Node.js / TypeScript, under node-server/. There is no Python in the backend — src/*.py, loader/ and requirements.txt were deleted when the drug pipeline was ported in 2026-07. The only Python in the repository is services/ocr-indra/ — a separate, optional OCR container (Indra OCR on CPU, FastAPI) that the backend calls over HTTP like MinerU; it is not backend code and nothing in node-server/ imports or spawns it. Two compose services run from node-server/: app (node dist/server.js — MCP + admin REST) and admin-worker (node dist/admin/adminWorker.js — every job type, including the three drug stages). The admin front end is the web-v2 service (static Vite + React + Mantine SPA from web-v2/, served by its own nginx container). OCR is an HTTP service, never an in-process model: provider mineru (external MinerU, the default) or indra (the bundled ocr-indra container), with an optional fallback provider — admin → 外部服務 → OCR, adapters in node-server/src/ocrProviders.ts. Make backend changes in node-server/src/, admin UI changes in web-v2/src/.

The only remaining thing under src/ is src/prompts/ — the Analysis-LM system prompt, read at runtime by drugAnalysisService.ts. Do not delete it.

Dead files that look live — do not edit, do not "fix": root pyproject.toml, pytest.ini, requirements-dev.txt (Python-era leftovers; requirements-docs.txt is the live one — deploy-docs.yml installs from it, so any plugin enabled in mkdocs.yml must be listed there or the build fails), root admin-ui/ (old Vite SPA — the real admin UI is web-v2/), and config/datasets.yaml (read by no code). web/ (the Next.js admin incl. web/admin-app/) is legacy: replaced by web-v2/ on 2026-10-17, its compose service is in profile legacy-web (not started) and kept only for rollback — do not add features there.