Skip to content

TASK: Refresh local SIT guide for event-driven service rollout #215

Closed

Description

@ramioooz

Objective

Update the platform local SIT guide so the merged Auth, MFA, Transaction, Payment, Notification, Account, and Ledger services can be deployed and verified in a repeatable dependency order.

Scope

  • Document all current banking services and their namespace/port dependencies.
  • Document PostgreSQL logical database, Auth JWT, MFA encryption-key, Kafka topic, and Config Server prerequisites without recording secret values.
  • Document API Gateway health, protected workflow, centralized OpenAPI, Kafka/AKHQ, and database verification boundaries.
  • Keep AWS/UAT/PROD rollout out of scope.

Dependencies

  • Parent task: .github#213
  • Related: config-repo#39, config-repo#41, infra-sit#29, infra-sit#31, and .github#212.

Acceptance Criteria

  • A contributor can follow the guide from an empty or existing local SIT cluster.
  • The guide distinguishes fresh PostgreSQL initialization from upgrade reconciliation.
  • It does not claim that unmerged configuration or undeployed services are already healthy.
  • It identifies the required wait points and verification evidence for the event-driven transfer slice.
  • No secrets, public production endpoints, or AWS implementation details are added.

Activity

  1. self-assigned this
    on Sep 4, 2026
  2. added theissue type on Sep 4, 2026
  3. ramioooz commented on Sep 4, 2026

    @ramioooz
    MemberAuthor

    Implementation PR: .github#216

    The local SIT guide now covers the full service rollout order, database and secret prerequisites, Gateway/OpenAPI verification, event-driven transfer evidence, and AKHQ checks. The PR is non-draft and clean; it can merge independently, but the documented rollout still depends on the referenced Config Repo and Infra SIT PRs.

  4. ramioooz commented on Sep 4, 2026

    @ramioooz
    MemberAuthor

    Follow-up handoff PR: #218

    The local SIT rollout guide from PR #216 is merged. PR #218 appends the current handoff state, including the PostgreSQL PVC-label rollout incident, the open prerequisite PRs, their merge order, and the gateway rate-limiting approval boundary.

    This documentation PR is non-draft and ready for review. No application or deployment behavior changes are included.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions