Mühendislik on Denomas Handbook

Açık Kaynak Stratejisi

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

Açık Kaynak Stratejisi

Denomas, açık kaynaklı projelerin üzerinde katma değer yaratan bir şirkettir. Açık kaynak ekosistemine aktif katkı sağlamak stratejik bir önceliktir.

Upstream-First Yaklaşım

Bir açık kaynaklı projede bug fix veya iyileştirme yaptığımızda:

Önce upstream'e gönder — Değişikliği orijinal projeye PR/MR olarak gönder
Kabul edilene kadar fork'ta tut — Upstream kabul edene kadar kendi fork'umuzda kullan
Upstream kabul edince fork'u senkronize et — Fork'taki özel patch'i kaldır

Bu yaklaşım:

Toplulukla ilişkimizi güçlendirir
Fork bakım yükünü azaltır
Ürün kalitesini artırır

Fork Kuralları

Durum	Aksiyon
Bug fix	Upstream'e PR + fork'ta geçici patch
Yeni özellik (genel)	Upstream'e PR
Denomas'a özel entegrasyon	Sadece fork'ta, ayrı katman
Güvenlik yaması	Upstream'e sorumlu ifşa + fork'ta patch

ürünleşme yaklaşımı İlişkisi

Fork'lar, Mühendislik'nin COPY fazına karşılık gelir. COMBINE ve TRANSFORM fazları ise Denomas'a özel katma değeri temsil eder. Bu katmanlar upstream'e gönderilmez.

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.

İzleme ve Gözlemlenebilirlik

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

İzleme ve Gözlemlenebilirlik

Denomas'ta her sistem gözlemlenebilir olmalıdır. Üç temel sinyal üzerinden izleme yaparız: metrikler, loglar ve tracing.

İzleme Yığını

Katman	Araç	Amaç
Metrikler	Prometheus + VictoriaMetrics	Zaman serisi metrik toplama
Görselleştirme	Grafana	Dashboard ve alerting
Loglama	Loki	Merkezi log toplama
Tracing	OpenTelemetry + Jaeger	Dağıtık izleme
Hata İzleme	Sentry	Uygulama hata yakalama
Altyapı İzleme	Denomas Denetim Otomasyon (Zabbix)	IT/OT izleme

Apdex Skoru

Apdex (Application Performance Index), kullanıcı memnuniyetini ölçen standart bir metriktir.

Kalite Mühendisliği

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

Kalite Mühendisliği

Kalite, Denomas'ta ayrı bir aşama değildir. Geliştirme sürecinin içine gömülü bir disiplindir.

Test Piramidi

 ╱ ╲
 ╱ E2E ╲ — Az ama kritik
 ╱───────╲
 ╱ Enteg. ╲ — Servisler arası
 ╱─────────────╲
 ╱ Birim Testleri ╲ — Çok ve hızlı
 ╱─────────────────────╲

Seviye	Hedef Kapsam	Çalıştırma	Araç
Birim	%80+	Her commit	pytest, jest
Entegrasyon	Kritik akışlar	Her MR	pytest + testcontainers
E2E	Kullanıcı senaryoları	Her release	Playwright, Cypress
Performans	Kritik endpoint'ler	Haftalık	k6

Hata Bütçesi (Error Budget)

Her üretim servisi için aylık hata bütçesi tanımlanır:

Kod İnceleme

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

Kod İnceleme

Kod inceleme, Denomas mühendislik kültürünün temel taşlarından biridir. Her değişiklik, merge edilmeden önce en az bir takım arkadaşının incelemesinden geçer.

İlkeler

Her MR Review Alır — İstisna yoktur, tek satırlık değişiklikler bile
Yapıcı Geri Bildirim — Eleştiri koda yöneliktir, kişiye değil
Öğrenme Aracı — Review, hem yazar hem reviewer için öğrenme fırsatıdır
Otomasyon Desteği — Linter ve testler review öncesi otomatik çalışır

Merge Request Standartları

Her MR şu bilgileri içermelidir:

Kod Kalitesi

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

Kod Kalitesi

Denomas'ta kod kalitesi, geliştirme sürecinin ayrılmaz bir parçasıdır. Her commit, pre-commit hook'larından geçer; her MR, Otomatik Kalite Kapısından geçmek zorundadır. Bu kapı, bilinen güvenlik açıklarının (SQL injection, XSS vb.) koda girmesini en başından engeller.

Temel Kural

Her commit pre-commit hook'larından geçmelidir. İstisnasız.

Pre-commit Hooks

Tüm projelerde aşağıdaki pre-commit hook'ları aktiftir:

# .pre-commit-config.yaml
repos:
 # Genel dosya kontrolleri
 - repo: https://github.com/pre-commit/pre-commit-hooks
 rev: v4.6.0
 hooks:
 - id: trailing-whitespace
 - id: end-of-file-fixer
 - id: check-yaml
 args: ['--allow-multiple-documents']
 - id: check-json
 - id: check-merge-conflict
 - id: detect-private-key
 - id: check-added-large-files
 args: ['--maxkb=1024']
 - id: no-commit-to-branch
 args: ['--branch', 'main', '--branch', 'master']

 # Python: Ruff (flake8 + isort + pyupgrade birleşimi)
 - repo: https://github.com/astral-sh/ruff-pre-commit
 rev: v0.4.0
 hooks:
 - id: ruff
 args: ['--fix']
 - id: ruff-format

 # Python: Black (formatter)
 - repo: https://github.com/psf/black
 rev: 24.4.0
 hooks:
 - id: black
 args: ['--line-length=120']

 # Python: MyPy (tip kontrolü)
 - repo: https://github.com/pre-commit/mirrors-mypy
 rev: v1.10.0
 hooks:
 - id: mypy
 additional_dependencies: ['types-requests', 'types-redis']
 args: ['--ignore-missing-imports']

 # Python: Bandit (güvenlik taraması)
 - repo: https://github.com/PyCQA/bandit
 rev: 1.7.8
 hooks:
 - id: bandit
 args: ['-c', 'pyproject.toml', '-r']
 additional_dependencies: ['bandit[toml]']

 # Ansible
 - repo: https://github.com/ansible/ansible-lint
 rev: v24.2.0
 hooks:
 - id: ansible-lint

 # Docker
 - repo: https://github.com/hadolint/hadolint
 rev: v2.12.0
 hooks:
 - id: hadolint

 # Shell
 - repo: https://github.com/shellcheck-py/shellcheck-py
 rev: v0.10.0
 hooks:
 - id: shellcheck

 # Commit message format (Conventional Commits)
 - repo: https://github.com/compilerla/conventional-pre-commit
 rev: v3.2.0
 hooks:
 - id: conventional-pre-commit
 stages: [commit-msg]
 args: ['feat', 'fix', 'docs', 'style', 'refactor', 'test', 'chore', 'ci']

Doğrudan Ana Dala Commit Yasak

no-commit-to-branch hook'u, doğrudan main veya master dalına commit yapılmasını engeller. Tüm değişiklikler feature branch üzerinden MR ile gelmelidir.

Mimari Prensipler

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

Mimari Prensipler

Denomas'ın tüm ürünleri ve altyapısı aşağıdaki mimari prensipler üzerine inşa edilir. Mimari, "Önce Teknik Temel (Foundation First)" felsefesine dayanır. Müşteriye sunulacak özellikler geliştirilmeden önce tüm geliştirme ve otomasyon altyapısı mükemmelleştirilir.

Teknoloji Yığını (Technology Stack)

Bileşen	Teknoloji	Versiyon / Detay	Gerekçe
Ana Platform	Odoo	18.0+ (Python 3.10+)	CRM, satış, faturalandırma, muhasebe için zengin özellik seti
Backend Framework	Python / Django	4.2+ LTS	Mikroservisler ve harici API'ler için
Mikroservisler	Python (FastAPI)	0.100+	Yüksek performanslı API güdümlü servisler
Veritabanı	PostgreSQL	15+	Nesne-ilişkisel, ölçeklenebilir, güvenilir
Önbellek / Kuyruk	Redis	7+	Session, cache, Celery broker
Web Sunucu	Caddy	Reverse proxy, SSL termination, load balancing
Kaynak Kod Yönetimi	GitLab (Self-Hosted)	`code.denomas.com` ve `code.ilimteknoloji.com`
CI/CD	GitLab CI/CD	Mevcut GitLab Runner'lar ile entegre pipeline
Ön Yüz (Frontend)	Odoo Owl JS Framework	Odoo ekosistemi içinde sorunsuz entegrasyon
Bilişsel Altyapı	Node.js tabanlı MCP Sunucuları	Model Context Protocol (Yapay Zeka Asistanı erişimi)
Konteynerizasyon	Docker, Docker Compose	Tutarlı, izole ve tekrarlanabilir ortamlar
IaC	Ansible / Terraform	Konfigürasyon yönetimi ve cloud provizyon
İzleme	Prometheus + Grafana	Metrik toplama ve görselleştirme
Loglama	Wazuh	Merkezi log yönetimi

1. API-First

Her ürün ve hizmet, önce API olarak tasarlanır. UI, API'nin bir tüketicisidir.

Mühendislik Yaklaşımı

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

Mühendislik Yaklaşımı

Bu sayfa Denomas'ın halka açık mühendislik yaklaşımını özetler. İç ürünleşme yöntemleri, iç otomasyon akışları ve rekabetçi mühendislik detayları Internal Handbook içinde tutulur.

Public İlkeler

Güçlü teknik temeller üzerine ürün inşa etmek
Kalite kapılarıyla güvenilir teslimat üretmek
Açık kaynak ekosistemini ciddiyetle değerlendirmek
Güvenlik, performans ve bakım kolaylığını birlikte düşünmek
Dokümantasyon ve mühendislik disiplinini birlikte yürütmek

Public Teknik Sınır

İç ürünleşme metodolojileri, otomasyon akışları, klasör yapıları, iç approval modelleri ve asistan protokolleri public yüzde ayrıntılı olarak paylaşılmaz.

Sürüm Süreci

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

Sürüm Süreci

Denomas, dual-track deployment stratejisi uygular. Bu strateji, SaaS ve self-managed ürün hatlarının farklı sürüm döngülerini yönetir. Dağıtım süreci code.denomas.com ve code.ilimteknoloji.com GitLab altyapıları üzerinde çalışır. Otomatik Kalite Kapısı tüm süreci otomatize eder ve güvence altına alır.

Git Akışı

Standart ve kanıtlanmış branch stratejisi:

feature-branch → develop → staging → main

Dal	Rol	Deploy Ortamı
`feature/*`	Yeni özellik veya bug fix geliştirmesi	Development (her push)
`develop`	Ana geliştirme dalı, tüm yeni özellikler buraya merge edilir	Development
`staging`	Canlıya çıkmadan önceki son test ortamı	Staging (otomatik)
`main`	Sadece stabil, test edilmiş ve canlıya çıkmaya hazır kod	Production (manuel onay)

Ana Dala Doğrudan Push Yasak

main ve develop dallarına doğrudan push yapılması pre-commit hook ile engellenmiştir. Tüm değişiklikler Merge Request üzerinden gelmelidir.

Mühendislik on Denomas Handbook

Açık Kaynak Stratejisi

Açık Kaynak Stratejisi

Upstream-First Yaklaşım

Fork Kuralları

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)

İzleme ve Gözlemlenebilirlik

İzleme ve Gözlemlenebilirlik

İzleme Yığını

Apdex Skoru

Kalite Mühendisliği

Kalite Mühendisliği

Test Piramidi

Hata Bütçesi (Error Budget)

Kod İnceleme

Kod İnceleme

İlkeler

Merge Request Standartları

Kod Kalitesi

Kod Kalitesi

Temel Kural

Pre-commit Hooks

Mimari Prensipler

Mimari Prensipler

Teknoloji Yığını (Technology Stack)

1. API-First

Mühendislik Yaklaşımı

Mühendislik Yaklaşımı

Public İlkeler

Public Teknik Sınır

Sürüm Süreci

Sürüm Süreci

Git Akışı

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