feat: implement image management system

.github/workflows/create-release.yml

@@ -66,6 +66,15 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
+      - name: Install build dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y make imagemagick
+
+      - name: Optimize images from matrici
+        run: |
+          make optimize-images
+
       - name: Build the site in the jekyll/builder container
         run: |
           docker run \

.github/workflows/validate-pr.yml

@@ -113,3 +113,126 @@ jobs:
             echo "❌ HTML found in markdown files"
             exit 1
           fi
+
+  check-generated-images:
+    runs-on: ubuntu-latest
+    env:
+      FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install build dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y make imagemagick
+
+      - name: Generate images from matrici
+        run: |
+          make optimize-images
+
+      - name: Check if assets/images needs update
+        id: check-images
+        run: |
+          if [[ -n "$(git diff src/jekyll/assets/images/)" ]]; then
+            echo "❌ Generated images are out of sync with matrici"
+            echo "Run 'make optimize-images' and commit the changes"
+            git diff --stat src/jekyll/assets/images/
+            exit 1
+          else
+            echo "✅ Generated images are in sync with matrici"
+          fi
+
+      - name: Comment on PR if images out of sync
+        if: failure() && steps.check-images.outcome == 'failure'
+        uses: actions/github-script@v6
+        with:
+          script: |
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: '❌ **Images Out of Sync**\n\n' +
+                    'Le immagini in `src/jekyll/assets/images/` non sono sincronizzate con `src/matrici/images/`.\n\n' +
+                    '**Soluzione:**\n' +
+                    '```bash\n' +
+                    'make optimize-images\n' +
+                    'git add src/jekyll/assets/images/\n' +
+                    'git commit -m "chore: regenerate optimized images"\n' +
+                    '```\n\n' +
+                    'Questo genererà le immagini ottimizzate dalle matrici.'
+            })
+
+  check-image-placeholders:
+    runs-on: ubuntu-latest
+    env:
+      FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install dependencies
+        run: |
+          cd scripts
+          npm install
+
+      - name: Check image placeholders
+        id: check-placeholders
+        run: |
+          cd scripts
+          node check-image-placeholders.js
+
+      - name: Validate image specs
+        id: validate-specs
+        run: |
+          cd scripts
+          node validate-image-specs.js
+
+      - name: Comment on PR if issues found
+        if: failure()
+        uses: actions/github-script@v6
+        with:
+          script: |
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: '❌ **Image Issues Found**\n\n' +
+                    'Sostituisci placeholder o correggi specifiche:\n' +
+                    '- **Volantini**: 3508×4961px (A3), max 500KB\n' +
+                    '- **Featured**: 1200×630px (16:9), max 200KB\n\n' +
+                    'Vedi log per dettagli completi.\n\n' +
+                    '📖 Guida: docs/IMAGE_GUIDE.md'
+            })
+
+  check-matrici-sync:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check matrici → assets sync
+        run: |
+          node scripts/check-matrici-sync.js
+
+      - name: Comment on PR if out of sync
+        if: failure()
+        uses: actions/github-script@v6
+        with:
+          script: |
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: '❌ **Matrici/Images Out of Sync**\n\n' +
+                    'Le immagini in src/matrici/images/ non sono sincronizzate con src/jekyll/assets/images/\n\n' +
+                    '**Soluzione:**\n' +
+                    '```bash\n' +
+                    'make optimize-images\n' +
+                    'git add src/jekyll/assets/images/\n' +
+                    'git commit -m "chore: sync assets from matrici"\n' +
+                    '```\n\n' +
+                    'Vedi docs/IMAGE_GUIDE.md per dettagli'
+            })

.gitignore

@@ -24,6 +24,9 @@ src/node_modules/
 src/output/
 src/vendor/
 
+# Generated images from matrici (run make optimize-images to regenerate)
+src/jekyll/assets/images/
+
 # Old accessibility reports location (now in output/accessibility/)
 docs/accessibility/reports/
 src/jekyll/.jekyll-cache/

CHANGELOG.txt

@@ -8,9 +8,64 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-
 ### Added
-- Project structure reorganization
+- Image management system with matrici (source repository)
+  - src/matrici/images/ for original PNG sources
+  - src/jekyll/assets/images/ as generated cache (not in git)
+  - Automatic optimization pipeline: PNG → JPG with size constraints
+  - Multi-size generation from single source (apple-touch-icon)
+  - Placeholder generation with protection against overwriting real images
+- make optimize-images target for automatic image processing
+  - Copy software logos (PNG with transparency)
+  - Copy branch logos (PNG with transparency)
+  - Generate apple-touch-icon sizes (72x72, 114x114, 144x144) from single source
+  - Optimize volantini (A3 @ 300DPI, 3508x4961)
+  - Optimize featured images (16:9, 1200x630)
+- make generate-placeholders for missing images
+  - Creates 1px red PNG placeholders for missing event/featured images
+  - Protection against overwriting real images (> 1KB)
+  - Force mode with --force flag
+- CI/CD integration for image optimization
+  - Automatic image generation during release workflow
+  - ImageMagick installed in CI for resize operations
+  - PR validation for generated images sync
+- .gitignore update for src/jekyll/assets/images/ (generated cache)
+
+### Changed
+- Image workflow from manual to automated
+  - Old: Manual optimization, JPG in git
+  - New: PNG sources in matrici, automatic generation, git-ignored cache
+- apple-touch-icon management
+  - Old: Multiple size files manually maintained
+  - New: Single high-res source, automatic multi-size generation
+  - Dimension validation (minimum 144x144, recommends 512x512)
+- HTML layout for apple-touch-icon
+  - Added explicit links for all sizes (72x72, 114x114, 144x144)
+  - Ensures iOS devices use correct resolution
+
+### Fixed
+- JPG conversion breaking PNG transparency
+  - Software logos now copied as PNG (transparency preserved)
+  - Branch logos now copied as PNG (transparency preserved)
+  - Apple-touch-icon generated as PNG (not JPG)
+- Missing image generation for campo-eg locandina
+  - Fixed optimize-volantini to handle both PNG and JPG placeholders
+  - generate-placeholders now creates PNG (not JPG)
+- Placeholder generation overwriting real images
+  - Added dimension check (> 1KB = real image, skip)
+  - Added --force flag to override protection when needed
+- Image dimension validation
+  - apple-touch-icon source validated for minimum 144x144
+  - Warning if upsampling required (quality degradation risk)
+
+### Removed
+- Manual image optimization workflow
+- Multiple redundant image files in git
+  - Software logo JPG versions (replaced with PNG generation)
+  - Branch logo JPG versions (replaced with PNG generation)
+  - Individual apple-touch-icon sizes (replaced with single source)
+
+### Project structure reorganization
   - All source files moved to src/ subdirectories (src/jekyll/, src/tailwind/, src/docker/)
   - New output/ directory for generated content (output/_site/, output/screenshots/)
   - Clear separation between source code and build artifacts