ponshu-room-lite/docs/PROJECT_BACKLOG_MASTER.md

115 lines
5.1 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 📋 Posimai Project Master Backlog
**Last Updated**: 2026-01-19
**Source**: Detailed Codebase & Documentation Analysis (Claude + Antigravity)
**Status**: Living Document for Co-development
---
## 📊 Summary
| Category | Count | Priority Focus |
| :--- | :--- | :--- |
| <20> **Infra & Ops** | 7 tasks | High: Dokploy & Tailscale |
| <20>🎮 **Gamification** | 8 tasks | High: Badge Expansion |
| 🎨 **UI/UX** | 18 tasks | High: Dark Mode, Camera UI |
| 🏗️ **Features** | 5 tasks | Medium: Instagram, Sommelier |
| 🐛 **Bugs/Debt** | 8 tasks | High: Coach Mark Fix |
| 🔮 **Future** | 6 tasks | Low: Firebase, Core Platform |
**Total**: 52 Tasks
---
## 🔴 Priority: High (Immediate Action / Week 1-2)
### 🏗️ Infrastructure & Ops: The Foundation
* [ ] **Dokploy Setup (Synology VM)**: Install Dokploy on Ubuntu VM. (1h)
* [ ] **Tailscale Funnel**: Configure secure public access properly. (1h)
* [ ] **Gitea Integration**: Connect Gitea webhook to Dokploy for auto-deploy. (1h)
### 🎮 Gamification: Badge Expansion (Phase 1)
* **Goal**: Expand from 3 to 21 badges using existing data.
* **Tasks**:
* [ ] **Region Badges (7)**: Tohoku (Done), Kanto, Kansai, Hokuriku, Chubu, Chugoku, Kyushu, National.
* **Activity Badges (6)**: Beginner (1), Enthusiast (10), Collector (50), etc.
* **Type Badges (3)**: Junmai, Ginjo, Daiginjo.
* **Business Badges (2)**: Menu Maker, Set Master.
* **Est**: 8 hours
### 🎨 UI/UX: Critical Fixes
* [x] **Dark Mode Readability**: ✅ **PARTIALLY COMPLETE** - Fixed guide_screen.dart, soul_screen.dart. Deferred: sake_detail_screen.dart (see [PROJECT_TODO.md](PROJECT_TODO.md)). Guidelines created: [DARK_MODE_COLOR_GUIDELINES.md](DARK_MODE_COLOR_GUIDELINES.md). (2h → 4h actual)
* [x] **Camera UI Tips**: ✅ COMPLETE - Tooltips and visual feedback already implemented. (0h - already done)
* [x] **Gallery Selection Feedback**: ✅ COMPLETE - Progress indicator implemented. (0h - already done)
* [x] **Photo Edit Touch Area**: ✅ COMPLETE - Drag handle size increased to 32px. (0h - already done)
### 🐛 Bugs: Critical
* [x] **Coach Mark Persistence**: ✅ RESOLVED - Tutorial service deleted due to persistent bugs. Replaced with Guide screen. (0h - deleted)
---
## 🟡 Priority: Medium (Week 3-4)
### 🏗️ Infrastructure & Ops: AI Integration
* [ ] **AI Git Accounts**: Create Gitea users for Claude/Gemini/Antigravity. (0.5h)
* [ ] **Keyboard Layout Fix (Web)**: Verify and fix layout overflow on Flutter Web. (2h)
### 🎨 UI/UX: Polish
* [ ] **Set Product Pricing UX**: Step-by-step input for Price/Cost/Margin. (4h)
* [ ] **QR Scan Animation**: Visual feedback (scan line, vibration). (2.5h)
* [ ] **AI Retry Flow**: "Retry" button on analysis failure. (2h)
* [ ] **Menu Selection Visibility**: Better highlight for selected items in Menu creation. (2.5h)
* [ ] **Home Filter Display**: Chips showing active filters. (2h)
* [ ] **Sort Discoverability**: Move sort button to visible chip area. (1.5h)
* [ ] **Munyun (Like) Animation**: Implement Rive/Lottie animation. (4h)
### 🎮 Gamification: Engagement
* [ ] **Badge Unlock Modal**: Replace simple SnackBar with celebratory dialog. (3.5h)
* [ ] **AI Sommelier (Placeholder)**: Implement chat UI with Gemini. (8h)
* [ ] **EXP Expansion**: Add logic for +10 EXP (Scan), +3 EXP (Review). (4h)
### 🏗️ Features: Business Mode
* [ ] **Instagram Promo Support**: AI caption generation & hashtag suggestion. (8h)
### 🐛 Technical Debt
* [ ] **Flutter Analyze Fixes**: Resolve 49 warnings (imports, deprecated APIs). (2h)
* [ ] **Image Compression**: Implement real resizing (not just file copy). (3h)
* [ ] **PDF Font Embedding**: Verify Potta One font in PDF export. (2h)
---
## 🟢 Priority: Low / Future (Phase 3+)
### 🏗️ Infrastructure & Ops: Optimization
* [ ] **Slack/Notion Webhooks**: Setup automated notifications for AI commits. (2h)
* [ ] **Vercel Cleanup**: Decommission old Vercel project after Dokploy stability. (0.5h)
### 🏗️ Features: Placeholders to Real
* [ ] **Brewery Map**: Real data integration & routing. (12h)
* [ ] **Sales Analytics**: Charts for items sold, taste trends. (10h)
* [ ] **Location Bonus**: GPS detection for brewery visits. (6h)
### 🎨 UI/UX: Nice to Have
* [ ] **Font Switch Flicker**: Preload Google Fonts to prevent popping. (3h)
* [ ] **Empty State CTA**: Big button for "Record First Sake". (1h)
* [ ] **Tablet Support**: Responsive grid layout. (6h)
* [ ] **Guide Content**: Video tutorials / FAQ. (6h)
### 🔮 Future Architecture
* [ ] **Firebase Sync**: Optional cloud backup. (16h)
* [ ] **Posimai Core**: Extract common logic for Incense App. (40h+)
* [ ] **Multi-language**: English/Chinese support. (20h)
---
## 🗓️ Proposed Sprint Schedule
| Sprint | Focus | Key Deliverables |
| :--- | :--- | :--- |
| **Week 1-2** | **Foundation & Wins** | **Dokploy Setup**, Badges (18 new), Dark Mode fix, Coach Mark fix. |
| **Week 3-4** | **Business & UX** | Pricing UX, Menu selection, Instagram Gen, AI Sommelier. |
| **Week 5-6** | **Polish & Debt** | Animations, Analyze fixes, Refactoring. |
---
*Verified against codebase on 2026-01-19*