# 📋 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 |
| :--- | :--- | :--- |
| �️ **Infra & Ops** | 7 tasks | High: Dokploy & Tailscale |
| �🎮 **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*