Konspekt · Biznes jarayonlar
Hujjatlarni uzluksiz raqamlash
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
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_apiMermaid: 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)
@endumlPlantUML: 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
@endumlXulosa
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'rsatkich | Boshida | Oxirida |
|---|---|---|
| Tushib qolgan raqamlar | 0/yr | 0/yr |
| Ikki marta ishlatilgan raqamlar | 0/yr | 0/yr |
| Seriya bo'yicha yakunlash | 900/s | 780/s |
| Yakunlashda p99 kutish | 4 ms | 18 ms |
Qadamlar
- Holat Har hisob-varaq navbatdagi raqamni oladi
Buxgalter hisob-varaq yaratadi, servis esa unga
INV-2026-000481kabi raqam beradi: seriya, yil va tartib raqami. - Muammo Reyestrda teshiklar bor
Yil oxirida reyestr soliq auditori uchun eksport qilinadi.
- Muammo MAX()+1 bitta raqamni ikki marta beradi
Dasturchi sequence'ni almashtiradi: navbatdagi raqam = eng kattasi plus bir.
- Yechim Har seriya va yil uchun hisoblagich qatori
Har seriya va yil uchun bitta qator oxirgi ishlatilgan raqamni saqlaydi.
- Yechim Raqam faqat hujjat chiqarilganda
Qoralamalar endi raqam olmaydi: ularda faqat ichki id bor.
- Muammo Hamma bitta qatorni kutadi
Oy oxirida yuklama testi bitta seriyada 64 ta parallel yakunlashni yurgizadi.
- Yechim Raqamni oxirida ol, og'ir ishni tashqarida qil
Tekshiruv va jami summalar
BEGINdan oldinga ko'chadi. - Muammo Chiqarilgan hisob-varaq o'chiriladi
000517 hisob-varaq noto'g'ri xaridorga ketgan.
- Yechim Bekor qil, hech qachon o'chirma
Chiqarilgan hujjat bekor qilinadi: status
cancelled, vaqti, sababi va uni almashtiruvchi hujjatga havola. - Yechim Har filialga o'z seriyasi
Kompaniya filial ochadi.
- Yechim Raqamlash 1-yanvarda qaytadan boshlanadi
Yangi yilda har seriya 000001 dan boshlanadi.
- 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.