Lucas Berger
5aa07e8dfa
- All 4 API requirements verified (API-01 through API-04) - Phase goal achieved: Claude Code can programmatically read, update, and test workflows - Verification passed: 4/4 must-haves confirmed Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
4.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-10 (in progress)
v1.1: n8n Integration & Polish
Enable faster development iteration via n8n API access, improve UX with inline keyboard buttons, add batch operations, and harden security by removing direct Docker socket exposure from n8n.
Phase 6: n8n API Access
Goal: Claude Code can programmatically read, update, and test workflows
Dependencies: None (enables faster iteration on all subsequent phases)
Requirements: API-01, API-02, API-03, API-04
Plans: 1 plan
Plans:
- 06-01-PLAN.md — Enable API access (create key, verify CRUD, execution history)
Success Criteria:
- n8n API key exists and Claude Code can authenticate against the n8n API
- Claude Code can retrieve the current workflow JSON via API call
- Claude Code can push workflow changes via API and they take effect immediately
- Claude Code can view execution history showing recent runs with success/failure status
Phase 7: Socket Security
Goal: Docker operations flow through a filtered proxy instead of direct socket access
Dependencies: Phase 6 (API access enables faster iteration on curl command migration)
Requirements: SEC-01, SEC-02, SEC-03, SEC-04
Success Criteria:
- Socket proxy container runs on internal network with Docker socket mounted
- n8n container connects to proxy via TCP instead of mounting docker.sock directly
- Dangerous Docker APIs (exec, create, build) return blocked/forbidden responses
- All existing bot commands (status, start, stop, restart, update, logs) work identically through proxy
Phase 8: Inline Keyboard Infrastructure
Goal: Users interact with containers via tappable buttons instead of typing commands
Dependencies: Phase 7 (security in place before adding new features)
Requirements: KEY-01, KEY-02, KEY-03, KEY-04, KEY-05
Success Criteria:
- Status command returns a message with inline buttons showing available actions per container
- Tapping an action button (start/stop/restart) executes that action on the target container
- Dangerous actions (stop, restart, update) show a confirmation prompt before executing
- During operation execution, the message updates to show progress (e.g., "Stopping plex...")
- After action completes, buttons are removed and final status is shown in the message
Phase 9: Batch Operations
Goal: Users can update multiple containers in a single command with clear feedback
Dependencies: Phase 8 (keyboard infrastructure supports confirmation dialogs)
Requirements: BAT-01, BAT-02, BAT-03, BAT-04, BAT-05, BAT-06
Success Criteria:
- User can type "update plex sonarr radarr" and all three containers update sequentially
- Each container shows individual progress/result as it completes (not waiting until all finish)
- "Update all" command shows confirmation with list of containers before executing
- If one container fails mid-batch, remaining containers still attempt to update
- Final message shows summary: "3 updated, 1 failed" with details
Phase 10: Polish & Audit
Goal: Clear Unraid update badges and verify environment configuration
Dependencies: Phase 9 (core features complete before polish)
Requirements: UNR-01, ENV-01, ENV-02
Success Criteria:
- After bot successfully updates a container, Unraid UI no longer shows "update available" for that container
- Documentation clarifies whether TELEGRAM_USERID env var is required or can be hardcoded
- Documentation clarifies whether TELEGRAM_BOT_TOKEN env var is required or if n8n credential suffices
Progress
| Phase | Name | Requirements | Status |
|---|---|---|---|
| 6 | n8n API Access | API-01, API-02, API-03, API-04 | Complete ✓ |
| 7 | Socket Security | SEC-01, SEC-02, SEC-03, SEC-04 | Pending |
| 8 | Inline Keyboard Infrastructure | KEY-01, KEY-02, KEY-03, KEY-04, KEY-05 | Pending |
| 9 | Batch Operations | BAT-01, BAT-02, BAT-03, BAT-04, BAT-05, BAT-06 | Pending |
| 10 | Polish & Audit | UNR-01, ENV-01, ENV-02 | Pending |
v1.1 Coverage: 22/22 requirements mapped
Updated: 2026-02-03