Lucas Berger
6.6 KiB
Roadmap — Unraid Docker Manager
Milestones
- ✅ v1.0 Docker Control via Telegram — Phases 1-5 (shipped 2026-02-02) -> Archive
- ✅ v1.1 n8n Integration & Polish — Phases 6-9 (shipped 2026-02-04) -> Archive
- ✅ v1.2 Modularization & Polish — Phases 10-13 + 10.1, 10.2 (shipped 2026-02-08) -> Archive
- ✅ v1.3 Unraid Update Status Sync — Phase 14 (shipped 2026-02-09, descoped) -> Archive
- 🚧 v1.4 Unraid API Native — Phases 15-18 (in progress)
Phases
✅ v1.0 Docker Control via Telegram (Phases 1-5) — SHIPPED 2026-02-02
- Phase 1: Foundation (2/2 plans)
- Phase 2: Container Actions (2/2 plans)
- Phase 3: Core Operations (4/4 plans)
- Phase 4: Container Logs (1/1 plan)
- Phase 5: Polish & Ship (3/3 plans)
✅ v1.1 n8n Integration & Polish (Phases 6-9) — SHIPPED 2026-02-04
- Phase 6: n8n API Access (1/1 plan)
- Phase 7: Socket Security (3/3 plans)
- Phase 8: Inline Keyboard Infrastructure (3/3 plans)
- Phase 9: Batch Operations (4/4 plans)
✅ v1.2 Modularization & Polish (Phases 10-13 + 10.1, 10.2) — SHIPPED 2026-02-08
- Phase 10: Workflow Modularization (7/7 plans)
- Phase 10.1: Aggressive Workflow Modularization (9/9 plans) (INSERTED)
- Phase 10.2: Better Logging & Log Management (4/4 plans) (INSERTED)
- Phase 11: Update All & Callback Limits (2/2 plans)
- Phase 12: Polish & Audit (2/2 plans)
- Phase 13: Documentation Overhaul (1/1 plan)
✅ v1.3 Unraid Update Status Sync (Phase 14) — SHIPPED 2026-02-09 (descoped)
- Phase 14: Unraid API Access (2/2 plans)
Phase 15: Single Container Sync(dropped — superseded by v1.4)Phase 16: Batch Sync & Documentation(dropped — superseded by v1.4)
🚧 v1.4 Unraid API Native (In Progress)
Milestone Goal: Replace Docker socket proxy with Unraid's GraphQL API for all container operations, remove container logs feature, and clean up all proxy artifacts.
Phase 15: Infrastructure Foundation
Goal: Data transformation layers ready for Unraid API integration Depends on: Phase 14 Requirements: INFRA-01, INFRA-02, INFRA-03, INFRA-04, INFRA-05 Success Criteria (what must be TRUE):
- Container ID translation layer maps container names to Unraid PrefixedID format (129-char)
- Callback data encoding works with PrefixedIDs within Telegram's 64-byte limit
- GraphQL response normalization transforms Unraid API shape to workflow contract
- GraphQL error handling standardized (checks response.errors[], handles HTTP 304)
- Timeout configuration accounts for myunraid.net cloud relay latency (200-500ms) Plans: 2 plans
Plans:
- 15-01-PLAN.md — Container ID Registry and Callback Token Encoding/Decoding
- 15-02-PLAN.md — GraphQL Response Normalizer, Error Handler, and HTTP Template
Phase 16: API Migration
Goal: All container operations work via Unraid GraphQL API Depends on: Phase 15 Requirements: API-01, API-02, API-03, API-04, API-05, API-06, API-07, API-08 Success Criteria (what must be TRUE):
- User can view container status via Unraid API (same UX as before)
- User can start, stop, restart containers via Unraid API
- User can update single container via Unraid API (single mutation replaces 5-step Docker flow)
- User can batch update multiple containers via Unraid API
- User can "update all :latest" via Unraid API
- Unraid update badges clear automatically after bot-initiated updates (no manual sync) Plans: 5 plans
Plans:
- 16-01-PLAN.md -- Container Status workflow migration (n8n-status.json)
- 16-02-PLAN.md -- Container Actions workflow migration (n8n-actions.json)
- 16-03-PLAN.md -- Container Update workflow migration (n8n-update.json)
- 16-04-PLAN.md -- Batch UI workflow migration (n8n-batch-ui.json)
- 16-05-PLAN.md -- Main workflow routing migration (n8n-workflow.json)
Phase 17: Cleanup
Goal: All Docker socket proxy artifacts removed from codebase Depends on: Phase 16 Requirements: CLN-01, CLN-02, CLN-03, CLN-04, CLN-05, CLN-06 Success Criteria (what must be TRUE):
- Container logs feature removed from workflows (text command, inline keyboard, sub-workflow)
- Docker socket proxy references removed from all workflow JSON files
- docker-socket-proxy container can be safely removed (no dependencies)
- n8n container config cleaned (no proxy network, no socket-related env vars)
- "unraid" test command updated or removed (v1.3 connectivity test) Plans: TBD
Plans:
- 17-01: TBD
Phase 18: Documentation
Goal: Documentation fully updated for Unraid API-native architecture Depends on: Phase 17 Requirements: DOC-01, DOC-02, DOC-03, DOC-04 Success Criteria (what must be TRUE):
- README.md reflects Unraid API-native architecture (no proxy references)
- ARCHITECTURE.md documents Unraid GraphQL API contracts and patterns
- CLAUDE.md updated with Unraid API patterns (proxy recipes removed)
- Cleanup instructions documented for removing docker-socket-proxy container Plans: TBD
Plans:
- 18-01: TBD
Progress
Execution Order: Phases execute in numeric order: 1-14 (complete) → 15 → 16 → 17 → 18
| Phase | Name | Milestone | Plans Complete | Status | Completed |
|---|---|---|---|---|---|
| 1-5 | Foundation through Polish | v1.0 | 12/12 | Complete | 2026-02-02 |
| 6-9 | API, Security, Keyboard, Batch | v1.1 | 11/11 | Complete | 2026-02-04 |
| 10 | Workflow Modularization | v1.2 | 7/7 | Complete | 2026-02-05 |
| 10.1 | Aggressive Modularization | v1.2 | 9/9 | Complete | 2026-02-06 |
| 10.2 | Better Logging & Log Management | v1.2 | 4/4 | Complete | 2026-02-07 |
| 11 | Update All & Callback Limits | v1.2 | 2/2 | Complete | 2026-02-08 |
| 12 | Polish & Audit | v1.2 | 2/2 | Complete | 2026-02-08 |
| 13 | Documentation Overhaul | v1.2 | 1/1 | Complete | 2026-02-08 |
| 14 | Unraid API Access | v1.3 | 2/2 | Complete | 2026-02-08 |
| 15 | Infrastructure Foundation | v1.4 | 2/2 | Complete | 2026-02-09 |
| 16 | API Migration | v1.4 | 0/5 | Not started | - |
| 17 | Cleanup | v1.4 | 0/? | Not started | - |
| 18 | Documentation | v1.4 | 0/? | Not started | - |
Total: 4 milestones shipped (14 phases, 50 plans), v1.4 in progress (Phase 15 complete, 3 phases remaining)
Updated: 2026-02-09 — Phase 15 complete (2/2 plans)