allos

Allosは、個人・世帯・介護者向けに設計されたセルフホスト型の健康記録・トラッカー・コーチングアプリケーションです。名称はallostasis（身体的恒常性）に由来し、変化を通じた安定維持という身体の仕組みを表します。プロジェクトの目的は、 personal health information をサードパーティのサービスに分散させるのではなく、一つのプライベートなタイムラインに集約することです。データは運用者が所有するSQLiteデータベースに保存され、主な分析はバンドルされたデータセットに対してローカルで実行され、AI機能はオプションです。 追跡範囲 本アプリは、毎日の健康（症状、気分、睡眠、バイタル、身体測定、栄養、ウェルネス実践）、トレーニング（筋力、心臓血管、スポーツ、ルーチン、目標、回復コンテキスト）、医療歴（疾患、アレルギー、処置、予防接種、診察予約、ケアプラン、家族歴）、検査・書類（バイオマーカー、参考範囲、検診、PDF、レコードインポート）、そして薬剤・サプリメント（スケジュール、用量履歴、補充、服薬遵守、ローカルでの相互作用警告チェック）をカバーします。世帯サポートとしては、個別プロファイル、介護者アクセス、読み取り専用付与、クロスプロファイル表示が含まれ、各プロファイルにログインは必要ありません。データはHealth Connect、Strava、Oura、Fitbit出力、Withings、カレンダーフィード、FHIR/CCDベースのインポート（MyChartなど）から取得できます。リマインダーはTelegram、Web Push、Home Assistant、メール経由で配信可能で、すべてJSON、CSV、FHIR形式でエクスポートかアップロード対応です。 設計原則 READMEでは5つの原則が掲げられています：デフォルトはローカル志向で外部サービスはオプトイン、健康はスコアリングではなくステアリングとして提示され、単一の invented health score ではなく生の信号が表示される、知見は情報提供型で出典を引用し処方箋的でない、安全事項以外では落ち着いたトーンで、薬剤安全性のリマインダーは他の観察より慎重に扱う、ユーザー制御——手動修正は同期後に生き残り、優先順位はユーザー所有、データはエクスポート可能。 デプロイメント Docker Composeが推奨パスです。Webアプリと通知・バックアップ用の軽量スケジューラサービスが起動します。運用者はリポジトリをクローンし、.env.example を.envにコピーして、管理者パスワードとcheckout外の絶対パスDATA_DIRを設定します。最初の管理者パスワードは初回ログイン作成時のみ適用されます。stackは docker compose up -d --pull always で開始し、ポート3000でアクセスします。アップデートはGitHub Container Registryから公開イメージを取得し、IMAGE変数で特定のビルドを固定可能です。データベースマイグレーションは起動時に自動実行され、まずdata/backups/pre-migration にデータベースのコピーが作成され、コピー不能な場合はコンテナの起動が拒否されます。 ソースからの実行にはNode.js 24（.nvmrcでピン留め）とnpm、better-sqlite3 のネイティブビルド前提条件が必要です。npm ci と npm run dev で十分で、SQLiteデータベースは data/allos.db に作成されます。シードコマンドにより数週分の合成サンプルデータを読み込めますが、実際の記録を持つインスタンスで実行することはREADMEで警告されています。 人物とアクセス 管理者はSettingsのPeople & accessで、追跡対象者のプロファイル、サインイン用のログイン、選択したプロファイルへの读写または読み取り専用の付与を作成します。管理者は全プロファイルにアクセスできるため、ここではどのプロファイルのリマインダーを受け取るかを選択可能です。通知はプロファイルごとにオプトインです。 データ、バックアップ、プライバシー DATA_DIR内の永続状態にはallos.db、アップロードされた医療ファイル、ログ、検証済みバックアップ、およびpre-migrationコピーが含まれます。内蔵の夜間スナップショットはライブデータベースと同じボリュームを共有するため、READMEではBACKUP_DEST_DIRを第2マウント先として設定し、Settingsから検証することを推奨しています。スナップショットはアップロードファイルを含まず、off-volumeバックアップ機能で別途ミラーされます。オプションサービスには機能有効化に必要なデータのみの提供とし、Anthropic互換エンドポイントが構成可能で、AI_BASE_URLによるセルフホストも可能です。SMTPはログイン招待、パスワードリセット、オプトイン通知メールに使用され、デフォルトではコンテンツなしのため健康詳細がインボックスに届くことはありません。 技術とライセンス スタックはNext.js 16（App Router、Server Actions）、React 19、TypeScript、better-sqlite3経由のSQLite、Tailwind CSS、Recharts、オプションのAnthropic互換AIで構成されます。開発チェックにはフォーマット、lint、typecheck、ユニットテスト、別個のSQLite統合テスト、孤立したシードデータベースに対するPlaywrightエンドツーエンドテスト、本番ビルドが含まれます。貢献者はAGENTS.mdにてアーキテクチャ、データスコーピング、マイグレーション、テスト規範を参照できます。AllosはGNU Affero General Public License v3.0（AGPL-3.0-only）の下でライセンスされています。