feat: add ConnectionTypeEnum and ConnectionConfigDTO to support DSN-based resolution

- Introduced ConnectionTypeEnum for normalized adapter types
- Added ConnectionConfigDTO to unify connection configuration structure
- Updated internal documentation and prepared for DSN routing in data-adapters
- Part of Phase 10 preparation (maatify/data-adapters)

Author: megyptm

.github/workflows/ci.yml

@@ -14,6 +14,9 @@ jobs:
     name: 🔧 Build & Test (PHP 8.4)
     runs-on: ubuntu-latest
 
+    env:
+      GH_START_ISO: ${{ github.event.head_commit.timestamp }}
+
     strategy:
       fail-fast: false
       matrix:
@@ -71,6 +74,76 @@ jobs:
           name: phpunit-coverage-report
           path: .phpunit.cache/
 
+      - name: 📲 Notify Telegram
+        if: always()
+        env:
+          TELEGRAM_BOT_TOKEN: ${{ secrets.TELEGRAM_CI_BOT_TOKEN }}
+          TELEGRAM_CHAT_ID: ${{ secrets.TELEGRAM_CI_CHAT_ID }}
+        run: |
+          
+          START_TS=$(date -u -d "$GH_START_ISO" +%s)
+          END_TS=$(date +%s)
+          
+          START_TIME=$(date -u -d "@$START_TS" +"%H:%M:%S UTC")
+          END_TIME=$(date -u +"%H:%M:%S UTC")
+          DURATION=$((END_TS - START_TS))
+          
+          if [ "$DURATION" -lt 60 ]; then
+            DURATION_STR="${DURATION}s"
+          else
+            DURATION_STR="$(($DURATION / 60))m $(($DURATION % 60))s"
+          fi
+          
+          STATUS="✅ Tests passed successfully!"
+          COLOR="🟢"
+          HEADER="Maatify CI Report"
+          
+          if grep -q "FAILURES!" phpunit.log || [ "${{ job.status }}" != "success" ]; then
+            STATUS="❌ Some tests failed. Please review the log."
+            COLOR="🔴"
+            HEADER="Maatify CI Alert"
+          fi
+          
+          PROJECT="maatify/common"
+          BRANCH="$GITHUB_REF_NAME"
+          ACTOR="$GITHUB_ACTOR"
+          URL="${GITHUB_SERVER_URL}/${GITHUB_REPOSITORY}/actions/runs/${GITHUB_RUN_ID}"
+          
+          MESSAGE="📢 <b>${HEADER}</b>
+      
+          ${COLOR} ${STATUS}
+      
+          📦 <b>Project:</b> ${PROJECT}
+          🧱 <b>Branch:</b> ${BRANCH}
+          👷‍♂️ <b>Committer:</b> ${ACTOR}
+      
+          ⏱ <b>Start:</b> ${START_TIME}
+          🕒 <b>End:</b> ${END_TIME}
+          📈 <b>Duration:</b> ${DURATION_STR}
+      
+          🔗 <a href='${URL}'>View Run Log</a>"
+          
+          PAYLOAD=$(jq -n \
+          --arg chat_id "$TELEGRAM_CHAT_ID" \
+          --arg text "$MESSAGE" \
+          --arg parse_mode "HTML" \
+          '{chat_id: $chat_id, text: $text, parse_mode: $parse_mode}')
+          
+          RESPONSE=$(curl -s -o /tmp/tg_resp.json -w "%{http_code}" \
+          -X POST "https://api.telegram.org/bot${TELEGRAM_BOT_TOKEN}/sendMessage" \
+          -H "Content-Type: application/json" \
+          -d "$PAYLOAD")
+          
+          echo "Raw Telegram Response (HTTP $RESPONSE):"
+          cat /tmp/tg_resp.json
+          
+          if [ "$RESPONSE" -ne 200 ]; then
+          echo "⚠️ Telegram notification failed (HTTP $RESPONSE)" >> $GITHUB_STEP_SUMMARY
+          cat /tmp/tg_resp.json >> $GITHUB_STEP_SUMMARY
+          else
+          echo "✅ Telegram notification sent successfully." >> $GITHUB_STEP_SUMMARY
+          fi
+
       - name: 📊 Summary
         if: always()
         run: |