docs: add README file

.github/workflows/pr-title-linter.yml

@@ -0,0 +1,25 @@
+name: PR Title Check
+
+on:
+  pull_request:
+    types: [opened, edited]
+
+jobs:
+  lint-pr-title:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Check PR Title
+        uses: actions/[email protected]
+        with:
+          script: |
+            const title = context.payload.pull_request.title;
+            const regex = /^(feat|fix|chore|docs|style|refactor|perf|test|ci|build|deps|hotfix|env|security)(\([\w\-]+\))?: .+/;
+            if (!regex.test(title)) {
+              core.setFailed(`❌ Invalid PR title: "${title}".\n✅ Expected format: type(scope): description\nExamples:\n  - feat(docker): preload Hugging Face models\n  - fix(api): handle missing auth headers`);
+            } else {
+              console.log(`✅ PR title "${title}" is valid.`);
+            }

.gitignore

@@ -0,0 +1,141 @@
+# General
+*.log
+*.tmp
+*.bak
+*.swp
+*.DS_Store
+Thumbs.db
+
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+.Python
+env/
+venv/
+ENV/
+*.env
+*.venv
+*.egg-info/
+.eggs/
+dist/
+build/
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Hugging Face / TensorFlow / PyTorch (AI models and cache)
+*.ckpt
+*.pt
+*.pth
+*.h5
+*.onnx
+output/
+logs/
+lightning_logs/
+cache/
+model_cache/
+.tokenizers_cache/
+.transformers_cache/
+__pycache__/
+
+# Go
+*.exe
+*.out
+*.test
+vendor/
+*.mod
+*.sum
+
+# Terraform
+secrets.tf
+secrets.tfvars
+.terraform/
+*.tfstate
+*.tfstate.*
+crash.log
+override.tf
+override.tf.json
+*.tfvars
+*.tfvars.json
+.terraform.lock.hcl
+
+# Docker
+*.env
+.env.local
+.dockerignore
+docker-compose.override.yml
+tag.txt
+# Ignore local Docker configuration files
+.docker/
+
+# Kubernetes
+*.yml~
+.kube/
+*.crt
+*.key
+
+# AWS
+.aws/
+.terraform/
+*.pem
+*.key
+*.config
+
+# Helm / Kustomize
+.kube/
+*.release.yaml
+
+# Secrets
+secrets/
+*.secret
+*.key
+*.cert
+*.pfx
+*.pem
+*.json
+
+# Node.js (if used for any UI dashboard)
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# JetBrains IDEs
+.idea/
+*.iml
+*.iws
+out/
+
+# VS Code
+.vscode/
+.history/
+
+# Operating System Files
+.DS_Store
+Thumbs.db
+
+# Miscellaneous
+*.sqlite3
+*.db
+*.sql
+*.tar
+*.zip
+*.gz
+*.7z
+*.rar
+*.bak
+
+# Logs
+logs/
+*.log
+*.log.*
+nohup.out
+
+# Artifacts
+*.artifact.zip
+*.whl
+
+# Trivy Cache
+.trivy-cache/
+.trivyignore

.terraformignore

@@ -0,0 +1,74 @@
+# Terraform state and backup files
+*.tfstate
+*.tfstate.backup
+*.tfplan
+
+# Terraform internal directories
+.terraform/
+
+# Logs and debug artifacts
+*.log
+crash.log
+*.out
+*.err
+
+# AWS credentials and sensitive files
+.aws/
+*.pem
+*.key
+*.crt
+*.env
+.env.*
+credentials.json
+secrets/
+**/credentials.tfvars
+
+# Python artifacts
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+*.egg-info/
+*.dist-info/
+*.ipynb_checkpoints/
+*.sqlite3
+*.db
+.venv/
+venv/
+env/
+
+# Docker build cache and local overrides
+Dockerfile.*
+docker-compose.override.yml
+*.tar
+*.img
+
+# Node-related (if present)
+node_modules/
+npm-debug.log
+yarn-error.log
+
+# Editor/OS/CI-related
+.idea/
+.vscode/
+*.swp
+*.swo
+*.bak
+*.tmp
+.DS_Store
+Thumbs.db
+
+# Git
+.git/
+.gitignore
+.gitattributes
+
+# Tests & coverage (optional)
+coverage/
+tests/__pycache__/
+test-results/
+
+# Model cache (if using Hugging Face Transformers)
+model_cache/
+transformers_cache/
+huggingface/

Jenkinsfile

@@ -0,0 +1,62 @@
+pipeline {
+    agent any
+    environment {
+        ECR_REGISTRY = credentials('ecr-registry-uri')
+        AWS_REGION = 'eu-central-1'
+        DOCKER_TAG = 'latest'
+    }
+    stages {
+        stage('Build and Push ai-agent') {
+            agent { docker { image 'docker:24-dind'; args '--privileged'; reuseNode true } }
+            when { changeset "ai-agent/**" }
+            steps {
+                withAWS(credentials: 'aws-credentials', region: "${AWS_REGION}") {
+                    sh 'aws ecr get-login-password --region ${AWS_REGION} | docker login --username AWS --password-stdin ${ECR_REGISTRY}'
+                    sh 'docker build -t ${ECR_REGISTRY}/ai-agent:${DOCKER_TAG} ./ai-agent'
+                    sh 'docker push ${ECR_REGISTRY}/ai-agent:${DOCKER_TAG}'
+                }
+            }
+        }
+        stage('Build and Push Go Microservices') {
+            agent { docker { image 'docker:24-dind'; args '--privileged'; reuseNode true } }
+            when { anyOf { changeset "go-services/blockchain-monitor/**"; changeset "go-services/anomaly-detector/**" } }
+            steps {
+                withAWS(credentials: 'aws-credentials', region: "${AWS_REGION}") {
+                    sh 'aws ecr get-login-password --region ${AWS_REGION} | docker login --username AWS --password-stdin ${ECR_REGISTRY}'
+                    script {
+                        def services = ['blockchain-monitor', 'anomaly-detector']
+                        services.each { svc ->
+                            sh "docker build -t ${ECR_REGISTRY}/${svc}:${DOCKER_TAG} ./go-services/${svc}"
+                            sh "docker push ${ECR_REGISTRY}/${svc}:${DOCKER_TAG}"
+                        }
+                    }
+                }
+            }
+        }
+        stage('Build and Push Dashboard') {
+            agent { docker { image 'docker:24-dind'; args '--privileged'; reuseNode true } }
+            when { changeset "dashboard/**" }
+            steps {
+                withAWS(credentials: 'aws-credentials', region: "${AWS_REGION}") {
+                    sh 'aws ecr get-login-password --region ${AWS_REGION} | docker login --username AWS --password-stdin ${ECR_REGISTRY}'
+                    sh 'docker build -t ${ECR_REGISTRY}/dashboard:${DOCKER_TAG} ./dashboard'  // Adjust if merged with anomaly-detector
+                    sh 'docker push ${ECR_REGISTRY}/dashboard:${DOCKER_TAG}'
+                }
+            }
+        }
+        stage('Deploy to EKS') {
+            steps {
+                withAWS(credentials: 'aws-credentials', region: "${AWS_REGION}") {
+                    sh 'helm upgrade --install ai-agent ./helm/ai-agent --namespace default --set image.repository=${ECR_REGISTRY}/ai-agent'
+                    sh 'helm upgrade --install blockchain-monitor ./helm/go-microservices/blockchain-monitor --namespace default --set image.repository=${ECR_REGISTRY}/blockchain-monitor'
+                    sh 'helm upgrade --install anomaly-detector ./helm/go-microservices/anomaly-detector --namespace default --set image.repository=${ECR_REGISTRY}/anomaly-detector'
+                    sh 'helm upgrade --install dashboard ./helm/dashboard --namespace default --set image.repository=${ECR_REGISTRY}/dashboard'
+                }
+            }
+        }
+    }
+    post {
+        always { sh 'echo "Pipeline complete!"' }
+        failure { echo 'Build failed!' }
+    }
+}