yutrutasu

📱 ゆるたす（yurutasu）仕様書

🎯 プロジェクト概要

🧠 基本コンセプト

🔧 技術仕様

依存関係

1. YaruKoto（プロジェクト）

class YaruKoto {
  final String id;           // UUID
  final String title;        // プロジェクト名
  final String? description; // 説明（任意）
  final List<TaskItem> items; // 関連する項目
  final DateTime createdAt;   // 作成日時
  
  // 進捗率を自動計算（項目の平均値）
  double get progressPercentage;
  String get progressLabel;   // 🌱🌳 で表示
}

2. TaskItem（項目）※中間階層

class TaskItem {
  final String id;           // UUID
  final String title;        // 項目名
  final String? description; // 説明（任意）
  final List<Task> tasks;    // 関連するタスク
  final DateTime createdAt;  // 作成日時
  
  // 進捗率を自動計算（配下のタスクの平均値）
  double get progressPercentage;
  String get progressLabel;   // 🌱🌳 で表示
}

3. Task（タスク）※最小単位

class Task {
  final String id;           // UUID
  final String title;        // タスク名
  final TaskProgress progress; // 進捗状態
  final DateTime createdAt;   // 作成日時
}

enum TaskProgress {
  notStarted(0, '未着手'),
  inProgress(50, 'ちょっとやった'), // 🌱
  completed(100, '完了');     // 🌳
}

🛠️ 機能詳細

1. プロジェクト管理（最上位階層）

2. 項目管理（中間階層）

3. タスク管理（最小単位）

4. 進捗可視化

5. データ永続化

6. UI/UX デザイン

🔧 技術仕様

依存関係パッケージ

プラットフォーム対応

📂 ファイル構成

lib/
├── main.dart                 # アプリエントリーポイント
├── src/
│   ├── app.dart             # アプリケーション設定
│   ├── controllers/         # 状態管理
│   │   └── yaru_koto_controller.dart
│   ├── models/              # データモデル
│   │   ├── yaru_koto.dart   # プロジェクトモデル
│   │   ├── task_item.dart   # 項目モデル（中間階層）
│   │   └── task.dart        # タスクモデル（最小単位）
│   ├── services/            # ビジネスロジック
│   │   ├── yaru_koto_service.dart
│   │   └── admob_service.dart
│   ├── views/               # UI画面
│   │   ├── yaru_koto_list_view.dart      # プロジェクト一覧
│   │   ├── yaru_koto_detail_view.dart    # プロジェクト詳細（項目一覧）
│   │   ├── task_item_detail_view.dart    # 項目詳細（タスク一覧）
│   │   └── dialogs/
│   └── settings/            # 設定関連

🎨 デザインガイドライン

📱 ユーザーフロー

  1. アプリ起動 → プロジェクト一覧表示
  2. プロジェクト作成 → 新規ダイアログ → 項目追加
  3. 項目管理 → プロジェクト詳細画面 → 項目一覧表示
  4. タスク管理 → 項目詳細画面 → タスク一覧表示・進捗更新
  5. 進捗更新 → タスクタップ → 3段階切り替え
  6. 全体確認 → 各階層の進捗バー・統計で現状把握

画面構造

プロジェクト一覧画面
├── プロジェクト詳細画面（項目一覧）
│   ├── 項目詳細画面（タスク一覧）
│   │   ├── タスク追加ダイアログ
│   │   └── タスク編集ダイアログ
│   ├── 項目追加ダイアログ
│   └── 項目編集ダイアログ
├── プロジェクト追加ダイアログ
└── プロジェクト編集ダイアログ

🚀 今後の拡張予定