# Βήμα 2+3: Τρέξιμο ms.gov_ked + porting του M1 ως module beveosi_ofeilwn

> **Status: ΕΚΤΕΛΕΣΤΗΚΕ (2026-08-06).** Ιστορικό. Το port έγινε, 13 tests πράσινα, ζωντανό
> smoke πέρασε. Δύο αποκλίσεις από το γραμμένο: το composer install χρειάστηκε mount των
> `/etc/passwd`+`/etc/group` και `--ignore-platform-req=ext-sockets`, και το `bff:publish`
> δήλωνε την ουρά durable ενώ ο consumer τους την θέλει non-durable. Και τα δύο διορθωμένα.
>
> **Status: ΕΓΚΕΚΡΙΜΕΝΟ, προς εκτέλεση** (2026-08-06). Αυτοτελές — γράφτηκε ώστε να
> εκτελεστεί από οποιοδήποτε μοντέλο/συνεδρία χωρίς το context της συνεδρίας που το
> συνέταξε. Προαπαιτούμενο διάβασμα: `docs/internal/egov-rabbitmq-classes-notes.md`.
> Κανόνες: όλα τοπικά σε branch, κανένα push στο GitLab Δημοκρίτου, κανένα commit από
> Claude (πρόταση commit message, χωρίς διπλά εισαγωγικά, σε κάθε checkpoint).

## Context

Ο Δημόκριτος παρέδωσε το skeleton `../ms.gov_ked/` (Laravel 10 / PHP 8.1, pinned
`egov/rabbitmq-classes` 1.1.27, ΚΑΝΕΝΑ domain code). Η SSH πρόσβαση στο GitLab τους
δουλεύει (δοκιμασμένη με `git ls-remote`, port 222) και το package αναλύθηκε πλήρως —
βλ. `ms.beveosiofeilon/docs/internal/egov-rabbitmq-classes-notes.md` (ΔΙΑΒΑΣΕ ΤΟ ΠΡΩΤΑ
αν εκτελείς χωρίς το context αυτής της συνεδρίας). Στόχος: (Βήμα 2) το gov_ked να
τρέχει τοπικά με Sail και να απαντά ping μέσω της δικής τους βιβλιοθήκης· (Βήμα 3) το
M1 domain code του ms.beveosiofeilon να μεταφερθεί μέσα του. Αύριο 10:00 hands-on με
CTO — θέλουμε ζωντανό demo: `make worker` + `make publish CMD=submit_beveosi` στο
πραγματικό wire format.

**Όλα τοπικά, σε branch, ΚΑΝΕΝΑ push στο GitLab του Δημοκρίτου, ΚΑΝΕΝΑ commit από
Claude** (ισχύει και στο gov_ked ό,τι λέει το CLAUDE.md του beveosiofeilon: προτείνουμε
commit messages χωρίς διπλά εισαγωγικά, ο χρήστης κάνει commit). Το ms.beveosiofeilon
ΔΕΝ αγγίζεται (μένει άθικτο, δίχτυ ασφαλείας).

## Δεδομένα-κλειδιά (από την ανάλυση — μην τα ξανα-ανακαλύψεις)

- Wire format request: `command_name|http_build_query($params, '', null, PHP_QUERY_RFC3986)`.
  ΠΑΝΤΑ με το `|`, ακόμα και χωρίς params (σκέτο `ping` σκάει στο interpreter τους).
- Reply: το `ICommand::execute(array $params)` επιστρέφει **string** =
  `json_encode($rabbitMQResponse)` (πρότυπο: το PingCommand του skeleton τους).
- Enums τους: `RabbitMQResponseStatus` int (OK=1, WARNING=2, ERROR=3, BUSINESS_ERROR=4),
  `RabbitMQResultType` string ('single','list','lookup').
- Ο consumer τους: `artisan rabbitmq:read` (με `QUEUE_CONNECTION=sync` τρέχει inline)·
  διαβάζει `config('microservices.gov_ked.*')` (host/port/user/password/vhost/queue) και
  `config('app.ms_name')` (skeleton: ήδη `'gov_ked'`). Queue declare **non-durable**.
- Dispatch: `config('rabbit_commands.commands.{cmd}.commandClass')` → `new` → `execute()`.
  Τα `api_commands` είναι για REST proxy — ΔΕΝ μας αφορούν, όλα τα δικά μας πάνε στα
  `commands`.
- Πεδίο `token` ΔΕΝ υπάρχει στο envelope τους.
- Skeleton `.env.example` είναι stock Laravel — ΛΕΙΠΟΥΝ τα `GOV_KED_*`/`RABBITMQ_*`.

## ΒΗΜΑ 2 — Να τρέξει το gov_ked (όλα μέσα στο /home/epapa/projects/dimikritos-ked/ms.gov_ked)

### 2.1 Branch
`git checkout -b feature/beveosi-ofeilwn-module` (από το τωρινό main `46ea3d4`). Κανένα
commit από Claude· πρόταση commit message σε κάθε φυσικό checkpoint.

### 2.2 composer install μέσω SSH (χωρίς τοπικό PHP — throwaway container)
Το composer.json τους δείχνει το package με **https** URL· το rewrite σε SSH γίνεται
με git config ΜΕΣΑ στο container (όχι μόνιμη αλλαγή στο repo):

```bash
docker run --rm -u "$(id -u):$(id -g)" -e COMPOSER_HOME=/tmp \
  -v "$HOME/.ssh":/tmp/.ssh:ro -e HOME=/tmp \
  -v "$PWD":/app -w /app composer:2 sh -c '
    export GIT_SSH_COMMAND="ssh -i /tmp/.ssh/id_ed25519 -o UserKnownHostsFile=/tmp/.ssh/known_hosts -o StrictHostKeyChecking=accept-new" &&
    git config --global url."ssh://git@gitlab.skel.iit.demokritos.gr:222/".insteadOf "https://gitlab.skel.iit.demokritos.gr/" &&
    composer install --no-interaction'
```

Προσαρμογές επί τόπου: το όνομα του key (`ls ~/.ssh` — μπορεί να είναι id_rsa)· αν το
key έχει passphrase, mount το `$SSH_AUTH_SOCK` αντί για το ~/.ssh. Αν βγει platform
error (το composer:2 image τρέχει νεότερη PHP), πρόσθεσε `--ignore-platform-req=php`
(ΟΧΙ αλλαγή στο composer.json τους). Το lock είναι ήδη resolved — install, όχι update.

### 2.3 compose.yaml + .env
- Αντιγραφή του `ms.beveosiofeilon/compose.yaml` → `ms.gov_ked/compose.yaml` με
  αλλαγές: υπηρεσία DB από `mysql:8.4` σε **`mariadb:10.6`** (παραγωγή = MariaDB
  10.6.11), init script `./vendor/laravel/sail/database/mariadb/create-testing-database.sh`,
  healthcheck `["CMD","healthcheck.sh","--connect","--innodb_initialized"]`, volume
  `sail-mariadb` (όχι sail-mysql), `MYSQL_*` env keys μένουν (η mariadb τα δέχεται).
  Runtime μένει `./vendor/laravel/sail/runtimes/8.1` / image `sail-8.1/app` (υπάρχει
  μετά το 2.2 — sail είναι στα require-dev τους).
- `.env` (ΤΟΠΙΚΟ, gitignored — δεν μπαίνει στο repo): από το .env.example τους +
  προσθήκες: `APP_KEY` (θα γεννηθεί), `MS_NAME=gov_ked`, `DB_HOST=mysql`,
  `DB_DATABASE=egov_ms_gov_ked`, `DB_USERNAME=sail`, `DB_PASSWORD=password`,
  `QUEUE_CONNECTION=sync` (ήδη), `RABBITMQ_HOST=rabbitmq`, `RABBITMQ_PORT=5672`,
  `RABBITMQ_USER=guest`, `RABBITMQ_PASSWORD=guest`,
  `GOV_KED_RABBITMQ_QUEUE_NAME=gov_ked`, `GOV_KED_RABBITMQ_ROUTING_KEY=gov_ked`,
  `GOV_KED_RABBITMQ_BASH_LOG=FULL`. (vhost: default `/` από τον κώδικά τους.)
- Ενημέρωση και του `.env.example` τους με τα ίδια κλειδιά ΚΕΝΑ/πλην defaults
  (θα προταθεί ως βελτίωση προς Δημόκριτο — μένει στο branch).
- ΠΡΟΣΟΧΗ σύγκρουση θυρών: το beveosiofeilon μπορεί να τρέχει με ίδιες θύρες
  (80/3306/5672/15672). Πριν το `sail up`: `docker ps` και αν χρειάζεται
  `cd ms.beveosiofeilon && ./vendor/bin/sail down` (χωρίς -v — να μη χαθούν δεδομένα).

### 2.4 Εκκίνηση + smoke
```bash
./vendor/bin/sail up -d          # πρώτη φορά: build του 8.1 image (~λεπτά)
./vendor/bin/sail artisan key:generate
./vendor/bin/sail artisan migrate
./vendor/bin/sail php -m | grep -i soap    # πρέπει να υπάρχει (χρειάζεται στο βήμα 3)
./vendor/bin/sail artisan rabbitmq:read    # terminal A: "Awaiting RPC requests"
```
Smoke του ping ΧΩΡΙΣ δικό μας publisher ακόμα (δεν έχει μεταφερθεί): μικρό tinker
one-liner ή rabbitmqadmin — απλούστερο: `sail artisan tinker` και publish με
php-amqplib χειροκίνητα, message body **`ping|`**, properties reply_to = προσωρινό
queue. (Εναλλακτικά: προχώρα στο 3.1 να έρθει το bff:publish και smoke μετά — αποδεκτό.)
**Checkpoint commit πρόταση**: `Run skeleton locally: compose file, env example keys, no code changes`

## ΒΗΜΑ 3 — Porting του M1

Πηγή πάντα: `/home/epapa/projects/dimikritos-ked/ms.beveosiofeilon`. Αντιγραφή αρχείων
(cp), μετά επεξεργασία στο gov_ked. ΔΕΝ μεταφέρονται: `app/Messaging/*` (όλο),
`app/Console/Commands/RabbitConsumeCommand.php`, `app/Commands/CommandDispatcher.php`,
`app/Commands/ICommand.php` (υπάρχει δικό τους), tests των ανωτέρω
(JsonMessageCodecTest, RabbitMQResponseTest, CommandDispatchTest).

### 3.1 Dev εργαλείο: bff:publish (πρώτο, για smoke testing όλων των υπολοίπων)
Αντιγραφή `app/Console/Commands/BffPublishCommand.php` → ίδια θέση στο gov_ked, με
αλλαγές: (α) body = `$cmd . '|' . http_build_query($params, '', null, PHP_QUERY_RFC3986)`
(πάντα το `|`), (β) config key `microservices.gov_ked.*`, (γ) `correlation_id = uniqid()`
για συμβατότητα με τον RpcClient τους (το δικό μας UUID δουλεύει επίσης — κράτα ό,τι
είναι απλούστερο), (δ) `--params=` δέχεται JSON/@file όπως πριν και το μετατρέπει σε
array πριν το http_build_query. Register στο `app/Console/Kernel.php` αν χρειάζεται
(Laravel 10 auto-discovers στο app/Console/Commands).
Smoke: `rabbitmq:read` (A) + `bff:publish ping` (B) → JSON με `"status":1`.

### 3.2 Domain: app/Ked/ αυτούσιο
`cp -r app/Ked` (WsseSoapClient, AuditRecordFactory, Progress/KedeProgressClient,
Delete/KedeDeleteClient) — καμία αλλαγή κώδικα (δεν αγγίζουν το messaging layer).
Μαζί: `config/ked.php` αυτούσιο + τα `KED_*` κλειδιά στο .env.example (κενά) και στο
τοπικό .env.

### 3.3 Commands
- `app/Commands/Kede/SubmitBeveosiCommand.php` → gov_ked, με προσαρμογές:
  - `use Egov\RabbitmqClasses\RabbitMQ\RabbitMQResponse;` + Enumerations αντί για
    `App\Messaging\*`· implements το ΔΙΚΟ ΤΟΥΣ `App\Commands\ICommand`.
  - Κάθε return γίνεται `return json_encode($response);` (και στο validation-error path).
  - `RabbitMQResultType::SINGLE_ITEM` υπάρχει και στους δύο — τιμή πλέον 'single'
    αυτόματα. Status: `RabbitMQResponseStatus::OK/ERROR` ίδια ονόματα, τιμές int.
  - ΠΡΟΣΟΧΗ: το validation μένει ΑΚΡΙΒΩΣ ίδιο (afm 9ψήφιο string, amount decimal
    string regex, synypochreoi ≤9 κ.λπ.). Τα params από parse_str έρχονται strings —
    συμβατά. Το `installments` (integer rule) θα έρθει string από το query — άλλαξε
    τον κανόνα σε `['required','integer',...]` → Laravel δέχεται numeric string· ΟΚ ως έχει.
  - Το δικό μας PingCommand ΔΕΝ μεταφέρεται — υπάρχει δικό τους.
- Register στο `config/rabbit_commands.php` τους:
  `'submit_beveosi' => ['commandClass' => \App\Commands\Kede\SubmitBeveosiCommand::class]`
  κάτω από `commands` (τα `api_commands` μένουν άδεια).

### 3.4 Migrations + φάκελος tests
- `cp database/migrations/2026_08_04_00000{1,2}_*.php` (beveosi_certifications,
  ked_call_log) → gov_ked, `sail artisan migrate`.
- Tests που μεταφέρονται: `WsseSoapClientTest` (αυτούσιο),
  `SubmitBeveosiCommandTest` (προσαρμογή: το execute επιστρέφει string →
  `json_decode($result, true)` πριν τα asserts· `status` πλέον 1/3, `type` 'single')
  + `tests/fixtures/beveosi.json` αυτούσιο. Νέο μικρό test:
  `PingViaTheirLibraryTest` — ότι `(new RabbitMQMessageInterpreter('ping|'))->process()`
  γυρνά JSON με status 1 (ελέγχει την ενσωμάτωση με τη βιβλιοθήκη τους end-to-end
  χωρίς broker). phpunit.xml τους: πρόσθεσε `<env name="DB_DATABASE" value="testing"/>`
  + connection mysql αν χρειαστεί για μελλοντικά DB tests (τα τωρινά δεν γράφουν DB).

### 3.5 Makefile + τεκμηρίωση
- Αντιγραφή Makefile με `worker:` → `$(SAIL) artisan rabbitmq:read` (το δικό τους).
- Νέο `ms.gov_ked/README.local.md` (ή ενότητα στο README): πώς τρέχει τοπικά
  (up/worker/publish/test) — για τον CTO αύριο.
- Στο ms.beveosiofeilon: ΚΑΜΙΑ αλλαγή κώδικα. (Μελλοντικά, μετά το CTO OK, θα
  σημειωθεί στο README του ότι το ενεργό development μεταφέρθηκε — ΟΧΙ τώρα.)

**Τελικό checkpoint commit πρόταση**:
`Port M1 as beveosi_ofeilwn module: Ked SOAP layer, submit_beveosi, migrations, tests, dev publisher`

## Verification (με τη σειρά)

1. `sail test` στο gov_ked — πράσινα (WSSE 4, SubmitBeveosi ~4, Ping-via-library 1+).
2. Terminal A: `make worker` → «Awaiting RPC requests».
3. Terminal B: `make publish CMD=ping` → JSON, `"status":1`.
4. `make publish CMD=submit_beveosi PARAMS=@tests/fixtures/beveosi.json` → stubbed
   απάντηση με `"atbNo"` string και `"type":"single"`.
5. Λάθος input (πείραξε το fixture: afm 8 ψηφία) → `"status":3` + errors + extraData.fields.
6. Kill τον worker με `docker exec <container> pkill -f rabbitmq:read` (κανόνας
   μνήμης: όχι host-side stop) και επανεκκίνηση — ξανά ping ΟΚ.
7. `git status` στο gov_ked: μόνο τα αναμενόμενα νέα/αλλαγμένα αρχεία, τίποτα στο
   ms.beveosiofeilon, κανένα push πουθενά.

## Ρίσκα / σημειώσεις εκτέλεσης

- Αν το composer install κολλήσει σε SSH auth: δοκίμασε πρώτα
  `GIT_SSH_COMMAND=... git ls-remote ssh://git@gitlab.skel.iit.demokritos.gr:222/egovapp/egovrabbitmqclasses.git`
  μέσα στο ίδιο container setup για να απομονώσεις το πρόβλημα.
- Το vladimir-yuldashev/laravel-queue-rabbitmq (dependency τους) θα κάνει register
  δικό του queue connection — ΔΕΝ το χρησιμοποιούμε (QUEUE_CONNECTION=sync)· αν ο
  provider του γκρινιάξει για config, πρόσθεσε το minimal `config/queue.php` entry
  που ζητά, χωρίς να αλλάξεις driver.
- Ο interpreter τους σκάει σε command χωρίς `|` — το bff:publish το βάζει πάντα.
- Non-durable queue: αν έχει προηγηθεί durable declare του `gov_ked` queue στο ίδιο
  broker volume, σβήσε το queue από το management UI (localhost:15672) πριν το smoke.
- Ημερομηνία-παγίδα interpreter: πεδία με ονόματα από το DATE_TYPE_PARAMETERS whitelist
  τους (date, date_from, created_at...) περνούν από Carbon::parse — τα δικά μας πεδία
  (dueDate κ.λπ.) ΔΕΝ είναι στη λίστα· μην ονομάσεις νέα πεδία από αυτή τη λίστα.
