sysnet-persons-model 1.4.2__tar.gz → 1.6.0__tar.gz

{sysnet_persons_model-1.4.2 → sysnet_persons_model-1.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sysnet-persons-model
-Version: 1.4.2
+Version: 1.6.0
 Summary: SYSNET Persons Data Model
 Author-email: Data Developer <info@sysnet.cz>
 License-Expression: LicenseRef-SYSNET-FreeForHomeUse
@@ -18,12 +18,15 @@ Requires-Dist: sysnet-pyutils>=1.7.0
 Requires-Dist: pydantic[email]>=2.11.4
 Provides-Extra: dev
 Requires-Dist: pytest>=9.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.26; extra == "dev"
 Requires-Dist: build>=1.0; extra == "dev"
 Requires-Dist: twine>=5.0; extra == "dev"
 Dynamic: license-file
 
 # sysnet-persons-model
 
+![Verze 1.4.2](https://img.shields.io/badge/verze-1.4.2-blue)
+
 Data model pro entity a osoby v ekosystému SYSNET. Postaveno na Pydantic v2.
 
 ## Instalace
@@ -39,6 +42,7 @@ pip install sysnet-persons-model
 - **Opaque extension slot** (`agenda`) pro agendově specifická data.
 
 ## Verze
+- **1.4.2**: Oprava validace `ScopeType` — rozsah `GLOBAL` s neprázdným seznamem jurisdikcí nyní vyvolá Pydantic `ValidationError` se zprávou „Globální rozsah nesmí definovat jurisdikce.“ místo jejich tichého ignorování. Sjednocení souboru `VERSION` na `1.4.2` a přidání `pytest-asyncio>=0.26` do vývojových závislostí. Viz [CHANGELOG.md](CHANGELOG.md).
 - **1.3.0**: Přidání atributu `agenda` (opaque extension slot) do `IndividualBaseType` a `PersonEntityBaseType`. Viz [AGENDA_GUIDE.md](docs/AGENDA_GUIDE.md).
 - **1.2.8**: Interní verze, přidání atributu `agenda` (špatná cesta k docs).
 - **1.2.7**: Přidání aliasu `metadata` pro pole `document` (Redmine #9850).

{sysnet_persons_model-1.4.2 → sysnet_persons_model-1.6.0}/README.md

@@ -1,5 +1,7 @@
 # sysnet-persons-model
 
+![Verze 1.4.2](https://img.shields.io/badge/verze-1.4.2-blue)
+
 Data model pro entity a osoby v ekosystému SYSNET. Postaveno na Pydantic v2.
 
 ## Instalace
@@ -15,6 +17,7 @@ pip install sysnet-persons-model
 - **Opaque extension slot** (`agenda`) pro agendově specifická data.
 
 ## Verze
+- **1.4.2**: Oprava validace `ScopeType` — rozsah `GLOBAL` s neprázdným seznamem jurisdikcí nyní vyvolá Pydantic `ValidationError` se zprávou „Globální rozsah nesmí definovat jurisdikce.“ místo jejich tichého ignorování. Sjednocení souboru `VERSION` na `1.4.2` a přidání `pytest-asyncio>=0.26` do vývojových závislostí. Viz [CHANGELOG.md](CHANGELOG.md).
 - **1.3.0**: Přidání atributu `agenda` (opaque extension slot) do `IndividualBaseType` a `PersonEntityBaseType`. Viz [AGENDA_GUIDE.md](docs/AGENDA_GUIDE.md).
 - **1.2.8**: Interní verze, přidání atributu `agenda` (špatná cesta k docs).
 - **1.2.7**: Přidání aliasu `metadata` pro pole `document` (Redmine #9850).

{sysnet_persons_model-1.4.2 → sysnet_persons_model-1.6.0}/persons_model/__init__.py

@@ -4,6 +4,7 @@ from persons_model.common import (
     RedundantType,
     DepartmentType,
     ContactType,
+    ContactEntryType,
     MembershipEnum,
     MemberType,
     IssuingType,
@@ -20,7 +21,9 @@ from persons_model.legal_form import (
 from persons_model.person_entity import (
     PersonEntityLinkType,
     PersonEntityEntryType,
+    PersonEntityExtEntryType,
     PersonEntityListType,
+    PersonEntityExtListType,
     PersonEntityBaseType,
     PersonEntityType,
 )
@@ -34,6 +37,7 @@ __all__ = [
     'RedundantType',
     'DepartmentType',
     'ContactType',
+    'ContactEntryType',
     'MembershipEnum',
     'MemberType',
     'IssuingType',
@@ -58,7 +62,9 @@ __all__ = [
     # person_entity
     'PersonEntityLinkType',
     'PersonEntityEntryType',
+    'PersonEntityExtEntryType',
     'PersonEntityListType',
+    'PersonEntityExtListType',
     'PersonEntityBaseType',
     'PersonEntityType',
     # role

{sysnet_persons_model-1.4.2 → sysnet_persons_model-1.6.0}/persons_model/common.py

@@ -3,9 +3,12 @@ from __future__ import annotations
 from datetime import datetime
 from typing import List, Optional
 
-from pydantic import BaseModel, Field, StrictBool, field_validator
+from datetime import date
+
+from pydantic import BaseModel, Field, StrictBool, field_validator, model_validator
 from sysnet_pyutils.models.general import LocationType, PhoneNumberType, MailAddressType, BaseEnum
 
+from persons_model.dates import PureDate, sync_birth_fields
 from persons_model.tag import TagType
 
 
@@ -55,7 +58,39 @@ class ContactType(BaseModel):
     degree_before: Optional[List[Optional[str]]] = Field(default=None, description="Tituly před jménem")
     degree_after: Optional[List[Optional[str]]] = Field(default=None, description="Tituly za jménem")
     full_name: Optional[str] = Field(default=None, description="Celé jméno pro zobrazení a tisk")
-    birthdate: Optional[datetime] = Field(default=None, description="Datum narození")
+    birthdate: Optional[datetime] = Field(
+        default=None,
+        description="Datum narození jako okamžik (zastaralé, ponecháno kvůli zpětné kompatibilitě). "
+                    "Použijte birth_date.", json_schema_extra={'deprecated': True})
+    birth_date: Optional[PureDate] = Field(
+        default=None, description="Datum narození jako čisté datum (YYYY-MM-DD, bez času a zóny)")
+    phone: Optional[List[Optional[PhoneNumberType]]] = Field(default=None, description="Telefonní číslo")
+    phone_default: Optional[int] = Field(default=0, description="Index hlavního telefonního čísla", alias="phoneDefault")
+    email: Optional[List[Optional[MailAddressType]]] = Field(default=None, description="Elektronická pošta")
+    email_default: Optional[int] = Field(default=0, description="Index hlavní adresy elektronické pošty")
+    web: Optional[str] = Field(default=None, description="Webová stránka subjektu")
+    isds: Optional[str] = Field(default=None, description="Identifikátor datové schránky")
+    reference: Optional[str] = Field(default=None, description="identifikátor uuid")
+
+    @model_validator(mode='before')
+    @classmethod
+    def _sync_birth_fields(cls, data):
+        return sync_birth_fields(data)
+
+
+class ContactEntryType(BaseModel):
+    """
+    Kontaktní údaje ve výpisu (``GET /person?extended=true``).
+
+    Stejná pole a stejné aliasy jako ``ContactType``, **bez** ``birthdate`` — datum narození zástupce
+    nepatří do hromadného výpisu (minimalizace osobních údajů); je dostupné jen v detailu subjektu.
+    """
+    identifier: Optional[str] = Field(default=None, description="identifikátor uuid")
+    first_name: Optional[str] = Field(default=None, description="Křestní jméno")
+    last_name: Optional[str] = Field(default=None, description="Příjmení")
+    degree_before: Optional[List[Optional[str]]] = Field(default=None, description="Tituly před jménem")
+    degree_after: Optional[List[Optional[str]]] = Field(default=None, description="Tituly za jménem")
+    full_name: Optional[str] = Field(default=None, description="Celé jméno pro zobrazení a tisk")
     phone: Optional[List[Optional[PhoneNumberType]]] = Field(default=None, description="Telefonní číslo")
     phone_default: Optional[int] = Field(default=0, description="Index hlavního telefonního čísla", alias="phoneDefault")
     email: Optional[List[Optional[MailAddressType]]] = Field(default=None, description="Elektronická pošta")
@@ -130,8 +165,13 @@ class ScopeType(BaseModel):
     def validate_jurisdictions(cls, jurisdictions, info):
         level = info.data.get("level")
 
+        if level == ScopeLevelEnum.GLOBAL:
+            if jurisdictions:
+                raise ValueError("Globální rozsah nesmí definovat jurisdikce.")
+            return None
+
         # Úrovně s implicitním celým rozsahem — jurisdikce se nevyžadují ani nezakazují
-        BROAD_LEVELS = {ScopeLevelEnum.GLOBAL, ScopeLevelEnum.NATIONAL, ScopeLevelEnum.CONTINENTAL}
+        BROAD_LEVELS = {ScopeLevelEnum.NATIONAL, ScopeLevelEnum.CONTINENTAL}
 
         if level in BROAD_LEVELS:
             # Prázdné jurisdikce znamenají „celý rozsah dané úrovně" — jsou v pořádku

sysnet_persons_model-1.6.0/persons_model/dates.py

@@ -0,0 +1,87 @@
+"""
+Převod hodnot data narození na kalendářní datum (Redmine #10334).
+
+Registr osob dosud ukládal datum narození jako ``datetime`` (naivní, většinou půlnoc UTC). Klienti ale
+posílali různé tvary (``2000-01-02``, ``…T12:00:00``, ``…T22:00:00Z``), takže se den při převodech mezi
+Prahou a UTC posouval. Kalendářní datum zóny nemá; jediné pravidlo je zde:
+
+- hodnota **se zónou** (``Z``, ``+00:00``, …) → den v ``Europe/Prague``,
+- hodnota **bez zóny** (``date``, naivní ``datetime``, řetězec bez zóny) → den tak, jak je.
+"""
+from __future__ import annotations
+
+from datetime import date, datetime
+from typing import Annotated, Any, Optional
+from zoneinfo import ZoneInfo
+
+from pydantic import BeforeValidator
+
+PRAGUE = ZoneInfo("Europe/Prague")
+
+
+def to_calendar_date(value: Any) -> Optional[date]:
+    """Vrátí kalendářní datum z ``date``, ``datetime`` nebo ISO řetězce; ``None`` zůstane ``None``.
+
+    :raises ValueError: pokud hodnotu nelze přečíst jako datum.
+    """
+    if value is None or value == '':
+        return None
+    if isinstance(value, datetime):
+        if value.tzinfo is None:
+            return value.date()
+        try:
+            return value.astimezone(PRAGUE).date()
+        except OverflowError:
+            # okraj rozsahu (0001-01-01 / 9999-12-31): posun o zónu by přetekl, bereme den tak, jak je
+            return value.date()
+    if isinstance(value, date):
+        return value
+    if isinstance(value, str):
+        text = value.strip()
+        if text.endswith(('Z', 'z')):
+            text = text[:-1] + '+00:00'
+        if 'T' in text or ' ' in text:
+            try:
+                parsed = datetime.fromisoformat(text)
+            except ValueError as exc:
+                raise ValueError(f"Neplatné datum: {value!r}") from exc
+            return to_calendar_date(parsed)
+        try:
+            return date.fromisoformat(text)
+        except ValueError as exc:
+            raise ValueError(f"Neplatné datum: {value!r}") from exc
+    raise ValueError(f"Neplatné datum: {value!r}")
+
+
+def to_midnight(value: Optional[date]) -> Optional[datetime]:
+    """Půlnoc daného dne jako naivní ``datetime`` (kompatibilní tvar pro starší pole ``birthdate``)."""
+    if value is None:
+        return None
+    return datetime(value.year, value.month, value.day)
+
+
+PureDate = Annotated[date, BeforeValidator(to_calendar_date)]
+"""Kalendářní datum: ``date`` v modelu, ``YYYY-MM-DD`` v JSON, ``format: date`` v OpenAPI."""
+
+
+def sync_birth_fields(data: Any) -> Any:
+    """Sjednotí ``birth_date`` (nové, ``date``) a ``birthdate`` (staré, ``datetime``) při validaci vstupu.
+
+    - zadáno ``birth_date`` → platí a ``birthdate`` se dopočítá jako půlnoc téhož dne (bez zóny),
+    - zadáno jen ``birthdate`` → ``birth_date`` se dopočítá (zóna → den v Praze), ``birthdate`` zůstane beze změny,
+    - nezadáno nic → data se nemění (kvůli ``exclude_unset``).
+    Vstup se nemění na místě.
+    """
+    if not isinstance(data, dict):
+        return data
+    new_value = data.get('birth_date')
+    old_value = data.get('birthdate')
+    if new_value not in (None, ''):
+        day = to_calendar_date(new_value)
+        data = dict(data)
+        data['birth_date'] = day
+        data['birthdate'] = to_midnight(day)
+    elif old_value not in (None, ''):
+        data = dict(data)
+        data['birth_date'] = to_calendar_date(old_value)
+    return data

{sysnet_persons_model-1.4.2 → sysnet_persons_model-1.6.0}/persons_model/individual.py

@@ -3,10 +3,11 @@ from __future__ import annotations
 from datetime import datetime
 from typing import Any, List, Optional
 
-from pydantic import BaseModel, Field, SecretStr, StrictBool, AliasChoices
+from pydantic import BaseModel, Field, SecretStr, StrictBool, AliasChoices, model_validator
 from sysnet_pyutils.models.general import LocationType, ListTypeBase, MetadataEssentialType
 
 from persons_model.common import ContactType, RegistryType
+from persons_model.dates import PureDate, sync_birth_fields
 from persons_model.tag import TagType
 
 
@@ -23,11 +24,21 @@ class IndividualBaseType(BaseModel):
     address: Optional[List[Optional[LocationType]]] = Field(default=None, description='Seznam adres')
     address_default: Optional[int] = Field(default=0, description="Primární adresní údaje")
     address_printable: Optional[str] = Field(default=None, description="Adresa pro tisk")
-    birthdate: Optional[datetime] = Field(default=None, description="Datum narození")
+    birthdate: Optional[datetime] = Field(
+        default=None,
+        description="Datum narození jako okamžik (zastaralé, ponecháno kvůli zpětné kompatibilitě). "
+                    "Použijte birth_date.", json_schema_extra={'deprecated': True})
+    birth_date: Optional[PureDate] = Field(
+        default=None, description="Datum narození jako čisté datum (YYYY-MM-DD, bez času a zóny)")
     gdpr: Optional[StrictBool] = Field(default=True, description="Udělen souhlas se zpracováním dat GDPR")
     note: Optional[str] = Field(default=None, description='Libovolná poznámka')
     agenda: Optional[dict[str, dict[str, Any]]] = Field(default=None, description='Agendově specifická data. Klíč = kód agendy (hnvo, ippc, cites). Hodnota = libovolný objekt parsovaný konzumentem.')
 
+    @model_validator(mode='before')
+    @classmethod
+    def _sync_birth_fields(cls, data):
+        return sync_birth_fields(data)
+
 
 class IndividualEntryType(BaseModel):
     """

{sysnet_persons_model-1.4.2 → sysnet_persons_model-1.6.0}/persons_model/person_entity.py

@@ -3,11 +3,12 @@ from __future__ import annotations
 from datetime import datetime
 from typing import TYPE_CHECKING, Any, List, Optional, Union
 
-from pydantic import BaseModel, Field, StrictBool, AliasChoices
+from pydantic import BaseModel, Field, StrictBool, AliasChoices, model_validator
 from sysnet_pyutils.models.general import LocationType, PersonTypeEnum, ListTypeBase, MetadataEssentialType
 
-from persons_model.common import RedundantType, DepartmentType, ContactType, IssuingType, RegistryType, MemberType, ScopeType
+from persons_model.common import RedundantType, DepartmentType, ContactType, ContactEntryType, IssuingType, RegistryType, MemberType, ScopeType
 from persons_model.legal_form import LegalFormEnum, LegalFormType, make_legal_form, person_type_from_legal_form
+from persons_model.dates import PureDate, sync_birth_fields
 from persons_model.tag import TagType
 
 
@@ -43,6 +44,17 @@ class PersonEntityEntryType(BaseModel):
     registry: Optional[RegistryType] = Field(default=None, description="Vazba na referenční registr (CRŽP uuid)")
 
 
+class PersonEntityExtEntryType(PersonEntityEntryType):
+    """
+    Položka rozšířeného výpisu subjektů (``GET /person?extended=true``, Redmine #10281).
+
+    Ke standardní položce přidává kontakty a zástupce, aby je klient (katalog úřadů) nemusel načítat
+    z detailu každého subjektu zvlášť. Datum narození se ve výpisu nevrací.
+    """
+    contacts: Optional[List[Optional[ContactEntryType]]] = Field(default=None, description="Kontakty subjektu (e-mail, telefon, datová schránka, web)")
+    representative: Optional[ContactEntryType] = Field(default=None, description="Kontaktní osoba / zástupce subjektu")
+
+
 class PersonEntityListType(ListTypeBase):
     """
     Seznam vrácených subjektů
@@ -51,13 +63,26 @@ class PersonEntityListType(ListTypeBase):
     entries: Optional[List[Optional[PersonEntityEntryType]]] = Field(default=None, description='Položky seznamu')
 
 
+class PersonEntityExtListType(ListTypeBase):
+    """
+    Seznam subjektů s kontakty (``GET /person?extended=true``)
+    """
+    hits: Optional[int] = Field(default=None, description="celkový počet vybraných položek")
+    entries: Optional[List[Optional[PersonEntityExtEntryType]]] = Field(default=None, description='Položky seznamu')
+
+
 class PersonEntityBaseType(BaseModel):
     """
     Osoba, subjekt. Fyzická nebo právnická osoba.
     """ # noqa: E501
     code: Optional[str] = Field(default=None, description="Kód subjektu")
     ico: Optional[str] = Field(default=None, description="Jiný identifikátor (IČO)")
-    birthdate: Optional[datetime] = Field(default=None, description="Datum narození")
+    birthdate: Optional[datetime] = Field(
+        default=None,
+        description="Datum narození jako okamžik (zastaralé, ponecháno kvůli zpětné kompatibilitě). "
+                    "Použijte birth_date.", json_schema_extra={'deprecated': True})
+    birth_date: Optional[PureDate] = Field(
+        default=None, description="Datum narození jako čisté datum (YYYY-MM-DD, bez času a zóny)")
     person_type: Optional[PersonTypeEnum] = Field(default=None, description='Typ osoby (zdroj CRŽP)')
     legal_form: Optional[LegalFormType] = Field(default=None, description='Právní forma osoby (číselník EGON RPP); pole code = LegalFormEnum, pole name = český název')
     name: Optional[str] = Field(default=None, description="Název nebo jméno osoby")
@@ -74,6 +99,11 @@ class PersonEntityBaseType(BaseModel):
     scope: Optional[ScopeType] = Field(default=None, description="Rozsah působnosti subjektu")
     agenda: Optional[dict[str, dict[str, Any]]] = Field(default=None, description="Agendově specifická data. Klíč = kód agendy (hnvo, ippc, cites). Hodnota = libovolný objekt parsovaný konzumentem.")
 
+    @model_validator(mode='before')
+    @classmethod
+    def _sync_birth_fields(cls, data):
+        return sync_birth_fields(data)
+
     def set_legal_form(self, code: Union[LegalFormEnum, str]) -> "PersonEntityBaseType":
         """Nastaví atribut legal_form podle kódu právní formy.
 

{sysnet_persons_model-1.4.2 → sysnet_persons_model-1.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sysnet-persons-model"
-version = "1.4.2"
+version = "1.6.0"
 authors = [
   { name="Data Developer", email="info@sysnet.cz" },
 ]
@@ -28,6 +28,7 @@ dependencies = {file = ["requirements.txt"]}
 [project.optional-dependencies]
 dev = [
     "pytest>=9.0",
+    "pytest-asyncio>=0.26",
     "build>=1.0",
     "twine>=5.0",
 ]

{sysnet_persons_model-1.4.2 → sysnet_persons_model-1.6.0}/sysnet_persons_model.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sysnet-persons-model
-Version: 1.4.2
+Version: 1.6.0
 Summary: SYSNET Persons Data Model
 Author-email: Data Developer <info@sysnet.cz>
 License-Expression: LicenseRef-SYSNET-FreeForHomeUse
@@ -18,12 +18,15 @@ Requires-Dist: sysnet-pyutils>=1.7.0
 Requires-Dist: pydantic[email]>=2.11.4
 Provides-Extra: dev
 Requires-Dist: pytest>=9.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.26; extra == "dev"
 Requires-Dist: build>=1.0; extra == "dev"
 Requires-Dist: twine>=5.0; extra == "dev"
 Dynamic: license-file
 
 # sysnet-persons-model
 
+![Verze 1.4.2](https://img.shields.io/badge/verze-1.4.2-blue)
+
 Data model pro entity a osoby v ekosystému SYSNET. Postaveno na Pydantic v2.
 
 ## Instalace
@@ -39,6 +42,7 @@ pip install sysnet-persons-model
 - **Opaque extension slot** (`agenda`) pro agendově specifická data.
 
 ## Verze
+- **1.4.2**: Oprava validace `ScopeType` — rozsah `GLOBAL` s neprázdným seznamem jurisdikcí nyní vyvolá Pydantic `ValidationError` se zprávou „Globální rozsah nesmí definovat jurisdikce.“ místo jejich tichého ignorování. Sjednocení souboru `VERSION` na `1.4.2` a přidání `pytest-asyncio>=0.26` do vývojových závislostí. Viz [CHANGELOG.md](CHANGELOG.md).
 - **1.3.0**: Přidání atributu `agenda` (opaque extension slot) do `IndividualBaseType` a `PersonEntityBaseType`. Viz [AGENDA_GUIDE.md](docs/AGENDA_GUIDE.md).
 - **1.2.8**: Interní verze, přidání atributu `agenda` (špatná cesta k docs).
 - **1.2.7**: Přidání aliasu `metadata` pro pole `document` (Redmine #9850).

{sysnet_persons_model-1.4.2 → sysnet_persons_model-1.6.0}/sysnet_persons_model.egg-info/SOURCES.txt

@@ -7,6 +7,7 @@ persons_model/common.py
 persons_model/config.py
 persons_model/context.py
 persons_model/country.py
+persons_model/dates.py
 persons_model/individual.py
 persons_model/legal_form.py
 persons_model/person_entity.py
@@ -17,6 +18,7 @@ sysnet_persons_model.egg-info/SOURCES.txt
 sysnet_persons_model.egg-info/dependency_links.txt
 sysnet_persons_model.egg-info/requires.txt
 sysnet_persons_model.egg-info/top_level.txt
+tests/test_birth_date.py
 tests/test_common.py
 tests/test_config.py
 tests/test_context.py

{sysnet_persons_model-1.4.2 → sysnet_persons_model-1.6.0}/sysnet_persons_model.egg-info/requires.txt

@@ -3,5 +3,6 @@ pydantic[email]>=2.11.4
 
 [dev]
 pytest>=9.0
+pytest-asyncio>=0.26
 build>=1.0
 twine>=5.0

sysnet_persons_model-1.6.0/tests/test_birth_date.py

@@ -0,0 +1,155 @@
+"""
+Testy pole ``birth_date`` (čisté datum) vedle ``birthdate`` (datetime) — Redmine #10334, cesta C.
+
+Pravidla:
+- ``birth_date`` je kalendářní datum (``datetime.date``), v JSON ``YYYY-MM-DD``, v OpenAPI ``format: date``.
+- Hodnota se zónou (``Z``, ``+00:00``) se převádí na den v ``Europe/Prague``; hodnota bez zóny se bere tak, jak je.
+- ``birthdate`` zůstává kvůli zpětné kompatibilitě; při vstupu jen s ním se ``birth_date`` dopočítá,
+  při vstupu jen s ``birth_date`` se ``birthdate`` dopočítá jako půlnoc téhož dne (bez zóny, jako dosud).
+- Pokud přijdou obě pole, platí ``birth_date`` (nové pole má přednost).
+"""
+from datetime import date, datetime
+
+import pytest
+
+from persons_model.common import ContactType
+from persons_model.dates import to_calendar_date
+from persons_model.individual import IndividualBaseType, IndividualType
+from persons_model.person_entity import PersonEntityBaseType, PersonEntityType
+
+TYPES = [ContactType, IndividualBaseType, IndividualType, PersonEntityBaseType, PersonEntityType]
+
+
+class TestToCalendarDate:
+    @pytest.mark.parametrize("raw, expected", [
+        ("1972-08-26", date(1972, 8, 26)),
+        ("1972-08-26T00:00:00", date(1972, 8, 26)),
+        ("1972-08-26T12:00:00", date(1972, 8, 26)),
+        ("1972-08-26 12:00:00", date(1972, 8, 26)),
+        # hodnoty se zónou: den v pražském čase. V roce 1972 platilo SEČ (UTC+1) i v létě,
+        # letní čas byl zaveden až 1979 — zoneinfo to ví.
+        ("1972-08-26T00:00:00Z", date(1972, 8, 26)),       # 01:00 SEČ
+        ("1972-08-25T22:00:00Z", date(1972, 8, 25)),       # 23:00 SEČ 25. 8.
+        ("1972-08-25T23:00:00Z", date(1972, 8, 26)),       # 00:00 SEČ 26. 8.
+        ("1972-12-31T23:00:00Z", date(1973, 1, 1)),        # 00:00 SEČ
+        ("1972-12-31T22:00:00Z", date(1972, 12, 31)),
+        ("1972-08-26T00:00:00+01:00", date(1972, 8, 26)),  # zóna odpovídá Praze
+        (datetime(1972, 8, 26, 0, 0), date(1972, 8, 26)),
+        (datetime(1972, 8, 26, 12, 0), date(1972, 8, 26)),
+        (date(1972, 8, 26), date(1972, 8, 26)),
+        (None, None),
+    ])
+    def test_prevod(self, raw, expected):
+        assert to_calendar_date(raw) == expected
+
+    def test_letni_cas_po_roce_1979(self):
+        # 1990-07-14T22:00Z = 00:00 SELČ 15. 7. (u dat z portálu typický případ „22:00Z“)
+        assert to_calendar_date("1990-07-14T22:00:00Z") == date(1990, 7, 15)
+        # zimní 23:00Z = 00:00 SEČ
+        assert to_calendar_date("1990-01-14T23:00:00Z") == date(1990, 1, 15)
+        # hranice letního času po roce 1979: 21:00Z je ještě 23:00 SELČ téhož dne
+        assert to_calendar_date("1990-07-14T21:00:00Z") == date(1990, 7, 14)
+
+    def test_krajni_roky_nepadaji(self):
+        assert to_calendar_date("0172-08-26T00:00:00Z").year == 172
+        # okraje rozsahu datetime: posun o pražskou zónu by přetekl, vrací se den z hodnoty
+        assert to_calendar_date("9999-12-31T23:00:00Z") == date(9999, 12, 31)
+        assert to_calendar_date("0001-01-01T00:00:00Z") == date(1, 1, 1)
+        # v datech CITES jsou i roky jako 6666 — běžný převod
+        assert to_calendar_date("6666-08-26T22:00:00Z") == date(6666, 8, 27)
+
+    def test_neplatna_hodnota(self):
+        with pytest.raises(ValueError):
+            to_calendar_date("není datum")
+
+
+@pytest.mark.parametrize("cls", TYPES)
+class TestBirthDatePole:
+    def test_vychozi_hodnoty(self, cls):
+        o = cls()
+        assert o.birth_date is None
+        assert o.birthdate is None
+
+    def test_jen_birth_date_dopocita_birthdate(self, cls):
+        o = cls(birth_date="1972-08-26")
+        assert o.birth_date == date(1972, 8, 26)
+        assert o.birthdate == datetime(1972, 8, 26, 0, 0)
+        assert o.birthdate.tzinfo is None
+
+    def test_jen_birthdate_dopocita_birth_date(self, cls):
+        o = cls(birthdate="1972-08-26T12:00:00")
+        assert o.birth_date == date(1972, 8, 26)
+
+    def test_birthdate_se_zonou_je_den_v_praze(self, cls):
+        o = cls(birthdate="1990-07-14T22:00:00Z")
+        assert o.birth_date == date(1990, 7, 15)
+
+    def test_obe_pole_birth_date_ma_prednost(self, cls):
+        o = cls(birth_date="1972-08-26", birthdate="1972-08-25T22:00:00Z")
+        assert o.birth_date == date(1972, 8, 26)
+        assert o.birthdate == datetime(1972, 8, 26, 0, 0)
+
+    def test_birth_date_prijima_i_datetime_tvary(self, cls):
+        assert cls(birth_date="1972-08-26T12:00:00").birth_date == date(1972, 8, 26)
+        assert cls(birth_date="1990-07-14T22:00:00Z").birth_date == date(1990, 7, 15)
+
+    def test_json_je_cisty_datum(self, cls):
+        o = cls(birth_date="1972-08-26")
+        import json
+        dumped = json.loads(o.model_dump_json())
+        assert dumped["birth_date"] == "1972-08-26"
+        assert dumped["birthdate"] == "1972-08-26T00:00:00"
+
+    def test_openapi_schema_format_date(self, cls):
+        prop = cls.model_json_schema()["properties"]["birth_date"]
+        formats = [p.get("format") for p in prop.get("anyOf", [prop])]
+        assert "date" in formats
+        assert "date-time" not in formats
+
+    def test_exclude_unset_nezanese_nepouzite_pole(self, cls):
+        # PUT s částečným tělem: nepoužité pole se nesmí objevit jako None v exclude_unset dumpu
+        o = cls(name="x") if "name" in cls.model_fields else cls()
+        assert "birth_date" not in o.model_dump(exclude_unset=True)
+
+    def test_neplatne_datum_je_chyba(self, cls):
+        with pytest.raises(ValueError):
+            cls(birth_date="32.13.1972")
+
+    def test_roundtrip_dump_validate(self, cls):
+        o = cls(birth_date="1972-08-26")
+        again = cls.model_validate(o.model_dump())
+        assert again.birth_date == date(1972, 8, 26)
+        again2 = cls.model_validate_json(o.model_dump_json())
+        assert again2.birth_date == date(1972, 8, 26)
+
+
+def test_vnorene_kontakty_maji_birth_date():
+    p = PersonEntityType(
+        representative={"birthdate": "1990-07-14T22:00:00Z"},
+        contacts=[{"birth_date": "1980-01-02"}],
+    )
+    assert p.representative.birth_date == date(1990, 7, 15)
+    assert p.contacts[0].birthdate == datetime(1980, 1, 2, 0, 0)
+
+
+def test_stare_ulozene_hodnoty_z_mongo_se_nactou():
+    """Mongo vrací naivní datetime (UTC půlnoc) — načtení nesmí selhat a den zůstane."""
+    o = IndividualType(birthdate=datetime(1972, 8, 26, 0, 0))
+    assert o.birth_date == date(1972, 8, 26)
+
+
+@pytest.mark.parametrize("cls", TYPES)
+def test_cteni_birthdate_nevyvolava_varovani(cls):
+    """Staré pole je v OpenAPI označeno jako deprecated, ale čtení atributu nesmí hlásit DeprecationWarning."""
+    import warnings
+    o = cls(birthdate="1972-08-26")
+    with warnings.catch_warnings():
+        warnings.simplefilter("error")
+        assert o.birthdate == datetime(1972, 8, 26, 0, 0)
+
+
+@pytest.mark.parametrize("cls", TYPES)
+def test_openapi_birthdate_je_deprecated(cls):
+    schema = cls.model_json_schema()["properties"]
+    assert schema["birthdate"].get("deprecated") is True
+    assert not schema["birth_date"].get("deprecated")

{sysnet_persons_model-1.4.2 → sysnet_persons_model-1.6.0}/tests/test_person_entity.py

@@ -6,6 +6,8 @@ from sysnet_pyutils.models.general import LocationType, PersonTypeEnum
 from persons_model.person_entity import (
     PersonEntityLinkType,
     PersonEntityEntryType,
+    PersonEntityExtEntryType,
+    PersonEntityExtListType,
     PersonEntityListType,
     PersonEntityBaseType,
     PersonEntityType
@@ -40,6 +42,49 @@ class TestPersonEntityEntryType:
         assert p.is_admin == True
 
 
+class TestPersonEntityExtEntryType:
+    """#10281 — rozšířený výpis: kontakty + zástupce, bez data narození."""
+
+    def test_je_rozsirenim_standardni_polozky(self):
+        assert set(PersonEntityEntryType.model_fields) < set(PersonEntityExtEntryType.model_fields)
+        assert set(PersonEntityExtEntryType.model_fields) - set(PersonEntityEntryType.model_fields) == {"contacts", "representative"}
+
+    def test_prazdny(self):
+        p = PersonEntityExtEntryType()
+        assert p.contacts is None and p.representative is None
+
+    def test_kontakty_a_zastupce(self):
+        raw = {"identifier": "u1", "name": "Úřad", "contacts": [{"email": [{"name": None, "email": "a@b.cz"}], "isds": "bbb666",
+               "web": "http://x.cz", "phone": [{"number": "606111222"}], "phoneDefault": 0}],
+               "representative": {"full_name": "Přemysl Ďáblík", "birthdate": "1970-01-01T00:00:00", "email": [{"email": "d@h.cz"}]}}
+        p = PersonEntityExtEntryType(**raw)
+        assert p.contacts[0].isds == "bbb666" and p.contacts[0].email[0].email == "a@b.cz"
+        assert p.contacts[0].phone[0].number == "606111222"
+        assert p.representative.full_name == "Přemysl Ďáblík"
+
+    def test_datum_narozeni_se_do_vypisu_nedostane(self):
+        p = PersonEntityExtEntryType(identifier="u1", representative={"full_name": "X", "birthdate": "1970-01-01T00:00:00"})
+        assert not hasattr(p.representative, "birthdate")
+        assert "birthdate" not in p.model_dump()["representative"]
+        assert "birthdate" not in p.model_dump(by_alias=True)["representative"]
+
+    def test_alias_phoneDefault_ve_vystupu(self):
+        p = PersonEntityExtEntryType(identifier="u1", contacts=[{"phoneDefault": 1}])
+        assert p.model_dump(by_alias=True)["contacts"][0]["phoneDefault"] == 1
+
+    def test_plny_model_se_do_vypisu_prevede(self):
+        """DbPerson.model_dump() obsahuje contacts s birthdate a další pole — Pydantic je tiše zahodí."""
+        full = PersonEntityType(identifier="u1", name="Úřad", contacts=[{"isds": "x", "birthdate": "1970-01-01T00:00:00"}],
+                                representative={"full_name": "Z", "birthdate": "1970-01-01T00:00:00"}, note="interní")
+        e = PersonEntityExtEntryType(**full.model_dump())
+        assert e.contacts[0].isds == "x" and e.representative.full_name == "Z"
+        assert not hasattr(e, "note")
+
+    def test_list(self):
+        l = PersonEntityExtListType(hits=1, entries=[PersonEntityExtEntryType(identifier="u1")])
+        assert l.hits == 1 and l.entries[0].identifier == "u1"
+
+
 class TestPersonEntityType:
     def test_prazdny(self):
         p = PersonEntityType()