# Ποιος κάνει τι: ροή μηνυμάτων BFF ↔ RabbitMQ ↔ microservice

Συνοδευτικό του `message-contract.md`: εκείνο λέει **τι** ταξιδεύει στο καλώδιο, αυτό λέει
**ποιος το στέλνει, ποιος το εκτελεί και πού γυρίζει η απάντηση**. Γραμμένο για το
walkthrough με δύο τερματικά. Επαληθευμένο ζωντανά στις 2026-08-06 πάνω σε
`ms.gov_ked` + `egov/rabbitmq-classes` 1.1.27.

## Το σχήμα

```
Terminal B                        RabbitMQ                     Terminal A
(ρόλος: BFF + UI)              (ουρά gov_ked)            (ρόλος: το microservice)

bff:publish  ──── request ──────────►  │  ──────────────────►  rabbitmq:read
"submit_beveosi|afm=137..."            │                        ↓
                                       │                  RabbitMQMessageInterpreter
                                       │                        ↓
                                       │                  SubmitBeveosiCommand->execute()
                                       │                        ↓
   εκτυπώνει το JSON  ◄──── reply ─────┤  ◄──────────────  json_encode(RabbitMQResponse)
   (reply_to queue)                    │                   δημοσίευση στο reply_to
```

**Terminal B — ο πελάτης.** Παίζει τον ρόλο που στην παραγωγή έχει το BFF του Δημοκρίτου
(και πίσω του το React UI). Στέλνει το request και **περιμένει την απάντηση**. Το JSON που
τυπώνεται στο B **είναι η απάντηση** — έφτασε πίσω σε αυτό, όχι στο A.

**Terminal A — το microservice.** Ο worker: ακούει την ουρά, εκτελεί, απαντά. Ο λόγος που
βλέπουμε και εκεί το JSON είναι απλώς logging (`GOV_KED_RABBITMQ_BASH_LOG=FULL`) — το
`echo " [x] Response: "` του δικού τους job. Με `BASIC` το A λέει μόνο «Processed…» και η
απάντηση συνεχίζει να φτάνει κανονικά στο B.

**Στη μέση ο RabbitMQ**, με **δύο** ουρές, όχι μία:

| Ουρά | Ποιος τη φτιάχνει | Διάρκεια ζωής |
|---|---|---|
| `gov_ked` | ο worker (non-durable declare) | μόνιμη όσο ζει ο broker |
| ανώνυμη ουρά απαντήσεων | ο πελάτης, μία ανά κλήση | exclusive, auto-delete |

Το όνομα της δεύτερης ταξιδεύει στο property `reply_to` του μηνύματος. Ο worker απαντά εκεί
και αντιγράφει το `correlation_id`, ώστε ο πελάτης να ξέρει ποια απάντηση αντιστοιχεί σε
ποιο αίτημα. Κλασικό **RPC over AMQP**: ασύγχρονη υποδομή, σύγχρονη εμπειρία για τον χρήστη.

## Business flow

1. Ο χρήστης πατά «Βεβαίωση οφειλής» στο UI.
2. Το BFF μαζεύει τα πεδία, τα κωδικοποιεί ως `submit_beveosi|afm=…&kae=…` και τα ρίχνει
   στην ουρά `gov_ked`. Δεν ξέρει τίποτα για ΚΕΔ ή SOAP — αυτό είναι όλο το νόημα του
   διαχωρισμού.
3. Το microservice παραλαμβάνει, **κάνει το validation** (ΑΦΜ 9ψήφιο string, ποσό δεκαδικό
   string με 2 δεκαδικά, ≤9 συνυπόχρεοι κ.λπ.) και —από το M2— καλεί το ΚΕΔ.
4. Επιστρέφει `RabbitMQResponse`: `status` 1 = πέρασε, 3 = σφάλμα, με τα πεδία που έφταιξαν
   στο `extraData.fields` ώστε το UI να τα δείξει δίπλα στα inputs.
5. Το BFF ξεμπλοκάρει, το UI δείχνει το αποτέλεσμα.

**Διευκρίνιση για να μην υπάρξει παρεξήγηση:** το `bff:publish` είναι **δικό μας εργαλείο
ανάπτυξης**, δεν είναι το BFF τους — μιμείται τον `RpcClient` τους. Ο worker στο terminal A
όμως είναι **εξ ολοκλήρου δικός τους κώδικας**.

## Πώς αποδεικνύεται ότι τρέχει η δική τους βιβλιοθήκη

Όλα από το root του repo.

**1. Η εντολή του worker δεν υπάρχει στον κώδικά μας.**

```bash
grep -rn "rabbitmq:read" app/ config/ || echo "ΔΕΝ υπάρχει στο app/ μας"
grep -rn "rabbitmq:read" vendor/egov/rabbitmq-classes/src/
./vendor/bin/sail artisan list | grep rabbitmq
```

Βρίσκεται μόνο στο `vendor/egov/rabbitmq-classes/src/Console/Commands/RabbitMQCommand.php`
και καταχωρείται από το auto-discovered `RabbitmqServiceProvider` τους.

**2. Τα μηνύματα του terminal A είναι literal strings του δικού τους αρχείου.**

```bash
grep -n "Awaiting RPC requests\|Accepted Message with parameter" \
  vendor/egov/rabbitmq-classes/src/Jobs/RabbitMQJob.php
```

Ό,τι βλέπουμε στην οθόνη τυπώνεται από τη γραμμή που μόλις βρέθηκε.

**3. Η απάντηση παράγεται από τη δική τους κλάση.**

```bash
grep -n "^use Egov" app/Commands/Kede/SubmitBeveosiCommand.php
grep -n "case OK\|case ERROR" \
  vendor/egov/rabbitmq-classes/src/RabbitMQ/Enumerations/RabbitMQResponseStatus.php
```

Το `"status": 1` και η σειρά κλειδιών `data, pagination, extraData, …` δεν είναι δική μας
επιλογή: είναι η σειρά δήλωσης των public properties στο `RabbitMQResponse.php` τους. Το
παλιό μας mirror έβγαζε `"status": "OK"` και άλλη σειρά — η αλλαγή στην έξοδο **είναι** η
απόδειξη.

**4. Η πιο πειστική: βγάλ' το από τη μέση και σπάει.**

```bash
mv vendor/egov vendor/egov.off
./vendor/bin/sail artisan rabbitmq:read      # → Command "rabbitmq:read" is not defined.
mv vendor/egov.off vendor/egov
```

**5. Χωρίς broker, μέσα από τον interpreter τους.**

```bash
./vendor/bin/sail test --filter=InterpreterIntegrationTest
```

Το `tests/Feature/InterpreterIntegrationTest.php` δίνει τα raw bytes στο
`Egov\RabbitmqClasses\RabbitMQ\RabbitMQMessageInterpreter` και ελέγχει τι γυρίζει. Αποδεικνύει
και το ζητούμενο για το `bff:publish`: **το format που στέλνουμε το διαβάζει ο δικός τους
parser**. Αν το είχαμε λάθος, το test θα έσκαγε — δεν υπάρχει δικός μας κώδικας
αποκωδικοποίησης πουθενά στη διαδρομή.

## Τα δύο τερματικά, βήμα βήμα

Terminal A:

```bash
cd <repo root>
./vendor/bin/sail up -d
./vendor/bin/sail artisan rabbitmq:read        # « [x] Awaiting RPC requests »
```

Terminal B:

```bash
cd <repo root>
./vendor/bin/sail artisan bff:publish ping
./vendor/bin/sail artisan bff:publish submit_beveosi --params=@tests/fixtures/beveosi.json
```

Ο worker σταματά με Ctrl-C, ή από άλλο shell **μέσα από το container**:

```bash
docker compose exec laravel.test pkill -f rabbitmq:read
```

Για τα σενάρια αποτυχίας (λάθος ΑΦΜ, ποσό ως αριθμός, άγνωστο command) βλ.
`message-contract.md`.
