Fork: 0
hasegawa / SmTIAS-Capture
Transfer to URL with SHA Find file
Newer
Older
SmTIAS-Capture / CLAUDE.md
Monika Suzuki TIAS2301\user (Monika Suzuki) on 31 May 4 KB [update] プレビュー JPEG をライブプレビュースナップショットに切替
Raw Blame History

MiniTIAS

千葉大学 TIAS（舌画像撮影・解析システム）のスマートフォン版．Flutter で開発し，初期は撮影・保存に特化する．

開発進捗

最新: プレビュー JPEG をライブビュー（自動 ISP）スナップショットに切替 ※ 本欄は最新ステップ 1 行のみ上書き更新．詳細な進捗履歴（動機・設計判断・失敗パターン）は docs/PROGRESS.md に追記する．運用ルールは GUIDE_05「進捗記録の運用ルール（CLAUDE.md / PROGRESS.md）」を参照．

必須ルール（コード実装時）

コーディング規約（GUIDE_06 準拠）

  • Effective Dart に準拠．プロジェクト固有ルールは GUIDE_06 を参照
  • dart format + dart analyze を必ず実行してからコミットする
  • 1 ファイル 1 クラス．命名は Provider / Service / Screen の接尾辞ルールに従う
  • エラー処理: Service → Provider → Screen の順で伝播し，画面でユーザーに通知

コミット前チェック（GUIDE_08 準拠）

  1. dart analyze — 警告・エラー 0 件
  2. dart format . — 差分なし
  3. flutter test — 全テスト通過
  4. ドキュメント更新（仕様変更がある場合）

Git 運用（GUIDE_04 準拠）

  • ブランチ名: feature//fix//docs//chore/ + 英単語 2〜4 語（kebab-case）
  • コミットメッセージ: [add]/[update]/[fix]/[remove]/[clean] + 日本語
  • コミット・push 後は gh pr create で PR を作成する

エージェントチーム（GUIDE_05 準拠）

  • 実装は /implement <タスク> で開始する（コーディング → テスト → リファクタリング → ドキュメント更新）
  • Phase 1 後に人間が動作確認，Phase 2 でテスト失敗時のみ方針判断
  • Phase 2 成功後は Phase 3 → Phase 4 まで自動で進む（Phase 4 で更新がある場合のみ確認）
  • テスト・リファクタリングをスキップしない

手動確認が必要な作業（自分で完了させないこと）

以下は実装完了後にユーザーへ報告し，確認・実施を依頼すること．

  • 外部サービスの設定（コンソール操作，セキュリティルール変更等）
  • 実機・ブラウザでの動作確認
  • ストアへのアップロード・リリース作業

ドキュメント

設計・規約に関する情報は docs/ にある． コードを書く前に関連するファイルを読むこと．

01_GUIDE（規約・ルール）

  • プロジェクト立ち上げフロー: docs/01_GUIDE/GUIDE_01_プロジェクト立ち上げフロー.md
  • ドキュメント作成規約: docs/01_GUIDE/GUIDE_02_ドキュメント作成ガイド.md
  • ファイル命名規則: docs/01_GUIDE/GUIDE_03_ファイル命名規則.md
  • Git 運用ルール: docs/01_GUIDE/GUIDE_04_Git運用ルール.md
  • エージェント運用ルール: docs/01_GUIDE/GUIDE_05_エージェント運用ルール.md
  • コーディング規約: docs/01_GUIDE/GUIDE_06_コーディング規約.md
  • テスト方針: docs/01_GUIDE/GUIDE_07_テスト方針.md
  • 実装完了フロー: docs/01_GUIDE/GUIDE_08_実装完了フロー.md

02_ENV（環境）

  • 技術スタック: docs/02_ENV/ENV_01_技術スタック.md
  • 環境構築手順: docs/02_ENV/ENV_02_環境構築手順.md
  • 管理者用環境構築手順: docs/02_ENV/ENV_03_管理者用環境構築手順.md

03_PLAN（計画）

  • 要件定義書: docs/03_PLAN/PLAN_01_要件定義書.md
  • 開発ステップ: docs/03_PLAN/PLAN_02_開発ステップ.md

04_SPEC（仕様・設計）

  • 画面機能仕様書: docs/04_SPEC/SPEC_01_画面機能仕様書.md

05_TECH（技術設計・外部要求仕様）

  • 定量撮影モード要求仕様（SmTIAS-LightSim 側からの外部要求）: docs/05_TECH/TECH_01_定量撮影モード要求仕様.md
  • MiniTIAS 引き継ぎ手順（SmTIAS-LightSim 側からのハンドオフ手順）: docs/05_TECH/TECH_02_MiniTIAS引き継ぎ手順.md

06_TEST（テスト・実機検証）

  • AQUOS sense3 カメラ能力診断結果（2026-05-31）: docs/06_TEST/camera_diagnostics_20260531_161734.json