Files
unraid-docker-manager/.planning/ROADMAP.md
T
Lucas Berger 63df54e8e3 docs: formalize v1.2 requirements and roadmap
12 requirements across 3 phases:
- Phase 10: Modularization, update all, callback limits (7 reqs)
- Phase 11: Unraid sync, env audit, tech debt (4 reqs)
- Phase 12: Documentation overhaul (1 req)

Removed WEB-01 (webhook fix) - already resolved.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-04 11:21:31 -05:00

97 lines
3.3 KiB
Markdown

# Roadmap — Unraid Docker Manager
## Milestones
- **v1.0 Docker Control via Telegram** — Phases 1-5 (shipped 2026-02-02) -> [Archive](milestones/v1.0-ROADMAP.md)
- **v1.1 n8n Integration & Polish** — Phases 6-9 (shipped 2026-02-04) -> [Archive](milestones/v1.1-ROADMAP.md)
- **v1.2 Modularization & Polish** — Phases 10-12 (planned)
---
## v1.2: Modularization & Polish
Modularize the workflow for maintainability, add "update all" functionality, fix callback data limits, and polish remaining issues.
### Phase 10: Workflow Modularization & Update All
**Goal:** Break main workflow into modular sub-workflows and add "update all" functionality with improved callback data handling
**Dependencies:** None
**Requirements:** MOD-01, MOD-02, BATCH-04, BATCH-05, BATCH-06, BATCH-07, DEBT-03
**Plans:** 0 plans
Plans:
- [ ] TBD (run /gsd:plan-phase 10 to break down)
**Success Criteria:**
1. Workflow split into logical sub-workflows (command routing, container operations, keyboard generation, etc.)
2. Sub-workflows callable from main without code duplication
3. User can type "update all" to update all :latest containers with confirmation
4. User can tap "Update All" in inline keyboard to update all :latest containers
5. Batch selection keyboard allows selecting 5+ containers without hitting callback limit
6. Containers with long names (20+ chars) can be selected in batch keyboard
7. Update flow consolidated between single and batch paths
---
### Phase 11: Polish & Audit
**Goal:** Clear Unraid update badges, fix webhook issues, verify environment configuration, and fix remaining tech debt
**Dependencies:** Phase 10 (modularization complete before polish)
**Requirements:** UNR-01, ENV-01, ENV-02, DEBT-02
**Plans:** 0 plans
Plans:
- [ ] TBD (run /gsd:plan-phase 11 to break down)
**Success Criteria:**
1. After bot successfully updates a container, Unraid UI no longer shows "update available" for that container
2. Documentation clarifies whether TELEGRAM_USERID env var is required or can be hardcoded
3. Documentation clarifies whether TELEGRAM_BOT_TOKEN env var is required or if n8n credential suffices
4. Image pull command has single --max-time flag (600s)
---
### Phase 12: Documentation Overhaul
**Goal:** Update README and documentation to reflect current architecture and features
**Dependencies:** Phase 11 (core features complete before documentation)
**Requirements:** DEBT-01
**Plans:** 0 plans
Plans:
- [ ] TBD (run /gsd:plan-phase 12 to break down)
**Success Criteria:**
1. README documents docker-socket-proxy architecture (not direct socket mount)
2. README documents all v1.2 features (update all, batch selection improvements)
3. Setup instructions verified accurate for clean install
---
## Progress
| Phase | Name | Milestone | Status |
|-------|------|-----------|--------|
| 1-5 | Foundation through Polish | v1.0 | Complete |
| 6 | n8n API Access | v1.1 | Complete |
| 7 | Socket Security | v1.1 | Complete |
| 8 | Inline Keyboard Infrastructure | v1.1 | Complete |
| 9 | Batch Operations | v1.1 | Complete |
| 10 | Workflow Modularization & Update All | v1.2 | Pending |
| 11 | Polish & Audit | v1.2 | Pending |
| 12 | Documentation Overhaul | v1.2 | Pending |
**v1.2 Coverage:** 12 requirements mapped across 3 phases
---
*Updated: 2026-02-04 after v1.1 milestone*