Lucas Berger
9b0e5fd8a5
Archived: - milestones/v1.0-ROADMAP.md (full phase details) Updated: - MILESTONES.md (new entry for v1.0) - PROJECT.md (requirements → Validated, Current State added) - ROADMAP.md (collapsed to one-line with archive link) - STATE.md (reset for next milestone) v1.0 Docker Control via Telegram shipped: - 5 phases, 12 plans, 5 days - Telegram bot with keyword commands - Docker socket integration via n8n Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
125 lines
3.4 KiB
Markdown
125 lines
3.4 KiB
Markdown
# Milestone v1.0: Docker Control via Telegram
|
|
|
|
**Status:** SHIPPED 2026-02-02
|
|
**Phases:** 1-5
|
|
**Total Plans:** 12
|
|
|
|
## Overview
|
|
|
|
Telegram bot for managing Docker containers on Unraid. Control containers from your phone via simple keyword commands — status, start, stop, restart, update, logs.
|
|
|
|
## Phases
|
|
|
|
### Phase 1: Foundation
|
|
|
|
**Goal:** Basic Telegram ↔ n8n communication working
|
|
**Plans:** 2 plans
|
|
|
|
Plans:
|
|
- [x] 01-01-PLAN.md — Create Telegram bot and n8n workflow
|
|
- [x] 01-02-PLAN.md — Verify echo and authentication
|
|
|
|
**Delivers:** REQ-01 (send/receive messages), REQ-09 (user ID auth)
|
|
**Status:** Complete (2026-01-28)
|
|
|
|
---
|
|
|
|
### Phase 2: Docker Integration
|
|
|
|
**Goal:** n8n can query Docker and return container info
|
|
**Plans:** 2 plans
|
|
|
|
Plans:
|
|
- [x] 02-01-PLAN.md — Configure n8n container for Docker socket access
|
|
- [x] 02-02-PLAN.md — Add Docker query workflow with container matching
|
|
|
|
**Delivers:** REQ-02 (container status queries)
|
|
**Status:** Complete (2026-01-29)
|
|
|
|
---
|
|
|
|
### Phase 3: Container Actions
|
|
|
|
**Goal:** Control containers through conversation
|
|
**Plans:** 4 plans
|
|
|
|
Plans:
|
|
- [x] 03-01-PLAN.md — Single-match container actions (start/stop/restart)
|
|
- [x] 03-02-PLAN.md — Callback infrastructure and no-match suggestions
|
|
- [x] 03-03-PLAN.md — Batch confirmation for multiple matches
|
|
- [x] 03-04-PLAN.md — Container update action (pull + recreate)
|
|
|
|
**Delivers:** REQ-03, REQ-04, REQ-05, REQ-06
|
|
**Status:** Complete (2026-01-30)
|
|
|
|
---
|
|
|
|
### Phase 4: Logs
|
|
|
|
**Goal:** View container logs via Telegram
|
|
**Plans:** 1 plan
|
|
|
|
Plans:
|
|
- [x] 04-01-PLAN.md — Container log retrieval with configurable lines
|
|
|
|
**Delivers:** REQ-07 (logs)
|
|
**Status:** Complete (2026-01-31)
|
|
|
|
---
|
|
|
|
### Phase 5: Polish & Deploy
|
|
|
|
**Goal:** Production-ready deployment on Unraid
|
|
**Plans:** 3 plans
|
|
|
|
Plans:
|
|
- [x] 05-01-PLAN.md — Remove NLU nodes and add keyword routing with persistent menu
|
|
- [x] 05-02-PLAN.md — Standardize error messages and migrate credentials
|
|
- [x] 05-03-PLAN.md — Write deployment README and end-to-end testing
|
|
|
|
**Delivers:** Production readiness
|
|
**Status:** Complete (2026-02-02)
|
|
|
|
---
|
|
|
|
## Requirements Mapping
|
|
|
|
| REQ | Description | Phase | Status |
|
|
|-----|-------------|-------|--------|
|
|
| REQ-01 | Send/receive messages | 1 | Complete |
|
|
| REQ-02 | Container status queries | 2 | Complete |
|
|
| REQ-03 | Start container | 3 | Complete |
|
|
| REQ-04 | Stop container | 3 | Complete |
|
|
| REQ-05 | Restart container | 3 | Complete |
|
|
| REQ-06 | Update container | 3 | Complete |
|
|
| REQ-07 | View logs (configurable lines) | 4 | Complete |
|
|
| REQ-08 | ~~Conversational queries~~ | - | Out of scope |
|
|
| REQ-09 | User ID authentication | 1 | Complete |
|
|
|
|
---
|
|
|
|
## Milestone Summary
|
|
|
|
**Key Decisions:**
|
|
- Use n8n for orchestration (already running on Unraid)
|
|
- Simple keyword matching over Claude NLU (reduces complexity)
|
|
- Single-user auth via Telegram user ID
|
|
- Hardcoded user ID in workflow (n8n CE limitation)
|
|
- Static curl binary mount (hardened n8n image)
|
|
- Exact match priority for container names
|
|
- Default to :latest tag when pulling images
|
|
- HTML escape log output for Telegram
|
|
|
|
**Issues Resolved:**
|
|
- Docker socket access (--group-add 281)
|
|
- Memory exhaustion on large pulls (tail -c 10000)
|
|
- All tags pulled without explicit tag (append :latest)
|
|
- HTML parse errors in logs (<computed> text)
|
|
- Container name collisions (exact match priority)
|
|
|
|
**Technical Debt:**
|
|
- None significant for v1.0
|
|
|
|
---
|
|
*Archived: 2026-02-02*
|