Proposal
Why¶
Teams Board には技術アーキテクチャ(docs/architecture.md)と概念モデル(docs/index.md)のドキュメントが存在するが、業務視点でのドキュメント(業務定義・業務シナリオ)が不足している。管理者・閲覧者がシステムをどのように活用するかを業務フローとして明文化し、開発チームと利用者間の共通理解を形成する必要がある。
What Changes¶
- 業務定義「参加状況管理業務」を新規作成: 参加者レポートの取り込みからグループ・メンバー実績の確認までの日常業務フローを定義
- 業務シナリオ2件を新規作成:
- 「参加者レポートの取込とメンバー活動実績の確認」— 管理者による取り込みから閲覧者によるメンバー実績確認まで
- 「参加者レポートの取込とグループ開催実績の確認」— 管理者による取り込みから閲覧者によるグループ実績確認まで
- 業務定義「グループ情報管理業務」を新規作成: グループ名の修正を行うメンテナンス業務フローを定義
- 業務シナリオ1件を新規作成:
- 「グループ名称の修正」— 管理者によるグループ名の編集・保存フロー
- ナビゲーション定義(
.pages)を新規作成: MkDocs でのドキュメント構成を定義
Capabilities¶
New Capabilities¶
business-docs: 業務定義ドキュメント(業務定義2件 + 業務シナリオ3件 + ナビゲーション定義)。ソースコード変更なし、docs/配下のマークダウンファイル追加のみ。
Modified Capabilities¶
(既存の spec に対する要件変更なし)
Impact¶
- 影響範囲:
docs/ディレクトリへのマークダウンファイル追加のみ - ソースコード: 変更なし
- 依存関係: 変更なし
- CI/CD: 影響なし(ドキュメントファイルはデプロイ対象外)
- 参照する実装:
src/services/csv-transformer.js— 参加者レポート解析ロジック(業務シナリオの記述に参照)src/services/index-merger.js— インデックス更新ロジック(業務シナリオの記述に参照)src/services/index-editor.js— グループ名修正ロジック(業務シナリオの記述に参照)src/pages/AdminPage.jsx— 管理者パネルの UI/UX フロー(業務シナリオの記述に参照)