Skip to content

docs: refresh handoff and revise roadmap after the 2026-10 review - #50

Merged
ut42tech merged 4 commits into
developfrom
docs/refresh-handoff
Oct 11, 2026
Merged

ut42tech merged 4 commits into
developfrom
docs/refresh-handoff

Conversation

@ut42tech

@ut42tech ut42tech commented Oct 11, 2026 •

Copy link
Copy Markdown
Owner

概要

ドキュメントを現状に合わせる PR。2 つの変更を含む。

  1. handoff の刷新:docs/handoff.md が 2026-05-29 時点のまま止まっていた(統計・サイネージを「develop のみ」と記載)。実際はすべて本番反映済みのため現状に合わせて書き直す
  2. 2026-10 の計画見直し:運用の変化を受けてフェーズ計画を更新する

計画見直しの内容

変更 内容
活動記録の担い手 メンターによる 30 分グリッドのログ記入(メンターアプリ)を取りやめ、子ども自身が振り返り・目標設定を記録する。紙 → デジタルへ移行(入力方式は Google フォーム / 自前画面で検討中)。目的はメンターの転記負担をなくすこと
直近の優先事項 チェックイン記録の追加・編集・削除(admin のみ、#48 / #49)、QR 読み取り精度の改善
計画から外した メンターアプリ、ログ CSV エクスポート(日次 SQL ダンプで代替)、振り返りシート OCR、教員側スプシとの自動同期(教員主導で確定)、iPad オフライン対応
保留 活動カテゴリ・機材マスタ、共同活動者の記録
Phase 2 に残す 公開 API、分析ダッシュボード、保護者向け機能

コミット

  • 8989bd1 handoff を現状(main = develop・全機能本番反映済み)に刷新。実在メンターのメールアドレス記載を削除
  • af63094 requirements.md:§3 フェーズ計画を改訂、§3.5「2026-10 の計画見直し」を追加、付録A D3〜D6 / D10 を置き換え扱いにし D16〜D19 を追加
  • 86dcfbd mvp.md / architecture.md(構成図の Future ノード整理)/ CLAUDE.md を改訂後の計画に揃える
  • 11d7a76 handoff の次ステップを新しい優先事項と計画に更新

確認

  • .claude/skills/pre-pr-check/scripts/scan-secrets.sh:シークレット混入なし
  • architecture.md の Mermaid は、全エッジの参照先が宣言済み・未使用ノードなしをスクリプトで確認
  • ドキュメントのみの変更(コード変更なし)

🤖 Generated with Claude Code

The handoff was frozen at 2026-05-29 and still described participation
stats and the signage app as develop-only, although both (plus the admin
UI refresh and the checkin data-layer migration) have since shipped to
main. Rewrite it to reflect the current state: main == develop, signage
complete, open issues #39/#47/#48/#49 and Phase 1.5 as next candidates.

Also condense the completed fullName/grade release runbooks into a
reusable "sheet column change" trap (full text kept in git history),
add the runtime-smoke lesson from PR #44, and drop a real mentor email.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Oct 11, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
tecnova-platform-admin Ready Ready Preview Oct 11, 2026 5:27am UTC
tecnova-platform-checkin Ready Ready Preview Oct 11, 2026 5:27am UTC
tecnova-platform-signage Ready Ready Preview Oct 11, 2026 5:27am UTC

ut42tech and others added 3 commits October 11, 2026 14:24
Operations changed: mentors no longer write activity logs, so children
record their own reflection and goal-setting, moving from paper to
digital (input method still undecided). CSV export is covered by the
daily D1 SQL dump, OCR is moot once records are digital, the teacher
sheet stays teacher-led, and offline support is dropped.

- Replace the mentor-app / 30-min grid plan with child self-recording
- Make check-in record correction (add/edit/delete) a near-term item
- Move dropped items to out-of-scope and add §3.5 summarising the review
- Supersede D3-D6/D10 and record the new decisions as D16-D19

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Follow-up to the requirements revision so the other docs stop pointing
at the dropped mentor app and its activity-log pipeline.

- mvp.md: refresh the Phase 1.5+ list and known operational limits
  (paper records transcribed to Google Forms, no way yet to correct
  check-in mistakes)
- architecture.md: swap the mentor app / activity logs / OCR / R2 /
  CSV / offline sync / prior-year import nodes for child record input,
  on-hold masters, and the daily D1 SQL dump used for analysis
- CLAUDE.md: note apps/mentor is cancelled

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Point the next steps at check-in record correction (add/edit/delete,
#48/#49) and the QR scanner recognition complaint, and replace the old
Phase 1.5 list (mentor app, activity logs, CSV export) with the revised
plan.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

This branch was successfully deployed

3 active deployments
Preview – tecnova-platform-signage — 11d7a769 Deployed Oct 11, 2026 by vercel[bot]
Preview – tecnova-platform-admin — 11d7a769 Deployed Oct 11, 2026 by vercel[bot]
Preview – tecnova-platform-checkin — 11d7a769 Deployed Oct 11, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant