WinWin 是一套以跨角色照顧資訊與責任連續性為核心的高齡照顧協作系統。它協助長者、家屬與專業照顧人員在同一個 Case 中理解重要照顧需求、留下有來源的照顧變化、提出問題、建立行動，並追蹤責任從指派、接受、進行到完成的過程。
目前成果是使用虛構資料的學生專題 Prototype。它不是正式醫療系統、臨床風險工具、長照資格判定工具或緊急服務，也尚未完成 Production 上線所需的持久化、安全 enforcement 與多人實際環境驗證。
家庭照顧經常由不同家屬、居家服務人員、日照或其他專業角色共同完成。資訊可能分散在訊息、口頭交接與個別紀錄中，使下一位照顧者難以確認發生了什麼、誰正在處理，以及某項責任是否真的被接受。
WinWin 將這些協作資訊整理成可以追溯的 Case、照顧需求、更新、問題與行動，使照顧資訊與責任狀態不因人員、班次或服務期間改變而失去脈絡。
WinWin 聚焦三類相互關聯的問題：
- 照顧資訊缺少共同脈絡，後續人員可能無法理解來源、時間與重要變化。
- 指派、接受、執行與完成容易被混為同一件事，造成責任狀態不清楚。
- 主要照顧者暫時無法照顧時，家庭難以具體辨識哪一項照顧需求、在哪個時間形成缺口。
WinWin 不以未經驗證的高、中、低風險分數取代具體資訊，而是保留需求、時間、責任、確認狀態與資料不足之處。
WinWin 提供兩個相互依賴的產品層次：
- 以 Collaboration Core 建立跨角色協作、權限、資訊來源與責任生命週期。
- 在相同資料與責任語意上，提供 Care Continuity 中斷情境分析。
Care Continuity 是 WinWin 的重要應用，不是 WinWin 的全部產品身份，也不建立第二套 membership、authorization、Action、Timeline 或 authority truth。
- 長者或被照顧者本人，在適當權限與協助下參與自己的照顧 Case。
- 家屬與家庭照顧者，記錄重要變化、確認照顧安排並協調行動。
- 居家服務、日間照顧、護理或其他專業照顧人員，在服務目的、範圍與期間內參與協作。
- 協作管理者，管理 Case 參與關係與協作流程；管理能力不代表可查看所有敏感內容。
Layer 1 是 WinWin 的產品核心，包含：
- Case
- Membership／Authorization
- CareNeed
- Care Structure
- Care Update
- Question
- Action
- Assignment
- Acceptance
- In Progress
- Completion
- Timeline／Traceability
核心語意固定為：
- Assignment 不等於 Acceptance。 被指派不代表對方已同意承擔。
- Action Completion 不等於 Question Resolution。 行動完成不會自動把相關問題標記為已解決。
- 已發布資訊與責任歷程應保留作者、時間、來源與狀態變化。
- Membership 表示 Case 關係，不代表可以查看所有內容；正式權限必須由完整且有效的 authorization path 判定。
Layer 2 使用 Layer 1 已建立的 CareNeed、Care Structure、Membership、Authorization、Action lifecycle、Timeline 與 authority semantics，回答：
如果明天主要照顧者不能照顧，哪些具體照顧事項會在什麼時間失去承接？
支援的情境方向包括24小時、72小時、7天與長期無法照顧，並依序處理：
Interruption Scenario
→ Occurrence
→ Coverage Analysis
→ Care Gap
→ Derived Care Backup Plan
→ Backup Action
→ Acceptance
→ Re-analysis
Coverage使用以下狀態：
COVERED：目前資料中已有符合條件且已接受的安排。UNCONFIRMED：存在可能安排，但尚未完成接手確認。UNCOVERED：目前資料中沒有替代安排。UNKNOWN：現有資料不足，必須人工確認。
COVERED不代表實際服務一定會到場或一定成功執行。Care Gap與Derived Care Backup Plan都是由目前Scenario、Occurrence、Coverage與Action資料推導的結果，不是獨立authority。
Layer 1主流程：
Case
→ Care Structure／CareNeed
→ Care Update／Question／Action
→ Assignment
→ Acceptance
→ In Progress
→ Completion
→ Timeline／Traceability
Layer 2延伸流程：
Primary Caregiver Interruption
→ Occurrences
→ Coverage Analysis
→ Care Gaps
→ Backup Actions
→ Acceptance
→ Re-analysis
- 虛構Case與多角色身分展示。
- CareNeed與Care Structure整理。
- Care Update、Question與Action的獨立語意。
- Action指派、接受、進行與完成生命週期。
- Timeline與責任歷程追蹤。
- Invitation與多Case工作區Prototype。
- 專業照顧紀錄、分享預覽與追加式更正Prototype。
- 主要照顧者中斷情境、Occurrence與Coverage分析。
- Derived Care Backup Plan、Backup Action與接受後重新分析。
- AI Care Draft的deterministic mock整理流程。
目前主要展示為WinWin Usability Prototype v1，使用完整虛構資料與React in-memory state。它已提供可點擊的Case、照顧協作、責任生命週期、Timeline、Care Structure與Care Continuity展示流程。
Prototype重新整理後會重置資料，不連接正式Production內容持久化。畫面中的角色、權限與access guard用於展示產品流程，不是Production安全邊界。
目前Prototype入口：
/v2/prototype
根路徑/也會導向此入口。
- React 19
- TypeScript
- Vite
- Vitest
- React Router
- Supabase／PostgreSQL authority foundation
- Vercel SPA deployment baseline
Prototype與Production foundation必須分開理解：前端Prototype展示產品語意；Supabase migrations、RLS、RPC及Foundation tooling則提供後端authority設計與本機驗證基礎。目前兩者尚未完成正式Production整合。
目前AI Care Draft是deterministic mock，只用來示範：
照顧敘述
→ 結構化草稿
→ 使用者檢視與修改
→ 使用者確認
它不會自動建立正式Care Update、CareNeed、Question、Action、Coverage或Backup Plan，也沒有已部署的外部生成式AI Production inference。任何未來AI輸出都必須保留來源、可修改性與Human confirmation。
- Prototype照顧案例與測試資料均為虛構資料，不應加入真實個案資料。
- 使用者角色、職稱或Case關係本身不等於完整資料權限。
- 專業服務存取必須受目的、範圍與有效期間限制。
- 衍生摘要、列印與AI草稿不得突破原始資料權限。
- WinWin不提供醫療診斷、處方、緊急應變保證或長照資格判定。
- 不建立未經研究驗證的醫療風險或照顧韌性分數。
已完成的是產品設計、可點擊Prototype、deterministic scenario logic、測試與本機Foundation驗證。尚未正式證實或完成的範圍包括：
- 完整Production內容持久化。
- 完整Production RLS／RPC enforcement。
- 真實multi-account Production E2E。
- 正式Production cutover。
- 外部AI inference的Production部署。
- 正式使用者、照護、臨床、法規或市場成效驗證。
Prototype測試PASS不能解讀為Production已完成。
目前Repository包含：
- Frontend unit／scenario／authorization regression tests。
- CareNeed、Occurrence、Coverage與Backup Plan tests。
- Migration與authority foundation verification SQL／scripts。
- Foundation deterministic contract、schema與safety tests。
Foundation checkpoint的deterministic suite為662／662 PASS。Production-local verifier目前回報BLOCKED / INSUFFICIENT_EVIDENCE，表示缺少本機Production reservation evidence；這不是Production failure，也不是Production readiness證明。
最新狀態與證據邊界請見WinWin Current Project Status。
- WinWin Usability Prototype v1已Freeze。
- Layer 1／Layer 2產品治理決策已核准。
- Foundation checkpoint與Repository hygiene checkpoint已建立。
- Prototype已具備moderated usability testing條件，但不得虛構human usability evidence已完成。
- Competition canonical source/tooling與technical release candidate已通過Human technical review。Formal DOCX／PDF與正式封面因公開資料最小化而僅保留於本機；最終競賽提交仍由Human決定。
- Production persistence、安全enforcement、multi-account E2E與cutover尚未完成。
README.md # WinWin專案入口
PLAN.md # Current WinWin Project Plan
docs/
├── architecture/ # Domain、data model與migration設計
├── project-status/ # Current status與歷史checkpoint
├── requirements/ # Product governance與authorization需求
├── research/ # Research與scenario evidence
├── verification/ # Migration與Foundation驗證
└── winwin/ # Current decisions及待canonicalize的WinWin設計文件
app/ # React／TypeScript Prototype與tests
supabase/ # Migrations、RLS／RPC foundation與SQL tests
tools/winwin/foundation/ # Foundation contracts、inspectors與deterministic tests
competition/ # Public-safe Competition source與generation tooling
Repository documentation仍在進行canonical migration。後續會將current product、architecture、research、usability與verification文件整理到清楚的canonical路徑；本輪不搬動歷史文件。
從Repository根目錄執行：
cd app
npm install
npm run dev依Vite顯示的本機網址開啟：
/v2/prototype
執行Frontend驗證：
cd app
npm test
npm run typecheck
npm run build以上指令不需要真實照顧資料。
最新開發範圍、Roadmap與Definition of Done請見WinWin Project Plan。
Repository仍保留歷史「備份心」研究、Prototype、routes、migrations與verification assets，供migration history、regression與研究稽核使用。它們不是目前WinWin產品定義，也不會因包含Coverage、Scenario或Backup概念而自動成為WinWin authority。
反之，不能只因內容涉及Care Continuity就判定為legacy：目前app/src/v2/scenario/中的Occurrence、Coverage、Care Gap與Backup Plan是WinWin Layer 2的一部分。Legacy內容將在後續canonical migration中另行archive或完成runtime dependency review，本階段不刪除或改寫其歷史證據。