Pipeline on Denomas Handbook

CI/CD Pipeline

Mon, 01 Jan 0001 00:00:00 +0000

CI/CD Pipeline

Denomas, tüm projelerinde GitLab CI/CD kullanır. Pipeline, kodun commit edilmesinden üretim ortamına deploy edilmesine kadar tüm aşamaları otomatize eder. CI/CD altyapısı code.denomas.com ve code.ilimteknoloji.com adreslerindeki self-hosted GitLab instance'ları üzerinde çalışır.

Pipeline Aşamaları

┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌────────────────┐ ┌──────────────┐
│ lint │ → │ test │ → │ build │ → │ scan │ → │ deploy-staging │ → │ deploy-prod │
└──────────┘ └──────────┘ └──────────┘ └──────────┘ └────────────────┘ └──────────────┘

1. lint

Pre-commit hook doğrulaması (pre-commit run --all-files)
Python: ruff lint + ruff-format kontrolü + mypy tip kontrolü
JavaScript: ESLint (airbnb-base preset)
YAML/JSON format kontrolü (yamllint)
Ansible: ansible-lint
Docker: hadolint
Shell: shellcheck
Docstring kontrolü (public fonksiyonlarda zorunlu)
Conventional Commit format kontrolü

2. test

Birim testleri — pytest --cov=src --cov-fail-under=80
Entegrasyon testleri — API endpoint testleri, veritabanı migration testleri
Odoo testleri — Odoo test framework ile modül testleri (odoo-bin --test-enable)
Ansible testleri — molecule test ile rol doğrulaması
Kapsam raporu oluşturma (Cobertura formatı, GitLab MR'da görselleştirme)

3. build

Docker image oluşturma (multi-stage build)
Semantic versiyon etiketi ($CI_COMMIT_TAG veya $CI_COMMIT_SHORT_SHA)
Docker image'ı GitLab Container Registry'ye push
Ansible artifact'ları paketleme (roller + playbook'lar)
Hugo site build (handbook ve website projeleri için)

4. scan

SAST: Bandit (Python), Semgrep (p/owasp-top-ten ruleset), GitLab SAST template
Dependency Scan: Trivy (container + dependency CVE taraması)
Lisans Kontrolü: Uyumsuz lisans tespiti (GPL kontrol)
Container Image Scan: Trivy ile Docker image güvenlik taraması
Secret Detection: GitLab Secret Detection template

5. deploy-staging

Ansible playbook ile staging ortamına deploy (ansible-playbook deploy-staging.yml)
Otomatik smoke testleri (ansible-playbook smoke-test.yml)
Performans testi (k6 ile yük testi)
Staging URL'i MR'a yorum olarak eklenir

6. deploy-prod

Dual-track deployment stratejisine göre
Track 1 (SaaS): main merge sonrası when: manual onay → canary deploy → kademeli rollout
Track 2 (Self-Managed): Release tag'i sonrası paketleme ve dağıtım
Production deploy sonrası otomatik health check

Tam `.gitlab-ci.yml` Örneği

# .gitlab-ci.yml — Denomas standart pipeline
image: python:3.10-slim

variables:
 # Genel
 PIP_CACHE_DIR: "$CI_PROJECT_DIR/.cache/pip"
 PRE_COMMIT_HOME: "$CI_PROJECT_DIR/.cache/pre-commit"
 # Docker
 DOCKER_IMAGE: "$CI_REGISTRY_IMAGE"
 DOCKER_TAG: "$CI_COMMIT_SHORT_SHA"
 # Deployment
 ANSIBLE_INVENTORY: "inventory/$CI_ENVIRONMENT_NAME"
 ANSIBLE_FORCE_COLOR: "true"
 # SAST
 SAST_EXCLUDED_PATHS: "tests/,migrations/,docs/"
 SECURE_LOG_LEVEL: "warn"

cache:
 key: ${CI_COMMIT_REF_SLUG}
 paths:
 - .cache/pip
 - .cache/pre-commit
 - .venv/

stages:
 - lint
 - test
 - build
 - scan
 - deploy-staging
 - deploy-prod

# ─── LINT ─────────────────────────────────────────────
lint:pre-commit:
 stage: lint
 script:
 - pip install pre-commit
 - pre-commit run --all-files
 rules:
 - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
 - if: '$CI_COMMIT_BRANCH == "develop"'

lint:mypy:
 stage: lint
 script:
 - pip install -r requirements-dev.txt
 - mypy src/ --ignore-missing-imports
 rules:
 - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
 allow_failure: false

# ─── TEST ─────────────────────────────────────────────
test:unit:
 stage: test
 services:
 - postgres:15-alpine
 - redis:7-alpine
 variables:
 POSTGRES_DB: test_db
 POSTGRES_USER: test_user
 POSTGRES_PASSWORD: $CI_DB_PASSWORD
 DATABASE_URL: "postgresql://test_user:$CI_DB_PASSWORD@postgres:5432/test_db"
 REDIS_URL: "redis://redis:6379/0"
 script:
 - pip install -r requirements-dev.txt
 - pytest --cov=src --cov-report=xml --cov-report=term --cov-fail-under=80
 artifacts:
 reports:
 coverage_report:
 coverage_format: cobertura
 path: coverage.xml
 expire_in: 30 days
 rules:
 - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
 - if: '$CI_COMMIT_BRANCH == "develop"'

test:integration:
 stage: test
 services:
 - postgres:15-alpine
 - redis:7-alpine
 script:
 - pip install -r requirements-dev.txt
 - pytest tests/integration/ -v --tb=short
 rules:
 - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'

# ─── BUILD ────────────────────────────────────────────
build:docker:
 stage: build
 image: docker:24.0
 services:
 - docker:24.0-dind
 script:
 - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
 - docker build -t $DOCKER_IMAGE:$DOCKER_TAG -t $DOCKER_IMAGE:latest .
 - docker push $DOCKER_IMAGE:$DOCKER_TAG
 - docker push $DOCKER_IMAGE:latest
 rules:
 - if: '$CI_COMMIT_BRANCH == "develop"'
 - if: '$CI_COMMIT_BRANCH == "main"'
 - if: '$CI_COMMIT_TAG'

# ─── SCAN ─────────────────────────────────────────────
scan:bandit:
 stage: scan
 script:
 - pip install bandit[toml]
 - bandit -c pyproject.toml -r src/ -f json -o bandit-report.json
 artifacts:
 paths:
 - bandit-report.json
 expire_in: 30 days
 rules:
 - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'

scan:semgrep:
 stage: scan
 image: returntocorp/semgrep
 script:
 - semgrep --config=p/owasp-top-ten --config=p/python --json -o semgrep-report.json src/
 artifacts:
 paths:
 - semgrep-report.json
 expire_in: 30 days
 rules:
 - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'

scan:trivy:
 stage: scan
 image:
 name: aquasec/trivy:latest
 entrypoint: [""]
 script:
 - trivy image --exit-code 1 --severity HIGH,CRITICAL $DOCKER_IMAGE:$DOCKER_TAG
 rules:
 - if: '$CI_COMMIT_BRANCH == "develop"'
 - if: '$CI_COMMIT_BRANCH == "main"'

include:
 - template: Security/SAST.gitlab-ci.yml
 - template: Security/Secret-Detection.gitlab-ci.yml

# ─── DEPLOY STAGING ───────────────────────────────────
deploy_staging:
 stage: deploy-staging
 image: ansible/ansible-runner:latest
 script:
 - ansible-playbook deploy-staging.yml -e "docker_tag=$DOCKER_TAG"
 - ansible-playbook smoke-test.yml -e "environment=staging"
 environment:
 name: staging
 url: https://staging.denomas.com
 rules:
 - if: '$CI_COMMIT_BRANCH == "staging"'

# ─── DEPLOY PRODUCTION ───────────────────────────────
deploy_canary:
 stage: deploy-prod
 image: ansible/ansible-runner:latest
 script:
 - ansible-playbook deploy-canary.yml -e "docker_tag=$DOCKER_TAG canary_weight=5"
 environment:
 name: canary
 url: https://canary.denomas.com
 rules:
 - if: '$CI_COMMIT_BRANCH == "main"'
 when: manual

deploy_production:
 stage: deploy-prod
 image: ansible/ansible-runner:latest
 script:
 - ansible-playbook deploy-production.yml -e "docker_tag=$DOCKER_TAG"
 - ansible-playbook smoke-test.yml -e "environment=production"
 environment:
 name: production
 url: https://denomas.com
 rules:
 - if: '$CI_COMMIT_BRANCH == "main"'
 when: manual
 needs: ["deploy_canary"]

Ortam Değişkenleri (CI/CD Variables)

Değişken	Tür	Kapsam	Açıklama
`CI_REGISTRY_USER`	Protected	Tüm projeler	GitLab Container Registry kullanıcı
`CI_REGISTRY_PASSWORD`	Protected, Masked	Tüm projeler	GitLab Container Registry parola
`CI_DB_PASSWORD`	Protected, Masked	Tüm projeler	Test veritabanı parolası
`ANSIBLE_SSH_KEY`	Protected, File	Deploy projeleri	Deployment SSH anahtarı
`SENTRY_DSN`	Protected	Production	Hata izleme DSN
`GRAFANA_API_KEY`	Protected, Masked	Monitoring	Grafana dashboard API
`VAULT_TOKEN`	Protected, Masked	Production	HashiCorp Vault erişim token

Sır Yönetimi

Hassas değerler asla .gitlab-ci.yml içinde açık metin olarak yazılmaz. Tüm sırlar GitLab CI/CD Variables'da Protected ve Masked olarak tanımlanır. Detaylar için Mimari Prensipler — Zero Trust bölümüne bakınız.

Data Engineer

Mon, 01 Jan 0001 00:00:00 +0000

Data Engineer (Veri Mühendisi)

Veri mühendisleri, Denomas ürünlerinin veri altyapısını tasarlar ve yönetir. ETL süreçleri, veri pipeline'ları, veri ambarı ve analitik altyapıdan sorumludur.

Kullanılan Araçlar

Araç	Kullanım Alanı
PostgreSQL	İlişkisel veri tabanı
Wazuh	Log toplama, arama ve görselleştirme
Apache Airflow	Pipeline orkestrasyon
Python	ETL betikleri ve veri işleme
Redis	Önbellekleme ve kuyruk yönetimi
Git	Versiyon kontrolü

Kariyer Seviyeleri ve Denomas Yetkinlik Çerçevesi Gereksinimleri

Junior Data Engineer — Yetkinlik Seviyesi 2

Denomas Yetkinlik Çerçevesi Gereksinimleri:

Pazarlama Performans Metrikleri

Mon, 01 Jan 0001 00:00:00 +0000

Pazarlama Performans Metrikleri

Denomas pazarlama ekibinin başarısını ölçmek için kullanılan temel performans göstergelerini (KPI) tanımlayan belgedir. Stratejik KPI'lar (pipeline katkısı, gelir etkisi, CAC), taktik KPI'lar (MQL, SQL, dönüşüm oranları, kanal bazlı lead üretimi, maliyet metrikleri), operasyonel KPI'lar (web sitesi, içerik, e-posta, sosyal medya metrikleri), ürün bazlı pazarlama metrikleri, funnel sağlık kontrolü, multi-touch attribution modeli ve raporlama takvimini kapsar.

İç Doküman

Bu konunun detayları iç handbook'ta yer almaktadır. Tam içerik için internal.handbook.denomas.com adresine bakınız.

Satış Rehberi

Mon, 01 Jan 0001 00:00:00 +0000

Satış Rehberi

Bu rehber, Denomas satış sürecinin tüm aşamalarını ve her aşamada yapılması gerekenleri tanımlar. Tüm satış aktiviteleri Odoo CRM üzerinden takip edilir ve satış ekibi koordinasyonu Nextcloud Talk üzerinden yururulur.

Satış Pipeline Aşamaları

1. PROSPECT → Potansiyel müşteri tespiti ve ilk temas
2. QUALIFY → BANT niteliklendirme ve ihtiyaç teyidi
3. DEMO → Canlı ürün gösterimi
4. POC → Proof of Concept / Pilot uygulama
5. PROPOSE → Resmi teklif sunumu
6. NEGOTIATE → Müzakere ve fiyatlandırma
7. CLOSE → Sözleşme imzalama ve handoff

1. Prospect (Potansiyel Müşteri Tespiti)

Kaynak Kanalları

Kanal	Açıklama
Inbound	Web sitesi, referans, webinar kayıtları
Outbound	Etkinlikler, soğuk arama, LinkedIn
Partner	Partner yönlendirmeleri
Mevcut Müşteri	Upsell / cross-sell fırsatları

İlk Temas Süreci

Lead Odoo CRM'e kaydedilir
24 saat içinde ilk temas yapılır
Temel bilgiler toplanır (şirket büyüklüğü, sektör, bölge)
Bir sonraki adım için randevu alınır

2. Qualify (Niteliklendirme)

BANT Kriterleri

Kriter	Soru
Budget (Bütçe)	Proje için ayrılmış bütçe var mi? TRY/USD/EUR cinsinden beklenti nedir?
Authority (Yetki)	Karar verici kim? Teknik ve finansal onay süreci nasıl?
Need (İhtiyaç)	Mevcut acı noktalar neler? Hangi sorunlar çözüm bekliyor?
Timeline (Zaman)	Ne zaman çözüm devreye alinmak isteniyor?

Niteliklendirme Puanlama

A (Hot) — 4/4 BANT kriteri pozitif, 30 gün içinde kapanma potansiyeli
B (Warm) — 3/4 kriter pozitif, 90 gün içinde kapanma potansiyeli
C (Nurture) — 2/4 kriter pozitif, uzun vadeli takip
D (Disqualify) — 1/4 veya daha az, pipeline'dan çıkarılır

3. Discovery Call Framework

Discovery call, niteliklendirme aşamasinin en kritik aktivitesidir. Aşağıdaki çerçeve takip edilir:

Talep Oluşturma

Mon, 01 Jan 0001 00:00:00 +0000

Talep Oluşturma

Talep oluşturma (demand generation), potansiyel müşterilerde Denomas ürünlerine yönelik farkındalık ve ilgi yaratarak nitelikli satış fırsatları üretmeyi amaçlar. Bu sayfa, lead generation süreçlerini, kampanya yönetimini ve funnel optimizasyonunu tanımlar.

@pazarlama-ekibi

Talep oluşturma stratejisi ve kampanya yönetimi @pazarlama-ekibi sorumluluğundadır. Satış ekibiyle MQL/SQL tanımları ve aktarım süreçleri ortaklaşa belirlenir.

Talep Oluşturma Stratejisi

Temel Prensipler

Nitelik > Nicelik — Çok sayıda düşük kaliteli lead yerine, satış ekibinin zamanını verimli kullanacağı nitelikli lead üretmek
Inbound Öncelik — İçerik pazarlama, SEO ve topluluk aracılığıyla gelen organik talep birincil kaynaktır
Outbound Destek — Hedefli outbound kampanyalar, belirli sektör ve hesap segmentlerinde inbound'u tamamlar
Hesap Bazlı Pazarlama (ABM) — Yüksek değerli hedef hesaplar için kişiselleştirilmiş kampanyalar
Satış-Pazarlama Hizalaması — MQL/SQL tanımları, aktarım süreçleri ve geri bildirim döngüsü net tanımlanmıştır

Lead Yönetimi

Lead Yaşam Döngüsü

Ziyaretçi → Lead → MQL → SQL → Fırsat → Müşteri

Aşama	Tanım	Kriter
Ziyaretçi	Web sitesini/içeriği ziyaret eden anonim kullanıcı	Sayfa görüntüleme
Lead	İletişim bilgilerini paylaşmış kişi	Form doldurma, kayıt
MQL (Marketing Qualified Lead)	Pazarlama tarafından nitelikli bulunan lead	Lead puanı ≥50
SQL (Sales Qualified Lead)	Satış ekibi tarafından nitelikli bulunan lead	BANT kriterleri karşılanmış
Fırsat	Aktif satış süreci başlamış potansiyel müşteri	Teklif aşaması
Müşteri	Sözleşme imzalamış kurum	Kapanmış fırsat

BANT Nitelendirme Çerçevesi

BANT (Budget, Authority, Need, Timeline), SQL nitelendirmesi için kullanılan çerçevedir:

Pipeline on Denomas Handbook

CI/CD Pipeline

CI/CD Pipeline

Pipeline Aşamaları

1. lint

2. test

3. build

4. scan

5. deploy-staging

6. deploy-prod

Tam .gitlab-ci.yml Örneği

Ortam Değişkenleri (CI/CD Variables)

Data Engineer

Data Engineer (Veri Mühendisi)

Kullanılan Araçlar

Kariyer Seviyeleri ve Denomas Yetkinlik Çerçevesi Gereksinimleri

Junior Data Engineer — Yetkinlik Seviyesi 2

Pazarlama Performans Metrikleri

Pazarlama Performans Metrikleri

Satış Rehberi

Satış Rehberi

Satış Pipeline Aşamaları

1. Prospect (Potansiyel Müşteri Tespiti)

Kaynak Kanalları

İlk Temas Süreci

2. Qualify (Niteliklendirme)

BANT Kriterleri

Niteliklendirme Puanlama

3. Discovery Call Framework

Talep Oluşturma

Talep Oluşturma

Talep Oluşturma Stratejisi

Temel Prensipler

Lead Yönetimi

Lead Yaşam Döngüsü

BANT Nitelendirme Çerçevesi

Tam `.gitlab-ci.yml` Örneği