megaplan-sdk 0.2.1__tar.gz → 0.2.2__tar.gz

{megaplan_sdk-0.2.1/src/megaplan_sdk.egg-info → megaplan_sdk-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: megaplan-sdk
-Version: 0.2.1
+Version: 0.2.2
 Summary: Professional Python SDK for Megaplan API v3
 Author-email: Maxim Borzov <max@borzov.com>
 License-Expression: MIT
@@ -314,7 +314,7 @@ entity = await client.{resource}.update(
 ```python
 task = await client.tasks.update(task_id=42, task_data={"status": "completed"})
 project = await client.projects.update(project_id=5, project_data={"name": "Новое название"})
-deal = await client.deals.update(deal_id=200, deal_data={"sum_base": 60000.0})
+deal = await client.deals.update(deal_id=200, deal_data={"price": {"currency": "RUB", "value": 60000}})
 ```
 
 #### Удаление (`delete`)
@@ -517,8 +517,8 @@ tasks = await client.tasks.list(filter=filter_obj)
 - `tags: list[BaseEntity]` - Теги
 - `attaches: list[BaseEntity]` - Вложения (файлы)
 - `todos: list[BaseEntity]` - Подзадачи-чеклисты
-- `created_at: str` - Дата создания
-- `updated_at: str` - Дата обновления
+- `time_created: str` - Дата создания (API поле `timeCreated`)
+- `time_updated: str` - Дата обновления (API поле `timeUpdated`)
 
 ### Упрощенные методы создания
 
@@ -775,8 +775,8 @@ milestone = await client.projects.add_milestone(
 - `tags: list[BaseEntity]` - Теги
 - `attaches: list[BaseEntity]` - Вложения
 - `todos: list[BaseEntity]` - Подзадачи-чеклисты
-- `created_at: str` - Дата создания
-- `updated_at: str` - Дата обновления
+- `time_created: str` - Дата создания (API поле `timeCreated`)
+- `time_updated: str` - Дата обновления (API поле `timeUpdated`)
 
 ### Упрощенные методы создания
 
@@ -967,18 +967,26 @@ deals = await client.deals.list(filter=filter_obj)
 ### Поля модели Deal
 - `id: int` - Идентификатор сделки
 - `name: str` - Название сделки
+- `number: str` - Номер сделки
+- `short_description: str` - Краткое описание
 - `program: BaseEntity` - Программа (схема сделки)
 - `state: ProgramState` - Текущий статус в программе
 - `contractor: BaseEntity` - Контрагент (ContractorCompany/ContractorHuman)
-- `responsible: BaseEntity` - Ответственный (Employee)
-- `sum_base: float` - Сумма сделки
+- `manager: BaseEntity` - Ответственный (Employee, API поле `manager`)
+- `price: Money` - Сумма сделки (объект с полями `currency`, `value`)
+- `cost: Money` - Стоимость
+- `debt: Money` - Долг
+- `result: str` - Результат (`"positive"`, `"negative"`, `null`)
 - `currency: BaseEntity` - Валюта
 - `deadline: str` - Срок
-- `description: str` - Описание
+- `description: str` - Описание (только в `deals.get()`, не в списке)
 - `tags: list[BaseEntity]` - Теги
 - `attaches: list[BaseEntity]` - Вложения
-- `created_at: str` - Дата создания
-- `updated_at: str` - Дата обновления
+- `time_created: str` - Дата создания (API поле `timeCreated`)
+- `time_updated: str` - Дата обновления (API поле `timeUpdated`)
+- `state_time_updated: str` - Дата последнего изменения статуса
+
+> **Примечание:** Поля `description`, `deadline` и пользовательские поля доступны только при запросе отдельной сделки через `deals.get(id)`, но не в списке.
 
 **Важно:** При создании сделки обязательно указывать поле `program` (программа/схема сделки).
 
@@ -1063,7 +1071,7 @@ details = await client.deals.get_full_details(
     include_history=True,                  # Загрузить историю изменений
     include_status_history=True,           # Загрузить историю статусов
     include_auditors=True,                  # Загрузить список аудиторов
-    include_responsible_details=True,      # Загрузить полные данные ответственного
+    include_manager_details=True,          # Загрузить полные данные ответственного
     include_contractor_details=True,       # Загрузить полные данные контрагента
     include_related_tasks=True,            # Загрузить связанные задачи
     comments_limit=50,                     # Лимит комментариев (опционально)
@@ -1077,7 +1085,7 @@ details = await client.deals.get_full_details(
 - `history: list[dict] | None` - История изменений
 - `status_history: list[dict] | None` - История статусов
 - `auditors: list[dict] | None` - Аудиторы
-- `responsible_details: Employee | None` - Полные данные ответственного
+- `manager_details: Employee | None` - Полные данные ответственного
 - `contractor_details: Contractor | None` - Полные данные контрагента
 - `related_tasks: list[Task] | None` - Связанные задачи
 
@@ -1278,14 +1286,14 @@ for task_full in tasks_full:
 ### Использование expand в сделках
 
 ```python
-deals_full = await client.deals.list(limit=10, expand=["responsible", "contractor"])
+deals_full = await client.deals.list(limit=10, expand=["manager", "contractor"])
 
 for deal_full in deals_full:
     deal = deal_full.deal
     print(f"Сделка: {deal.name}")
 
-    if deal_full.responsible_details:
-        print(f"Ответственный: {deal_full.responsible_details.display_name()}")
+    if deal_full.manager_details:
+        print(f"Ответственный: {deal_full.manager_details.display_name()}")
 
     if deal_full.contractor_details:
         print(f"Контрагент: {deal_full.contractor_details.display_name()}")
@@ -1296,7 +1304,7 @@ for deal_full in deals_full:
 ```
 
 **Поддерживаемые поля для expand в сделках:**
-- `responsible` - ответственный сотрудник
+- `manager` - ответственный сотрудник
 - `contractor` - контрагент
 
 ### Использование expand в проектах

{megaplan_sdk-0.2.1 → megaplan_sdk-0.2.2}/README.md

@@ -282,7 +282,7 @@ entity = await client.{resource}.update(
 ```python
 task = await client.tasks.update(task_id=42, task_data={"status": "completed"})
 project = await client.projects.update(project_id=5, project_data={"name": "Новое название"})
-deal = await client.deals.update(deal_id=200, deal_data={"sum_base": 60000.0})
+deal = await client.deals.update(deal_id=200, deal_data={"price": {"currency": "RUB", "value": 60000}})
 ```
 
 #### Удаление (`delete`)
@@ -485,8 +485,8 @@ tasks = await client.tasks.list(filter=filter_obj)
 - `tags: list[BaseEntity]` - Теги
 - `attaches: list[BaseEntity]` - Вложения (файлы)
 - `todos: list[BaseEntity]` - Подзадачи-чеклисты
-- `created_at: str` - Дата создания
-- `updated_at: str` - Дата обновления
+- `time_created: str` - Дата создания (API поле `timeCreated`)
+- `time_updated: str` - Дата обновления (API поле `timeUpdated`)
 
 ### Упрощенные методы создания
 
@@ -743,8 +743,8 @@ milestone = await client.projects.add_milestone(
 - `tags: list[BaseEntity]` - Теги
 - `attaches: list[BaseEntity]` - Вложения
 - `todos: list[BaseEntity]` - Подзадачи-чеклисты
-- `created_at: str` - Дата создания
-- `updated_at: str` - Дата обновления
+- `time_created: str` - Дата создания (API поле `timeCreated`)
+- `time_updated: str` - Дата обновления (API поле `timeUpdated`)
 
 ### Упрощенные методы создания
 
@@ -935,18 +935,26 @@ deals = await client.deals.list(filter=filter_obj)
 ### Поля модели Deal
 - `id: int` - Идентификатор сделки
 - `name: str` - Название сделки
+- `number: str` - Номер сделки
+- `short_description: str` - Краткое описание
 - `program: BaseEntity` - Программа (схема сделки)
 - `state: ProgramState` - Текущий статус в программе
 - `contractor: BaseEntity` - Контрагент (ContractorCompany/ContractorHuman)
-- `responsible: BaseEntity` - Ответственный (Employee)
-- `sum_base: float` - Сумма сделки
+- `manager: BaseEntity` - Ответственный (Employee, API поле `manager`)
+- `price: Money` - Сумма сделки (объект с полями `currency`, `value`)
+- `cost: Money` - Стоимость
+- `debt: Money` - Долг
+- `result: str` - Результат (`"positive"`, `"negative"`, `null`)
 - `currency: BaseEntity` - Валюта
 - `deadline: str` - Срок
-- `description: str` - Описание
+- `description: str` - Описание (только в `deals.get()`, не в списке)
 - `tags: list[BaseEntity]` - Теги
 - `attaches: list[BaseEntity]` - Вложения
-- `created_at: str` - Дата создания
-- `updated_at: str` - Дата обновления
+- `time_created: str` - Дата создания (API поле `timeCreated`)
+- `time_updated: str` - Дата обновления (API поле `timeUpdated`)
+- `state_time_updated: str` - Дата последнего изменения статуса
+
+> **Примечание:** Поля `description`, `deadline` и пользовательские поля доступны только при запросе отдельной сделки через `deals.get(id)`, но не в списке.
 
 **Важно:** При создании сделки обязательно указывать поле `program` (программа/схема сделки).
 
@@ -1031,7 +1039,7 @@ details = await client.deals.get_full_details(
     include_history=True,                  # Загрузить историю изменений
     include_status_history=True,           # Загрузить историю статусов
     include_auditors=True,                  # Загрузить список аудиторов
-    include_responsible_details=True,      # Загрузить полные данные ответственного
+    include_manager_details=True,          # Загрузить полные данные ответственного
     include_contractor_details=True,       # Загрузить полные данные контрагента
     include_related_tasks=True,            # Загрузить связанные задачи
     comments_limit=50,                     # Лимит комментариев (опционально)
@@ -1045,7 +1053,7 @@ details = await client.deals.get_full_details(
 - `history: list[dict] | None` - История изменений
 - `status_history: list[dict] | None` - История статусов
 - `auditors: list[dict] | None` - Аудиторы
-- `responsible_details: Employee | None` - Полные данные ответственного
+- `manager_details: Employee | None` - Полные данные ответственного
 - `contractor_details: Contractor | None` - Полные данные контрагента
 - `related_tasks: list[Task] | None` - Связанные задачи
 
@@ -1246,14 +1254,14 @@ for task_full in tasks_full:
 ### Использование expand в сделках
 
 ```python
-deals_full = await client.deals.list(limit=10, expand=["responsible", "contractor"])
+deals_full = await client.deals.list(limit=10, expand=["manager", "contractor"])
 
 for deal_full in deals_full:
     deal = deal_full.deal
     print(f"Сделка: {deal.name}")
 
-    if deal_full.responsible_details:
-        print(f"Ответственный: {deal_full.responsible_details.display_name()}")
+    if deal_full.manager_details:
+        print(f"Ответственный: {deal_full.manager_details.display_name()}")
 
     if deal_full.contractor_details:
         print(f"Контрагент: {deal_full.contractor_details.display_name()}")
@@ -1264,7 +1272,7 @@ for deal_full in deals_full:
 ```
 
 **Поддерживаемые поля для expand в сделках:**
-- `responsible` - ответственный сотрудник
+- `manager` - ответственный сотрудник
 - `contractor` - контрагент
 
 ### Использование expand в проектах

{megaplan_sdk-0.2.1 → megaplan_sdk-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "megaplan-sdk"
-version = "0.2.1"
+version = "0.2.2"
 description = "Professional Python SDK for Megaplan API v3"
 readme = "README.md"
 requires-python = ">=3.11"

{megaplan_sdk-0.2.1 → megaplan_sdk-0.2.2}/src/megaplan_sdk/__init__.py

@@ -26,7 +26,7 @@ from megaplan_sdk.helpers import (
 )
 from megaplan_sdk.logging_config import setup_logging
 from megaplan_sdk.models.comment import Comment
-from megaplan_sdk.models.common import DateTime
+from megaplan_sdk.models.common import DateTime, Money
 from megaplan_sdk.models.contractor import Contractor, ContractorCompany, ContractorHuman
 from megaplan_sdk.models.deal import Deal, DealFullDetails
 from megaplan_sdk.models.department import Department
@@ -66,6 +66,7 @@ __all__ = [
     "Deal",
     "DealFullDetails",
     "Comment",
+    "Money",
     "Contractor",
     "ContractorCompany",
     "ContractorHuman",
@@ -102,4 +103,4 @@ __all__ = [
     "ProjectFilterBuilder",
 ]
 
-__version__ = "0.1.0"
+__version__ = "0.2.2"

megaplan_sdk-0.2.2/src/megaplan_sdk/models/base.py

@@ -0,0 +1,27 @@
+"""Base models for Megaplan SDK."""
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class BaseEntity(BaseModel):
+    """Base entity with contentType, id, and optional name.
+
+    All Megaplan entities have ``contentType`` and ``id`` fields.
+    Many API responses also include a ``name`` field even in reference
+    objects, so it is captured here to avoid silent data loss.
+
+    Unknown fields from the API are preserved in ``model_extra`` via
+    ``extra="allow"``, which enables forward compatibility and prevents
+    silent data loss when the API returns new fields.
+
+    Attributes:
+        content_type: Entity type identifier (e.g., "Employee", "Task").
+        id: Entity numeric identifier.
+        name: Optional display name returned by the API in many contexts.
+    """
+
+    content_type: str = Field(alias="contentType")
+    id: int
+    name: str | None = None
+
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

{megaplan_sdk-0.2.1 → megaplan_sdk-0.2.2}/src/megaplan_sdk/models/comment.py

@@ -40,4 +40,4 @@ class Comment(BaseEntity, TimestampMixin):
     is_dropped: bool | None = Field(alias="isDropped", default=None)
     completed: int | None = None
 
-    model_config = ConfigDict(populate_by_name=True, extra="ignore")
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

{megaplan_sdk-0.2.1 → megaplan_sdk-0.2.2}/src/megaplan_sdk/models/common.py

@@ -50,7 +50,7 @@ class File(BaseModel):
     name: str | None = None
     size: int | None = None
 
-    model_config = ConfigDict(populate_by_name=True, extra="ignore")
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
 
 
 class DateTime(BaseModel):
@@ -66,7 +66,37 @@ class DateTime(BaseModel):
     content_type: str = Field(alias="contentType", default="DateTime")
     value: str
 
-    model_config = ConfigDict(populate_by_name=True, extra="ignore")
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+
+class Money(BaseModel):
+    """Money model for monetary value fields.
+
+    Megaplan API returns monetary values as structured objects with
+    currency, value, and optional exchange rate information.
+
+    Attributes:
+        content_type: Always "Money".
+        currency: ISO 4217 currency code (e.g., "RUB", "USD").
+        value: Amount in the original currency.
+        value_in_main: Amount converted to the main company currency.
+        rate: Exchange rate relative to the main currency.
+
+    Example:
+        >>> money = Money(contentType="Money", currency="RUB", value=18055000)
+        >>> money.value
+        18055000
+        >>> money.currency
+        'RUB'
+    """
+
+    content_type: str = Field(alias="contentType", default="Money")
+    currency: str = ""
+    value: float | int | None = None
+    value_in_main: float | int | None = Field(None, alias="valueInMain")
+    rate: float | None = None
+
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
 
 
 class SortField(BaseModel):
@@ -84,10 +114,13 @@ class SortField(BaseModel):
 class TimestampMixin(BaseModel):
     """Mixin for entities with creation and update timestamps.
 
+    Megaplan API returns timestamps using the field names ``timeCreated``
+    and ``timeUpdated`` (not ``createdAt``/``updatedAt``).
+
     Attributes:
-        created_at: Entity creation timestamp.
-        updated_at: Entity last update timestamp.
+        time_created: Entity creation timestamp (API field: ``timeCreated``).
+        time_updated: Entity last update timestamp (API field: ``timeUpdated``).
     """
 
-    created_at: str | DateTime | None = Field(alias="createdAt", default=None)
-    updated_at: str | DateTime | None = Field(alias="updatedAt", default=None)
+    time_created: str | DateTime | None = Field(alias="timeCreated", default=None)
+    time_updated: str | DateTime | None = Field(alias="timeUpdated", default=None)

{megaplan_sdk-0.2.1 → megaplan_sdk-0.2.2}/src/megaplan_sdk/models/contractor.py

@@ -40,7 +40,7 @@ class Contractor(BaseEntity, TimestampMixin):
     tags: list[BaseEntity | str] | None = None  # Can be Tag entities or strings
     custom_fields: dict[str, Any] | None = Field(alias="customFields", default=None)
 
-    model_config = ConfigDict(populate_by_name=True, extra="ignore")
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
 
     def display_name(self) -> str:
         """Get display name for contractor.

{megaplan_sdk-0.2.1 → megaplan_sdk-0.2.2}/src/megaplan_sdk/models/deal.py

@@ -7,7 +7,7 @@ from typing import Any
 from pydantic import BaseModel, ConfigDict, Field
 
 from megaplan_sdk.models.base import BaseEntity
-from megaplan_sdk.models.common import DateTime, TimestampMixin
+from megaplan_sdk.models.common import DateTime, Money, TimestampMixin
 
 
 class TradeFilter(BaseModel):
@@ -24,6 +24,12 @@ class ProgramState(BaseModel):
     """Program state model.
 
     Represents a state in a deal program.
+
+    Note:
+        The ``name`` field may be absent in list endpoint responses.
+        In that case ``str(state)`` falls back to ``"State#<id>"``.
+        Use ``client.deals.get(deal_id)`` to retrieve the full state object
+        with the name populated.
     """
 
     id: int
@@ -31,7 +37,7 @@ class ProgramState(BaseModel):
     name: str | None = None
     program: BaseEntity | None = None
 
-    model_config = ConfigDict(populate_by_name=True, extra="ignore")
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
 
     def __str__(self) -> str:
         """Return state name for display.
@@ -51,23 +57,43 @@ class Deal(TimestampMixin):
     """Deal model.
 
     Represents a deal in Megaplan with all its properties.
+
+    Note:
+        The list endpoint (``GET /api/v3/deal``) returns a subset of fields
+        compared to the single-entity endpoint (``GET /api/v3/deal/{id}``).
+        Fields like ``description``, ``deadline``, ``invoices``, and custom
+        category fields are only available via ``client.deals.get(deal_id)``.
+
+        When using the ``fields`` parameter in ``list()``, use the actual
+        API field names: ``manager``, ``price``, ``timeCreated``, etc.
+
+        Unknown API fields are preserved in ``model_extra`` (``extra="allow"``).
     """
 
     id: int
     content_type: str = Field(alias="contentType", default="Deal")
     name: str | None = None
+    number: str | None = None
+    short_description: str | None = Field(None, alias="shortDescription")
+    description: str | None = None
+
+    manager: BaseEntity | None = None
     program: BaseEntity | None = None
     state: ProgramState | None = None
     contractor: BaseEntity | None = None
-    responsible: BaseEntity | None = None
-    sum_base: float | None = Field(alias="sumBase", default=None)
     currency: BaseEntity | None = None
-    deadline: str | DateTime | dict[str, Any] | None = None  # Can be DateOnly, DateTime, or string
-    description: str | None = None
+
+    price: Money | None = None
+    cost: Money | None = None
+    debt: Money | None = None
+
+    result: str | None = None
+    state_time_updated: str | DateTime | None = Field(None, alias="stateTimeUpdated")
+    deadline: str | DateTime | dict[str, Any] | None = None
     tags: list[BaseEntity] | None = None
     attaches: list[BaseEntity] | None = None
 
-    model_config = ConfigDict(populate_by_name=True, extra="ignore")
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
 
 
 class DealFullDetails(BaseModel):
@@ -79,7 +105,7 @@ class DealFullDetails(BaseModel):
         history: Change history entries (if requested).
         status_history: Status change history (if requested).
         auditors: List of auditors (if requested).
-        responsible_details: Full responsible employee details (if requested).
+        manager_details: Full manager (responsible) employee details (if requested).
         contractor_details: Full contractor details (if requested).
         related_tasks: Tasks related to this deal (if requested).
     """
@@ -89,8 +115,8 @@ class DealFullDetails(BaseModel):
     history: list[dict[str, Any]] | None = None
     status_history: list[dict[str, Any]] | None = None
     auditors: list[dict[str, Any]] | None = None
-    responsible_details: Any | None = None
+    manager_details: Any | None = None
     contractor_details: Any | None = None
     related_tasks: list[Any] | None = None
 
-    model_config = ConfigDict(populate_by_name=True, extra="ignore")
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

{megaplan_sdk-0.2.1 → megaplan_sdk-0.2.2}/src/megaplan_sdk/models/department.py

@@ -24,7 +24,7 @@ class Department(BaseEntity, TimestampMixin):
     parent: BaseEntity | None = None
     manager: BaseEntity | None = None
 
-    model_config = ConfigDict(populate_by_name=True, extra="ignore")
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
 
     def __str__(self) -> str:
         """Return department name for display.

{megaplan_sdk-0.2.1 → megaplan_sdk-0.2.2}/src/megaplan_sdk/models/employee.py

@@ -54,7 +54,7 @@ class Employee(BaseEntity, TimestampMixin):
     access_role: BaseEntity | None = Field(alias="accessRole", default=None)
     custom_fields: dict[str, Any] | None = Field(alias="customFields", default=None)
 
-    model_config = ConfigDict(populate_by_name=True, extra="ignore")
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
 
     def full_name(self, include_middle: bool = True) -> str:
         """Get full name of the employee.

{megaplan_sdk-0.2.1 → megaplan_sdk-0.2.2}/src/megaplan_sdk/models/filter.py

@@ -21,7 +21,7 @@ class BaseFilter(BaseModel):
     name: str | None = None
     config: dict[str, Any] | None = None
 
-    model_config = ConfigDict(populate_by_name=True, extra="ignore")
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
 
 
 class TaskFilter(BaseFilter):
@@ -57,7 +57,7 @@ class FilterExport(BaseModel):
 
     file: BaseEntity | None = None
 
-    model_config = ConfigDict(populate_by_name=True, extra="ignore")
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
 
 
 class UserSetting(BaseModel):

{megaplan_sdk-0.2.1 → megaplan_sdk-0.2.2}/src/megaplan_sdk/models/group.py

@@ -25,7 +25,7 @@ class Group(BaseEntity):
     children: list[BaseEntity] | None = None
     children_count: int | None = Field(alias="childrenCount", default=None)
 
-    model_config = ConfigDict(populate_by_name=True, extra="ignore")
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
 
     def display_name(self) -> str:
         """Get display name for the group.

{megaplan_sdk-0.2.1 → megaplan_sdk-0.2.2}/src/megaplan_sdk/models/milestone.py

@@ -46,7 +46,7 @@ class Milestone(BaseEntity, TimestampMixin):
     reminder: dict[str, Any] | None = None
     possible_actions: list[str] | None = Field(alias="possibleActions", default=None)
 
-    model_config = ConfigDict(populate_by_name=True, extra="ignore")
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
 
     def display_name(self) -> str:
         """Get display name for milestone.

{megaplan_sdk-0.2.1 → megaplan_sdk-0.2.2}/src/megaplan_sdk/models/project.py

@@ -44,7 +44,7 @@ class Project(TimestampMixin):
     attaches: list[BaseEntity] | None = None
     todos: list[BaseEntity] | None = None
 
-    model_config = ConfigDict(populate_by_name=True, extra="ignore")
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
 
 
 class ProjectFullDetails(BaseModel):
@@ -76,7 +76,7 @@ class ProjectFullDetails(BaseModel):
     responsible_details: Any | None = None
     owner_details: Any | None = None
 
-    model_config = ConfigDict(populate_by_name=True, extra="ignore")
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
 
 
 # Rebuild models after Milestone is defined to resolve forward references

{megaplan_sdk-0.2.1 → megaplan_sdk-0.2.2}/src/megaplan_sdk/models/task.py

@@ -45,7 +45,7 @@ class Task(TimestampMixin):
     attaches: list[BaseEntity] | None = None
     todos: list[BaseEntity] | None = None
 
-    model_config = ConfigDict(populate_by_name=True, extra="ignore")
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
 
 
 class TaskFullDetails(BaseModel):
@@ -75,7 +75,7 @@ class TaskFullDetails(BaseModel):
     responsible_details: Any | None = None
     owner_details: Any | None = None
 
-    model_config = ConfigDict(populate_by_name=True, extra="ignore")
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
 
 
 # Rebuild models after Milestone is defined to resolve forward references

{megaplan_sdk-0.2.1 → megaplan_sdk-0.2.2}/src/megaplan_sdk/resources/deals.py

@@ -49,10 +49,10 @@ class DealsResource(BaseResource, FullDetailsMixin):
             RelatedDataConfig("status_history", "include_status_history", "get_status_history"),
             RelatedDataConfig("auditors", "include_auditors", "get_auditors"),
             RelatedDataConfig(
-                "responsible_details",
-                "include_responsible_details",
+                "manager_details",
+                "include_manager_details",
                 None,
-                entity_field="responsible",
+                entity_field="manager",
                 entity_type="employee",
             ),
             RelatedDataConfig(
@@ -190,11 +190,14 @@ class DealsResource(BaseResource, FullDetailsMixin):
             page_after: Load page starting from this entity.
             page_before: Load page strictly before this entity.
             page_with: Load page containing this entity.
-            fields: Additional fields to include.
+            fields: Additional fields to request from the API.
+                Must use actual API field names: ``manager``, ``price``,
+                ``timeCreated``, ``timeUpdated``, ``number``, ``cost``, ``debt``,
+                ``result``, ``shortDescription``, ``stateTimeUpdated``.
             sort_by: Sort fields.
             only_requested_fields: Return only requested fields.
-            expand: List of fields to expand (e.g., ["responsible", "contractor"]).
-                Supported values: "responsible", "contractor".
+            expand: List of fields to expand (e.g., ["manager", "contractor"]).
+                Supported values: "manager", "contractor".
                 If provided, returns list[DealFullDetails] instead of list[Deal].
 
         Returns:
@@ -204,13 +207,13 @@ class DealsResource(BaseResource, FullDetailsMixin):
             >>> # Get deals without expansion
             >>> deals = await client.deals.list(limit=10)
             >>>
-            >>> # Get deals with expanded responsible and contractor
+            >>> # Get deals with expanded manager and contractor
             >>> deals_full = await client.deals.list(
-            ...     limit=10, expand=["responsible", "contractor"]
+            ...     limit=10, expand=["manager", "contractor"]
             ... )
             >>> for deal_full in deals_full:
-            ...     if deal_full.responsible_details:
-            ...         print(deal_full.responsible_details.display_name())
+            ...     if deal_full.manager_details:
+            ...         print(deal_full.manager_details.display_name())
             ...     if deal_full.contractor_details:
             ...         print(deal_full.contractor_details.display_name())
         """
@@ -258,22 +261,22 @@ class DealsResource(BaseResource, FullDetailsMixin):
         from megaplan_sdk.models.employee import Employee
 
         expand_config: dict[str, tuple[str, type, str]] = {
-            "responsible": ("employee", Employee, ContentType.EMPLOYEE),
+            "manager": ("employee", Employee, ContentType.EMPLOYEE),
             "contractor": ("contractor", Contractor, ContentType.CONTRACTOR),
         }
 
         expanded = await self._expand_list_entities(deals, expand, expand_config)
-        responsible_map = expanded.get("responsible", {})
+        manager_map = expanded.get("manager", {})
         contractor_map = expanded.get("contractor", {})
 
         # 4. Build DealFullDetails objects
         results = []
         for deal in deals:
-            resp_details = None
+            mgr_details = None
             contr_details = None
 
-            if deal.responsible and deal.responsible.id in responsible_map:
-                resp_details = responsible_map[deal.responsible.id]
+            if deal.manager and deal.manager.id in manager_map:
+                mgr_details = manager_map[deal.manager.id]
 
             if deal.contractor and deal.contractor.id in contractor_map:
                 contr_details = contractor_map[deal.contractor.id]
@@ -281,7 +284,7 @@ class DealsResource(BaseResource, FullDetailsMixin):
             results.append(
                 DealFullDetails(
                     deal=deal,
-                    responsible_details=resp_details,
+                    manager_details=mgr_details,
                     contractor_details=contr_details,
                 )
             )
@@ -683,7 +686,7 @@ class DealsResource(BaseResource, FullDetailsMixin):
         include_history: bool = False,
         include_status_history: bool = False,
         include_auditors: bool = False,
-        include_responsible_details: bool = False,
+        include_manager_details: bool = False,
         include_contractor_details: bool = False,
         include_related_tasks: bool = False,
         comments_limit: int | None = None,
@@ -700,7 +703,7 @@ class DealsResource(BaseResource, FullDetailsMixin):
             include_history: Load change history.
             include_status_history: Load status change history.
             include_auditors: Load auditors list.
-            include_responsible_details: Load full responsible (Employee) details.
+            include_manager_details: Load full manager (responsible Employee) details.
             include_contractor_details: Load full contractor details.
             include_related_tasks: Load tasks related to this deal.
             comments_limit: Limit for comments (if included).
@@ -736,7 +739,7 @@ class DealsResource(BaseResource, FullDetailsMixin):
             include_history=include_history,
             include_status_history=include_status_history,
             include_auditors=include_auditors,
-            include_responsible_details=include_responsible_details,
+            include_manager_details=include_manager_details,
             include_contractor_details=include_contractor_details,
             include_related_tasks=include_related_tasks,
             comments_limit=comments_limit,

{megaplan_sdk-0.2.1 → megaplan_sdk-0.2.2}/src/megaplan_sdk/resources/projects.py

@@ -12,6 +12,7 @@ from megaplan_sdk.models.project import Project, ProjectFullDetails
 from megaplan_sdk.models.task import Task
 from megaplan_sdk.resources.base import BaseResource
 from megaplan_sdk.resources.full_details import FullDetailsMixin, RelatedDataConfig
+from megaplan_sdk.types import FilterType
 
 if TYPE_CHECKING:
     from megaplan_sdk.models.milestone import Milestone
@@ -172,6 +173,7 @@ class ProjectsResource(BaseResource, FullDetailsMixin):
     async def list(
         self,
         *,
+        filter: FilterType | None = None,
         limit: int | None = None,
         page_after: dict[str, Any] | None = None,
         page_before: dict[str, Any] | None = None,
@@ -186,6 +188,7 @@ class ProjectsResource(BaseResource, FullDetailsMixin):
     async def list(
         self,
         *,
+        filter: FilterType | None = None,
         limit: int | None = None,
         page_after: dict[str, Any] | None = None,
         page_before: dict[str, Any] | None = None,
@@ -198,6 +201,7 @@ class ProjectsResource(BaseResource, FullDetailsMixin):
 
     async def list(
         self,
+        filter: FilterType | None = None,
         limit: int | None = None,
         page_after: dict[str, Any] | None = None,
         page_before: dict[str, Any] | None = None,
@@ -210,6 +214,16 @@ class ProjectsResource(BaseResource, FullDetailsMixin):
         """Get list of projects.
 
         Args:
+            filter: Project filter (``ProjectFilterBuilder`` result or filter config dict).
+                Use ``ProjectFilterBuilder`` for fluent filter construction:
+
+                .. code-block:: python
+
+                    from megaplan_sdk import ProjectFilterBuilder
+
+                    f = ProjectFilterBuilder().field_date("timeCreated").greater_than("2025-01-01").build()
+                    projects = await client.projects.list(filter=f)
+
             limit: Number of items per page.
             page_after: Load page starting from this entity.
             page_before: Load page strictly before this entity.
@@ -228,6 +242,11 @@ class ProjectsResource(BaseResource, FullDetailsMixin):
             >>> # Get projects without expansion
             >>> projects = await client.projects.list(limit=10)
             >>>
+            >>> # Get projects with filter
+            >>> from megaplan_sdk import ProjectFilterBuilder
+            >>> f = ProjectFilterBuilder().field("name").contains("SDK").build()
+            >>> projects = await client.projects.list(filter=f)
+            >>>
             >>> # Get projects with expanded responsible and owner
             >>> projects_full = await client.projects.list(
             ...     limit=10, expand=["responsible", "owner"]
@@ -240,6 +259,7 @@ class ProjectsResource(BaseResource, FullDetailsMixin):
 
         # Use base method to build params (DRY)
         params = self._build_list_params(
+            filter=filter,
             limit=limit,
             page_after=page_after,
             page_before=page_before,

{megaplan_sdk-0.2.1 → megaplan_sdk-0.2.2/src/megaplan_sdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: megaplan-sdk
-Version: 0.2.1
+Version: 0.2.2
 Summary: Professional Python SDK for Megaplan API v3
 Author-email: Maxim Borzov <max@borzov.com>
 License-Expression: MIT
@@ -314,7 +314,7 @@ entity = await client.{resource}.update(
 ```python
 task = await client.tasks.update(task_id=42, task_data={"status": "completed"})
 project = await client.projects.update(project_id=5, project_data={"name": "Новое название"})
-deal = await client.deals.update(deal_id=200, deal_data={"sum_base": 60000.0})
+deal = await client.deals.update(deal_id=200, deal_data={"price": {"currency": "RUB", "value": 60000}})
 ```
 
 #### Удаление (`delete`)
@@ -517,8 +517,8 @@ tasks = await client.tasks.list(filter=filter_obj)
 - `tags: list[BaseEntity]` - Теги
 - `attaches: list[BaseEntity]` - Вложения (файлы)
 - `todos: list[BaseEntity]` - Подзадачи-чеклисты
-- `created_at: str` - Дата создания
-- `updated_at: str` - Дата обновления
+- `time_created: str` - Дата создания (API поле `timeCreated`)
+- `time_updated: str` - Дата обновления (API поле `timeUpdated`)
 
 ### Упрощенные методы создания
 
@@ -775,8 +775,8 @@ milestone = await client.projects.add_milestone(
 - `tags: list[BaseEntity]` - Теги
 - `attaches: list[BaseEntity]` - Вложения
 - `todos: list[BaseEntity]` - Подзадачи-чеклисты
-- `created_at: str` - Дата создания
-- `updated_at: str` - Дата обновления
+- `time_created: str` - Дата создания (API поле `timeCreated`)
+- `time_updated: str` - Дата обновления (API поле `timeUpdated`)
 
 ### Упрощенные методы создания
 
@@ -967,18 +967,26 @@ deals = await client.deals.list(filter=filter_obj)
 ### Поля модели Deal
 - `id: int` - Идентификатор сделки
 - `name: str` - Название сделки
+- `number: str` - Номер сделки
+- `short_description: str` - Краткое описание
 - `program: BaseEntity` - Программа (схема сделки)
 - `state: ProgramState` - Текущий статус в программе
 - `contractor: BaseEntity` - Контрагент (ContractorCompany/ContractorHuman)
-- `responsible: BaseEntity` - Ответственный (Employee)
-- `sum_base: float` - Сумма сделки
+- `manager: BaseEntity` - Ответственный (Employee, API поле `manager`)
+- `price: Money` - Сумма сделки (объект с полями `currency`, `value`)
+- `cost: Money` - Стоимость
+- `debt: Money` - Долг
+- `result: str` - Результат (`"positive"`, `"negative"`, `null`)
 - `currency: BaseEntity` - Валюта
 - `deadline: str` - Срок
-- `description: str` - Описание
+- `description: str` - Описание (только в `deals.get()`, не в списке)
 - `tags: list[BaseEntity]` - Теги
 - `attaches: list[BaseEntity]` - Вложения
-- `created_at: str` - Дата создания
-- `updated_at: str` - Дата обновления
+- `time_created: str` - Дата создания (API поле `timeCreated`)
+- `time_updated: str` - Дата обновления (API поле `timeUpdated`)
+- `state_time_updated: str` - Дата последнего изменения статуса
+
+> **Примечание:** Поля `description`, `deadline` и пользовательские поля доступны только при запросе отдельной сделки через `deals.get(id)`, но не в списке.
 
 **Важно:** При создании сделки обязательно указывать поле `program` (программа/схема сделки).
 
@@ -1063,7 +1071,7 @@ details = await client.deals.get_full_details(
     include_history=True,                  # Загрузить историю изменений
     include_status_history=True,           # Загрузить историю статусов
     include_auditors=True,                  # Загрузить список аудиторов
-    include_responsible_details=True,      # Загрузить полные данные ответственного
+    include_manager_details=True,          # Загрузить полные данные ответственного
     include_contractor_details=True,       # Загрузить полные данные контрагента
     include_related_tasks=True,            # Загрузить связанные задачи
     comments_limit=50,                     # Лимит комментариев (опционально)
@@ -1077,7 +1085,7 @@ details = await client.deals.get_full_details(
 - `history: list[dict] | None` - История изменений
 - `status_history: list[dict] | None` - История статусов
 - `auditors: list[dict] | None` - Аудиторы
-- `responsible_details: Employee | None` - Полные данные ответственного
+- `manager_details: Employee | None` - Полные данные ответственного
 - `contractor_details: Contractor | None` - Полные данные контрагента
 - `related_tasks: list[Task] | None` - Связанные задачи
 
@@ -1278,14 +1286,14 @@ for task_full in tasks_full:
 ### Использование expand в сделках
 
 ```python
-deals_full = await client.deals.list(limit=10, expand=["responsible", "contractor"])
+deals_full = await client.deals.list(limit=10, expand=["manager", "contractor"])
 
 for deal_full in deals_full:
     deal = deal_full.deal
     print(f"Сделка: {deal.name}")
 
-    if deal_full.responsible_details:
-        print(f"Ответственный: {deal_full.responsible_details.display_name()}")
+    if deal_full.manager_details:
+        print(f"Ответственный: {deal_full.manager_details.display_name()}")
 
     if deal_full.contractor_details:
         print(f"Контрагент: {deal_full.contractor_details.display_name()}")
@@ -1296,7 +1304,7 @@ for deal_full in deals_full:
 ```
 
 **Поддерживаемые поля для expand в сделках:**
-- `responsible` - ответственный сотрудник
+- `manager` - ответственный сотрудник
 - `contractor` - контрагент
 
 ### Использование expand в проектах

megaplan_sdk-0.2.1/src/megaplan_sdk/models/base.py

@@ -1,16 +0,0 @@
-"""Base models for Megaplan SDK."""
-
-from pydantic import BaseModel, ConfigDict, Field
-
-
-class BaseEntity(BaseModel):
-    """Base entity with contentType and id.
-
-    All Megaplan entities have contentType and id fields.
-    Link entities (for references) only contain these two fields.
-    """
-
-    content_type: str = Field(alias="contentType")
-    id: int
-
-    model_config = ConfigDict(populate_by_name=True, extra="ignore")