LedgerCore

Hisoblar orasidagi pul harakatini yozadigan tizimning yagona talabi — hech qachon xato qilmaslik. So'rovlar bir vaqtda kelsa ham, mijoz qayta yuborsa ham, jarayon o'rtada to'xtasa ham pul paydo bo'lmasligi, yo'qolmasligi va bitta o'tkazma ikki marta bajarilmasligi kerak.

API (NestJS 10 modulli monolit) foydalanuvchi va hisoblar, depozit va yechib olish, o'tkazma, reversal, balans, tarix va reconciliation'ni bajaradi. O'sha kod bazasidagi alohida worker jarayoni outbox hodisalarini FOR UPDATE SKIP LOCKED bilan olib, HMAC imzoli webhook sifatida yuboradi. Invariantlarni PostgreSQL 16 deferred constraint trigger'lari tekshiradi, shuning uchun ilova kodidagi xato ularni chetlab o'tolmaydi. Operatsion konsol (React + Vite) hisoblar, o'tkazmalar va outbox yetkazilishini ko'rsatadi.

Kattalashtirish

Nima o'zgartirildi

Balans endpoint'i BEGIN READ ONLY → hisobni tekshirish → SUM → COMMIT qilib, bazaga 4 marta borib-kelardi va ulanishni band qilardi (HTTP p95 141 ms, SQL'ning o'zi ~0.3 ms). READ COMMITTED'da har bir statement o'z snapshot'ini oladi, shuning uchun bu tranzaksiya hech qanday izchillik bermasdi. Pool 20 dan 40 ga oshirilganda faqat 7% tezlashdi, demak sabab pool emas edi; 200 000 yozuvli bazada EXPLAIN ANALYZE ikkala variantda ham 55 buffer va bir xil indeksni ko'rsatdi. accounts + CROSS JOIN LATERAL (SUM …) bitta statement'ga o'tkazildi (404 saqlandi) va bazaga bitta so'rov borishini tekshiradigan regressiya testi qo'shildi. Qat'iy tezlik 100 iter/s, 3 + 3 run; tarix va o'tkazma p95 farqi shovqin chegarasida.

Belgi

To'liq bench'da 3 ta 500 va 3 ta 409 chiqdi, ledger esa muvozanatda qoldi.

Sabab

Postgres 04:00:52.7 da lock_timeout bergan, API esa javobni 10 soniya keyin yozgan, o'sha paytda 40 ms ichida bir guruh 500 chiqqan: Node jarayonining o'zi to'xtab qolgan. Sabab — har bir so'rovni info darajasida log qilish; Windows'da stdout pipe'ga yozish sinxron, PowerShell yo'naltirishi esa ulgurmagan.

Yechim

LOG_LEVEL=warn bilan xuddi shu stsenariyda fault 0, 409 0, throughput +37%. lock_timeout 3 s, statement_timeout 5 s va idle_in_transaction_session_timeout 10 s qulflarni bo'shatdi; 500 INTERNAL_ERROR qaytargan timeout'lar endi 503 DATABASE_TIMEOUT (retryable: true) qaytaradi (8c30dba).

Takrorlanmasligi uchun

Haqiqiy Postgres va pg-pool bilan timeout → 503 bo'yicha 3 ta test yozildi; production'da asinxron logger yoki sampling kerakligi cheklovlarga yozildi.

Testlar soni

392

Qamrov

—

CI

GitHub Actions (커밋 메시지, 포맷, lint, typecheck, Postgres 서비스로 테스트, 빌드; billing 문제로 현재 중단)

Test vositalari

Vitest, supertest, 실제 PostgreSQL 16 (mock 없음), k6 + bench.ps1

Deploy muhiti

iwinv VPS, Docker Compose. Faqat web (Caddy) tashqi proxy tarmog'ida turadi va /v1/* ni API'ga yo'naltiradi; Postgres va Redis portlari ochilmagan. deploy.sh: conflict belgilari tekshiruvi → git merge --ff-only → migrate, api va web image'lari SHA tegi bilan build (worker api image'ini ishlatadi) → migrate muvaffaqiyatli tugagach API va worker → /v1/health/ready 60 soniyagacha kutiladi → faqat tayyor versiya APP_TAG va .deploy-history'ga yoziladi, bo'lmasa aniq rollback buyrug'i chiqariladi.

Backup

Cron har kuni 03:00 da serverdagi barcha Postgres konteynerlarini pg_dump -Fc bilan zaxiralaydi, 7 kun saqlanadi. restore-test.sh eng so'nggi nusxani vaqtinchalik bazaga tiklab, jadvallar sonini solishtiradi; LedgerCore uchun VERIFY_SQL double-entry invariantini ham tekshiradi: 68K nusxa, 14/14 jadval, tiklash 0.68 s, 20 yozuv imbalance=0.

Rollback

rollback.sh build qilmasdan api, worker va web'ni oldingi (yoki berilgan) SHA'ga qaytaradi va health tekshiradi; Postgres va Redis'ga tegmaydi, migratsiyalar qaytarilmaydi. Production'da 2066318 → d10826f → 2066318 sinaldi, har safar ready (~1 s).

Monitoring

postgresql.prod.conf: lock_timeout 3 s, statement_timeout 5 s, idle_in_transaction_session_timeout 10 s, 500 ms dan sekin so'rovlar log qilinadi, pg_stat_statements yoqilgan, DB PG Insight'ga monitoring tarmog'i orqali ulangan. /v1/health/ready

• db/migrations/1737000200000_enforce-double-entry-invariant.sql

  Debet = kreditni COMMIT'da tekshiradigan deferred constraint trigger'lar

• db/migrations/1737000300000_make-ledger-immutable.sql

  Yozuvlarni o'zgartirish va o'chirishni bazaning o'zida taqiqlaydi

• apps/api/src/modules/ledger/infrastructure/transaction.repository.ts

  Hisoblarni id tartibida FOR UPDATE bilan qulflash

• apps/api/src/modules/ledger/application/transfer.service.ts

  Qulf, mablag' tekshiruvi, yozuvlar, outbox — bitta tranzaksiyada

• apps/api/src/modules/ledger/application/reversal.service.ts

  Qulfdan keyin statusni qayta o'qiydigan reversal (race tuzatilgan)

• apps/api/src/modules/ledger/infrastructure/balance.repository.ts

  Bitta statement'li balans o'qish

• apps/api/src/shared/database/transaction.manager.ts

  AsyncLocalStorage asosidagi tranzaksiya, 40001/40P01 da qayta urinish

• apps/api/src/shared/errors/postgres-error.translator.ts

  SQLSTATE → domen xatosi, timeout → 503

• apps/api/test/concurrency/transfer-concurrency.test.ts

  10 ta parallellik testi

• load-tests/bench.ps1

  Warm-up, 3 run, mediana, yaroqlilik qoidalari

Yakuniy kodda 12/12 yuk testi yaroqli chiqdi: fault 0, deadlock 0, contention 0, har bir rundan keyin ledger muvozanatda. Balans o'qishni bitta statement'ga qisqartirib, qat'iy tezlikdagi A/B'da p95 24.9 ms dan 13.4 ms ga tushirildi. Raqamlarga ishonishdan oldin yana quyidagilar topilib tuzatildi: ikki parallel reversal'dan ikkinchisi 409 o'rniga 422 qaytargan race (ccee39b), .env.test gitignore'da bo'lgani uchun toza klonda testlar umuman ishlamagani (e0e6884), k6 skriptlaridagi __ITER va teardown xatolari (0f76291).