c8aaba657e
- Updated comments and documentation to reflect the new branding of the chat API and related components. - Renamed functions and variables to align with the Swift Assistent terminology. - Enhanced UI components with animations using Framer Motion for a smoother user experience. - Removed outdated architecture documentation related to the Medical Scribe system. This change is part of the transition to the Swift Assistent branding, ensuring consistency across the application.
70 lines
4.1 KiB
Markdown
70 lines
4.1 KiB
Markdown
# 🚀 MVP Userstories & Scope: Swift Cortex (Public Prototype)
|
|
|
|
**Betreft:** Scope voor de "Build in Public" fase van het Swift Intent System V2.
|
|
**Doel:** Een werkend, indrukwekkend prototype neerzetten dat de kernwaarde van "Agency" (Multi-intent & Context) demonstreert, zonder te verzanden in productie-complexiteit.
|
|
|
|
---
|
|
|
|
## 1. Scope Definitie
|
|
|
|
We splitsen de ontwikkeling in **MVP** (Wat we nu bouwen voor de publieke demo) en **Post-MVP** (Wat nodig is voor een veilig medisch productiesysteem).
|
|
|
|
### ✅ In Scope (MVP - "The Prototype")
|
|
*Focus: Wow-factor, core mechanics, demonstratie van intelligentie.*
|
|
|
|
1. **Hybrid Architecture:** De naadloze switch tussen Layer 1 (Reflex) en Layer 2 (AI).
|
|
2. **Multi-Intent:** Het kunnen verwerken van samengestelde zinnen ("Zeg af en maak notitie").
|
|
3. **Context Awareness:** Het correct interpreteren van "hij", "deze", "morgen" o.b.v. de huidige schermstatus.
|
|
4. **UI Feedback:** Visualisatie van het "denkproces" en gestapelde resultaten (Stacked Cards).
|
|
5. **Basic Safety Net:** Eén hardcoded voorbeeld van proactiviteit (bijv. "Wondcontrole suggestie") om het concept te tonen.
|
|
|
|
### ❌ Out of Scope (Post-MVP - "The Product")
|
|
*Focus: Veiligheid, robuustheid, edge-cases.*
|
|
|
|
1. **Complete Medische Protocollen:** Geen volledige rule-engine voor alle ziektebeelden.
|
|
2. **Complex Rollback:** Geen "Undo" knop voor database mutaties (wel confirmaties vooraf).
|
|
3. **Offline Mode:** Het prototype gaat uit van internetverbinding.
|
|
4. **Advanced Error Handling:** Geen automatische retry-mechanismes of fallbacks als de LLM down is.
|
|
5. **Analytics & Learning:** Geen telemetry opslag voor model-training.
|
|
|
|
---
|
|
|
|
## 2. MVP User Stories
|
|
|
|
Deze stories zijn leidend voor de aankomende bouwfase.
|
|
|
|
### Thema 1: De Slimme Assistent (Core Intelligence)
|
|
|
|
| ID | Story | Acceptatie Criteria |
|
|
|----|-------|---------------------|
|
|
| **US-MVP-01** | Als gebruiker wil ik **twee acties in één zin** kunnen geven ("Zeg Jan af en mail de huisarts"), zodat ik niet hoef te wachten. | - Systeem herkent "en/daarna" signalen.<br>- UI toont twee losse acties in progressie.<br>- Beide acties worden uitgevoerd. |
|
|
| **US-MVP-02** | Als gebruiker wil ik naar **"deze patiënt"** of **"hij"** kunnen verwijzen, zodat ik natuurlijk kan spreken. | - Systeem gebruikt de `ActivePatient` uit de store om "hij" te invullen.<br>- Als er geen patiënt open staat, vraagt het systeem "Wie bedoel je?". |
|
|
| **US-MVP-03** | Als gebruiker wil ik **impliciete tijd** ("morgen", "volgende week") kunnen gebruiken, zodat ik geen datums hoef te noemen. | - "Morgen" wordt correct vertaald naar de datum van morgen.<br>- Context (huidige tijd) wordt meegestuurd naar de AI. |
|
|
|
|
### Thema 2: Hybride Snelheid (Architecture)
|
|
|
|
| ID | Story | Acceptatie Criteria |
|
|
|----|-------|---------------------|
|
|
| **US-MVP-04** | Als gebruiker wil ik dat simpele commando's (**"Agenda", "Zoek Jan"**) direct werken (<20ms), zodat het systeem niet traag voelt. | - Reflex Arc (Regex) vangt deze af.<br>- Geen AI spinner zichtbaar, directe actie. |
|
|
| **US-MVP-05** | Als gebruiker wil ik zien **dat het systeem nadenkt** bij complexe vragen, zodat ik weet dat ik moet wachten. | - Bij trage/AI acties (Layer 2) toont de UI direct een "Processing..." indicator.<br>- Geen "bevroren" scherm. |
|
|
|
|
### Thema 3: De Partner (Proactivity - Concept)
|
|
|
|
| ID | Story | Acceptatie Criteria |
|
|
|----|-------|---------------------|
|
|
| **US-MVP-06** | Als gebruiker wil ik een **proactieve suggestie** zien na een specifieke actie (bijv. wondzorg), zodat ik snap dat het systeem meedenkt. | - *Demo Case:* Na invoeren "Wondverzorging" toont systeem kaartje: "Afspraak wondcontrole inplannen?".<br>- Klikken op "Ja" opent direct het planningsscherm. |
|
|
|
|
---
|
|
|
|
## 3. Technische Randvoorwaarden (MVP)
|
|
|
|
* **Model:** Claude 3.5 Haiku (via Anthropic API).
|
|
* **Latency Target:** Reflex < 50ms, AI < 1.5s (acceptabel voor prototype).
|
|
* **Data:** We gebruiken mock-data voor patiënten en agenda, geen echte EPD koppeling.
|
|
|
|
## 4. 'Build in Public' roadmap
|
|
|
|
1. **Week 1:** De "Reflex" werkend krijgen (De basis).
|
|
2. **Week 2:** De "Cortex" aansluiten (Multi-intent parsing demo).
|
|
3. **Week 3:** De UI polijsten (Stacked Cards & Animaties) & Share video.
|