luckberg/unraid-docker-manager
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: create milestone v1.4 roadmap (4 phases)

Browse Source 
Phases 15-18: Infrastructure Foundation, API Migration, Cleanup, Documentation
23 requirements mapped across 4 phases with 0 gaps.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Lucas Berger
2026-02-09 08:29:16 -05:00
parent 7eab41eaba
commit 16034bbdb8
3 changed files with 129 additions and 38 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.planning/ROADMAP.md
+74 -2
View File
@@ -6,6 +6,7 @@
- ✅ **v1.1 n8n Integration & Polish** — Phases 6-9 (shipped 2026-02-04) -> [Archive](milestones/v1.1-ROADMAP.md)
- ✅ **v1.2 Modularization & Polish** — Phases 10-13 + 10.1, 10.2 (shipped 2026-02-08) -> [Archive](milestones/v1.2-ROADMAP.md)
- ✅ **v1.3 Unraid Update Status Sync** — Phase 14 (shipped 2026-02-09, descoped) -> [Archive](milestones/v1.3-ROADMAP.md)
- 🚧 **v1.4 Unraid API Native** — Phases 15-18 (in progress)
## Phases
@@ -51,8 +52,75 @@
</details>
### 🚧 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):
1. Container ID translation layer maps container names to Unraid PrefixedID format (129-char)
2. Callback data encoding works with PrefixedIDs within Telegram's 64-byte limit
3. GraphQL response normalization transforms Unraid API shape to workflow contract
4. GraphQL error handling standardized (checks response.errors[], handles HTTP 304)
5. Timeout configuration accounts for myunraid.net cloud relay latency (200-500ms)
**Plans**: TBD
Plans:
- [ ] 15-01: TBD
#### 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):
1. User can view container status via Unraid API (same UX as before)
2. User can start, stop, restart containers via Unraid API
3. User can update single container via Unraid API (single mutation replaces 5-step Docker flow)
4. User can batch update multiple containers via Unraid API
5. User can "update all :latest" via Unraid API
6. Unraid update badges clear automatically after bot-initiated updates (no manual sync)
**Plans**: TBD
Plans:
- [ ] 16-01: TBD
#### 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):
1. Container logs feature removed from workflows (text command, inline keyboard, sub-workflow)
2. Docker socket proxy references removed from all workflow JSON files
3. docker-socket-proxy container can be safely removed (no dependencies)
4. n8n container config cleaned (no proxy network, no socket-related env vars)
5. "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):
1. README.md reflects Unraid API-native architecture (no proxy references)
2. ARCHITECTURE.md documents Unraid GraphQL API contracts and patterns
3. CLAUDE.md updated with Unraid API patterns (proxy recipes removed)
4. 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 |
@@ -64,8 +132,12 @@
| 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 | 0/? | Not started | - |
| 16 | API Migration | v1.4 | 0/? | Not started | - |
| 17 | Cleanup | v1.4 | 0/? | Not started | - |
| 18 | Documentation | v1.4 | 0/? | Not started | - |
**Total: 4 milestones shipped (14 phases, 50 plans)**
**Total: 4 milestones shipped (14 phases, 50 plans), v1.4 in progress (4 phases)**
---
*Updated: 2026-02-09 — v1.3 shipped (descoped to Phase 14 only)*
*Updated: 2026-02-09 — v1.4 Unraid API Native roadmap created*