ポートフォリオ用の仕様書・API契約・設計メモを管理するリポジトリです。 複数のアプリや関連サービスの仕様を、実装リポジトリから参照しやすい形で保管します。
ポートフォリオリポジトリのため外部 PR、一般的なサポート依頼、機能要望、通常のバグ報告は受け付けません。Issue は公開リポジトリ運用上の衛生報告のために限定的に有効化します。
このリポジトリに含まれる医薬品・疾患・臨床計算ツール関連の仕様は、架空データを扱うサンプルアプリ向けの設計資料です。該当する仕様は、医療判断・診断・処方・服薬判断その他のいかなる医療行為にも一切用いないでください。
Some specifications in this repository describe FICTIONAL drug, disease, and clinical-calculation sample data. They are NOT medical advice and MUST NOT be used for diagnosis, treatment, prescribing, or any other medical decision.
- 仕様書を実装から分離 — アプリや関連サービスから参照する仕様・設計メモを独立管理
- アプリ単位で仕様を整理 — プロジェクトごとにディレクトリを分け、画面仕様、データモデル、API 契約、永続化スキーマを配置
- 契約ファイルを同梱 — OpenAPI など、実装側が参照する machine-readable な契約も必要に応じて保管
- ポートフォリオ向けの短い説明構成 — README は参照実装リポジトリと同じ流れで、初見でも役割が分かる構成に統一
仕様はアプリまたはサービス単位のディレクトリにまとめます。README では個別ファイルを列挙せず、各ディレクトリを仕様セットの入口として扱います。
現在は fictional-drug-and-disease-ref/ に、架空医薬品・疾患リファレンスアプリと連携 mock-server の仕様を配置しています。この配下には、画面仕様、データモデル、DB スキーマ、fixture 設計、OpenAPI 契約が含まれます。
今後別アプリの仕様を追加する場合も、同じ粒度でディレクトリを追加し、README は代表的な仕様領域と運用方針だけを説明します。
- fictional-drug-and-disease-ref-flutter — Flutter 参考実装
- fictional-drug-and-disease-ref-mock-server — Ktor mock-server
- resume-flutter — ポートフォリオ履歴書
このリポジトリは仕様書中心のため、アプリケーションの build step はありません。
JSON を変更した場合は、対象ファイルを parser で確認してください。
python3 -m json.tool fictional-drug-and-disease-ref/openapi.json >/dev/null- 外部からの Pull Request はレビュー対象外です。
- 一般的なサポート・機能要望・通常のバグ報告は GitHub Issues では受け付けていません。
- 公開 Issue は repository hygiene report のみに限定し、秘密情報・個人情報・脆弱性詳細を投稿しない導線にしています。
- GitHub Actions と workflow 依存の更新は selected actions と SHA pinning を維持したまま手動レビューで適用します。
- セキュリティ報告は SECURITY.md の手順に従ってください。
本プロジェクトは MIT License で公開しています。