Purpose

This document defines the safest first accommodation runtime/bootstrap path.

This sprint does not execute extraction or cutover.

It chooses a low-risk bootstrap direction that keeps rollback easy and keeps compatibility residue explicit.

Target runtime location

Prepared runtime target:

• services/svc-accommodations

Current status:

• location reserved as the future accommodation runtime home
• no active route cutover
• no old host deletion

Bootstrap/server entry plan

Planned runtime shape:

• services/svc-accommodations/package.json
• services/svc-accommodations/tsconfig.json
• services/svc-accommodations/src/server.ts
• services/svc-accommodations/src/config.ts
• services/svc-accommodations/src/db.ts
• services/svc-accommodations/src/auth.ts
• services/svc-accommodations/src/http/authTypes.ts
• services/svc-accommodations/src/routes/registerAccommodationRoutes.ts
• services/svc-accommodations/src/routes/support/accommodationRouteSupport.ts
• services/svc-accommodations/src/routes/support/detailExtractionSupport.ts copied locally or replaced by a narrower local helper
• services/svc-accommodations/src/accommodation/* copied from the accommodation-owned slice

Bootstrap wiring should mirror current route-time truth:

1. resolve config
2. create DB pool
3. build shared auth ingress adapter
4. create AccommodationCommandHandlers
5. create AccommodationReadRepository
6. create AccommodationOwnerReadRepository
7. build AccommodationRouteSupport
8. register accommodation routes
9. expose /health

Recommended bootstrap approach

Chosen direction for next execution sprint:

• copy-first runtime creation

Reason:

• accommodation active routes already depend on dedicated accommodation modules
• gateway env seam already exists
• rollback should stay as ACCOMMODATIONS_SERVICE_URL fallback to TENDERS_SERVICE_URL

Coexistence strategy with old host

During first runtime execution:

• old accommodation hosting in svc-tenders stays active
• gateway route shape stays unchanged
• ACCOMMODATIONS_SERVICE_URL points to new runtime only during parity verification/cutover rehearsal
• fallback remains old svc-tenders accommodation host

Rollback notes

Rollback path should stay:

1. unset or change ACCOMMODATIONS_SERVICE_URL
2. gateway falls back to TENDERS_SERVICE_URL
3. old svc-tenders accommodation hosting serves the same routes again

This is the same env-first pattern proven on ICPI and should remain the accommodation cutover model.

Why this sprint did not create a runnable runtime yet

The runtime target is now concrete, but full copy-first scaffolding is deferred because:

• migration ownership is still mixed across accommodation-only and vacancy/accommodation legacy migrations
• compatibility residue is still explicit in services/svc-tenders/src/accommodation/compatibilityReadRepository.ts
• detailExtractionSupport.ts is still shared with vacancy
• this sprint was aimed at low-ambiguity bootstrap prep, not premature extraction execution

Main blockers before runtime execution

• define the exact copy-first accommodation source file set
• decide which migrations copy first versus stay as legacy residue
• copy or localize the small shell-local auth/parser helper types
• keep root compatibility hosting explicit until parity is proven