Konspekt · Biznes jarayonlar
Pul va yaxlitlash
Muammo
Do'kon so'mda sotadi va 12% QQS bilan elektron hisob-faktura chiqaradi. Narxlar suzuvchi nuqtali sonlar bo'lsa, aynan to'g'ri summadagi to'lov tenglik tekshiruvidan o'tmaydi. Summalar valyutasi bilan birga eng kichik birlikdagi butun songa aylanadi, keyin esa asl savollar boshlanadi: qaysi yaxlitlash qoidasi, qayerda yaxlitlash (har qatorda yoki butun hujjatda), summani bir tiyin ham yo'qotmasdan qanday bo'lish, bir haftadan keyin ham isbotlay oladigan kurs bilan qanday konvertatsiya qilish va nega formatlash faqat eng chekkada bo'lishi kerak.
Nimani o'rganasiz
- Nega ikkilik suzuvchi nuqta 0.1 yoki 19 990.10 ni aniq saqlay olmaydi va valyutali eng kichik birlikdagi butun sonlar buni qanday hal qiladi (0, 2 va 3 kasr xonali valyutalar)
- Yaxlitlash usullari: half-up, half-even (bank usuli) va nosimmetrik Math.round, hamda nega qoida bir marta yozib qo'yiladigan biznes qarori
- Har qatorda yoki butun hisob-fakturada yaxlitlash: QQS'dagi 1 tiyinlik farq va jami summalar chop etilgan qatorlar yig'indisi degan qoida
- Summani eng katta qoldiq usuli bilan bo'lish, valyutani saqlangan kurs va vaqt bilan konvertatsiya qilish va lokal bo'yicha formatlashni chekkada qilish
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_app(["Checkout"])
n_api["Buyurtma servisi"]
n_db[("Buyurtmalar bazasi")]
n_tax>"Hisob-faktura tizimi"]
n_fx>"Kurs manbai"]
n_app -->|"chaqiruv"| n_api
n_api --> n_db
n_api -->|"asinxron"| n_tax
n_api -->|"chaqiruv"| n_fxMermaid: so'rovlar ketma-ketligi
sequenceDiagram
participant n_app as Checkout
participant n_api as Buyurtma servisi
participant n_db as Buyurtmalar bazasi
participant n_tax as Hisob-faktura tizimi
participant n_fx as Kurs manbai
Note over n_app,n_api: Narxlari oddiy son bo'lgan buyurtma
n_app->>n_api: POST /v1/orders HTTP/1.1
n_api-->>n_app: HTTP/1.1 201 Created
Note over n_app,n_api: To'g'ri to'lov jami summaga mos kelmaydi
n_app->>n_api: #62; 19990.1 * 3
Note over n_app,n_api: Eng kichik birlikdagi butun sonlarni saqla
n_app->>n_api: POST /v1/orders HTTP/1.1
n_api-->>n_app: currency exponent 1 unit =
Note over n_api,n_db: Yaxlitlash usullari: aynan yarimda nima bo'ladi
n_api->>n_db: 1.5% fee on 10 003.00 so'm = 15 004.5 tiyin
Note over n_api,n_tax: Qatorlar QQS'i jami summaga teng chiqmaydi
n_api->>n_tax: invoice INV-2026-11-04417 VAT 12%
n_tax-->>n_api: rejected: total VAT 10 660.71 != sum of line VAT 10 660.72
Note over n_api,n_tax: Har qatorda bir marta yaxlitla, saqlanganini qo'sh
n_api->>n_tax: POST /v1/invoices INV-2026-11-04417
n_tax-->>n_api: accepted INV-2026-11-04417
Note over n_api,n_db: Uchta to'lov, bitta tiyin yetishmaydi
n_api->>n_db: installments: 100 000.00 so'm in 3 months = 10 000 000 tiyin / 3
Note over n_api,n_db: Qoldiqni eng kattasidan boshlab taqsimla
n_api->>n_db: allocate a 5 000.00 so'm discount (500 000 tiyin) by line net
Note over n_api,n_fx: Bugungi kurs bilan qaytarish
n_api->>n_fx: order o_8120 49.99 USD, paid in UZS on 2026-11-09
Note over n_api,n_db: Kursni, uning manbai va vaqtini konvertatsiya bilan birga saqla
n_api->>n_db: INSERT INTO conversions (order o_8120)
n_db-->>n_api: 4999 x 1268743 / 100 = 63 424 462.57 -#62; 63 424 463 tiyin
Note over n_app,n_api: Faqat chekkada, lokal bo'yicha formatla
n_app->>n_api: stored: minor 63424463, currency UZSD2
direction: right
n_app: "Checkout" {
shape: rectangle
}
n_api: "Buyurtma servisi" {
shape: rectangle
}
n_db: "Buyurtmalar bazasi" {
shape: cylinder
}
n_tax: "Hisob-faktura tizimi" {
shape: cloud
}
n_fx: "Kurs manbai" {
shape: cloud
}
n_app -> n_api: "chaqiruv"
n_api -> n_db
n_api -> n_tax: "asinxron"
n_api -> n_fx: "chaqiruv"PlantUML: so'rovlar ketma-ketligi
@startuml
participant "Checkout" as n_app
participant "Buyurtma servisi" as n_api
database "Buyurtmalar bazasi" as n_db
boundary "Hisob-faktura tizimi" as n_tax
boundary "Kurs manbai" as n_fx
note over n_app, n_api : Narxlari oddiy son bo'lgan buyurtma
n_app -> n_api : POST /v1/orders HTTP/1.1
n_api --> n_app : HTTP/1.1 201 Created
note over n_app, n_api : To'g'ri to'lov jami summaga mos kelmaydi
n_app -> n_api : > 19990.1 * 3
note over n_app, n_api : Eng kichik birlikdagi butun sonlarni saqla
n_app -> n_api : POST /v1/orders HTTP/1.1
n_api --> n_app : currency exponent 1 unit =
note over n_api, n_db : Yaxlitlash usullari: aynan yarimda nima bo'ladi
n_api -> n_db : 1.5% fee on 10 003.00 so'm = 15 004.5 tiyin
note over n_api, n_tax : Qatorlar QQS'i jami summaga teng chiqmaydi
n_api ->> n_tax : invoice INV-2026-11-04417 VAT 12%
n_tax -->> n_api : rejected: total VAT 10 660.71 != sum of line VAT 10 660.72
note over n_api, n_tax : Har qatorda bir marta yaxlitla, saqlanganini qo'sh
n_api ->> n_tax : POST /v1/invoices INV-2026-11-04417
n_tax -->> n_api : accepted INV-2026-11-04417
note over n_api, n_db : Uchta to'lov, bitta tiyin yetishmaydi
n_api -> n_db : installments: 100 000.00 so'm in 3 months = 10 000 000 tiyin / 3
note over n_api, n_db : Qoldiqni eng kattasidan boshlab taqsimla
n_api -> n_db : allocate a 5 000.00 so'm discount (500 000 tiyin) by line net
note over n_api, n_fx : Bugungi kurs bilan qaytarish
n_api -> n_fx : order o_8120 49.99 USD, paid in UZS on 2026-11-09
note over n_api, n_db : Kursni, uning manbai va vaqtini konvertatsiya bilan birga saqla
n_api -> n_db : INSERT INTO conversions (order o_8120)
n_db --> n_api : 4999 x 1268743 / 100 = 63 424 462.57 -> 63 424 463 tiyin
note over n_app, n_api : Faqat chekkada, lokal bo'yicha formatla
n_app -> n_api : stored: minor 63424463, currency UZS
@endumlPlantUML: komponentlar
@startuml
left to right direction
agent "Checkout" as n_app
component "Buyurtma servisi" as n_api
database "Buyurtmalar bazasi" as n_db
cloud "Hisob-faktura tizimi" as n_tax
cloud "Kurs manbai" as n_fx
n_app --> n_api : chaqiruv
n_api --> n_db
n_api --> n_tax : asinxron
n_api --> n_fx : chaqiruv
@endumlXulosa
Pul uchun yetti qoida.
1) Hech qachon float emas: eng kichik birlikdagi butun sonlar, doim valyuta bilan. 2) Kasr xonalari valyuta jadvalidan olinadi: 0, 2 yoki 3. 3) Yaxlitlash usulini qoidaga ko'ra tanla va usuli aniq ko'rsatilgan bitta funksiyani ishlat. 4) Bitta belgilangan joyda yaxlitla, yaxlitlangan summalarni saqla va jami summalar saqlangan narsalar yig'indisi bo'lsin. 5) Taqsimlash bilan bo'l, shunda qismlar doim butunga teng. 6) Har bir konvertatsiyani kursi, manbai va vaqti bilan saqla va qaytarishda qayta ishlat. 7) Lokal bo'yicha faqat ilovada formatla.
Ko'rsatkichlar: boshida va oxirida
| Ko'rsatkich | Boshida | Oxirida |
|---|---|---|
| Farq, tiyin | 0 | 0 |
| Mos kelmagan hujjatlar | 0/kun | 0/kun |
| Qaytarishdagi kamomad, tiyin | 0 | 0 |
Qadamlar
- Holat Narxlari oddiy son bo'lgan buyurtma
Checkout buyurtma yuboradi: 19 990.10 so'mlik uch quti choy.
- Muammo To'g'ri to'lov jami summaga mos kelmaydi
Ikkilik suzuvchi nuqtada 19 990.10 eng yaqin ikkilik kasr sifatida saqlanadi, u esa biroz farq qiladi.
- Yechim Eng kichik birlikdagi butun sonlarni saqla
Endi har bir summa eng kichik birlikdagi butun son va valyutadan iborat: UZS'da 1 999 010 tiyin.
- Yechim Yaxlitlash usullari: aynan yarimda nima bo'ladi
Butun sonlar yaxlitlashni yo'q qilmaydi: 10 003.00 so'mdan 1.5% komissiya 15 004.5 tiyin, undirish esa faqat butun tiyinda mumkin.
- Muammo Qatorlar QQS'i jami summaga teng chiqmaydi
Hisob-fakturada uchta qator bor.
- Yechim Har qatorda bir marta yaxlitla, saqlanganini qo'sh
Endi qoida shunday: QQS har bir qatorda, half-up bilan, qator yaratilganda yaxlitlanadi va saqlanadi.
- Muammo Uchta to'lov, bitta tiyin yetishmaydi
Mijoz 100 000.00 so'mni 3 oylik to'lov bilan to'laydi.
- Yechim Qoldiqni eng kattasidan boshlab taqsimla
Taqsimlash (allocation) summani vaznlar bo'yicha qismlar doim butunga teng bo'ladigan qilib bo'ladi.
- Muammo Bugungi kurs bilan qaytarish
Mahsulot narxi 49.99 USD, mijoz esa so'mda to'laydi.
- Yechim Kursni, uning manbai va vaqtini konvertatsiya bilan birga saqla
Endi har bir konvertatsiya yozuv: asl summa, aniq o'nlik kasr ko'rinishidagi kurs, u qayerdan va qachon olingani, konvertatsiya qilingan summa va yaxlitlash usuli.
- Yechim Faqat chekkada, lokal bo'yicha formatla
Baza, API'lar va log'lar eng kichik birlik va valyutani saqlaydi.
- Xulosa Xulosa
Pul uchun yetti qoida.
Atamalar
- Suzuvchi nuqta xatosi
- Ikkilik double 0.1 kabi o'nlik kasrlarni aniq saqlay olmaydi, shuning uchun 0.1 + 0.2 0.30000000000000004 beradi. Pul uchun butun sonlar yoki decimal turi ishlatiladi.
- Yaxlitlash usuli
- Aynan yarimdagi qiymat qayerga ketishini belgilaydigan qoida: half-up yarimni noldan uzoqqa, half-even (bank usuli) juft qo'shniga oladi. Qoidani qonun yoki shartnoma belgilaydi.
- Eng katta qoldiq usuli
- Summani qismlarga bo'lish usuli: har bir qism pastga yaxlitlangan ulushini oladi, ortgan tiyinlar esa bittadan eng katta qoldiqli qismlarga beriladi. Qismlar doim butunga teng.
- Saqlangan valyuta kursi
- Konvertatsiya bilan birga yozib qo'yiladigan kurs, uning manbai, vaqti va yaxlitlash usuli. Qaytarish va audit shu sonlardan foydalanadi, kursni qaytadan olmaydi.