Engineering 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.

AI Agent Specialist

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

AI Agent Specialist (Yapay Zeka Asistanı Uzmanı)

AI Agent Specialist rolü, Denomas AI-Force ekosistemindeki Yapay Zeka Asistanlarının tasarımı, geliştirilmesi, optimizasyonu ve işletilmesinden sorumludur. Prompt mühendisliği, context yönetimi, çoklu asistan orkestrasyonu ve skill framework geliştirme bu rolün temel alanlarıdır.

Kariyer Seviyeleri ve Denomas Yetkinlik Çerçevesi Gereksinimleri

AI Agent Developer — Yetkinlik Seviyesi 3

Yetkinlik	Seviye	Açıklama
PROG	3	Asistan geliştirme
IRMG	2	Bilgi yönetimi
TEST	2	Asistan testi

Temel Sorumluluklar:

Asistan SKILL.md dosyaları oluşturma ve bakım
Prompt mühendisliği ve optimizasyon
Asistan testleri yazma ve çalıştırma
Context bütçesi izleme
Mevcut skill'leri kullanarak asistan görev akışı kurma
Handbook entegrasyonu

Aranan Nitelikler:

AI-Force

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

AI-Force

AI-Force, Denomas mühendislik departmanının Yapay Zeka Asistanı geliştirme ve yönetim birimidir. BMad Ajan Framework üzerinde çalışan Yapay Zeka Asistanları, IECO (Integrated Ecosystem) mimarisi ile deterministik görev akışları yürütür.

Birim Misyonu

AI-Force'un temel misyonu: insan-asistan işbirliğini deterministik, ölçülebilir ve güvenli hale getirmek. Asistanlar handbook'u tek gerçek kaynağı (single source of truth) olarak kullanır ve Human Gate protokolünü GitLab issue, MR, reviewer ve CI zinciri üzerinden uygular.

Alt Sayfalar

Sayfa	Açıklama
Yapay Zeka Asistanı Genel Bakış	Asistan türleri — Düşünürler, Yapanlar, Denetleyenler
Skill Framework	175+ yetenek tanımı ve yükleme protokolü
Yetkinlik Çerçevesi	Denomas Yetkinlik 9 tabanlı yetkinlik haritası
Context Yönetimi	Token ekonomisi ve hafıza yönetimi
IECO v6.0	Bütünleşik Yapay Zeka Asistanı ekosistemi mimarisi
Yapay Zeka Asistanı İş Akışı SOP	Standart operasyon prosedürü
Yapay Zeka Asistanı Onboarding	Yeni Yapay Zeka Asistanı başlatma rehberi

AI Mühendisleri İçin

Bu bölüm Yapay Zeka Asistanı geliştirme ve yönetim süreçlerini kapsar. Yeni Yapay Zeka Asistanı başlatmadan önce Yapay Zeka Asistanı Onboarding rehberini okuyun.

AI-Force Genel Bakış

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

AI-Force Genel Bakış

AI-Force, Denomas'ın Yapay Zeka Asistanı ekosistemidir. İnsan çalışanlar ve Yapay Zeka Asistanları, aynı Denomas Yetkinlik Çerçevesi altında, aynı handbook kurallarına tabi olarak birlikte çalışır. Her Yapay Zeka Asistanı FreeIPA kimliği, yetkinlik profili ve tanımlı yetki sınırlarına sahiptir.

Vizyon

Her rutin görevi otomatize et, her insanı yaratıcı işe odakla.

Üç Asistan Kategorisi

1. Düşünürler (Thinkers)

Analiz, planlama ve strateji oluşturma görevlerini üstlenir. Araştırma yapar, seçenek sunar ve karar süreçlerini destekler. Yetkinlik seviyesi PROG:4-7 arasındadır. Karar yetkisi öneri niteliğindedir; nihai karar insana aittir.

Altyapı

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

Altyapı

Denomas altyapı birimi, on-premise ve bulut ortamlarının hibrit yönetimini, izleme standartlarını ve sürekli erişilebilirliği sağlar.

Alt Sayfalar

Sayfa	Açıklama
Hibrit Bulut	On-premise + cloud strateji, Docker Compose ve Kubernetes geçiş planı
İzleme Standartları	Altyapı izleme standartları, Prometheus, Grafana, Zabbix

Altyapı Standartları

Operasyonel altyapı standartları (sunucu hazırlama, yedekleme, felaket kurtarma) için Operasyonlar / Altyapı Standartları bölümüne bakın.

İlgili Sayfalar

Altyapı İzleme Standartları

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

Altyapı İzleme Standartları

Tüm Denomas altyapı bileşenlerinde aşağıdaki izleme standartları uygulanır.

Zorunlu Metrikler

Sunucu Metrikleri

Metrik	Eşik (Uyarı)	Eşik (Kritik)	Kontrol Sıklığı
CPU kullanımı	> %80	> %95	30 saniye
Memory kullanımı	> %80	> %95	30 saniye
Disk kullanımı	> %80	> %90	5 dakika
Disk I/O wait	> %20	> %40	30 saniye
Network throughput	Baseline + %50	Baseline + %100	30 saniye
Uptime	-	Restart tespit	30 saniye

Servis Metrikleri

Metrik	Eşik (Uyarı)	Eşik (Kritik)
HTTP 5xx oranı	> %1	> %5
Yanıt süresi (p95)	> 1s	> 5s
Kuyruk derinliği	> 1000	> 5000
Bağlantı havuzu	> %80	> %95

Veritabanı Metrikleri

Metrik	Eşik (Uyarı)	Eşik (Kritik)
Sorgu süresi (p95)	> 500ms	> 2s
Bağlantı sayısı	> %80 max	> %95 max
Replikasyon gecikmesi	> 5s	> 30s
Deadlock sayısı	> 0	> 5/dakika

Alarm Politikası

Flapping önleme — En az 3 ardışık kontrol başarısız olmalı
Eskalasyon — P1 15 dk içinde yanıtlanmazsa yöneticiye eskalasyon
Susturma — Planlanan bakım penceresinde alarmlar susturulur
Korelasyon — İlişkili alarmlar gruplama ile tek bildirim

İzleme Araçları

Katman	Araç
Altyapı	Denomas Denetim Otomasyon (Zabbix)
Uygulama	Prometheus + Grafana
Log	Loki
APM	OpenTelemetry + Jaeger

Ajan Protokolü

Yapay Zeka Asistanları alarm analizi ve on-triage görevlerinde bulunabilir. Alarm susturma yetkisi Denomas Yetkinlik PROG:4+ gerektirir.

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.

Context Yönetimi

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

Context Yönetimi

Denomas Yapay Zeka Asistanlarının context penceresi yönetim stratejilerini tanımlayan belgedir. Token ekonomisi prensipleri, progressive disclosure katmanları (llms.txt'den spesifik sayfalara kadar), Informed Walk protokolü, SOP bağımlılık tabanlı context yükleme, hafıza kalıcılığı (PARA yapısı, üç katmanlı hafıza sistemi, QMD Recall) ve bilgi grafı navigasyonu konularını 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.

İlgili Sayfalar

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:

DevOps Engineer

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

DevOps Engineer (DevOps Mühendisi)

DevOps mühendisleri, yazılım teslimat süreçlerinin otomasyonunu, altyapı yönetimini, izleme ve dağıtım stratejilerini yönetir. Geliştirme ve operasyon arasındaki köprüyü kurar.

Kariyer Seviyeleri ve Denomas Yetkinlik Çerçevesi Gereksinimleri

Junior DevOps Engineer — Yetkinlik Seviyesi 2

Yetkinlik	Seviye	Açıklama
ITOP	2	Temel IT operasyonları
CFMG	1	Konfigürasyon yönetimi temelleri
PROG	1	Temel scripting

Temel Sorumluluklar:

CI/CD pipeline'larının izlenmesi ve temel bakım
Mevcut otomasyon scriptlerinin çalıştırılması
Log izleme ve alarm yönetimi
Dokümantasyon takibi

Aranan Nitelikler:

Hibrit Bulut Stratejisi

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

Hibrit Bulut Stratejisi

Denomas, müşterilerine hem on-premise hem de cloud ortamlarında hizmet verir. Hibrit bulut stratejimiz, veri egemenliğini korurken bulutun esnekliğinden yararlanmayı amaçlar.

Strateji

┌─────────────────────────────────────────┐
│ Denomas Cloud (SaaS) │
│ Track 1 — Sürekli deployment │
│ denomas.com üzerinden │
├─────────────────────────────────────────┤
│ Müşteri On-Premise (Self-Managed) │
│ Track 2 — Aylık release │
│ Ansible ile otomatik kurulum │
├─────────────────────────────────────────┤
│ Hibrit (Karma) │
│ Kontrol düzlemi cloud + veri on-prem │
└─────────────────────────────────────────┘

Deployment Modelleri

Model	Kullanım Alanı	Örnek
Full SaaS	KOBİ'ler, hızlı başlangıç	Denomas AIO Community
Self-Managed	Kamu, finans, telekom	Denomas Denetim Otomasyon Enterprise
Hibrit	Hassas veri + cloud esneklik	Denomas Cloud

Veri Egemenlik Prensipleri

Müşteri verileri, müşterinin seçtiği lokasyonda kalır
KVKK ve GDPR uyumu tüm modellerde sağlanır
Veri sınıflandırması: Public, Internal, Confidential, Restricted

Altyapı Otomasyon

Tüm ortamlar Denomas Yönetim Otomasyon ile yönetilir:

IECO v6.0 Genel Bakış

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

IECO v6.0 Genel Bakış

IECO (Intelligent Enterprise Cognitive Ontology), Denomas'ın tescilli domain-agnostic kurumsal işletim sistemidir. Geleneksel şablon doldurma veya doküman yönetimi yaklaşımlarından farklı olarak, organizasyonel bilgiyi atomik birimler halinde bir bilgi grafında modeller ve bu atomlardan çok eksenli semantik projeksiyon ile sınırsız çıktı türü üretir.

IECO Nedir?

IECO, kurumsal bilgiyi bir işletim sistemi çekirdeği gibi ele alır. Şablon değil, bilgi grafı kullanır. Tek bir bilgi atomu; teklif, sözleşme, web sayfası, katalog, teknik belge, satış el kitabı veya sipariş formuna dönüşebilir.

İ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

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

Mühendislik

Denomas Mühendislik departmanı, açık kaynak çekirdekleri kurumsal ürünlere dönüştüren çekirdek birimdir. Geniş bir ürün portföyü oluşturur ve tüm mühendislik süreçleri 12 katmanlı (12-Tier) deterministik dizin yapısı üzerinde işler. Temel felsefemiz "Önce Teknik Temel (Foundation First)" yaklaşımıdır.

Mühendislik Vizyonu

Mühendislik departmanının temel misyonu: %100 deterministik, otomatize bir ekosistem oluşturmak. Bu ekosistemde Yapay Zeka Asistanları ve insanlar, belirli dosya sistemi protokolleri üzerinden işbirliği yapar. Bilgi nerede bulunduğuna göre değil, nerede kullanılacağına göre planlanır.

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.

Quality Engineer

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

Quality Engineer (Kalite Mühendisi)

Kalite mühendisleri, Denomas ürünlerinin kalitesini test otomasyon, CI/CD kalite kapıları ve kalite metrikleri aracılığıyla güvence altına alır.

Kullanılan Araçlar

Araç	Kullanım Alanı
Selenium / Playwright	Web UI test otomasyonu
pytest / Jest	Birim ve entegrasyon test framework
GitLab CI/CD	Pipeline ve kalite kapıları
SonarQube	Kod kalitesi ve statik analiz
k6 / Locust	Performans ve yük testi
Postman / Newman	API testi

Kariyer Seviyeleri ve Denomas Yetkinlik Çerçevesi Gereksinimleri

Junior Quality Engineer — Yetkinlik Seviyesi 2

Denomas Yetkinlik Çerçevesi Gereksinimleri:

Sales Engineer

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

Sales Engineer (Satış Mühendisi)

Satış mühendisleri, teknik ürün bilgisi ile satış sürecini birleştirerek müşteri ihtiyaçlarını karşılayan çözümler sunar. Pre-sales teknik destek, demo ve teknik teklif hazırlamadan sorumludur.

Kariyer Seviyeleri ve Denomas Yetkinlik Çerçevesi Gereksinimleri

Sales Engineer — Yetkinlik Seviyesi 3

Yetkinlik	Seviye	Açıklama
SALE	3	Satış süreçleri
RLMT	3	Müşteri ilişkileri
ARCH	2	Temel çözüm tasarımı

Temel Sorumluluklar:

Ürün demosu ve teknik sunum yapma
Müşteri teknik gereksinimlerini anlama ve dokümantasyonu
RFP/RFI yanıtları hazırlama
Teknik teklif ve çözüm mimarisi oluşturma
Satış takımıyla işbirliği
POC (Proof of Concept) yürütme

Aranan Nitelikler:

Security Engineer

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

Security Engineer (Güvenlik Mühendisi)

Güvenlik mühendisleri, Denomas ürün ve altyapısının güvenlik duruşunu yönetir. Güvenlik testi, uyumluluk denetimi, olay müdahale ve güvenlik mimarisi tasarımından sorumludur.

Kariyer Seviyeleri ve Denomas Yetkinlik Çerçevesi Gereksinimleri

Junior Security Engineer — Yetkinlik Seviyesi 2

Yetkinlik	Seviye	Açıklama
SCTY	2	Temel güvenlik uygulamaları
AUDT	1	Denetim temelleri

Temel Sorumluluklar:

Güvenlik tarama araçlarını çalıştırma ve sonuç raporlama
Güvenlik politikalarını izleme
Zafiyet yönetimi süreçlerine katılım
Güvenlik dokümantasyonu bakımı

Aranan Nitelikler:

Site Reliability Engineer

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

Site Reliability Engineer (SRE)

SRE mühendisleri, Denomas ürün ve hizmetlerinin güvenilirliğini, performansını ve kullanılabilirliğini sağlar. İzleme, olay yönetimi, kapasite planlaması ve otomasyon sorumluluğunu taşır.

Kullanılan Araçlar

Araç	Kullanım Alanı
Zabbix	Altyapı ve uygulama izleme
Grafana	Metrik görselleştirme ve dashboard
Ansible	Altyapı otomasyon
Wazuh	Log yönetimi ve analiz
PagerDuty / benzeri	Uyarı yönetimi ve nöbet
Terraform	Altyapı kod olarak (IaC)
Docker / Kubernetes	Konteyner orkestrasyon

Kariyer Seviyeleri ve Denomas Yetkinlik Çerçevesi Gereksinimleri

Junior SRE — Yetkinlik Seviyesi 2

Denomas Yetkinlik Çerçevesi Gereksinimleri:

Skill Framework

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

Skill Framework

Denomas AI-Force ekosistemi, 181 tanımlı yeteneğe (skill) sahiptir. Her yetenek, bağımsız bir dizinde SKILL.md dosyasıyla tanımlanır. Yapay Zeka Asistanları, sahip olduğu skill seti ve yetkinlik seviyesine göre görev alır.

Skill Kataloğu — Kategori Özeti

Aşağıdaki tablo, 181 skill dizininin kategoriye göre dağılımını göstermektedir:

Kategori	Skill Sayısı
Güvenlik (Security)	18
Otomasyon ve Altyapı (Automation & Infrastructure)	17
Geliştirme (Development)	22
Test ve Kalite (Testing & Quality)	13
Veri ve Analiz (Data & Analytics)	10
AI ve Bağlam Yönetimi (AI & Context)	14
Proje Yönetimi ve Planlama	11
Dokümantasyon ve İçerik	14
Frontend ve UI/UX	12
Veritabanı (Database)	8
Mobil Geliştirme	4
Pazarlama ve İş Geliştirme	3
Bilimsel ve Araştırma	3
Araç ve Yardımcı (Tooling & Utility)	21
Uyumluluk ve Regülasyon (Compliance)	5
Gözlemleme ve İzleme (Observability)	6
Toplam	181

SKILL.md Dosya Yapısı

Her skill, kendi dizininde bir SKILL.md dosyasıyla tanımlanır. Dosya şu bölümlerden oluşur:

Software Engineer

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

Software Engineer (Yazılım Mühendisi)

Yazılım mühendisleri, Denomas ürün ve platformlarının teknik temelini oluşturur. Kod yazma, test, mimari tasarım ve teknik borç yönetiminden sorumludur.

Kariyer Seviyeleri ve Denomas Yetkinlik Çerçevesi Gereksinimleri

Junior Software Engineer — Yetkinlik Seviyesi 2

Denomas Yetkinlik Çerçevesi Gereksinimleri:

Yetkinlik	Seviye	Açıklama
PROG	2	Rehberlik altında kod yazma
TEST	1	Temel birim test yazma
DESN	1	Basit tasarım kalıplarını uygulama

Temel Sorumluluklar:

Tanımlanmış görevleri rehberlik altında tamamlama
Birim test yazma ve mevcut testleri çalıştırma
Kod inceleme sürecine katılım
Dokümantasyon okuma ve takip etme
Günlük standup'lara katılım

Aranan Nitelikler:

Solutions Architect

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

Solutions Architect (Çözüm Mimarı)

Çözüm mimarları, müşteri gereksinimlerini teknik çözümlere dönüştürür. Sistem mimarisi, teknoloji seçimi, entegrasyon stratejisi ve teknik liderlik sağlar.

Kariyer Seviyeleri ve Denomas Yetkinlik Çerçevesi Gereksinimleri

Solutions Architect — Yetkinlik Seviyesi 4

Yetkinlik	Seviye	Açıklama
ARCH	4	Çözüm mimarisi tasarımı
DESN	4	Sistem tasarımı
STPL	3	Stratejik planlama
RLMT	3	Paydaş ilişkileri

Temel Sorumluluklar:

Müşteri gereksinimlerini teknik çözümlere çevirme
Sistem mimarisi tasarımı ve dokümantasyonu
Teknoloji değerlendirme ve seçimi
Entegrasyon stratejisi belirleme
Teknik teklif hazırlama
Prototip geliştirme

Aranan Nitelikler:

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.

Yetkinlik Çerçevesi

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

Denomas Yetkinlik Çerçevesi Tabanlı Organizasyon

Denomas'ın hem insan çalışanlar hem de Yapay Zeka Asistanları için kullandığı yetkinlik ve yetki tanımlama çerçevesini tanımlar. PROG:1'den PROG:7'ye kadar yetkinlik seviyeleri, organizasyon tasarımında kullanılan Denomas Yetkinlik eksenleri (GOVN, POMG, ARCH, PROG vb.), Yapay Zeka Asistanı-yetkinlik yetenek haritalama, insan-yapay zeka skill paritesi modeli, yetki matrisi, agent kartı formatı ve kariyer ilerleme mekanizmalarını 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.

Engineering on Denomas Handbook

Açık Kaynak Stratejisi

Açık Kaynak Stratejisi

Upstream-First Yaklaşım

Fork Kuralları

AI Agent Specialist

AI Agent Specialist (Yapay Zeka Asistanı Uzmanı)

Kariyer Seviyeleri ve Denomas Yetkinlik Çerçevesi Gereksinimleri

AI Agent Developer — Yetkinlik Seviyesi 3

AI-Force

AI-Force

Birim Misyonu

Alt Sayfalar

AI-Force Genel Bakış

AI-Force Genel Bakış

Vizyon

Üç Asistan Kategorisi

1. Düşünürler (Thinkers)

Altyapı

Altyapı

Alt Sayfalar

İlgili Sayfalar

Altyapı İzleme Standartları

Altyapı İzleme Standartları

Zorunlu Metrikler

Sunucu Metrikleri

Servis Metrikleri

Veritabanı Metrikleri

Alarm Politikası

İzleme Araçları

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)

Context Yönetimi

Context Yönetimi

İlgili Sayfalar

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

DevOps Engineer

DevOps Engineer (DevOps Mühendisi)

Kariyer Seviyeleri ve Denomas Yetkinlik Çerçevesi Gereksinimleri

Junior DevOps Engineer — Yetkinlik Seviyesi 2

Hibrit Bulut Stratejisi

Hibrit Bulut Stratejisi

Strateji

Deployment Modelleri

Veri Egemenlik Prensipleri

Altyapı Otomasyon

IECO v6.0 Genel Bakış

IECO v6.0 Genel Bakış

IECO Nedir?

İ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

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