kortext 1.0.0 → 2.2.0

package/workspace/memory/handover.md

@@ -0,0 +1,40 @@
+# Handover Reports
+
+> [!TODO]
+> - Kullanım Kuralı: Yeni kayıtlar dosyanın **en üstüne** eklenir; eski kayıtlar silinmez.
+> - Her görev kapanışında doldurulması zorunludur — handover tamamlanmadan görev Done'a çekilemez.
+> - Oturum başlangıcında bu dosyayı `kortext-session-start.py` ile özetle: `python scripts/kortext-session-start.py`
+
+<!-- ŞABLON — kopyala, doldur, bu yorum satırını sil -->
+## Handover: [task-id] — [task-name]
+
+> [!INFO]
+> - **Author:** [+ajan] 
+> - **To:** [devralan +ajan veya "Yok" — görev Done]
+> - **Date:** [DD.MM.YY-HH:MM]
+> - **Status:** [Tamamlandı / Bloklandı / Kısmen tamamlandı]
+
+### ✅ Completed *(zorunlu)*
+
+- [Ne yapıldı? Tek cümleyle özetle, gerekirse madde madde.]
+ 
+### Changed Files *(zorunlu)*
+
+- `[dosya-yolu]` — [ne değişti]
+
+### Kritik Bağlam *(zorunlu — en az 1 madde)*
+
+- [Bir sonraki ajanın **mutlaka** bilmesi gereken bilgi. Workaround, kritik bağımlılık, beklenmedik davranış, alınan karar. Boş bırakma — "Yok" yaz.]
+
+### Watch-outs & Decisions *(varsa)*
+
+- [Kırılgan nokta, teknik borç, ileride sorun çıkabilecek alan. `workspace/memory/decisions.md`'ye referans ver.]
+
+### Last Commit *(zorunlu)*
+
+- `[commit-hash]` — `[commit-mesajı]`
+
+### Next Steps *(zorunlu)*
+
+- [Devralan ajan ne yapacak? Yoksa "Yok" yaz — boş bırakma.]
+

package/workspace/memory/learned.md

@@ -0,0 +1,21 @@
+# Knowledge Base
+
+## Öğrenim: [Hata/Problem Başlığı veya Konu]
+
+**Author:** [+ajan] | **Status:** [Waiting], [`Approved/Rejected` | [YYYY-MM-DD:HH:MM]] | **Approver:** [+ajan]
+
+### Problem
+
+- [Yaşanan sorunun veya tespit edilen eksikliğin ne olduğu]
+
+### Root Cause
+
+- [Sorunu oluşturan kök sebep (Örn: Yanlış package versiyonu, eksik config vb.)]
+
+### Solution
+
+- [Uygulanan çözüm yolu (Çalıştırılan komutlar, güncellenen dosya yolları vb.)]
+
+### Prevention
+
+- [Bu hatanın bir daha yaşanmaması için projeye dahil edilen kural veya önlemler]

package/workspace/references/access.md

@@ -0,0 +1,47 @@
+---
+status: uninitialized
+owner: +operation-manager
+last_review: 2026-05-17
+---
+
+# Access & Service Configuration
+
+> [!INFO]
+> - status: [draft/approved] | [DD.MM.YY-HH:MM]
+> - author: +devops-engineer, +prime
+> - approver: +prime
+
+---
+
+## Lokal Geliştirme Araçları
+
+- [Araç adı] — [kurulum notu]
+-  [MCP Sunucu adı] — [kurulum notu]
+
+## Versiyon Kontrolü
+
+- GitHub Repo: [+prime dolduracak]
+- Organization: [+prime dolduracak]
+
+## Hosting & Deployment
+
+- Production URL: [+prime dolduracak]
+- Staging URL: [+prime dolduracak]
+- Platform: [Firebase Hosting / Vercel / AWS]
+
+## Sunucu Erişimi
+
+- SSH Root: [+prime dolduracak]
+- Domain: [+prime dolduracak]
+
+## Veritabanı
+
+- Provider: [Firebase / Supabase / PostgreSQL]
+- Production Instance: [+prime dolduracak]
+- Staging Instance: [+prime dolduracak]
+
+## Diğer Servisler
+
+- Analytics: [Google Analytics / Mixpanel]
+- CDN: [Cloudflare]
+- Mail: [SendGrid / Resend]

package/workspace/references/api-reference.md

@@ -0,0 +1,59 @@
+---
+status: uninitialized
+owner: +engineering-manager
+last_review: 2026-05-17
+---
+
+# API Reference
+
+> [!INFO]
+> - status: [draft/approved] | [DD.MM.YY-HH:MM]
+> - author: +engineering-manager
+> - reviewer: +backend-developer
+
+---
+
+## Authentication
+
+- **Type:** [Örn: Bearer Token, OAuth2, API Key]
+- **Headers:** 
+
+## Base URLs
+
+- **Production:** `https://api.example.com/v1`
+- **Staging/Test:** `https://staging-api.example.com/v1`
+
+## Endpoints
+
+### [Modül Adı / Grup Adı]
+#### `GET /path/to/resource` (Açıklama)
+- **Parameters / Query:**
+- `param` (type): [Açıklama]
+- **Request Body:** (Eğer varsa)
+```json
+{
+  "key": "value"
+}
+```
+- **Response Data (Success 2xx):**
+```json
+{
+  "data": "value"
+}
+```
+- **Response Data (Error 4xx/5xx):**
+```json
+{
+  "error": "Message"
+}
+```
+
+## Error Codes & Formatting
+
+- **200:** Success
+- **400:** Bad Request
+- **401:** Unauthorized
+- **403:** Forbidden
+- **404:** Not Found
+- **500:** Internal Server Error
+- vb.

package/workspace/references/blueprint.md

@@ -0,0 +1,29 @@
+---
+status: uninitialized
+owner: +prime
+last_review: 2026-05-17
+---
+
+# Product Roadmap & Vision
+
+> [!INFO]
+> - status: [draft/approved] | [DD.MM.YY-HH:MM]
+> - author: +prime
+
+---
+
+## Product Vision & Goals
+
+- [Ürünün ana amacı ve vizyonu]
+
+## Target Audience & Personas
+
+- [Hangi kullanıcı kitlelerine hitap ediliyor?]
+
+## Key Performance Indicators (KPIs)
+
+- [Başarı kriterleri nelerdir?]
+
+## Future Scope & Out of Scope
+
+- [Neler kapsam dışında?]

package/workspace/references/content-strategy.md

@@ -0,0 +1,39 @@
+---
+status: uninitialized
+owner: +copywriter
+last_review: 2026-05-17
+---
+
+# Content Strategy & Microcopy
+
+> [!INFO]
+> - status: [draft/approved] | [DD.MM.YY-HH:MM]
+> - author: +copywriter
+> - approver: +prime
+
+---
+
+## Brand Voice & Tone
+
+- **Tone:** [Örn: Profesyonel, Samimi, Neşeli, Ciddi]
+- **Dos & Don'ts:** 
+ - **Yap:** [Örn: Kullanıcıyı yönlendirici basit cümleler kur]
+ - **Yapma:** [Örn: Aşırı teknik jargona boğma]
+
+## Microcopy (UI Interface Texts)
+
+- **Primary Buttons:** [Örn: 'Devam Et', 'Kaydet', 'Hemen Başla']
+- **Secondary Buttons:** [Örn: 'İptal', 'Geri Dön']
+- **Empty States:** [Örn: 'Henüz burada kayıt yok, ilk kaydı oluştur!']
+- **Success Messages:** [Örn: 'Başarıyla kaydedildi.']
+
+## Error Messages
+
+- **Validation Errors:** [Örn: 'Bu alan zorunludur.', 'Geçersiz e-posta formatı.']
+- **Server/System Errors:** [Örn: 'Sunucuya bağlanılamadı, lütfen tekrar deneyin.']
+
+## Email & Notification Templates
+
+### [Bildirim Türü / Senaryo]
+- **Subject / Başlık:** 
+- **Body / İçerik:**

package/workspace/references/db-schema.md

@@ -0,0 +1,51 @@
+---
+status: uninitialized
+owner: +db-admin
+last_review: 2026-05-17
+---
+
+# Database Schema
+
+> [!INFO]
+> - status: [draft/approved] | [DD.MM.YY-HH:MM]
+> - author: +db-admin
+> - approver: +engineering-manager
+
+---
+
+## Database Overview
+
+- **Database Engine:** [Örn: PostgreSQL, MongoDB]
+- **ORM / ODM:** [Örn: Prisma, Mongoose]
+- **Migrations Tool:** [Örn: Prisma Migrate, TypeORM]
+
+## Conventions & Standards
+
+- **Table Naming:** [Örn: snake_case (çoğul)]
+- **Column Naming:** [Örn: snake_case / camelCase]
+- **Primary Keys:** [Örn: UUID / Auto-increment integer]
+- **Timestamps:** `created_at`, `updated_at` (Zorunlu)
+
+## Entity-Relationship (ERD) Structure
+
+### Table: `[table_name]`
+- **Description:** [Tablonun işlevi]
+- **Columns:**
+- `id` (PK, UUID)
+- `[column_name]` ([type], [nullable/unique]) - [Description]
+- **Relations:** 
+- `[FK/Relation]` -> `[Related Table]`
+
+### Table: `[table_name_2]`
+- **Description:** [Tablonun işlevi]
+- **Columns:**
+- `id` (PK)
+...
+
+## Indexes & Performance Optimizations
+
+- **[table_name]:** `[column_name]` (Index Type) -> Nedeni
+
+## Security Policies / Row-Level Security
+
+- [Örn: RLS Kuralları, Hassas verilerin şifrelenmesi]

package/workspace/references/design-system.md

@@ -0,0 +1,107 @@
+---
+status: uninitialized
+owner: +designer
+last_review: 2026-05-17
+---
+
+# Design System (Strict & Tokenized Specification)
+
+> [!INFO]
+> - status: [draft/approved] | [DD.MM.YY-HH:MM]
+> - author: +designer
+> - reviewer: +frontend-developer
+> - approver: +prime
+
+---
+
+## Core Tokens (Atomic Values)
+
+> [!WARNING] **FE KURALI:**
+>  Kod içerisinde ham değer (HEX, px, rem) kullanımı yasaktır. Sadece aşağıdaki değişken isimleri kullanılacaktır.
+
+### Color Palette & Functional Mapping
+
+| Token Name | HEX / RGB | Usage Context |
+| :--- | :--- | :--- |
+| `--color-bg-main` | `[VALUE]` | Sayfa ana arka planı |
+| `--color-bg-surface` | `[VALUE]` | Kartlar, modallar, section'lar |
+| `--color-text-base` | `[VALUE]` | Standart metin içeriği |
+| `--color-text-muted` | `[VALUE]` | Placeholder, yardımcı metinler |
+| `--color-primary` | `[VALUE]` | Ana butonlar, aktif linkler |
+| `--color-primary-hover`| `[VALUE]` | Hover durumu (Zorunlu) |
+| `--color-border` | `[VALUE]` | Ayırıcı çizgiler ve input border |
+| `--color-success` | `[VALUE]` | Başarı mesajları ve ikonları |
+| `--color-error` | `[VALUE]` | Hata mesajları ve input hata durumu |
+
+### Spacing Scale (8px Grid Rule)
+
+> [!WARNING] **FE KURALI:**
+>  Margin ve Padding değerleri sadece bu skaladan seçilebilir. Ara değer (13px, 7px vb.) kullanımı yasaktır.
+
+- `--space-unit`: `8px`
+- `--space-xs`: `4px`  (0.5x)
+- `--space-sm`: `8px`  (1x)
+- `--space-md`: `16px` (2x)
+- `--space-lg`: `24px` (3x)
+- `--space-xl`: `32px` (4x)
+- `--space-2xl`: `48px` (6x)
+
+---
+
+## Typography (The Vertical Rhythm)
+
+> [!WARNING] **FE KURALI:**
+> Font-size tek başına yeterli değildir. Line-height ve Weight değerleri her rol için sabittir.
+
+| Role | Font-Family | Size (px) | Line-Height | Weight | Letter-Spacing |
+| :--- | :--- | :--- | :--- | :--- | :--- |
+| `H1` | `[Family]` | `40px` | `1.2` | `700` | `-0.02em` |
+| `H2` | `[Family]` | `32px` | `1.2` | `600` | `-0.01em` |
+| `Body` | `[Family]` | `16px` | `1.5` | `400` | `normal` |
+| `Small` | `[Family]` | `12px` | `1.4` | `400` | `0.01em` |
+| `Label` | `[Family]` | `14px` | `1` | `500` | `0.02em` |
+
+---
+
+## Layout & Grid (Structural Constraints)
+
+| Property | Value | Description |
+| :--- | :--- | :--- |
+| `--container-max` | `1200px` | İçeriğin merkezleneceği maksimum genişlik |
+| `--gutter` | `24px` | Sütunlar arası boşluk |
+| `--screen-sm` | `640px` | Mobile breakpoint |
+| `--screen-md` | `768px` | Tablet breakpoint |
+| `--screen-lg` | `1024px` | Desktop breakpoint |
+| `--safe-area` | `16px` | Mobil cihazlar için minimum kenar boşluğu |
+
+---
+
+## UI Components (Strict Atoms)
+
+### Buttons
+- **Border-Radius:** `--radius-btn`: `[px]`
+- **Heights:** `Small: 32px`, `Default: 44px`, `Large: 56px`
+- **States (Zorunlu):**
+- *Focus:* `outline: 2px solid --color-primary`, `offset: 2px`
+- *Active:* `transform: scale(0.98)`
+- *Disabled:* `opacity: 0.5`, `cursor: not-allowed`
+
+### Inputs
+- **Border:** `1px solid --color-border`
+- **Focus State:** `border-color: --color-primary`, `box-shadow: [Value]`
+- **Border-Radius:** `--radius-input`: `[px]`
+
+### Effects & Elevation
+- `--shadow-sm`: `[CSS Box Shadow Value]`
+- `--shadow-md`: `[CSS Box Shadow Value]`
+- `--transition-base`: `all 0.2s ease-in-out`
+
+---
+
+##  Technical Implementation Directives (Red Lines)
+
+1. **No Magic Numbers:** Tasarımda tanımlı olmayan her değer reddedilecektir. Yapmadan önce danışın.
+2. **Icon Mapping:** Sadece `[İkon Seti Adı]` kütüphanesi kullanılacaktır. İkon boyutları `16/24/32px` dışında olamaz.
+3. **Variable Injection:** Designer bu dosyayı onayladığında, +frontend-developer tüm değerleri `CSS Variables` veya `Tailwind Config` dosyasına aktaracaktır.
+ 4. **Consistency:** Tüm "shadow", "blur" ve "transition" değerleri bu dosyada belirtilen CSS kodları dışında yazılamaz.
+ 5. **Zero Tolerance for Hardcoding:** CSS dosyalarında HEX kodu tespiti kritik hata (Blocker) sayılacaktır.

package/workspace/references/dictionary.md

@@ -0,0 +1,42 @@
+---
+status: uninitialized
+owner: +engineering-manager
+last_review: 2026-05-17
+---
+
+# Coding Dictionary & Standards
+
+> [!INFO]
+> - status: [draft/approved] | [DD.MM.YY-HH:MM]
+> - author: +engineering-manager
+> - approver: +prime
+
+---
+
+## Naming Conventions
+
+- **Variables & Functions:** [`camelCase, snake_case`]
+- **Classes & Interfaces:** [`PascalCase`]
+- **Constants:** [`UPPER_SNAKE_CASE`]
+- **Files & Directories:** [`kebab-case`]
+- **Database Tables:** [`snake_case, plural/singular`]
+
+## Code Quality & Formatting
+
+- **Linter & Formatter:** [Örn: ESLint + Prettier ayarları]
+- **Indent:** [Örn: 2 spaces]
+- **Quote Mark:** [Örn: Single quotes ('')]
+
+## Project Terminology (Domain Language)
+
+- **[Kullanılan Terim]:** [Açıklama / Bizim uygulamamızdaki anlamı]
+- *Örnek:* **Client:** Uygulamayı kullanan müşteri (User demeyeceğiz).
+- *Örnek:* **Cart:** Alışveriş sepeti (Basket demeyeceğiz).
+
+## Commenting & Documentation Rules
+
+- [Örn: JSDoc kullanılacak, kodun "ne" yaptığı değil, "neden" yaptığı yorumlanacak]
+
+## Error Handling Pattern
+
+- [Genel try/catch veya error response fırlatma standartları]

package/workspace/references/file-system.md

@@ -0,0 +1,42 @@
+---
+status: uninitialized
+owner: +engineering-manager
+last_review: 2026-05-17
+---
+
+# File System & Architecture
+
+> [!INFO]
+> - status: [draft/approved] | [DD.MM.YY-HH:MM]
+> - author: +engineering-manager
+> - approver: +prime
+
+---
+
+## High-Level Folder Structure
+
+```
+[Project Root]/
+├── src/
+│   ├── components/    → [Açıklama]
+│   ├── pages/         → [Açıklama]
+│   ├── utils/         → [Açıklama]
+│   └── api/           → [Açıklama]
+├── public/            → [Açıklama]
+└── [Config Files]     → (package.json, tsconfig.json vb.)
+```
+
+## Directory Rules
+
+- [**`/components/`:** Yalnızca tekrar kullanılabilir UI elemanlarını barındırır.]
+- [**`/pages/` veya `/app/`:** Sadece sayfa/route yönetimini barındırır.]
+- [**`/utils/`:** Saf (pure) yardımcı fonksiyonlar bulunur (state içermez).]
+
+## Path Aliases
+
+- [Örn: `@components/*` -> `src/components/*`]
+- [Örn: `@utils/*` -> `src/utils/*`]
+
+## Feature-Based vs Type-Based Structure
+
+- [Projenin yapısı (domain-driven, feature-sliced, vb.) hangisine uyacaksa açıklaması]

package/workspace/references/growth-strategy.md

@@ -0,0 +1,46 @@
+---
+status: uninitialized
+owner: +growth-expert
+last_review: 2026-05-17
+---
+
+# Growth & Analytic Strategy
+
+> [!INFO]
+> - status: [draft/approved] | [DD.MM.YY-HH:MM]
+> - author: +growth-expert
+> - approver: +prime
+
+---
+
+## Analytics Goals & Metrics
+
+- **Kuzey Yıldızı Metriği (North Star):** [Temel başarı ölçütü, örn: Aktif İşlem Yapan Kullanıcı]
+- **Birincil Hedefler:** [Örn: %10 dönüşüm oranı, Günlük 5K MAU]
+
+## Tracking Setup & Tools
+
+- **Analitik Araçları:** [Örn: Google Analytics 4, Mixpanel, Amplitude]
+- **Tag Yönetimi:** [Örn: Google Tag Manager (GTM)]
+- **Hata Takibi:** [Örn: Sentry, Datadog]
+
+## Key Events to Track (Event Taxonomy)
+
+[Tüm olaylar (events) aşağıdaki örnek gibi isimlendirme kurallarına (Örn: `Object_Action`) uymalıdır.]
+[- `user_signed_up`: Kullanıcı başarılı kayıt olduğunda (**Parameters:** method, tier)]
+[- `purchase_completed`: Kullanıcı ödeme yaptığında (**Parameters:** amount, currency)]
+[- `[event_name]`: [Tetiklenme durumu ve parametreleri]]
+
+## SEO & ASO Strategy
+
+- **On-Page SEO:** [H1 etiketleri, meta description kuralları, schema.org yapısı]
+- **URL Structure:** [Örn: /kategori/urun-adi (Kebab-case, SEO friendly)]
+- **Sitemap & Robots.txt:** [Oluşturulma ve endeksleme politikası]
+
+## User Acquisition & Funnel
+
+- [A/B Test planları, funnel aşamaları (Acquisition, Activation, Retention...)]
+
+## Epics & Tasks
+
+[`workspace/memory/backlog/` altındaki düz backlog yapısına eklenecek Epic ve görev listesi (ölçümleme araçlarının entegrasyonu, eventlerin eklenmesi, SEO/GEO için yapılması gerekenler vb.)]

package/workspace/references/legal-strategy.md

@@ -0,0 +1,35 @@
+---
+status: uninitialized
+owner: +compliance-expert
+last_review: 2026-05-17
+---
+
+# Legal & Compliance Strategy
+
+> [!INFO]
+> - status: [draft/approved] | [DD.MM.YY-HH:MM]
+> - author: +compliance-expert
+> - approver: +prime
+
+---
+
+## Compliance Scope
+
+[Projenin kapsamına göre uyum hedefleri (KVKK, GDPR, CCPA vb.)]
+
+## Identified Risks (Risk Analizi)
+
+- [Risk durumu - Örn: Kullanıcının konum bilgisinin açık tutulması]
+
+## Required Approvals & Consents
+
+- [Örn: Kayıt olurken Gizlilik Sözleşmesi Onayı (Zorunlu)]
+- [Çerez Yönetimi (Cookie Policy) nasıl kurgulanacak?]
+
+## Technical Integration Requests
+
+- [Örn: Veritabanındaki `password` ve `tc_no` alanları mutlaka Hash'lenmeli.]
+
+## Epics & Tasks
+
+[`workspace/memory/backlog/` altındaki düz backlog yapısına eklenecek Epic ve görev listesi]

package/workspace/references/required-skills.md

@@ -0,0 +1,11 @@
+---
+status: uninitialized
+owner: +operation-manager
+last_review: 2026-05-17
+---
+
+| **AJAN** | **AJAN** |  **AJAN** | **AJAN** |
+| :---: | :---: | :---: |:---:|
+|  [skill] | [skill] | [skill] | [skill] |
+|  [skill] | [skill] | [skill] | [skill] |
+|  [skill] | [skill] | [skill] | [skill] |

package/workspace/references/security-rules.md

@@ -0,0 +1,34 @@
+---
+status: uninitialized
+owner: +security-engineer
+last_review: 2026-05-17
+---
+
+# Security Rules
+
+> [!INFO]
+> - status: [draft/approved] | [DD.MM.YY-HH:MM]
+> - author: +security-engineer
+> - approver: +engineering-manager
+
+---
+
+## Security Overview
+
+- [Projenin kullanacağı tech stack raporu özeti ve bulguları]
+- [Dikka edilmesi gereken konular]
+
+## Vulnerability Findings
+
+| Risk Level | Finding | Description | Recommendation |
+|---|---|---|---|
+| [High/Med] | [Örn: XSS açığı] | [Hangi dosyada, nasıl oluşuyor] | [Çözüm önerisi] |
+| [Low] | [Örn: Outdated package] | [Eski kütüphane] | [Update npm package] |
+
+## Action Plan
+
+- [Bulgular doğrultusunda analiz aşamasında yapılması gerekenler]
+
+## Security Rules
+
+- [Proje genelinde uyulacak olan güvenlik kuralları]

package/workspace/references/tech-stack.md

@@ -0,0 +1,49 @@
+---
+status: uninitialized
+owner: +engineering-manager
+last_review: 2026-05-17
+---
+
+# Tech Stack & Infrastructure
+
+> [!INFO]
+> - status: [draft/approved] | [DD.MM.YY-HH:MM]
+> - author: +engineering-manager
+> - approver: +prime
+
+---
+
+## Core Technologies
+
+- **Frontend:** [Dil, Framework, Sürüm — Örn: TypeScript, React 18, Next.js 14, Kotlin, SwiftUI]
+- **Backend:** [Dil, Framework, Sürüm — Örn: Node.js 20, NestJS]
+- **Database:** [Veritabanı, Sürüm — Örn: PostgreSQL 16, Redis]
+
+## Architecture Pattern
+
+- [Örn: Mikroservis mi, Monolit mi, Serverless mı? Hangi dizayn (MVC vb) kullanılacak?]
+
+## Tooling & Prerequisites
+
+- **Package Manager:** [Örn: npm, yarn, pnpm]
+- **Environment:** [Örn: Docker Desktop, Node v20+]
+- **Testing:** [Örn: Jest, Cypress, Playwright]
+- **Tools:** [Örn: Postman, Antigravity vb.]
+- **MPC's:** [Örn: Vercel MCP, Firebase MCP]
+
+## Infrastructure & Deployment (CI/CD)
+
+- **Cloud Provider:** [Örn: AWS, Vercel, Google Cloud]
+- **CI/CD Platform:** [Örn: GitHub Actions, GitLab CI]
+- **Containerization:** [Örn: Docker]
+
+## Third-Party Services & Integrations
+
+- **Auth:** [Örn: Firebase, NextAuth, Auth0]
+- **Payments:** [Örn: Stripe, Iyzico]
+- **Storage/CDN:** [Örn: AWS S3, Cloudflare]
+
+## Security & Policies
+
+- [Hassas verilerin nasıl saklanacağı, özel gitignore kuralları vb.]
+- [Güvenlik Kuralları: `workspace/references/security-rules.md`]