# Τοπικό τρέξιμο — gov_ked (module: beveosi_ofeilwn)

Το `beveosi_ofeilwn` (βεβαίωση οφειλών τρίτων προς ΑΑΔΕ/ΚΕΔ) ζει μέσα σε αυτό το
microservice ως module: domain code στο `app/Ked/`, commands στο `app/Commands/Kede/`.
Ο consumer και το wire format έρχονται αυτούσια από το `egov/rabbitmq-classes`.

## Προαπαιτούμενα

Docker + Docker Compose. **Δεν χρειάζεται τοπική PHP/Composer** — όλα μέσα σε container.

## Οι εντολές

Όλες οι εντολές — πρώτη εγκατάσταση, `sail up`, ο worker, το `bff:publish`, το frontend, ο
scheduler, τα tests — βρίσκονται συγκεντρωμένες στο **`docs/runbook.md`**. Δεν
επαναλαμβάνονται εδώ, ώστε να μην αποκλίνουν.

Το RabbitMQ management UI: <http://localhost:15672> (guest/guest).

Αυτό το αρχείο κρατά μόνο ό,τι αφορά το **wire format** και τις παγίδες του.

## Το wire format

Το `bff:publish` μιμείται τον `RpcClient` του BFF. Το body **δεν είναι JSON**:

```
submit_beveosi|afm=137569280&kae=82838&amount=150.00&synypochreoi%5B0%5D%5Bafm%5D=...
```

Το `|` υπάρχει πάντα, ακόμα και χωρίς params (`ping|`) — χωρίς αυτό ο interpreter σκάει.
Η απάντηση είναι `json_encode` ενός `RabbitMQResponse`:

```json
{"data": ..., "pagination": [], "extraData": [], "errors": [], "warnings": [],
 "messages": [], "status": 1, "type": "single"}
```

`status`: 1=OK, 2=WARNING, 3=ERROR, 4=BUSINESS_ERROR. `type`: `single|list|lookup`.

## Σημειώσεις

- Το `submit_beveosi` καλεί **πραγματικά** το ΚΕΔ (Milestone 2). Με `KED_DRIVER=fake` — το
  default — παίζει καταγεγραμμένες απαντήσεις του πιλότου χωρίς δίκτυο· με `KED_DRIVER=soap`
  μιλά στην ΑΑΔΕ.
- Ποσά/ΑΦΜ/ΚΑΕ/ΔΟΥ είναι **strings** — τα αρχικά μηδενικά μετράνε, τα ποσά δεν γίνονται
  ποτέ float. Το `atbNo` φτάνει τα 20 ψηφία.
- Η ουρά δηλώνεται **non-durable** (έτσι την δηλώνει ο consumer τους). Αν υπάρχει ήδη
  durable ουρά `gov_ked` στον broker, σβήστε την από το management UI.
- Ο worker σταματά με `docker exec <container> pkill -f rabbitmq:read` — όχι με Ctrl-C στον
  host. Γιατί: `docs/runbook.md` §2.
