chore: CLAUDE.md do gitignore, ostava len lokalne

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Tomas
2026-04-09 00:24:38 +02:00
parent 3e8502178c
commit 5d8ddb91f5
2 changed files with 1 additions and 83 deletions
+1
View File
@@ -0,0 +1 @@
CLAUDE.md
-83
View File
@@ -1,83 +0,0 @@
# l10n_sk_partner — Slovak Tax IDs for Odoo 19.0
## Účel modulu
Modul pridáva slovenské daňové identifikátory na kontakty a faktúry:
- **IČO** (`company_registry`) — 8 číslic, natívne pole Odoo, label prepísaný na "IČO" pre SK krajinu
- **DIČ** (`dic`) — vlastné pole, 10 číslic
- **IČ DPH** (`vat`) — štandardné Odoo pole, validácia formátu `SK` + 10 číslic
## Štruktúra
```
l10n_sk_partner/
├── models/
│ ├── res_partner.py # Pole dic, is_vat_payer, validácie, label IČO
│ └── res_company.py # Sync dic → income_tax_id pri uložení firmy
├── views/
│ └── res_partner_views.xml # Pole dic a is_vat_payer na formulári partnera
├── report/
│ └── report_layout_sk.xml # Prázdny, opravy sa robia cez migration scripty
├── migrations/
│ ├── 19.0.2.0.4/post-migrate.py # Oprava šablón faktúr (IČO/DIČ pre odberateľa)
│ ├── 19.0.2.0.5/post-migrate.py # Skrytie natívneho VAT t-if bloku v external_layout pre SK
│ └── 19.0.2.0.6/post-migrate.py # Oprava VAT t-else bloku (zostatok po 2.0.5)
└── hooks.py # post_init_hook — oprava l10n_sk.vat_registry_tax_id_external_layout
```
## Kľúčové rozhodnutia
### Prečo migration scripty miesto XML pohľadov
Moduly `l10n_sk` a `web` definujú šablóny faktúr ako databázové záznamy (`ir.ui.view`). Štandardný `inherit_id` v XML spôsoboval problémy (duplicitné bloky, zlý rendering). Riešenie: priame prepísanie `arch_db` cez SQL v migration scriptoch.
- `hooks.py` → oprava `l10n_sk.vat_registry_tax_id_external_layout` (blok IČO/DIČ firmy)
- `migrations/19.0.2.0.4` → oprava `l10n_sk.report_invoice_document` (IČO/DIČ odberateľa)
- `migrations/19.0.2.0.5` → skrytie natívneho VAT `t-if` bloku v `web.external_layout_*` šablónach pre SK
- `migrations/19.0.2.0.6` → oprava VAT `t-else` bloku (2.0.5 opravila `t-if`, ale `t-else` zostal — renderoval prázdny "IČ DPH:" riadok)
### Podmienka zobrazovania
Všetky bloky IČO/DIČ sa zobrazujú len keď `company.account_fiscal_country_id.code == 'SK'` alebo `company_id.country_code == 'SK'`, takže modul neovplyvňuje zahraničné lokalizácie.
### Validácie
| Pole | Formát | Constraint |
|------|--------|------------|
| `company_registry` (IČO) | presne 8 číslic | `_check_ico` |
| `dic` (DIČ) | presne 10 číslic | `_check_dic` |
| `vat` (IČ DPH) | `SK` + 10 číslic | `_check_sk_vat` (len pre SK krajinu) |
### Automatické správanie
- `_onchange_vat_fill_dic` — pri zadaní IČ DPH automaticky vyplní DIČ (bez `SK` prefixu), ak je prázdne
- `is_vat_payer` — computed field, `True` ak `vat` začína `SK`
- `res_company.write()` — pri každom uložení firmy syncuje `partner.dic``company.income_tax_id`
## Závislosti
- `contacts` — základná správa kontaktov
- `account` — modul faktúr
- `l10n_sk` — slovenská lokalizácia (definuje šablóny, ktoré tento modul opravuje)
## Nasadenie
Modul je nasadený na produkčnom serveri `10.10.10.240`, databáza `seri_db`.
Po aktualizácii modulu spustiť:
```bash
# Na serveri
odoo -d seri_db -u l10n_sk_partner --stop-after-init
```
Migration scripty sa spustia automaticky pri upgrade keď sa zmení verzia v `__manifest__.py`.
## Časté problémy
**Duplicitný IČ DPH na faktúre** — vyriešené v `migrations/19.0.2.0.5` + `19.0.2.0.6`. 2.0.5 zmenila `t-if="not forced_vat"` na `t-if="not forced_vat and country != SK"`, ale `t-else` zostal a renderoval prázdny "IČ DPH:" riadok. 2.0.6 zmenila tento `t-else` na `t-if="forced_vat and country != SK"`. Ak sa objaví znovu po reinstalácii `web` modulu, treba zvýšiť verziu a upgradovať modul.
**Pozor na `\\n` v JSON texte pri migration scriptoch**`arch_db::text` obsahuje newline ako literálne `\n` (2 znaky: backslash + n), nie skutočný newline. V regex to treba matchovať ako `\\n`, v `replace()` ako Python string `'\\n'` (= `\\` + `n`). Práve preto zlyhala 2.0.5 — použila Python `'\n'` (skutočný newline) v regex patternu. Riešenie v 2.0.6: `replace()` s `_NL = '\\n'`.
**Rôzna indentácia v external_layout šablónach** — VAT blok má rôzny počet medzier po `\n` podľa layoutu: standard/bold/folder/striped/wave = 28, boxed = 32, bubble = 40. Pri replace() treba použiť správny počet medzier pre každý layout.
**`hooks.py` vs migration script** — `post_init_hook` sa spustí len pri prvej inštalácii. Pre opravy existujúcich inštalácií treba migration script s vyššou verziou.