Koza Proje Zekâsı – Entegrasyon Gereksinimleri

1) Amaç

Koza Proje Zekâsı; proje gecikmeleri, kaynak çakışmaları, bütçe sapmaları, kritik yol riskleri ve
kapsam kaymalarını erken tespit eder. Proje portföyü genelinde görünürlük ve öngörü sağlar.

2) Veri Kaynakları

ERP Proje Modülü: Proje kartları, bütçe, maliyet, faturalama
PPM/PMO Araçları: Görevler, sprintler, backlog, ilerleme yüzdeleri
İK/Zaman Takip (varsa): Kaynak atamaları, timesheet
Finans: Proje maliyet merkezleri, gerçekleşen giderler

3) Zorunlu Veri Setleri

3.1) Projects (Proje Kartları)

Alan	Açıklama	Zorunlu
ProjectCode	Proje kodu	Evet
ProjectName	Proje adı	Evet
StartDate	Başlangıç tarihi	Evet
EndDate	Planlanan bitiş	Hayır
Status	Planned/Active/OnHold/Completed	Evet
ProjectManager	PM kullanıcı kodu	Hayır
CustomerCode	Müşteri (varsa)	Hayır
UpdatedAt	Son güncelleme	Hayır

3.2) Tasks (Görevler / Work Packages)

Alan	Açıklama	Zorunlu
TaskId	Görev kimliği	Evet
ProjectCode	Bağlı proje	Evet
TaskName	Görev adı	Evet
ParentTaskId	Üst görev (WBS)	Hayır
StartDate	Başlangıç	Hayır
EndDate	Bitiş	Hayır
PlannedEffortHours	Planlanan efor (saat)	Hayır
Status	Open/InProgress/Done/Blocked	Evet
ProgressPercent	% ilerleme	Hayır

3.3) TaskDependencies (Bağımlılıklar / Kritik Yol)

Alan	Açıklama	Zorunlu
TaskId	Görev	Evet
DependsOnTaskId	Bağımlı olduğu görev	Evet
DependencyType	FS/SS/FF/SF	Hayır

3.4) ResourceAssignments (Kaynak Atamaları)

Alan	Açıklama	Zorunlu
AssignmentId	Atama kimliği	Evet
TaskId	Görev	Evet
ResourceId	Kullanıcı/personel	Evet
Role	Rol	Hayır
AllocatedHours	Atanan saat	Hayır
StartDate	Başlangıç	Hayır
EndDate	Bitiş	Hayır

3.5) Timesheets (Zaman Kayıtları)

Alan	Açıklama	Zorunlu
TimesheetId	Kayıt kimliği	Evet
ResourceId	Kullanıcı	Evet
TaskId	Görev	Evet
WorkDate	Tarih	Evet
Hours	Çalışılan saat	Evet
Approved	Onaylı mı?	Hayır

3.6) ProjectBudgets (Bütçe & Maliyet)

Alan	Açıklama	Zorunlu
ProjectCode	Proje	Evet
BudgetAmount	Toplam bütçe	Hayır
Currency	Para birimi	Hayır
ActualCost	Gerçekleşen maliyet	Hayır
CostUpdatedAt	Son güncelleme	Hayır

4) Opsiyonel Veri Setleri

Milestones: Kilometre taşları
Risks & Issues: Risk/issue kayıtları
ChangeRequests: Kapsam değişiklikleri
Invoices: Proje bazlı faturalama (finans modülünden)
Documents: Proje doküman metadatası (DMS entegrasyonu)

5) Entegrasyon Yöntemi

ERP/PPM API: Projects, Tasks, Budgets, Assignments
PM Tool API: Jira/Asana/MS Project Online vb. (Tasks, Sprints)
Event/MQ: task.updated, timesheet.submitted, budget.updated
Scheduled Export: Günlük özetler ve geçmiş analiz

6) Üretilen KPI & Analizler

Schedule Variance (SV): Planlanan vs gerçekleşen süre
Cost Variance (CV): Bütçe vs gerçekleşen maliyet
Resource Utilization: Kaynak doluluk/çakışma analizi
Critical Path Risk: Kritik yol gecikme riski
Burn-down/Burn-up: Sprint/proje ilerleme eğrileri
Risk Heatmap: Risk yoğunluğu

7) Performans & Format Beklentileri

ProjectCode ve TaskId benzersiz ve tutarlı olmalı
ProgressPercent 0–100 aralığında olmalı
Bağımlılıklar (Dependencies) çift yönlü tutarlılık göstermeli
Timesheet tarihleri ISO 8601 ve timezone içermeli

8) Hazırlık Kontrol Listesi

Proje kartları ve görev yapısı erişilebilir
Görev bağımlılıkları (kritik yol) alınabiliyor
Kaynak atamaları ve zaman kayıtları mevcut
Bütçe ve gerçekleşen maliyet verileri bağlı
Read-only kullanıcı ve ağ izinleri hazır

9) Örnek Endpoint/Topic Seti


# ERP / PPM
/api/projects
/api/projects/tasks
/api/projects/dependencies
/api/projects/resource-assignments
/api/projects/timesheets
/api/projects/budgets

# PM Tool
/api/pm/tasks
/api/pm/sprints

# Event Topics
topic.pm.task.updated
topic.pm.timesheet.submitted
topic.pm.budget.updated
topic.pm.project.statusChanged

Yetkilendirme önerisi: OAuth2 / API Key / IP Whitelist + SSL/TLS