From e9ca42060c2e91a62b9a4ba70e9257929bc7b4dc Mon Sep 17 00:00:00 2001 From: kisfenyo Date: Mon, 8 Jun 2026 13:38:27 +0200 Subject: [PATCH] chore: rework references for repo rename deploy-felhom-compose -> felhom-controller Repo renamed on Gitea (admin/deploy-felhom-compose -> admin/felhom-controller). Updates clone URLs, clone dirs, the customer bootstrap URL, build.sh, BUILDING.md, README.md, CLAUDE.md, CONTEXT.md and TASK.md to the new name. No functional change: Go module path and Docker image path (both already 'felhom-controller') untouched. Co-Authored-By: Claude Opus 4.8 (1M context) --- CHANGELOG.md | 7 +++++++ CLAUDE.md | 8 ++++---- CONTEXT.md | 2 +- TASK.md | 2 +- controller/BUILDING.md | 12 ++++++------ controller/README.md | 4 ++-- controller/build.sh | 4 ++-- scripts/README.md | 2 +- scripts/felhom-wipe.sh | 2 +- 9 files changed, 25 insertions(+), 18 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 43011ad..cafc4e4 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,12 @@ ## Changelog +### Repo rename — `deploy-felhom-compose` → `felhom-controller` (2026-06-08) + +#### Changed +- **Gitea repo renamed** `admin/deploy-felhom-compose` → `admin/felhom-controller` (via API). Sibling rename: `admin/proxmox-controller` → `admin/felhom-agent` (docs repo, future agent code). +- **Reference rework (no functional change)**: updated every reference to the old repo name across docs and scripts — clone URLs, clone dirs (`~/git/felhom-controller`), the customer bootstrap URL in `scripts/felhom-wipe.sh` / `scripts/README.md`, `controller/build.sh`, `controller/BUILDING.md`, `controller/README.md`, `CLAUDE.md`, `CONTEXT.md`, `TASK.md`. Local working-copy dirs and the build-server source clone (`192.168.0.180:~/git/`) renamed to match. +- **Intentionally unchanged**: Go module path `gitea.dooplex.hu/admin/felhom-controller` (already matches new name), Docker image path `gitea.dooplex.hu/admin/felhom-controller` (registry is namespaced by owner, not repo), binary name `felhom-controller`. Historical CHANGELOG entries left as-is (they record what was true at the time). + ### Refactor — extract app-data-backup primitives into `internal/appbackup` (no behaviour change) (2026-06-08) #### Changed diff --git a/CLAUDE.md b/CLAUDE.md index 3a78103..3d00c86 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -12,7 +12,7 @@ ## Project overview Creating a business (Felhom) for home-server deployment for Hungarian customers. This repository -(`deploy-felhom-compose`) contains the felhom-controller — a Go application that manages Docker +(`felhom-controller`) contains the felhom-controller — a Go application that manages Docker Compose stacks on customer hardware via a Hungarian-language web dashboard. See `controller/README.md` for full architecture and status (update after each session, keep track of how different functions/features operate, like backup, monitoring, storage handling, app management, user settings, update workflow, notification system, etc-etc...). @@ -44,7 +44,7 @@ Claude Code runs on Windows 11. The working directory is `E:\git\` (mapped as `/ This repo is at: ``` -E:\git\deploy-felhom-compose\ (or /e/git/deploy-felhom-compose/ in Git Bash) +E:\git\felhom-controller\ (or /e/git/felhom-controller/ in Git Bash) ├── controller/ # Go application (main codebase) │ ├── cmd/controller/ # Entry point (main.go) │ ├── internal/ @@ -123,7 +123,7 @@ Do NOT leave code changes uncommitted or undeployed. The full cycle is: ### Step 1: Commit and push changes ```bash -cd /e/git/deploy-felhom-compose +cd /e/git/felhom-controller git add -A && git commit -m "" && git push ``` @@ -146,7 +146,7 @@ $SSH kisfenyo@192.168.0.162 "docker ps --filter name=felhom-controller --format Then build with the next version (e.g., if current is 0.2.10, use 0.2.11): IMPORTANT!: Build directory is: ~/build/felhom-controller ```bash -$SSH kisfenyo@192.168.0.180 "cd ~/build/felhom-controller && git -C ~/git/deploy-felhom-compose pull && ./build.sh --push" +$SSH kisfenyo@192.168.0.180 "cd ~/build/felhom-controller && git -C ~/git/felhom-controller pull && ./build.sh --push" ``` The build script: diff --git a/CONTEXT.md b/CONTEXT.md index a5c8594..22304ab 100644 --- a/CONTEXT.md +++ b/CONTEXT.md @@ -124,7 +124,7 @@ Last updated: 2026-02-19 (session 59) | Repository | Status | Notes | |------------|--------|-------| -| deploy-felhom-compose | Active | This repo. Controller code + deploy scripts | +| felhom-controller | Active | This repo. Controller code + deploy scripts | | app-catalog-felhom.eu | Active | 10 app templates, all with .felhom.yml metadata + memory limits | | felhom.eu | Active | Website + hub/ subfolder (felhom-hub service) + k8s manifests | | homelab-manifests | Stable | k3s cluster running (dooplex.hu services) | diff --git a/TASK.md b/TASK.md index e48d817..de7710f 100644 --- a/TASK.md +++ b/TASK.md @@ -331,7 +331,7 @@ After deployment: ```bash SSH=/c/Windows/System32/OpenSSH/ssh.exe # After committing and pushing: -$SSH kisfenyo@192.168.0.180 "cd ~/build/felhom-controller && git -C ~/git/deploy-felhom-compose pull && ./build.sh v0.28.0 --push" +$SSH kisfenyo@192.168.0.180 "cd ~/build/felhom-controller && git -C ~/git/felhom-controller pull && ./build.sh v0.28.0 --push" $SSH kisfenyo@192.168.0.162 "cd /opt/docker/felhom-controller && sudo docker pull gitea.dooplex.hu/admin/felhom-controller:v0.28.0 && sudo sed -i 's|image: gitea.dooplex.hu/admin/felhom-controller:.*|image: gitea.dooplex.hu/admin/felhom-controller:v0.28.0|' docker-compose.yml && sudo docker compose up -d" ``` diff --git a/controller/BUILDING.md b/controller/BUILDING.md index 7aad090..4fd88ce 100644 --- a/controller/BUILDING.md +++ b/controller/BUILDING.md @@ -2,10 +2,10 @@ ## Repository layout -Source lives in the `controller/` subfolder of the deploy-felhom-compose repo: +Source lives in the `controller/` subfolder of the felhom-controller repo: ``` -https://gitea.dooplex.hu/admin/deploy-felhom-compose +https://gitea.dooplex.hu/admin/felhom-controller └── controller/ ├── cmd/controller/main.go ├── internal/ @@ -26,7 +26,7 @@ are flat in `controller/`, run the restructure script first (see Step 0). ## Build setup -Git repo: `/home/kisfenyo/git/deploy-felhom-compose` +Git repo: `/home/kisfenyo/git/felhom-controller` Build dir: `/home/kisfenyo/build/felhom-controller/` (outside the repo — keeps it clean) ```bash @@ -41,7 +41,7 @@ chmod +x ~/build/felhom-controller/build.sh If all `.go` files are in `controller/` without subdirectories: ```bash -cd ~/git/deploy-felhom-compose/controller +cd ~/git/felhom-controller/controller bash restructure.sh # Verify it compiles go mod tidy && go build ./cmd/controller/ @@ -107,7 +107,7 @@ Build artifacts live in `~/build/felhom-controller/workspace/` — your git repo Edit the top of `build.sh` if your paths differ: ```bash -REPO_DIR="/home/kisfenyo/git/deploy-felhom-compose" +REPO_DIR="/home/kisfenyo/git/felhom-controller" CONTROLLER_SRC="${REPO_DIR}/controller" WEBSITE_ASSETS_DIR="/home/kisfenyo/git/felhom.eu/website/assets" ``` @@ -183,7 +183,7 @@ curl -v https://gitea.dooplex.hu/v2/ ### Structure check fails ```bash # The build script verifies package dirs exist. If it fails: -cd ~/git/deploy-felhom-compose/controller +cd ~/git/felhom-controller/controller ls -la cmd/controller/ internal/config/ internal/stacks/ internal/api/ internal/web/ # If these don't exist, run restructure.sh first ``` diff --git a/controller/README.md b/controller/README.md index 40f8bcc..db28a6a 100644 --- a/controller/README.md +++ b/controller/README.md @@ -1730,7 +1730,7 @@ Response format: `{"ok": true/false, "data": ..., "error": "...", "message": ".. ```bash # On build server (192.168.0.180) cd ~/build/felhom-controller -git -C ~/git/deploy-felhom-compose pull +git -C ~/git/felhom-controller pull ./build.sh v0.20.0 --push ``` @@ -1828,6 +1828,6 @@ See `docker-compose.yml` for the full volume configuration. | Repository | Purpose | |------------|---------| -| [deploy-felhom-compose](https://gitea.dooplex.hu/admin/deploy-felhom-compose) | This repo — controller + deploy scripts | +| [felhom-controller](https://gitea.dooplex.hu/admin/felhom-controller) | This repo — controller + deploy scripts | | [app-catalog-felhom.eu](https://gitea.dooplex.hu/admin/app-catalog-felhom.eu) | Docker Compose templates + .felhom.yml metadata | | [felhom.eu](https://gitea.dooplex.hu/admin/felhom.eu) | Website + app assets + felhom-hub service | diff --git a/controller/build.sh b/controller/build.sh index a37572c..0b19911 100755 --- a/controller/build.sh +++ b/controller/build.sh @@ -16,7 +16,7 @@ set -euo pipefail # --- Configuration (edit these if your paths differ) --- -REPO_DIR="/home/kisfenyo/git/deploy-felhom-compose" +REPO_DIR="/home/kisfenyo/git/felhom-controller" CONTROLLER_SRC="${REPO_DIR}/controller" WEBSITE_ASSETS_DIR="/home/kisfenyo/git/felhom.eu/website/assets" REGISTRY="gitea.dooplex.hu/admin" @@ -40,7 +40,7 @@ step() { echo -e "${CYAN}[STEP]${NC} $*"; } # --- Pre-flight checks --- if [[ ! -d "${CONTROLLER_SRC}" ]]; then error "Controller source not found: ${CONTROLLER_SRC}" - error "Clone the repo first: git clone https://gitea.dooplex.hu/admin/deploy-felhom-compose.git ${REPO_DIR}" + error "Clone the repo first: git clone https://gitea.dooplex.hu/admin/felhom-controller.git ${REPO_DIR}" exit 1 fi diff --git a/scripts/README.md b/scripts/README.md index 568a649..66546c8 100644 --- a/scripts/README.md +++ b/scripts/README.md @@ -304,5 +304,5 @@ wizard to temporarily inspect drives. It is cleaned up from `full` level onwards ### Redeploy after nuclear wipe ```bash -curl -fsSL https://gitea.dooplex.hu/admin/deploy-felhom-compose/raw/branch/main/scripts/docker-setup.sh | bash +curl -fsSL https://gitea.dooplex.hu/admin/felhom-controller/raw/branch/main/scripts/docker-setup.sh | bash ``` diff --git a/scripts/felhom-wipe.sh b/scripts/felhom-wipe.sh index 1b14e55..b76c7c0 100644 --- a/scripts/felhom-wipe.sh +++ b/scripts/felhom-wipe.sh @@ -484,7 +484,7 @@ do_nuclear_wipe() { echo "" info "Nuclear wipe complete." echo -e "${CYAN}To redeploy, run:${NC}" - echo " curl -fsSL https://gitea.dooplex.hu/admin/deploy-felhom-compose/raw/branch/main/scripts/docker-setup.sh | bash" + echo " curl -fsSL https://gitea.dooplex.hu/admin/felhom-controller/raw/branch/main/scripts/docker-setup.sh | bash" } # --- Main ---