← Back to CZ country layer · Country index

CZ RUIAN VFR building/address downloader and parser freeze

done synth-downloader

Task metadata

idt_e468ed5e
titleCZ RUIAN VFR building/address downloader and parser freeze
assigneesynth-downloader
statusdone
tenantsynthestat
priority80
workspace_kindscratch
workspace_path/home/synthestat/.hermes/kanban/boards/synthestat-population-qa/workspaces/t_e468ed5e
created_bysynth-marginals-researcher
created_at2026-05-19 20:24:42 CEST
started_at2026-05-19 20:26:45 CEST
completed_at2026-05-19 20:34:06 CEST

Latest summary

Froze CZ ČÚZK RÚIAN/VFR 202602 at national manifest plus verified sample-parser scope: 6,258 OB municipality package records, checksummed sample/dependency raw assets, parsed sample building/address tables, parsed ST_UCIS usage codelist, and updated downloader/manager handoffs. Full national OB payload mirroring/checksums remain explicitly flagged pending; `PocetBytu` capacity caveat is retained throughout.

Body

Follow-up from marginals task t_5b3ef51c. Implement/freeze the official ČÚZK RÚIAN/VFR building/address evidence for CZ national placement.

Inputs/handoffs:
- /home/synthestat/workspace/manager_handoffs/marginals/2026-05-19_1821_sources.md
- /home/synthestat/workspace/manager_handoffs/marginals/2026-05-19_1821_needs.md
- /home/synthestat/workspace/manager_handoffs/marginals/latest.md

Official endpoints/source IDs:
- VFR docs: https://cuzk.gov.cz/vfr
- VFR archive root: https://services.cuzk.gov.cz/vfr
- Frozen example month: https://services.cuzk.gov.cz/vfr/202602/
- OB package pattern: https://services.cuzk.gov.cz/vfr/{YYYYMM}/{YYYYMMDD}_OB_{obec_kod}_UKSH.xml.zip
- Codelists: https://services.cuzk.gov.cz/vfr/202602/20260203_ST_UCIS.xml.zip
- Address package: https://services.cuzk.gov.cz/vfr/202602/20260203_ST_UADS.xml.zip
- XSD ZIP: https://cuzk.gov.cz/ruian/Poskytovani-udaju-ISUI-RUIAN-VDP/Vymenny-format-RUIAN-(VFR)/2024_06_19_vf.aspx

Acceptance:
1. Mirror/catalogue target-month RÚIAN OB municipality package manifest with retrieval timestamps, file sizes, checksums, source URLs, package dates, licence/terms provenance, and quality flags.
2. Parse/build at least a verified sample or full national stream-ready table spec with building object ID, address ID, building-address link, obec code/name, usage code/label, `PocetBytu`, validity/transaction fields, geometry fields, and `Nespravny` handling.
3. Parse `ST_UCIS` residential usage codelist and XSD provenance.
4. Explicitly flag capacity caveat: RÚIAN `PocetBytu` is a registered flat-count attribute, not observed occupancy; missing/non-residential/recreational/accommodation cases must not be silently imputed.
5. Write downloader handoff under /home/synthestat/workspace/manager_handoffs/downloader/ and update latest.md.

Parents

[
  "t_5b3ef51c"
]

Children

[]

Runs

IDProfileStatusOutcomeStartedEndedSummary/error
115synth-downloaderdonecompleted2026-05-19 20:26:45 CEST2026-05-19 20:34:06 CESTFroze CZ ČÚZK RÚIAN/VFR 202602 at national manifest plus verified sample-parser scope: 6,258 OB municipality package records, checksummed sample/dependency raw assets, parsed sample building/address tables, parsed ST_UCIS usage codelist, and updated downloader/manager handoffs. Full national OB payload mirroring/checksums remain explicitly flagged pending; `PocetBytu` capacity caveat is retained throughout.

Events

TimeKindPayload
2026-05-19 20:24:42 CESTcreated{ "assignee": "synth-downloader", "status": "todo", "parents": [ "t_5b3ef51c" ], "tenant": "synthestat", "skills": null }
2026-05-19 20:26:05 CESTpromotednull
2026-05-19 20:26:45 CESTclaimed{ "lock": "vmi3188806:1590352", "expires": 1779216105, "run_id": 115 }
2026-05-19 20:26:46 CESTspawned{ "pid": 1685248 }
2026-05-19 20:34:06 CESTcompleted{ "result_len": 0, "summary": "Froze CZ ČÚZK RÚIAN/VFR 202602 at national manifest plus verified sample-parser scope: 6,258 OB municipality package records, checksummed sample/dependency raw assets, parsed sample building/address tables, parsed ST_UCIS usage codelist, and updated downloader/manager handoffs. Full national OB payload mirroring/checksums remain explicitly flagged pending; `PocetBytu` capacity caveat is retained t" }

Comments

No comments yet.