Lucas Berger
5.3 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 — Phases 14-16 (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 (In Progress)
Milestone Goal: After the bot updates a container, Unraid recognizes it's current — no stale badges, no false-positive notifications.
Phase 14: Unraid API Access
Goal: Validate GraphQL API connectivity and establish secure authentication from n8n container to Unraid host.
Depends on: Nothing (first phase of milestone)
Requirements: INFRA-01, INFRA-02, INFRA-03
Success Criteria (what must be TRUE):
- n8n container can successfully reach Unraid's GraphQL API endpoint via HTTP request
- Unraid API key exists with Docker update permission and is securely stored in gitignored
.env.unraid-api - Container ID format is documented (e.g.,
docker:<name>) and verified via test GraphQL query - Test GraphQL query can list containers and return expected data structure
Plans: TBD
Plans:
- 14-01: TBD
Phase 15: Single Container Sync
Goal: After bot updates a single container via text command or inline keyboard, Unraid automatically clears the "update available" badge without user intervention.
Depends on: Phase 14
Requirements: SYNC-01, SYNC-02, SYNC-05
Success Criteria (what must be TRUE):
- After bot updates a container via text command (e.g., "update plex"), Unraid's WebGUI shows no update badge for that container
- After bot updates a container via inline keyboard update button, Unraid's WebGUI shows no update badge for that container
- Unraid sync failure does not block or fail the Docker container update itself (best-effort sync)
- User receives clear feedback if sync fails (warning message, but update still succeeds)
- n8n-update.json sub-workflow calls Unraid GraphQL
updateContainermutation after successful Docker API update
Plans: TBD
Plans:
- 15-01: TBD
Phase 16: Batch Sync & Documentation
Goal: Batch update operations sync all updated containers to Unraid efficiently, and users can set up Unraid sync integration from documentation alone.
Depends on: Phase 15
Requirements: SYNC-03, SYNC-04, SYNC-06, DOC-01, DOC-02
Success Criteria (what must be TRUE):
- After "update all" operation, all updated containers sync to Unraid in a single efficient GraphQL call
- After batch selection update, all selected containers sync to Unraid in a single efficient GraphQL call
- User receives no false-positive Unraid Telegram notifications for containers updated via the bot
- README documents how to create Unraid API key, configure n8n container networking, and set up
.env.unraid-api - ARCHITECTURE.md documents Unraid sync integration including GraphQL API contract, data flow diagram, and new n8n nodes
Plans: TBD
Plans:
- 16-01: TBD
Progress
| 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 | 0/TBD | Not started | - |
| 15 | Single Container Sync | v1.3 | 0/TBD | Not started | - |
| 16 | Batch Sync & Documentation | v1.3 | 0/TBD | Not started | - |
Total: 3 milestones shipped (13 phases, 48 plans) + 1 milestone in progress (3 phases)
Updated: 2026-02-08 — v1.3 roadmap created