Health Skillz

Health Skillz помогает пользователям собирать записи SMART on FHIR из пациентских порталов, просматривать и экспортировать их локально, а также опционально передавать их AI с использованием сквозного шифрования.

Документация

• Дизайн и архитектура: docs/design/DESIGN.md
• Заметки по окружению и эксплуатации: AGENTS.md

Данный README намеренно остаётся высокоуровневым. Контракты API, структуры данных, модель безопасности и детали протокола описаны в docs/design/DESIGN.md.

Попробовать сейчас

Рабочий экземпляр доступен по адресу health-skillz.joshuamandel.com.

1. Скачайте скилл: health-record-assistant.zip
2. Установите в Claude: Settings -> Skills -> Upload zip
3. Спросите: "Can you look at my health records?"

Тестовые учётные данные для песочницы Epic:

• Имя пользователя: fhircamila
• Пароль: epicepic1

Локальная разработка

Требования

• Bun
• Регистрация SMART on FHIR клиента (или sandbox client ID)

Быстрый старт

git clone https://github.com/jmandel/health-skillz
cd health-skillz

bun install
cp config.json.example config.local.json
# Отредактируйте config.local.json: укажите base URL и client ID

bun run setup
mkdir -p static data
ln -snf "$(pwd)/brands" static/brands

CONFIG_PATH=./config.local.json bun run dev

Проверка работоспособности:

Если используется другой порт, обновите URL соответственно.

Конфигурация (высокий уровень)

Сервер читает переменную CONFIG_PATH (по умолчанию ./config.json).

Минимальный набор полей, которые следует проверить в выбранном конфигурационном файле:

1. server.port
2. server.baseURL
3. brands[].clientId
4. brands[].redirectURL (или значение по умолчанию ${baseURL}/connect/callback)

Примеры запуска:

CONFIG_PATH=./config.local.json bun run dev
CONFIG_PATH=./config.local.json bun run start

Регистрация SMART App

Для Epic:

1. Зарегистрируйтесь на https://fhir.epic.com/Developer/Apps
2. Укажите redirect URI на ваш задеплоенный callback (обычно ${baseURL}/connect/callback)
3. Запросите скоупы, например patient/*.rs
4. Поместите выданный client ID в конфигурацию

Основные команды

bun run dev            # режим наблюдения за изменениями
bun run start          # локальный запуск в production-режиме
bun run build:brands   # загрузка и сборка ресурсов каталога провайдеров
bun run build:skill    # упаковка скилла в zip
bun run generate-jwks  # генерация JWKS-файлов
bun run setup          # brands + skill + jwks

Структура проекта (высокий уровень)

src/        Bun-сервер + React-клиент
skill/      Шаблоны скилла, скрипты, ссылки
scripts/    Скрипты сборки и обслуживания
docs/       Документация по дизайну и планированию
static/     Статические ресурсы (например, brands)
data/       Локальные runtime-данные (SQLite, сгенерированные файлы)

Лицензия

MIT