SERVICES API RESPONSIBILITY MAP

Current scope: Gest

Category: 10_normative | Version: v1.0.0

Owner: DOCUMENT_CUSTODIAN | Review cycle: 90 days

Approval Authority: GOVERNANCE_ADMIN

Read-only Documentation Portal. Editing and mutation endpoints are disabled.

METADATA INCOMPLETE: Document ID, Version, Owner Role, Last Review Date, Next Review Date, Change Log

services/api Responsibility Map

Status: ACTIVE
Audit Date: 2026-03-16
Cleanup Sprint: 01

Purpose

This document classifies services/api route/modules by actual responsibility.

Use these labels:

gateway
façade
fallback
mock/fixture
compatibility
should-move-later

Module Map

| Module | Classification | State | Notes | | --- | --- | --- | --- | | services/api/src/routes/auth.ts | gateway + façade | REAL | mostly proxies to svc-auth, but /me is gateway-composed | | services/api/src/routes/profile.ts | gateway | REAL | profile proxy to auth service | | | gateway | REAL | direct service façade | | | gateway | REAL | direct façade | | | gateway | REAL | direct façade | | | façade + eventing edge | REAL | proxies to and emits Kafka proxy events | | | façade | MIXED | KES-related surface, not the durable event backbone itself | | | gateway | REAL | proxies stakeholder context reads | | | gateway | REAL | proxies onboarding mutation subflows | | | façade + partial stub | MIXED | draft/submit/events/projection proxied; reviewer actions stubbed | | | gateway + compatibility | MIXED | modern proxy routes plus mounted legacy flow | | | fallback | MIXED | upstream proxy plus read fallback for list/detail | | | compatibility route shell | MIXED | mounts legacy local-engine actions and keeps route-level compatibility behavior explicit | | | compatibility bridge | MIXED | gateway-side legacy outbox enqueue bridge used by tender legacy routes | | | should-move-later | UI-FIRST | local legacy domain engine, not canonical public truth | | | gateway + fallback surface | MIXED | read proxy plus mounted local engine | | | fallback | MIXED | upstream read proxy and local-engine fallback helpers | | | fallback + compatibility | MIXED | local action flow for create/open/bid/award/settle | | | should-move-later | UI-FIRST | local auction engine, not canonical service-owned action path | | | mock/fixture | SHELL | fixture-backed projection endpoint | | | mock/fixture | SHELL | fixture-backed stakeholder | | | façade composition | REAL | cleanup sprint grouping layer | | | runtime boot | REAL | now thin bootstrap only |

Loading workspace

Loading module

Loading workspace

SERVICES API RESPONSIBILITY MAP

services/api Responsibility Map

Purpose

Module Map

Route Family Classification

Gateway

Façade

Fallback

Compatibility

Compatibility Bridge

Mock / Fixture

Cleanup Sprint 01 Changes

Should Move Later