vuralserhat86

arch_decisions

ADR template, database selection, capacity planning ve scalability.

vuralserhat86 43 12 Updated 5mo ago
GitHub

Install

npx skillscat add vuralserhat86/antigravity-agentic-skills/arch-decisions

Install via the SkillsCat registry.

SKILL.md

📋 Architecture Decisions

ADR, database selection ve capacity planning.


📝 ADR Template

# ADR-001: Database Selection

## Status: Accepted

## Context
[Problem açıklaması]

## Decision
PostgreSQL kullanacağız.

## Consequences
### Positive
- ACID compliance
### Negative
- Horizontal scaling zor

## Alternatives
- MongoDB: Rejected - JOINs için uygun değil

🗄️ Database Selection

SQL NoSQL
Complex JOINs Flexible schema
ACID High throughput
Transactions Horizontal scale

📊 Capacity Planning

DAU: 1M users
Requests: 20/user/day = 20M/day
RPS: 20M / 86400 = ~230 RPS
Peak: 230 × 3 = ~700 RPS

Architecture Decisions v1.0

🔄 Workflow

Kaynak: AWS Architecture Blog

Aşama 1: Problem Identification

  • Context: Problemi ve etkilerini net tanımla.
  • Constraints: Kısıtlamaları (Bütçe, Zaman, Teknoloji) belirle.
  • Options: En az 2 alternatif çözüm yolu belirle.

Aşama 2: Proposal (Status: Proposed)

  • Draft: ADR şablonunu doldur.
  • RFC: Takımdan yorum iste (Pull Request veya Toplantı).
  • Evaluation: Alternatifleri kriterlere göre puanla (Pros/Cons).

Aşama 3: Decision (Status: Accepted/Rejected)

  • Consensus: Kararı netleştir ve statüyü güncelle.
  • Implications: Kararın uzun vadeli etkilerini (Consequences) yaz.
  • Commit: ADR dosyasını repoya ekle.

Kontrol Noktaları

Aşama Doğrulama
1 Problem ve alternatifler net mi?
2 Takım görüşü alındı mı?
3 Kararın "Consequences" bölümü dürüstçe yazıldı mı?