📦Artifact Repository & Governance Standartları

Bu bölüm, Komtaş çalışanlarının AI araçlarıyla ürettiği artifact'lerin yönetişim standartlarını tanımlar. Artifact Repository, şirket genelinde yeniden kullanılabilir dijital çözümlerin merkezi yönetimini sağlar; Komtaş Copilot platformu aracılığıyla her artifact doğal dil sorgusuyla keşfedilebilir hale gelir.

A.1 Artifact Türleri ve Kapsam

A.2 Artifact ID ve Klasör Yapısı

Her artifact OneDrive'da aşağıdaki hiyerarşik yapıda saklanır. ID formatı: [DEP]-[YYYY]-[NNN] (departman kısaltması, yıl, 3 haneli sıra numarası — örn. FIN-2025-001, IT-2025-047).

Komtaş-AI-Artifacts/
├── Finans/
│   ├── FIN-2025-001-NakitAkisDashboard/
│   │   ├── README.md          ← Künye, metadata, Copilot'a bildirilir
│   │   ├── artifact.html      ← Ana artifact dosyası
│   │   └── CHANGELOG.md       ← Versiyon geçmişi
│   └── FIN-2025-002-.../
├── Proje-Delivery/
├── IT/
└── [Departman-Adı]/

A.3 Zorunlu Metadata (README.md Künye)

Her artifact oluşturulduğu anda bir README.md dosyasıyla ilişkilendirilmelidir. Bu dosya Komtaş Copilot'ta vektörize edilerek AI destekli arama ve keşfe açılır.

A.4 README.md Şablonu

Aşağıdaki şablon hem insan tarafından okunabilir hem de Copilot vektörizasyonuna uygundur. Artifact oluşturan her kişi bu şablonu doldurmakla yükümlüdür.

# [Artifact Adı]

## Künye / Metadata
- **artifact_id**: [DEP-YYYY-NNN]
- **name**: [Artifact Adı]
- **type**: [excel | html | pdf | script | report | prompt]
- **owner**: [Ad Soyad — kullanici@komtas.com]
- **department**: [Departman Adı]
- **target_audience**: [Hedef Kitle / Departman]
- **created_date**: YYYY-MM-DD
- **version**: 1.0.0
- **tags**: [etiket1, etiket2, etiket3]
- **ai_tools_used**: [Kullanılan AI araçları]

## Açıklama
[Bu artifact'in ne işe yaradığını 2-3 cümleyle açıklayın.
Arama motorları ve AI asistan bu alanı öncelikli okur.]

## Kullanım
[Artifact nasıl kullanılır? Adım adım açıklayın.]

## Veri Kaynakları
- **data_source_1**: [OneDrive yolu veya SharePoint URL]
- **refresh_frequency**: [Günlük | Haftalık | Manuel]
- **data_owner**: [Veriyi yöneten kişi]

## Erişim ve Paylaşım
- **access_level**: [Departman İçi | Çapraz Departman | Şirket Geneli]
- **collaboration_type**: [Solo | Team | Cross-Department]
- **onedrive_path**: [OneDrive klasör yolu]

## Değişiklik Geçmişi
| Versiyon | Tarih      | Değişiklik    | Kişi       |
|----------|------------|---------------|------------|
| 1.0.0    | YYYY-MM-DD | İlk versiyon  | [Ad Soyad] |

A.5 Erişim ve Yetki Modeli

A.6 Validation Checklist

Artifact repository'e eklenmeden önce aşağıdaki 5 zorunlu madde geçilmelidir. Kontrol artifact sahibi tarafından yapılır.

A.7 Komtaş Copilot Entegrasyonu

Her artifact'in README.md dosyası Komtaş Copilot'a bildirilerek vektörize edilir ve AI destekli doğal dil aramasına açılır.