Fix Docker workflow filename expectation for custom .deb

Updated Docker workflow and Dockerfiles to expect the correct filename:
- Changed from: onlyoffice-communityserver-custom.deb
- Changed to: onlyoffice-communityserver-mail-custom.deb

This matches the actual filename created by the mail-targeted build workflow.
Files updated:
- .github/workflows/build-docker.yml: Download URL and output filename
- Dockerfile.mod: COPY and install commands
- Dockerfile.multi: COPY command
- Workflow descriptions and traceability messages

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: root

.Dockerfile.multi.swp

@@ -65,15 +65,60 @@ jobs:
           repository: 42mgr/OO_CommunityServer
           token: ${{ secrets.PAT_TOKEN }}
 
+      - name: Display release information
+        run: |
+          echo "🏷️ RELEASE INFORMATION FOR ${{ matrix.build_type }} BUILD:"
+          echo "📋 Release Tag: ${{ steps.get_release.outputs.release }}"
+          echo "📅 Release Date: $(curl -s https://api.github.com/repos/42mgr/OO_CommunityServer/releases/tags/${{ steps.get_release.outputs.release }} | jq -r '.created_at')"
+          echo "📦 Build Type: ${{ matrix.build_type }}"
+          echo "🐳 Docker Tag: ${{ matrix.tag }}"
+          echo ""
+          echo "📊 Recent releases for context:"
+          curl -s https://api.github.com/repos/42mgr/OO_CommunityServer/releases | jq -r '.[:5] | .[] | "\(.tag_name) - \(.created_at) - \(.name)"'
+          echo ""
+
       - name: Download .deb from latest release
         run: |
           echo "📦 Downloading .deb for ${{ matrix.build_type }} build..."
-          curl -L -o onlyoffice-communityserver-custom.deb \
-            -H "Authorization: Bearer ${{ secrets.PAT_TOKEN }}" \
-            https://github.com/42mgr/OO_CommunityServer/releases/download/${{ steps.get_release.outputs.release }}/onlyoffice-communityserver-custom.deb
+          echo "🏷️ Using release: ${{ steps.get_release.outputs.release }}"
+          
+          DOWNLOAD_URL="https://github.com/42mgr/OO_CommunityServer/releases/download/${{ steps.get_release.outputs.release }}/onlyoffice-communityserver-mail-custom.deb"
+          echo "🔗 Download URL: $DOWNLOAD_URL"
+          
+          # Check if the asset exists before downloading
+          if curl -s -f -I -H "Authorization: Bearer ${{ secrets.PAT_TOKEN }}" "$DOWNLOAD_URL" >/dev/null; then
+            echo "✅ Asset found, downloading..."
+            curl -L -o onlyoffice-communityserver-mail-custom.deb \
+              -H "Authorization: Bearer ${{ secrets.PAT_TOKEN }}" \
+              "$DOWNLOAD_URL"
+          else
+            echo "❌ Asset not found at expected URL, checking available assets..."
+            curl -s -H "Authorization: Bearer ${{ secrets.PAT_TOKEN }}" \
+              "https://api.github.com/repos/42mgr/OO_CommunityServer/releases/tags/${{ steps.get_release.outputs.release }}" | \
+              jq -r '.assets[] | .name'
+            exit 1
+          fi
+          
+          echo ""
+          echo "✅ Downloaded .deb file details:"
+          ls -lh onlyoffice-communityserver-mail-custom.deb
+          
+          # Create a build info file for the Docker image
+          cat > build-info.txt << EOF
+          DOCKER_BUILD_INFO
+          =================
+          Build Date: $(date -u +%Y-%m-%dT%H:%M:%SZ)
+          Build Type: ${{ matrix.build_type }}
+          Source Release: ${{ steps.get_release.outputs.release }}
+          Docker Tag: ${{ matrix.tag }}
+          Workflow Run: ${{ github.run_number }}
+          Commit SHA: ${{ github.sha }}
+          Repository: ${{ github.repository }}
+          EOF
           
-          echo "✅ Downloaded and renamed .deb file:"
-          ls -lh onlyoffice-communityserver-custom.deb
+          echo ""
+          echo "📋 Build information created:"
+          cat build-info.txt
 
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
@@ -129,6 +174,12 @@ jobs:
             org.opencontainers.image.revision=${{ github.sha }}
             build.type=${{ matrix.build_type }}
             build.dockerfile=${{ matrix.dockerfile }}
+            build.source_release=${{ steps.get_release.outputs.release }}
+            build.workflow_run=${{ github.run_number }}
+            build.deb_source=42mgr/OO_CommunityServer
+            onlyoffice.custom.source_release=${{ steps.get_release.outputs.release }}
+            onlyoffice.custom.build_date=$(date -u +'%Y-%m-%dT%H:%M:%SZ')
+            onlyoffice.custom.build_type=${{ matrix.build_type }}
 
       - name: Build and push Docker image (no cache)
         if: steps.cache-config.outputs.use_cache == 'false'
@@ -147,8 +198,37 @@ jobs:
             org.opencontainers.image.created=$(date -u +'%Y-%m-%dT%H:%M:%SZ')
             org.opencontainers.image.revision=${{ github.sha }}
             build.type=${{ matrix.build_type }}
+            build.source_release=${{ steps.get_release.outputs.release }}
+            build.workflow_run=${{ github.run_number }}
+            build.deb_source=42mgr/OO_CommunityServer
+            onlyoffice.custom.source_release=${{ steps.get_release.outputs.release }}
+            onlyoffice.custom.build_date=$(date -u +'%Y-%m-%dT%H:%M:%SZ')
+            onlyoffice.custom.build_type=${{ matrix.build_type }}
             build.dockerfile=${{ matrix.dockerfile }}
 
+      - name: Build success summary
+        if: success()
+        run: |
+          echo "🎉 Docker build completed successfully!"
+          echo ""
+          echo "📦 DOCKER IMAGE DETAILS:"
+          echo "  🐳 Image: mgr42/oo_crm:${{ matrix.tag }}"
+          echo "  🏷️ Tagged: ${{ matrix.tag }}-${{ steps.get_release.outputs.release }}"
+          echo "  📋 Build Type: ${{ matrix.build_type }}"
+          echo "  🔗 Source Release: ${{ steps.get_release.outputs.release }}"
+          echo "  🏗️ Workflow Run: ${{ github.run_number }}"
+          echo ""
+          echo "📋 RELEASE TRACEABILITY:"
+          echo "  ✅ This Docker image was built from:"
+          echo "     - Source: 42mgr/OO_CommunityServer"
+          echo "     - Release: ${{ steps.get_release.outputs.release }}"
+          echo "     - .deb Package: onlyoffice-communityserver-mail-custom.deb"
+          echo "     - Docker Build: ${{ github.run_number }}"
+          echo ""
+          echo "🔍 TO CHECK WHAT'S INSIDE THIS IMAGE:"
+          echo "  docker inspect mgr42/oo_crm:${{ matrix.tag }} | jq '.Config.Labels'"
+          echo "  docker run --rm mgr42/oo_crm:${{ matrix.tag }} cat /app/build-info.txt"
+
       - name: Build success notification
         if: success()
         run: |

.github/workflows/build-docker.yml

@@ -108,12 +108,17 @@ RUN apt-get -y update && \
   apt-get clean && \
   rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
 
-COPY onlyoffice-communityserver-custom.deb /tmp/
+COPY onlyoffice-communityserver-mail-custom.deb /tmp/
+COPY build-info.txt /app/
 
-RUN ls -ll /tmp
+RUN ls -ll /tmp && \
+    echo "📋 Build Information:" && \
+    cat /app/build-info.txt
 
 RUN apt-get update && \
-  apt-get install -y /tmp/onlyoffice-communityserver-custom.deb
+  apt-get install -y /tmp/onlyoffice-communityserver-mail-custom.deb && \
+  echo "✅ Custom OnlyOffice package installed" && \
+  dpkg -s onlyoffice-communityserver | grep -E "(Version|X-Modified-Components)" || true
 
 COPY config /app/config/
 COPY assets /app/assets/

Dockerfile.mod

@@ -153,7 +153,7 @@ LABEL ${PACKAGE_SYSNAME}.community.release-date="${RELEASE_DATE}" \
       securitytxt="https://www.${PACKAGE_SYSNAME}.com/.well-known/security.txt"
 
 # Copy the custom .deb file
-COPY onlyoffice-communityserver-custom.deb /tmp/onlyoffice-communityserver.deb
+COPY onlyoffice-communityserver-mail-custom.deb /tmp/onlyoffice-communityserver.deb
 
 # Install the custom OnlyOffice package
 RUN echo "📦 Installing custom OnlyOffice package..." && \

Dockerfile.multi

@@ -0,0 +1,207 @@
+# OnlyOffice Monitoring Stack
+
+This docker-compose file provides comprehensive monitoring for your OnlyOffice deployment with health monitoring, metrics collection, and alerting.
+
+## 🚀 Quick Start
+
+```bash
+# Start the full stack with monitoring
+docker-compose -f docker-compose.workspace-managed.yml up -d
+
+# View logs
+docker-compose -f docker-compose.workspace-managed.yml logs -f onlyoffice-monitor
+```
+
+## 📊 Access Points
+
+| Service | URL | Purpose |
+|---------|-----|---------|
+| **OnlyOffice** | http://localhost:1180 | Main application |
+| **Grafana** | http://monitoring.local:3000 | Dashboards & Visualization |
+| **Prometheus** | http://prometheus.local:9090 | Metrics & Queries |
+| **Monitor API** | http://monitor.local:8090 | Custom monitoring service |
+| **Traefik** | http://traefik.local:8080 | Load balancer dashboard |
+| **Alertmanager** | http://alerts.local:9093 | Alert management |
+
+**Default Credentials:**
+- Grafana: `admin` / `onlyoffice123`
+
+## 🏗️ Architecture
+
+### Core OnlyOffice Services
+- **Community Server** - Main application (with CRM auto-linking)
+- **Document Server** - Document editing
+- **Mail Server** - Email functionality  
+- **MySQL** - Database
+- **Elasticsearch** - Search & indexing
+- **Control Panel** - Management interface
+
+### Monitoring Stack
+- **Prometheus** - Metrics collection & storage
+- **Grafana** - Visualization dashboards
+- **Loki** - Log aggregation
+- **Promtail** - Log collection
+- **Alertmanager** - Alert routing & management
+- **Traefik** - Reverse proxy & load balancing
+
+### Exporters & Collectors
+- **Node Exporter** - Host system metrics
+- **cAdvisor** - Container metrics  
+- **MySQL Exporter** - Database metrics
+- **Elasticsearch Exporter** - Search engine metrics
+- **Custom Monitor** - OnlyOffice-specific monitoring
+
+## 🔍 Custom Monitoring Features
+
+### Health Monitoring
+- Container status and health checks
+- Service availability monitoring
+- Resource usage tracking (CPU, memory, disk)
+- Database connection monitoring
+
+### CRM Auto-Linking Oversight
+- **Email processing metrics** - Track emails processed for CRM linking
+- **Error detection** - Monitor CRM auto-linking failures
+- **Duplication detection** - Alert on duplicate email processing
+- **Service status** - Monitor WebCrmMonitoringService health
+
+### API Endpoints
+
+```bash
+# Basic health check
+curl http://localhost:8090/health
+
+# Detailed system overview
+curl http://localhost:8090/health/detailed
+
+# CRM-specific metrics
+curl http://localhost:8090/metrics/crm
+
+# Container status
+curl http://localhost:8090/api/containers
+
+# Container logs
+curl http://localhost:8090/api/logs/onlyoffice-community-server
+```
+
+## 🚨 Alerting
+
+### Pre-configured Alerts
+- **Container Down** - Any monitored container stops
+- **High Resource Usage** - CPU/Memory thresholds exceeded
+- **Database Issues** - MySQL connectivity or performance problems
+- **CRM Auto-linking Failures** - Email processing errors
+- **Email Duplication** - Duplicate email detection
+- **Service Health** - OnlyOffice service availability
+
+### Alert Channels
+- **Webhook** - Sent to custom monitor service
+- **Email** - Configure SMTP in alertmanager/config.yml
+
+## 📈 Key Metrics
+
+### System Metrics
+- `container_status` - Container running status
+- `onlyoffice_health_status` - Service health status
+- `mysql_connections_active` - Database connections
+- `elasticsearch_health_score` - Search engine health
+
+### CRM Metrics
+- `crm_autolink_emails_total` - Total emails processed
+- `crm_autolink_errors_total` - Auto-linking errors
+- `crm_autolink_service_up` - Service availability
+- `email_duplication_events_total` - Duplicate emails detected
+
+## 🛠️ Configuration
+
+### Environment Variables
+```env
+# MySQL connection
+MYSQL_HOST=onlyoffice-mysql-server
+MYSQL_USER=root
+MYSQL_PASSWORD=my-secret-pw
+MYSQL_DATABASE=onlyoffice
+
+# Monitoring settings
+CHECK_INTERVAL=30
+CRM_AUTO_LINK_MONITORING=true
+```
+
+### Host File Setup
+Add to `/etc/hosts` for local access:
+```
+127.0.0.1 monitoring.local
+127.0.0.1 prometheus.local
+127.0.0.1 traefik.local
+127.0.0.1 alerts.local
+127.0.0.1 monitor.local
+127.0.0.1 onlyoffice.local
+```
+
+## 🔧 Customization
+
+### Adding New Metrics
+1. Edit `monitoring/custom/monitor.py`
+2. Add Prometheus metrics definitions
+3. Implement collection logic
+4. Rebuild custom monitor: `docker-compose build onlyoffice-monitor`
+
+### Custom Dashboards
+1. Access Grafana at http://monitoring.local:3000
+2. Create new dashboards
+3. Export JSON and save to `monitoring/grafana/dashboards/`
+
+### Alert Rules
+1. Edit `monitoring/prometheus/alert_rules.yml`
+2. Add new alert conditions
+3. Restart Prometheus: `docker-compose restart prometheus`
+
+## 📋 Maintenance
+
+### Backup
+```bash
+# Backup monitoring configuration
+tar -czf monitoring-backup.tar.gz monitoring/
+
+# Backup Grafana dashboards
+docker exec onlyoffice-grafana grafana-cli admin export-dashboard
+```
+
+### Cleanup
+```bash
+# Remove monitoring stack only
+docker-compose -f docker-compose.workspace-managed.yml stop prometheus grafana loki
+docker-compose -f docker-compose.workspace-managed.yml rm prometheus grafana loki
+
+# Clean up volumes
+docker volume prune
+```
+
+## 🐛 Troubleshooting
+
+### Common Issues
+
+**Grafana not loading dashboards:**
+```bash
+docker-compose restart grafana
+docker logs onlyoffice-grafana
+```
+
+**Prometheus not scraping targets:**
+```bash
+# Check configuration
+curl http://localhost:9090/api/v1/targets
+```
+
+**Custom monitor errors:**
+```bash
+docker logs onlyoffice-monitor
+```
+
+**Permission issues:**
+```bash
+# Fix monitoring directory permissions
+sudo chown -R $(id -u):$(id -g) monitoring/
+```
+
+This monitoring stack provides comprehensive oversight of your OnlyOffice deployment with special focus on the CRM auto-linking functionality!