adelorenzo/konstruct
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: add Phase 8 — Mobile Layout + PWA

Browse Source
This commit is contained in:
Adolfo Delorenzo
2026-03-25 19:29:24 -06:00
parent 9759019262
commit 210be50321
3 changed files with 36 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
.planning/REQUIREMENTS.md
View File

@@ -81,6 +81,15 @@ Requirements for beta-ready release. Each maps to roadmap phases.
- [x] **I18N-05**: Error messages, validation text, and system notifications are localized
- [x] **I18N-06**: Adding a new language requires only translation files, not code changes (extensible i18n architecture)
### Mobile + PWA
- [ ] **MOB-01**: All portal pages render correctly and are usable on mobile (320px–480px) and tablet (768px–1024px) screens
- [ ] **MOB-02**: Sidebar collapses to a hamburger menu on mobile with smooth open/close animation
- [ ] **MOB-03**: Chat interface is fully functional on mobile — send messages, see streaming responses, scroll history
- [ ] **MOB-04**: Portal installable as a PWA with app icon, splash screen, and service worker for offline shell caching
- [ ] **MOB-05**: Push notifications for new messages when PWA is installed (or service worker caches app shell for instant load)
- [ ] **MOB-06**: All touch interactions feel native — no hover-dependent UI that breaks on touch devices
## v2 Requirements
Deferred to future release. Tracked but not in current roadmap.
@@ -177,12 +186,20 @@ Which phases cover which requirements. Updated during roadmap creation.
| I18N-05 | Phase 7 | Complete |
| I18N-06 | Phase 7 | Complete |
| MOB-01 | Phase 8 | Pending |
| MOB-02 | Phase 8 | Pending |
| MOB-03 | Phase 8 | Pending |
| MOB-04 | Phase 8 | Pending |
| MOB-05 | Phase 8 | Pending |
| MOB-06 | Phase 8 | Pending |
**Coverage:**
- v1 requirements: 25 total (all complete)
- RBAC requirements: 6 total (Phase 4, all complete)
- Employee Design requirements: 5 total (Phase 5, all complete)
- Web Chat requirements: 5 total (Phase 6, all complete)
- Multilanguage requirements: 6 total (Phase 7)
- Multilanguage requirements: 6 total (Phase 7, all complete)
- Mobile + PWA requirements: 6 total (Phase 8)
---
*Requirements defined: 2026-03-23*

19
.planning/ROADMAP.md
View File

@@ -131,7 +131,7 @@ Plans:
## Progress
**Execution Order:**
Phases execute in numeric order: 1 -> 2 -> 3 -> 4 -> 5 -> 6 -> 7
Phases execute in numeric order: 1 -> 2 -> 3 -> 4 -> 5 -> 6 -> 7 -> 8
| Phase | Plans Complete | Status | Completed |
|-------|----------------|--------|-----------|
@@ -142,6 +142,7 @@ Phases execute in numeric order: 1 -> 2 -> 3 -> 4 -> 5 -> 6 -> 7
| 5. Employee Design | 4/4 | Complete | 2026-03-25 |
| 6. Web Chat | 3/3 | Complete | 2026-03-25 |
| 7. Multilanguage | 4/4 | Complete | 2026-03-25 |
| 8. Mobile + PWA | 0/0 | Not started | - |
---
@@ -168,6 +169,22 @@ Plans:
- [ ] 07-03-PLAN.md — Frontend string extraction: replace all hardcoded English strings with useTranslations() calls across all pages and components
- [ ] 07-04-PLAN.md — Human verification: multilanguage testing across all pages, language switcher, AI Employee language response
### Phase 8: Mobile + PWA
**Goal**: The portal is fully responsive on mobile/tablet devices and installable as a Progressive Web App — operators and customers can manage their AI workforce and chat with employees from any device
**Depends on**: Phase 7
**Requirements**: MOB-01, MOB-02, MOB-03, MOB-04, MOB-05, MOB-06
**Success Criteria** (what must be TRUE):
1. All portal pages render correctly and are usable on mobile screens (320px–480px) and tablets (768px–1024px)
2. The sidebar collapses to a hamburger menu on mobile with smooth open/close animation
3. The chat interface is fully functional on mobile — send messages, see streaming responses, scroll history
4. The portal can be installed as a PWA from Chrome/Safari with app icon, splash screen, and offline shell
5. Push notifications work for new messages when the PWA is installed (or at minimum, the service worker caches the app shell for instant load)
6. All touch interactions (swipe, tap, long-press) feel native — no hover-dependent UI that breaks on touch
**Plans**: 0 plans
Plans:
- [ ] TBD (run /gsd:plan-phase 8 to break down)
---
*Roadmap created: 2026-03-23*
*Coverage: 25/25 v1 requirements + 6 RBAC requirements + 5 Employee Design requirements + 5 Web Chat requirements + 6 Multilanguage requirements mapped*

0
.planning/phases/08-mobile-pwa/.gitkeep Normal file
View File