# Διασύνδεση ΕΚΕΦΕ Δημόκριτου με ΚΕΔ
### Εκτίμηση ανάπτυξης — internal

---

## 1. Πλαίσιο

Το ΦΕΚ 1911/Β΄/2019 υποχρεώνει τους φορείς να βεβαιώνουν έσοδα ηλεκτρονικά μέσω των web services του ΚΕΔ. Ο Δημόκριτος σήμερα το κάνει με excel + φυσική αποστολή στη ΔΟΥ.

**Στόχος**: ηλεκτρονικό σύστημα που αντικαθιστά το excel και επικοινωνεί με το ΚΕΔ.

**Επίσημο spec**: SOAP web service `kedeProgressService` v1.01, με WS-Security, TLS 1.2. Test endpoint: `test.gsis.gr/esbpilot`, prod: `ked.gsis.gr/esb`.

---

## 2. Τι αφορά (context)

Το σύστημα αφορά **οφειλές τρίτων προς τον Δημόκριτο** — τις οποίες ο Δημόκριτος βεβαιώνει στη ΔΟΥ για να τις εισπράξει το Δημόσιο για λογαριασμό του.

```
Οφειλέτης (πολίτης/εταιρεία) ──χρωστάει──→ Δημόκριτος
                                                │
                                  ΚΕΔ ←─ βεβαίωση
                                   │
                                   ▼
                                  ΔΟΥ (εκδίδει ΑΤΒ, εισπράττει)
```

**Παραδείγματα οφειλών**: αχρεωστήτως καταβληθέντα (μισθοδοσία, επιδοτήσεις, υποτροφίες), πρόστιμα προμηθευτών, οφειλές από συμβάσεις.

**Τι ΔΕΝ είναι**: πληρωμές του Δημόκριτου προς τρίτους, οφειλές του Δημόκριτου σε άλλους φορείς, εσωτερικό λογιστικό σύστημα.

---

## 3. Τι κάνει το σύστημα

Ο υπάλληλος εισάγει στο UI **μία βεβαίωση ανά οφειλέτη**:
- Ποιος (ΑΦΜ, τυχόν συνυπόχρεοι)
- Πόσο και πώς (συνολικό ποσό, δόσεις, εκπτώσεις)
- Γιατί (ΚΑΕ, αρ. απόφασης, σχόλια, προαιρετικό PDF απόφασης)
- Ποιος υπογράφει

Το σύστημα στέλνει στο ΚΕΔ, παίρνει πίσω ΑΤΒ και Ταυτότητες Οφειλής, και παράγει την Περιληπτική Κατάσταση σε PDF για εσωτερική αρχειοθέτηση.

---

## 4. Ροή με τα web services

```
1. retrieveNames  →  μία φορά, αποστολή λίστας υπογραφόντων στο ΚΕΔ
                     (επανάληψη μόνο σε αλλαγές)

2. retrieveKedeAmount  →  μία κλήση ανά οφειλέτη/γραμμή
                          επιστρέφει αριθμό Χρηματικού Καταλόγου + γραμμή

3. retrieveCloseDay  →  μετά την ολοκλήρωση του ΧΚ
                        επιστρέφει ΑΤΒ + Ταυτότητες Οφειλής

4. PDF Περιληπτικής με ΑΤΒ  →  για αρχειοθέτηση

Phase 2 (παρακολούθηση):
   retrieveVerificationProgress  → επιβεβαίωση βεβαίωσης
   retrievePayProgress           → πορεία είσπραξης
   retrievePaymentData           → πληρωμές σε χρονική περίοδο
```

**Σημαντικό**: κάθε αποστολή πρέπει να «κλειδώνει» τοπικά για να μην σταλεί διπλή και να δημιουργηθεί διπλό χρέος. Είναι ρητός κανόνας του ΚΕΔ.

---

## 5. Scope

**Phase 1 — MVP**
Αντικατάσταση excel, αποστολή βεβαιώσεων, λήψη ΑΤΒ, PDF περιληπτικής, διαχείριση υπογραφόντων, locking/anti-duplicate.

**Phase 2 — Παρακολούθηση**
Πορεία βεβαίωσης, εισπράξεις, reports για λογιστήριο.

**Phase 3 — Διαγραφές**
Χρειάζεται ξεχωριστό web service spec (δεν περιλαμβάνεται στο τρέχον). Out of scope μέχρι να ληφθεί.

---

## 6. Engineering effort (Phase 1 MVP)

Effort σε man-days, βασισμένο στο επίσημο spec v1.01:

| Ενότητα | Man-days |
|---|---|
| UI (φόρμα, δόσεις, συνυπόχρεοι, υπογράφοντες) | 18–28 |
| Backend & DB (locking, reconciliation, audit) | 12–18 |
| Integration ΚΕΔ (SOAP, WS-Security, retries) | 14–22 |
| PDF Περιληπτικής | 3–5 |
| Testing & UAT (με sandbox ΚΕΔ) | 12–18 |
| Deployment & docs | 2–4 |
| PM overhead (~15%) | 10–14 |
| **Σύνολο raw effort** | **~71–109 md** |

Με agentic coding gain ~30% (ενσωματωμένο στο timeline): effective ~50–76 md.

---

## 7. Team & timeline

**Ομάδα**:
- 1 Senior Backend developer — 100%
- 1 Mid Frontend developer — 100% τις πρώτες εβδομάδες, ~50% τις τελευταίες
- 1 Product Owner — 30%
- Designer: δεν υπολογίζεται ξεχωριστά — AI mockups + dev (έχει γίνει PoC και φαίνεται οκ)

**Διάρκεια**:
- 6-8 εβδομάδες για production MVP (με ρίσκο)
- 8-10 εβδομάδες με ασφαλέστερο buffer

**Calendar breakdown (8 εβδ. σενάριο)**:
- Εβδ. 1: Discovery, design, setup
- Εβδ. 2-3: UI scaffolding + ΚΕΔ client (happy path)
- Εβδ. 4-5: Δόσεις, συνυπόχρεοι, locking logic, PDF generation
- Εβδ. 6: Integration testing με sandbox ΚΕΔ
- Εβδ. 7: UAT με Δημόκριτο, bug fixing
- Εβδ. 8: Deployment, documentation, hand-over

---

## 8. Pricing

*Σε αναμονή guidance από CTO. Ερωτήματα προς συζήτηση:*

- Loading factor στα gross salaries
- Standard markup της Logicea
- Διαφοροποίηση για δημόσιο φορέα/government project
- Fixed price vs Time & Materials
- Strategic value: pricing στο κόστος για να κερδίσουμε referenceable government client, ή standard markup;

---

## 9. Παραδοχές

1. Manual entry (όχι integration με υπάρχον σύστημα Δημόκριτου)
2. Scanned υπογραφή σε PDF (όχι qualified electronic)
3. Άμεση επικοινωνία με ΚΕΔ (όχι μέσω hub)
4. Πιστοποίηση φορέα στην ΑΑΔΕ: εκτός effort, blocker για go-live
5. Phase 3 (διαγραφές) απαιτεί ξεχωριστό spec — δεν εκτιμάται τώρα
6. Stack agnostic — εκτίμηση δεν εξαρτάται από τεχνολογικές επιλογές
7. Agentic coding gain ~30% συμπεριλαμβάνεται στο timeline
8. AI-driven design αντί ξεχωριστού designer

---

## 10. Risks

| Risk | Impact | Mitigation |
|---|---|---|
| Καθυστέρηση πιστοποίησης ΑΑΔΕ | Delay go-live (όχι development) | Παράλληλη εκκίνηση εβδ. 1 |
| Scope creep από Δημόκριτο (π.χ. ERP integration) | +20-40% effort | Σαφές scope statement, change requests |
| Sandbox ΚΕΔ unstable/incomplete | +1-2 εβδομάδες | Early integration testing |
| Documentation ΚΕΔ ασαφές σε edge cases | +10-15% integration effort | Άμεση επικοινωνία με ΚΕΔ helpdesk |
| Δημόκριτος αργεί στο UAT | Delay closure | Time-boxed UAT, hard cutoff |

---

## 11. Ερωτήματα προς Δημόκριτο (αν χρειάζεται)

1. Έχει πάρει από ΑΑΔΕ τα: extOrg, credentials, επιτρεπτούς ΚΑΕ, txtCode;
2. Όγκος: πόσες βεβαιώσεις/μήνα;
3. Ποιες κατηγορίες οφειλών συμπληρώνονται σήμερα; (αχρεωστήτως, πρόστιμα, άλλα;)
4. Δόσεις ή εφάπαξ; Αν δόσεις, ποια περιοδικότητα;
5. Συνυπόχρεοι (κληρονόμοι/εγγυητές) — πόσο συχνά;
6. Επισυναπτόμενο PDF απόφασης — από πού έρχεται;
7. Πηγή δεδομένων: manual ή από υπάρχον σύστημα;
8. Timeline / deadline;

---

## 12. Next steps

1. Συζήτηση για pricing strategy
2. Mockup/prototype για validation με Δημόκριτο
3. Discovery call με Δημόκριτο για απαντήσεις στα ερωτήματα §11 - αν χρειάζεται
4. Formal proposal

---

*Internal document — δεν προορίζεται για αποστολή σε πελάτη.*
