mufassall

Konspekt · Biznes jarayonlar

Hujjatlarni uzluksiz raqamlash

14 daq · O'rta · mufassall.dtwin.uz/uz/l/document-numbering/

← Darsni ochish

Muammo

Ko'p mamlakatlarda chiqarilgan hisob-varaqlar uzluksiz raqamlanishi shart: har seriya va har yil ichida birorta raqam tushib qolmasligi va ikki marta ishlatilmasligi kerak, auditor esa reyestrni tekshiradi. Bazadagi sequence bo'shliq qoldiradi, MAX()+1 esa dublikat beradi. Yakunlash tranzaksiyasida olinadigan hisoblagich qatori ikkala kafolatni ham beradi, evaziga yozuvchilar navbatda turadi. Shuning uchun dars bu narxni o'lchaydi va uni kichik ushlaydi.

Nimani o'rganasiz

  • Nega bazadagi sequence'lar ataylab bo'shliq qoldiradi va nega MAX()+1 bitta raqamni ikki hujjatga beradi
  • Har seriya va yil uchun hisoblagich qatori: hujjat bilan bitta tranzaksiyada UPDATE ... RETURNING bilan olinadi; uning qator lock'i o'tkazuvchanlikka qanchaga tushadi
  • Raqam qoralamada emas, yakunlashda olinadi; tranzaksiyaning lock ostidagi qismi qisqa ushlanadi
  • O'chirish o'rniga bekor qilish, har filialga o'z seriyasi va yil almashinuvi kompaniyaning qonuniy vaqt zonasida
Yakuniy sahna

Diagramma kod sifatida

Darsdagi yakuniy sxemani matn ko'rinishida oling va Jira, GitLab, GitHub, Notion yoki hujjatga qo'ying: Mermaid u yerlarda o'zi chiziladi. D2 va PlantUML (Confluence, IntelliJ) uchun alohida variantlar bor.

Mermaid: sxema

flowchart LR
  n_clerk(["Buxgalter"])
  n_api["Hisob-varaq servisi"]
  n_db[("Hisob-varaqlar bazasi")]
  n_export("Reyestr eksporti")
  n_auditor>"Soliq auditori"]
  n_branch(["Filial"])
  n_clerk -->|"chaqiruv"| n_api
  n_api --> n_db
  n_export --> n_db
  n_export -->|"asinxron"| n_auditor
  n_branch -->|"chaqiruv"| n_api

Mermaid: so'rovlar ketma-ketligi

sequenceDiagram
  participant n_api as Hisob-varaq servisi
  participant n_db as Hisob-varaqlar bazasi
  participant n_export as Reyestr eksporti
  participant n_auditor as Soliq auditori
  Note over n_api,n_db: Har hisob-varaq navbatdagi raqamni oladi
  n_api->>n_db: INSERT INTO invoices (id, number, status, buyer_id)
  n_db-->>n_api: INSERT 0 1 number = INV-2026-000481
  Note over n_export,n_auditor: Reyestrda teshiklar bor
  n_export->>n_auditor: register 2026, series INV: 000481 000482 000484 000485 000490 ...
  Note over n_api,n_db: MAX()+1 bitta raqamni ikki marta beradi
  n_api->>n_db: number = SELECT max(no) + 1 FROM invoices WHERE series = 'INV'
  Note over n_api,n_db: Har seriya va yil uchun hisoblagich qatori
  n_api->>n_db: UPDATE number_counters
  n_db-->>n_api: UPDATE 1 last_no = 482
  Note over n_api,n_db: Raqam faqat hujjat chiqarilganda
  n_api->>n_db: BEGIN#59; -- POST /invoices/9f2c/finalize
  Note over n_api,n_db: Hamma bitta qatorni kutadi
  n_api->>n_db: load test: 64 parallel finalizes, one series
  Note over n_api,n_db: Raqamni oxirida ol, og'ir ishni tashqarida qil
  n_api->>n_db: finalize, reordered
  Note over n_export,n_auditor: Chiqarilgan hisob-varaq o'chiriladi
  n_export->>n_auditor: DELETE FROM invoices WHERE number = 'INV-2026-000517'#59; -- wrong buyer
  Note over n_api,n_db: Bekor qil, hech qachon o'chirma
  n_api->>n_db: UPDATE invoices
  Note over n_api,n_db: Har filialga o'z seriyasi
  n_api->>n_db: SELECT series, year, last_no FROM number_counters#59;
  n_db-->>n_api: HQ #124; 2026 #124; 517
  Note over n_api,n_db: Raqamlash 1-yanvarda qaytadan boshlanadi
  n_api->>n_db: INSERT INTO number_counters (series, year, last_no)

D2

direction: right

n_clerk: "Buxgalter" {
  shape: rectangle
}
n_api: "Hisob-varaq servisi" {
  shape: rectangle
}
n_db: "Hisob-varaqlar bazasi" {
  shape: cylinder
}
n_export: "Reyestr eksporti" {
  shape: rectangle
  style.multiple: true
}
n_auditor: "Soliq auditori" {
  shape: cloud
}
n_branch: "Filial" {
  shape: rectangle
}

n_clerk -> n_api: "chaqiruv"
n_api -> n_db
n_export -> n_db
n_export -> n_auditor: "asinxron"
n_branch -> n_api: "chaqiruv"

PlantUML: so'rovlar ketma-ketligi

@startuml
participant "Hisob-varaq servisi" as n_api
database "Hisob-varaqlar bazasi" as n_db
participant "Reyestr eksporti" as n_export
boundary "Soliq auditori" as n_auditor
note over n_api, n_db : Har hisob-varaq navbatdagi raqamni oladi
n_api -> n_db : INSERT INTO invoices (id, number, status, buyer_id)
n_db --> n_api : INSERT 0 1 number = INV-2026-000481
note over n_export, n_auditor : Reyestrda teshiklar bor
n_export ->> n_auditor : register 2026, series INV: 000481 000482 000484 000485 000490 ...
note over n_api, n_db : MAX()+1 bitta raqamni ikki marta beradi
n_api -> n_db : number = SELECT max(no) + 1 FROM invoices WHERE series = 'INV'
note over n_api, n_db : Har seriya va yil uchun hisoblagich qatori
n_api -> n_db : UPDATE number_counters
n_db --> n_api : UPDATE 1 last_no = 482
note over n_api, n_db : Raqam faqat hujjat chiqarilganda
n_api -> n_db : BEGIN; -- POST /invoices/9f2c/finalize
note over n_api, n_db : Hamma bitta qatorni kutadi
n_api -> n_db : load test: 64 parallel finalizes, one series
note over n_api, n_db : Raqamni oxirida ol, og'ir ishni tashqarida qil
n_api -> n_db : finalize, reordered
note over n_export, n_auditor : Chiqarilgan hisob-varaq o'chiriladi
n_export ->> n_auditor : DELETE FROM invoices WHERE number = 'INV-2026-000517'; -- wrong buyer
note over n_api, n_db : Bekor qil, hech qachon o'chirma
n_api -> n_db : UPDATE invoices
note over n_api, n_db : Har filialga o'z seriyasi
n_api -> n_db : SELECT series, year, last_no FROM number_counters;
n_db --> n_api : HQ | 2026 | 517
note over n_api, n_db : Raqamlash 1-yanvarda qaytadan boshlanadi
n_api -> n_db : INSERT INTO number_counters (series, year, last_no)
@enduml

PlantUML: komponentlar

@startuml
left to right direction
agent "Buxgalter" as n_clerk
component "Hisob-varaq servisi" as n_api
database "Hisob-varaqlar bazasi" as n_db
collections "Reyestr eksporti" as n_export
cloud "Soliq auditori" as n_auditor
agent "Filial" as n_branch
n_clerk --> n_api : chaqiruv
n_api --> n_db
n_export --> n_db
n_export --> n_auditor : asinxron
n_branch --> n_api : chaqiruv
@enduml

Xulosa

Qonun uzluksiz bo'lishini talab qiladigan raqamlar uchun olti qoida.

1) Ular uchun bazadagi sequence'dan foydalanmang: u ataylab raqam o'tkazib yuboradi. 2) MAX()+1 dan foydalanmang: ikki yozuvchi bir xil maksimumni o'qiydi. 3) Har seriya va yil uchun hisoblagich qatorini saqlang va raqamni hujjat bilan bitta tranzaksiyada UPDATE ... RETURNING bilan oling: rollback uni qayta ishlatadi. 4) Raqamni yakunlashda oling, hech qachon qoralamada emas. 5) Qator lock'i yozuvchilarni navbatga qo'yadi: raqamni oxirida oling, og'ir ishni tashqarida qiling, qoidalar ruxsat bersa, seriyalarga bo'ling. 6) O'chirish o'rniga bekor qiling, yilni esa qonuniy vaqt zonasida, oldindan yaratilgan qatorlar bilan almashtiring.

Ko'rsatkichlar: boshida va oxirida

Ko'rsatkichBoshidaOxirida
Tushib qolgan raqamlar0/yr0/yr
Ikki marta ishlatilgan raqamlar0/yr0/yr
Seriya bo'yicha yakunlash900/s780/s
Yakunlashda p99 kutish4 ms18 ms

Qadamlar

  1. Holat Har hisob-varaq navbatdagi raqamni oladi

    Buxgalter hisob-varaq yaratadi, servis esa unga INV-2026-000481 kabi raqam beradi: seriya, yil va tartib raqami.

  2. Muammo Reyestrda teshiklar bor

    Yil oxirida reyestr soliq auditori uchun eksport qilinadi.

  3. Muammo MAX()+1 bitta raqamni ikki marta beradi

    Dasturchi sequence'ni almashtiradi: navbatdagi raqam = eng kattasi plus bir.

  4. Yechim Har seriya va yil uchun hisoblagich qatori

    Har seriya va yil uchun bitta qator oxirgi ishlatilgan raqamni saqlaydi.

  5. Yechim Raqam faqat hujjat chiqarilganda

    Qoralamalar endi raqam olmaydi: ularda faqat ichki id bor.

  6. Muammo Hamma bitta qatorni kutadi

    Oy oxirida yuklama testi bitta seriyada 64 ta parallel yakunlashni yurgizadi.

  7. Yechim Raqamni oxirida ol, og'ir ishni tashqarida qil

    Tekshiruv va jami summalar BEGIN dan oldinga ko'chadi.

  8. Muammo Chiqarilgan hisob-varaq o'chiriladi

    000517 hisob-varaq noto'g'ri xaridorga ketgan.

  9. Yechim Bekor qil, hech qachon o'chirma

    Chiqarilgan hujjat bekor qilinadi: status cancelled, vaqti, sababi va uni almashtiruvchi hujjatga havola.

  10. Yechim Har filialga o'z seriyasi

    Kompaniya filial ochadi.

  11. Yechim Raqamlash 1-yanvarda qaytadan boshlanadi

    Yangi yilda har seriya 000001 dan boshlanadi.

  12. Xulosa Xulosa

    Qonun uzluksiz bo'lishini talab qiladigan raqamlar uchun olti qoida.

Atamalar

Uzluksiz raqamlash
Har seriya va yil ichida hujjat raqamlari birorta ham tushib qolmasdan va takrorlanmasdan ketma-ket boradi. Ko'pincha qonun talabi, auditor reyestr bo'yicha tekshiradi.
Raqamlar seriyasi
Prefiks va yil bilan ajratilgan alohida raqamlar ketma-ketligi, masalan har filial uchun. Har seriyaning o'z hisoblagichi bor, shuning uchun seriyalar bir-birini kutmaydi.
Hisoblagich qatori
Seriya uchun oxirgi raqamni saqlaydigan qator, hujjat bilan bitta tranzaksiyada UPDATE ... RETURNING bilan oshiriladi. Rollback raqamni qaytaradi, qator lock'i esa yozuvchilarni navbatga qo'yadi.
Sequence bo'shlig'i
Bazadagi sequence o'tkazib yuborgan qiymat: rollback, kesh yoki yiqilishdan keyin. Sequence'lar tezlik uchun ataylab orqaga qaytmaydi, shuning uchun uzluksiz raqamlarga yaramaydi.