Update Dockerfile and workflows to use BASE_IMAGE_TAG for ESP-IDF versioning

- Refactor Dockerfile to replace ESP_IDF_VERSION with BASE_IMAGE_TAG for improved clarity and consistency in versioning.
- Update GitHub Actions workflow to align with the new BASE_IMAGE_TAG format, ensuring seamless integration during builds.
- Modify README to reflect changes in build arguments, enhancing user understanding of the build process.

Author: hacker-cb

.github/workflows/esp-idf.yml

@@ -144,7 +144,7 @@ jobs:
           cache-from: type=gha,scope=esp-matter-${{ steps.platform.outputs.tag }}
           cache-to: type=gha,mode=max,scope=esp-matter-${{ steps.platform.outputs.tag }}
           build-args: |
-            ESP_IDF_VERSION=${{ matrix.esp_idf_version }}
+            BASE_IMAGE_TAG=idf-${{ matrix.esp_idf_version }}-${{ steps.platform.outputs.tag }}
             ESP_MATTER_VERSION=${{ matrix.esp_matter_version }}
 
   create-manifest-matter:

images/esp-matter/Dockerfile

@@ -1,12 +1,11 @@
 # ESP-Matter Development Image
 # Build arguments for version pinning
-ARG ESP_IDF_VERSION=v5.4.1
+ARG BASE_IMAGE_TAG=idf-v5.4.1
 ARG ESP_MATTER_VERSION=v1.4.2
 
 # Use our esp-idf image as base
-# For local builds: Uses idf-${ESP_IDF_VERSION} tag
-# For CI/CD: Override with --build-arg BASE_IMAGE_TAG=idf-${ESP_IDF_VERSION}-linux-${ARCH}
-ARG BASE_IMAGE_TAG=idf-${ESP_IDF_VERSION}
+# For local builds: Uses default idf-v5.4.1 tag
+# For CI/CD: Override with --build-arg BASE_IMAGE_TAG=idf-v5.4.1-linux-${ARCH}
 FROM ghcr.io/jethome-iot/jethome-dev-esp-idf:${BASE_IMAGE_TAG}
 
 # Re-declare build arguments after FROM

images/esp-matter/README.md

@@ -252,13 +252,13 @@ docker build -t jethome-dev-esp-matter .
 
 ```bash
 docker build \
-  --build-arg ESP_IDF_VERSION=v5.4.1 \
+  --build-arg BASE_IMAGE_TAG=idf-v5.4.1 \
   --build-arg ESP_MATTER_VERSION=v1.4.2 \
   -t jethome-dev-esp-matter .
 ```
 
 Available build arguments:
-- `ESP_IDF_VERSION` - ESP-IDF version (default: `v5.4.1`)
+- `BASE_IMAGE_TAG` - ESP-IDF base image tag (default: `idf-v5.4.1`)
 - `ESP_MATTER_VERSION` - ESP-Matter version tag (default: `v1.4.2`)
 
 ### Multi-Platform Support