Brokerlik ve sigorta operasyonları için SQL Server tabanlı çok kiracılı yönetim platformu.
Yafes Pars; poliçe, hasar, müşteri, görev, belge ve denetim iş akışlarını tek bir SQL Server veritabanında birleştiren SSMS-first sigorta operasyon platformudur.
Kullanıcı deneyiminin merkezi bir web arayüzü değil SQL Server Management Studio'dur: Query Editor, Results Grid, SQLCMD Mode, yönlendirilmiş scriptler ve saklı yordam köprüleri.
SSMS arayüzünün nasıl kullanıldığını görmek için tarayıcıda açın:
simulation/index.html
➡️ Sunucuya bağlanma · Nesne Gezgini · Tablo sorgulama · SQL yazma · Saklı yordam çalıştırma — 9 adımlı interaktif tutorial
╔══════════════════════════════════════════════════════════╗
║ SSMS Operator (Birincil Arayüz) ║
║ Query Editor · Results Grid · SQLCMD Mode ║
╚═══════════════════════════╤══════════════════════════════╝
│
╔═══════════════════════════▼══════════════════════════════╗
║ SQL Server 2022 — YafesPars ║
║ ║
║ person · policy · claim · task · document ║
║ risk · coverage · finance · institution · audit ║
║ config · identity ║
║ ║
║ 115 tablo · 21 migration · 12 şema ║
╚═══════════════════════════╤══════════════════════════════╝
│
╔═══════════════════════════▼══════════════════════════════╗
║ .NET 8 Web API (Dapper · Minimal API) ║
║ JWT/OIDC · Rate Limiting · Application Insights ║
╚═══════════════════════════╤══════════════════════════════╝
│
╔═══════════════════════════▼══════════════════════════════╗
║ Azure App Service ║
║ Key Vault · Log Analytics · GHCR · Bicep ║
╚══════════════════════════════════════════════════════════╝
|
Gerçek/tüzel kişi, adres, iletişim, belge yönetimi. Çoklu tenant izolasyonu ile her acenteye ayrı veri alanı. Sözleşme, taraf, nesne, teminat ve prim takibi. Kasko, sağlık, konut, hayat domain'leri. Olay kaydı, ekspertiz, ödeme takibi ve kapanış iş akışı. Belge bağlama ve audit trail. |
Görev atama, yorum, öncelik ve durum takibi. Tüm entity tiplerine belge bağlantısı. Çok kiracılı rol/yetki matrisi, kullanıcı yönetimi ve tam audit trail. Least-privilege tasarımı. 35+ endpoint, 14 write stored procedure (araç, mülk, sigorta, fatura, ödeme). JWT/OIDC, rate limiting, Application Insights. |
| Şema | Kapsam |
|---|---|
person |
Gerçek/tüzel kişi, adres yönetimi |
policy |
Poliçe, sözleşme, taraf, nesne |
coverage |
Teminat, prim, ContractCoverageItem |
claim |
Hasar, ekspertiz, ödeme |
risk |
Risk nesnesi, araç, mülk |
task |
Görev, yorum, hatırlatma |
document |
Belge, arşiv, bağlantı |
finance |
Fatura, ödeme, ödeme planı |
identity |
Kullanıcı, rol, tenant |
institution |
Kurum, şube |
config |
Sistem yapılandırması |
audit |
Denetim izi, değişiklik geçmişi |
Migration 020__add_write_stored_procedures.sql ile eklenen 14 SP:
| SP | Şema | Açıklama |
|---|---|---|
SP_CreateLegalPerson |
person |
Tüzel kişi kaydı |
sp_CreateRiskObject |
risk |
Risk nesnesi oluştur |
sp_CreateVehicle |
risk |
Araç kaydı (plaka, şasi, marka) |
sp_CreateProperty |
risk |
Mülk kaydı (adres, tip, alan) |
sp_LinkRiskToContract |
risk |
Risk'i poliçeye bağla |
sp_AddCoverageItem |
coverage |
Teminat kalemi ekle |
sp_SetPremium |
coverage |
Prim, vergi, komisyon güncelle |
sp_UpdateCoverage |
coverage |
Limit ve muafiyet güncelle |
sp_CreateInvoice |
finance |
Fatura oluştur |
sp_RecordPayment |
finance |
Ödeme kaydet (tam ödemede otomatik kapat) |
sp_CreatePaymentPlan |
finance |
Taksit planı + taksit kalemleri |
sp_CreateDocument |
document |
Belge kaydı (storage_key, provider) |
sp_LinkDocument |
document |
Belgeyi entity'e bağla |
sp_ArchiveDocument |
document |
Belgeyi arşivle |
-- 1. SQL Server'a bağlan: localhost,1433 veya Azure SQL endpoint
-- 2. Veritabanı: YafesPars
-- 3. Query > SQLCMD Mode'u aç
-- Ana dashboard
:r database/ssms/05__operator_dashboard_home.sql
-- Günlük kontrol listesi
:r database/ssms/10__daily_operator_checklist.sql| Adım | Script | Amaç |
|---|---|---|
| 1 | 00__open_first_safety_check.sql |
Sunucu ve veritabanı doğrulama |
| 2 | 05__operator_dashboard_home.sql |
Ana dashboard |
| 3 | 10__daily_operator_checklist.sql |
Günlük kontroller |
| 4 | 06__query_library_shortcuts.sql |
Kayıt arama |
| 5 | 07__data_entry_bridge_templates.sql |
Veri oluşturma |
| 6 | 08__data_editing_guardrails.sql |
Güvenli güncelleme |
| 7 | 09__graph_report_pack.sql |
Raporlar |
| 8 | 04__admin_security_audit_queries.sql |
RBAC & denetim |
# Ortam dosyasını oluştur
cp .env.example .env
# Başlat (API + SQL Server 2022)
docker compose up -d
# Migration'ları çalıştır (000–020)
$env:YAFES_SQL_SERVER = "localhost,1433"
$env:YAFES_SQL_DATABASE = "YafesPars_DEV"
./database/tools/run-dev-migrations.ps1cd backend/src/YafesPars.Api
dotnet run
# Swagger → http://localhost:5000/swagger
# Health → http://localhost:5000/healthAdım adım Azure kurulum rehberi için: docs/azure-kurulum-rehberi.html (20 sayfalık interaktif simülasyon)
# Giriş yap
az login
# Resource group oluştur
az group create \
--name rg-yafespars-prod \
--location westeurope
# SQL Server + veritabanı
az sql server create \
--name sql-yafespars-prod \
--resource-group rg-yafespars-prod \
--location westeurope \
--admin-user yafes_admin \
--admin-password "<güvenli-şifre>"
az sql db create \
--server sql-yafespars-prod \
--resource-group rg-yafespars-prod \
--name YafesPars \
--service-objective S2 \
--collation Turkish_CI_AS
# App Service + Web App (.NET 8)
az appservice plan create \
--name asp-yafespars-prod \
--resource-group rg-yafespars-prod \
--sku B2 --is-linux
az webapp create \
--name app-yafespars-prod \
--resource-group rg-yafespars-prod \
--plan asp-yafespars-prod \
--runtime "DOTNETCORE:8.0" \
--assign-identity SystemAssigned
# Key Vault
az keyvault create \
--name kv-yafespars-prod \
--resource-group rg-yafespars-prod \
--location westeurope| Secret | Açıklama |
|---|---|
AZURE_CLIENT_ID |
Azure AD uygulama client ID |
AZURE_TENANT_ID |
Azure AD tenant ID |
AZURE_SUBSCRIPTION_ID |
Azure abonelik ID |
AZURE_RESOURCE_GROUP |
Resource group adı |
JWT_AUTHORITY |
OIDC authority URL |
JWT_AUDIENCE |
JWT audience değeri |
Yafes_Pars/
├── 📂 database/
│ ├── migrations/ # 000–020 sıralı migration scriptleri
│ ├── ssms/ # SSMS operator scriptleri (00–17)
│ └── tools/ # CI/CD ve migration araçları
├── 📂 backend/
│ └── src/
│ ├── YafesPars.Api/ # Minimal API endpoints
│ ├── YafesPars.Application/ # Commands & queries
│ └── YafesPars.Infrastructure/ # Dapper repositories
├── 📂 infra/
│ ├── main.bicep # Azure IaC (App Service, Key Vault, AI)
│ └── main.bicepparam
├── 📂 simulation/
│ └── index.html # İnteraktif SSMS tutorial simülasyonu
├── 📂 docs/
│ ├── assets/logo.png # Proje logosu
│ ├── kullanim-kilavuzu.md # Türkçe kullanım kılavuzu
│ ├── kurulum-rehberi.html # Docker kurulum simülasyonu (6 adım)
│ └── azure-kurulum-rehberi.html # Azure kurulum simülasyonu (20 adım)
├── 📂 md/ # Teknik belgeler
├── 🐳 Dockerfile
├── 🐳 docker-compose.yml
└── 📋 .github/workflows/ # CI/CD pipeline'ları (4 workflow)
Tüm PR'larda (path filtresi yok) 4 check çalışır:
git push → PR / main
│
├─▶ backend-build.yml ✓ dotnet restore + build + test
├─▶ sql-server-validation.yml ✓ 21 migration · SP doğrulama
├─▶ database-quality-gate.yml ✓ SQL lint · destructive pattern tarama
└─▶ ssms-workbench-validation.yml ✓ Manifest sayım · JS syntax · SSMS contract
| Döküman | İçerik |
|---|---|
docs/kullanim-kilavuzu.md |
Tam Türkçe kullanım kılavuzu (v1.5) |
docs/kurulum-rehberi.html |
Docker kurulum simülasyonu |
docs/azure-kurulum-rehberi.html |
Azure kurulum simülasyonu (20 adım) |
md/database/architecture.md |
Veritabanı mimarisi |
md/database/domain-model.md |
Domain model |
md/ssms/operator-workbench.md |
SSMS operator kılavuzu |
md/ssms/tutorials/ |
Tutorial serisi (01–11) |
SECURITY.md |
Güvenlik politikası |
- SQL Server 2022 — Developer Edition (yerel) veya Azure SQL (üretim)
- SSMS 20+ veya Azure Data Studio
- .NET 8 SDK — backend için
- Docker Desktop — isteğe bağlı
- PowerShell 7+ — migration araçları için
- Azure CLI 2.60+ — bulut deploy için
SQL Server 2022 · .NET 8 · Azure · 115 Tablo · 21 Migration · MIT License