doc updates and test fixin

docs/operations/DEPLOYMENT.md

@@ -80,6 +80,22 @@ For deployments using Gitea CI/CD workflows, configure these as **repository sec
 
 ## NGINX Configuration
 
+### Reference Configuration Files
+
+The repository contains reference copies of the production NGINX configurations for documentation and version control purposes:
+
+| File                                                              | Server Config             |
+| ----------------------------------------------------------------- | ------------------------- |
+| `etc-nginx-sites-available-flyer-crawler.projectium.com`          | Production NGINX config   |
+| `etc-nginx-sites-available-flyer-crawler-test-projectium-com.txt` | Test/staging NGINX config |
+
+**Important Notes:**
+
+- These are **reference copies only** - they are not used directly by NGINX
+- The actual live configurations reside on the server at `/etc/nginx/sites-available/`
+- When modifying server NGINX configs, update these reference files to keep them in sync
+- Use the dev container config at `docker/nginx/dev.conf` for local development
+
 ### Reverse Proxy Setup
 
 Create a site configuration at `/etc/nginx/sites-available/flyer-crawler.projectium.com`:
@@ -106,9 +122,35 @@ server {
         proxy_set_header Host $host;
         proxy_cache_bypass $http_upgrade;
     }
+
+    # Serve flyer images from static storage (7-day cache)
+    location /flyer-images/ {
+        alias /var/www/flyer-crawler.projectium.com/flyer-images/;
+        expires 7d;
+        add_header Cache-Control "public, immutable";
+    }
 }
 ```
 
+### Static Flyer Images
+
+Flyer images are served as static files from the `/flyer-images/` path with browser caching enabled:
+
+| Environment   | Directory                                                  | URL Pattern                                               |
+| ------------- | ---------------------------------------------------------- | --------------------------------------------------------- |
+| Production    | `/var/www/flyer-crawler.projectium.com/flyer-images/`      | `https://flyer-crawler.projectium.com/flyer-images/`      |
+| Test          | `/var/www/flyer-crawler-test.projectium.com/flyer-images/` | `https://flyer-crawler-test.projectium.com/flyer-images/` |
+| Dev Container | `/app/public/flyer-images/`                                | `https://localhost/flyer-images/`                         |
+
+**Cache Settings**: Files are served with `expires 7d` and `Cache-Control: public, immutable` headers for optimal browser caching.
+
+Create the flyer images directory if it does not exist:
+
+```bash
+sudo mkdir -p /var/www/flyer-crawler.projectium.com/flyer-images
+sudo chown www-data:www-data /var/www/flyer-crawler.projectium.com/flyer-images
+```
+
 Enable the site:
 
 ```bash