Lucas Berger
107 lines
4.1 KiB
Markdown
107 lines
4.1 KiB
Markdown
# Project State -- Unraid Docker Manager
|
|
|
|
## Current Position
|
|
|
|
- **Milestone:** v1.4 Unraid API Native
|
|
- **Phase:** 15 of 18 (Infrastructure Foundation) - Plan 2 of 2 complete
|
|
- **Status:** In progress
|
|
- **Last activity:** 2026-02-09 — Phase 15 Plan 02 complete (GraphQL utility nodes)
|
|
|
|
## Project Reference
|
|
|
|
See: .planning/PROJECT.md (updated 2026-02-09)
|
|
|
|
**Core value:** When you get a container update notification or notice a service is down, you can immediately investigate and act from your phone.
|
|
|
|
**Current focus:** v1.4 Unraid API Native — replace Docker socket proxy with Unraid GraphQL API
|
|
|
|
## Progress
|
|
|
|
```
|
|
v1.0: [**********] 100% SHIPPED (Phases 1-5, 12 plans)
|
|
v1.1: [**********] 100% SHIPPED (Phases 6-9, 11 plans)
|
|
v1.2: [**********] 100% SHIPPED (Phases 10-13 + 10.1-10.2, 25 plans)
|
|
v1.3: [**********] 100% SHIPPED (Phase 14, 2 plans — descoped)
|
|
v1.4: [*.........] 10% IN PROGRESS (Phases 15-18, 1 of ~10 plans)
|
|
|
|
Overall: 4 milestones shipped (14 phases, 50 plans), v1.4 in progress (1 plan complete)
|
|
```
|
|
|
|
## Performance Metrics
|
|
|
|
**Velocity:**
|
|
- Total plans completed: 51
|
|
- Total execution time: 12 days + 5 minutes (v1.0: 5 days, v1.1: 2 days, v1.2: 4 days, v1.3: 1 day, v1.4: 5 min)
|
|
- Average per milestone: 3 days
|
|
|
|
**By Milestone:**
|
|
|
|
| Milestone | Plans | Duration | Avg/Plan |
|
|
|-----------|-------|----------|----------|
|
|
| v1.0 | 12 | 5 days | ~10 hours |
|
|
| v1.1 | 11 | 2 days | ~4 hours |
|
|
| v1.2 | 25 | 4 days | ~4 hours |
|
|
| v1.3 | 2 | 1 day | ~2 minutes |
|
|
| v1.4 | 1 | 5 minutes | 5 minutes |
|
|
|
|
**Phase 15 Details:**
|
|
|
|
| Plan | Duration | Tasks | Files |
|
|
|------|----------|-------|-------|
|
|
| 15-02 | 5 min | 2 | 1 |
|
|
|
|
## Accumulated Context
|
|
|
|
### Decisions
|
|
|
|
Decisions are logged in PROJECT.md Key Decisions table.
|
|
Key decisions from v1.3 and v1.4 planning:
|
|
|
|
- [v1.4] Remove container logs feature entirely (not valuable enough to justify hybrid architecture)
|
|
- [v1.4] Remove docker-socket-proxy completely (clean single-API architecture)
|
|
- [v1.3] Descope to Phase 14 only — Phases 15-16 superseded by v1.4 Unraid API Native
|
|
- [v1.3] myunraid.net cloud relay for Unraid API (direct LAN IP fails due to nginx redirect)
|
|
- [v1.3] Environment variables for Unraid API auth (more reliable than n8n Header Auth)
|
|
- [Phase 15-02]: GraphQL normalizer keeps full Unraid PrefixedID (Container ID Registry handles translation)
|
|
- [Phase 15-02]: ALREADY_IN_STATE error maps to HTTP 304 (matches Docker API pattern)
|
|
- [Phase 15-02]: 15-second timeout for myunraid.net cloud relay (200-500ms latency + safety margin)
|
|
|
|
### Pending Todos
|
|
|
|
None.
|
|
|
|
### Blockers/Concerns
|
|
|
|
**v1.4 architectural risks (from research):**
|
|
- Container ID format translation critical (Docker 64-char hex vs Unraid 129-char PrefixedID)
|
|
- Telegram callback data 64-byte limit with longer IDs requires encoding redesign
|
|
- GraphQL response normalization must prevent cascading failures across 60+ Code nodes
|
|
- myunraid.net cloud relay adds 200-500ms latency (timeout configuration needed)
|
|
|
|
**Next phase readiness:**
|
|
- Phase 15 Plan 02 complete — GraphQL utility nodes ready
|
|
- Phase 16 (API Migration) ready to begin
|
|
- Utility nodes provide complete transformation pipeline
|
|
- No blockers
|
|
|
|
## Key Artifacts
|
|
|
|
- `n8n-workflow.json` -- Main workflow (175 nodes — includes 3 GraphQL utility nodes from Phase 15)
|
|
- `n8n-batch-ui.json` -- Batch UI sub-workflow (17 nodes) -- ID: `ZJhnGzJT26UUmW45`
|
|
- `n8n-status.json` -- Container Status sub-workflow (11 nodes) -- ID: `lqpg2CqesnKE2RJQ`
|
|
- `n8n-confirmation.json` -- Confirmation Dialogs sub-workflow (16 nodes) -- ID: `fZ1hu8eiovkCk08G`
|
|
- `n8n-update.json` -- Container Update sub-workflow (34 nodes) -- ID: `7AvTzLtKXM2hZTio92_mC`
|
|
- `n8n-actions.json` -- Container Actions sub-workflow (11 nodes) -- ID: `fYSZS5PkH0VSEaT5`
|
|
- `n8n-logs.json` -- Container Logs sub-workflow (9 nodes) -- ID: `oE7aO2GhbksXDEIw` -- TO BE REMOVED
|
|
- `n8n-matching.json` -- Container Matching sub-workflow (23 nodes) -- ID: `kL4BoI8ITSP9Oxek`
|
|
- `ARCHITECTURE.md` -- Full architecture docs, contracts, and node analysis
|
|
|
|
## Session Continuity
|
|
|
|
Last session: 2026-02-09
|
|
Stopped at: Completed 15-02-PLAN.md
|
|
Next step: Continue Phase 15 (Plan 01 if needed) or begin Phase 16 API Migration
|
|
|
|
---
|
|
*Auto-maintained by GSD workflow*
|