From 254002f72308cbbeeccf4bacdd87ae6999843b59 Mon Sep 17 00:00:00 2001 From: PotapovaA Date: Thu, 22 Oct 2026 16:58:19 +0300 Subject: [PATCH 1/2] =?UTF-8?q?=D1=82=D0=B5=D1=85=20=D0=B4=D0=BE=D0=BB?= =?UTF-8?q?=D0=B3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- api/src/api/endpoints/directories/accounts.py | 18 ++++-- api/src/repositories/directories.py | 19 +++++- api/src/schemas/directories.py | 8 +++ api/src/services/intercompany_matrix.py | 12 ++-- .../services/intercompany_matrix_export.py | 2 +- api/tests/test_api_accounts.py | 54 ++++++++++++++++- api/tests/test_api_intercompany_matrix.py | 24 +++++++- api/tests/test_intercompany_matrix.py | 59 ++++++++++++++++--- api/tests/test_intercompany_matrix_export.py | 33 +++++++++++ 9 files changed, 207 insertions(+), 22 deletions(-) diff --git a/api/src/api/endpoints/directories/accounts.py b/api/src/api/endpoints/directories/accounts.py index eb0b912..410aa18 100644 --- a/api/src/api/endpoints/directories/accounts.py +++ b/api/src/api/endpoints/directories/accounts.py @@ -1,11 +1,13 @@ """Плоский список счетов плана счетов для выбора статьи расходов.""" -from fastapi import APIRouter, Depends +from typing import Annotated + +from fastapi import APIRouter, Depends, Query from src.api.dependencies.auth import require from src.api.dependencies.db import SessionDep from src.repositories import directories as repo -from src.schemas.directories import AccountOut +from src.schemas.directories import AccountFilter, AccountOut router = APIRouter() @@ -16,6 +18,12 @@ router = APIRouter() dependencies=[Depends(require("DIRECTORY_VIEW"))], summary="Список счетов плана счетов", ) -async def list_accounts(session: SessionDep) -> list[AccountOut]: - """Все счета одним списком""" - return [AccountOut.model_validate(account) for account in await repo.list_accounts(session)] +async def list_accounts( + session: SessionDep, + filters: Annotated[AccountFilter, Query()], +) -> list[AccountOut]: + """Счета одним списком с необязательными фильтрами.""" + accounts = await repo.list_accounts( + session, kind=filters.kind, row_type=filters.row_type, is_off_balance=filters.is_off_balance + ) + return [AccountOut.model_validate(account) for account in accounts] diff --git a/api/src/repositories/directories.py b/api/src/repositories/directories.py index a745220..817500b 100644 --- a/api/src/repositories/directories.py +++ b/api/src/repositories/directories.py @@ -27,15 +27,28 @@ from src.models.directories import ( RelatedGroup, RelatedGroupMember, ) -from src.models.enums import FileStatus, RelatedGroupKind +from src.models.enums import AccountKind, AccountRowType, FileStatus, RelatedGroupKind from src.models.files import Document, StoredFile LIKE_ESCAPE = "\\" ALIAS_LOCK_PREFIX = "legal-entity-alias" # пространство ключей advisory-блокировки алиасов -async def list_accounts(session: AsyncSession) -> list[ChartOfAccount]: - accounts = (await session.scalars(select(ChartOfAccount))).all() +async def list_accounts( + session: AsyncSession, + *, + kind: list[AccountKind] | None = None, + row_type: AccountRowType | None = None, + is_off_balance: bool | None = None, +) -> list[ChartOfAccount]: + stmt = select(ChartOfAccount) + if kind is not None: + stmt = stmt.where(ChartOfAccount.kind.in_(kind)) + if row_type is not None: + stmt = stmt.where(ChartOfAccount.row_type == row_type) + if is_off_balance is not None: + stmt = stmt.where(ChartOfAccount.is_off_balance.is_(is_off_balance)) + accounts = (await session.scalars(stmt)).all() return sorted(accounts, key=lambda account: (account_sort_key(account.code), account.code)) diff --git a/api/src/schemas/directories.py b/api/src/schemas/directories.py index 39636dd..8885d00 100644 --- a/api/src/schemas/directories.py +++ b/api/src/schemas/directories.py @@ -38,6 +38,14 @@ class RegionalOfficeOut(RegionalOfficeBrief): is_active: bool +class AccountFilter(BaseModel): + """Необязательные фильтры списка счетов.""" + + kind: list[AccountKind] | None = None + row_type: AccountRowType | None = None + is_off_balance: bool | None = None + + class AccountOut(BaseModel): """Одна строка плана счетов; parent_id сохраняет иерархию в плоском списке.""" diff --git a/api/src/services/intercompany_matrix.py b/api/src/services/intercompany_matrix.py index bbc0014..56c41fd 100644 --- a/api/src/services/intercompany_matrix.py +++ b/api/src/services/intercompany_matrix.py @@ -185,7 +185,7 @@ def calculate_matrix( variance_amount=variance_amount, variance_percent=variance_percent, exceeds_threshold=exceeds_threshold, - one_sided=bool(debit_ids) != bool(credit_ids), + one_sided=min(amount_a, amount_b) == 0 and variance_amount > 0, skipped_osv_entry_count=skipped_entries[(company_a, company_b)] + skipped_entries[(company_b, company_a)], osv_entry_ids_debit=debit_ids, @@ -360,7 +360,7 @@ class IntercompanyMatrixService: debit_account_ids: Sequence[uuid.UUID] = (), credit_account_ids: Sequence[uuid.UUID] = (), ) -> IntercompanyMatrixOut: - """ALL использует все счета нужного вида; MANUAL раскрывает выбранные счета и потомков.""" + """ALL использует балансовые счета нужного вида; MANUAL раскрывает выбранные счета и потомков.""" matrix, _, _, _ = await self._build_accounts( version_id, mode=mode, debit_account_ids=debit_account_ids, credit_account_ids=credit_account_ids ) @@ -404,8 +404,12 @@ class IntercompanyMatrixService: if mode == "ALL": if debit_account_ids or credit_account_ids: raise DomainValidationError("ACCOUNTS_NOT_ALLOWED", "Для режима ALL не нужно указывать счета") - debit = frozenset(account.id for account in accounts if account.kind in DEBIT_KINDS) - credit = frozenset(account.id for account in accounts if account.kind in CREDIT_KINDS) + debit = frozenset( + account.id for account in accounts if not account.is_off_balance and account.kind in DEBIT_KINDS + ) + credit = frozenset( + account.id for account in accounts if not account.is_off_balance and account.kind in CREDIT_KINDS + ) elif mode == "MANUAL": if not debit_account_ids or not credit_account_ids: raise DomainValidationError("ACCOUNTS_REQUIRED", "Выберите дебетовые и кредитовые счета") diff --git a/api/src/services/intercompany_matrix_export.py b/api/src/services/intercompany_matrix_export.py index 5e91e55..4a262c3 100644 --- a/api/src/services/intercompany_matrix_export.py +++ b/api/src/services/intercompany_matrix_export.py @@ -120,7 +120,7 @@ def build_matrix_workbook(matrix: IntercompanyMatrixOut, info: MatrixExportInfo) if cell is None: continue _write_values(sheet, start_row, column, cell) - if cell.exceeds_threshold: + if cell.exceeds_threshold or cell.one_sided: for offset in range(len(METRICS)): marked = sheet.cell(start_row + offset, column) marked.fill = THRESHOLD_FILL diff --git a/api/tests/test_api_accounts.py b/api/tests/test_api_accounts.py index 54c8497..cb5bca5 100644 --- a/api/tests/test_api_accounts.py +++ b/api/tests/test_api_accounts.py @@ -4,9 +4,14 @@ import uuid from types import SimpleNamespace from unittest.mock import AsyncMock +import pytest + +from src.api.endpoints.directories import accounts as accounts_endpoint from src.api.endpoints.directories.accounts import list_accounts +from src.app import app from src.models.enums import AccountKind, AccountRowType from src.repositories.directories import list_accounts as query_accounts +from src.schemas.directories import AccountFilter async def test_accounts_are_flat_and_naturally_sorted() -> None: @@ -43,10 +48,57 @@ async def test_accounts_are_flat_and_naturally_sorted() -> None: session = SimpleNamespace(scalars=AsyncMock(return_value=SimpleNamespace(all=lambda: rows))) assert [item.code for item in await query_accounts(session)] == ["60", "60.2", "60.10"] - response = await list_accounts(session) + response = await list_accounts(session, AccountFilter()) assert [item.code for item in response] == ["60", "60.2", "60.10"] assert response[0].parent_id is None assert response[2].parent_id == root_id assert response[2].id == sub_id assert [item.model_dump(mode="json")["is_debit"] for item in response] == [True, False, True] assert [item.model_dump(mode="json")["is_credit"] for item in response] == [True, True, False] + + +@pytest.mark.parametrize( + ("filters", "expected_columns"), + [ + ({}, set()), + ({"kind": [AccountKind.A]}, {"kind"}), + ({"kind": [AccountKind.A, AccountKind.AP]}, {"kind"}), + ({"row_type": AccountRowType.analytic}, {"row_type"}), + ({"is_off_balance": False}, {"is_off_balance"}), + ( + {"kind": [AccountKind.AP, AccountKind.P], "row_type": AccountRowType.account, "is_off_balance": True}, + {"kind", "row_type", "is_off_balance"}, + ), + ], +) +async def test_account_filters_apply_only_when_supplied(filters: dict, expected_columns: set[str]) -> None: + session = SimpleNamespace(scalars=AsyncMock(return_value=SimpleNamespace(all=list))) + + assert await query_accounts(session, **filters) == [] + statement = session.scalars.await_args.args[0] + where_clause = str(statement.whereclause) if statement.whereclause is not None else "" + for column in ("kind", "row_type", "is_off_balance"): + assert (f"chart_of_account.{column} " in where_clause) == (column in expected_columns) + if "kind" in filters: + assert "chart_of_account.kind IN" in where_clause + assert statement.compile().params["kind_1"] == filters["kind"] + + +async def test_account_endpoint_forwards_all_filters(monkeypatch: pytest.MonkeyPatch) -> None: + query = AsyncMock(return_value=[]) + monkeypatch.setattr(accounts_endpoint.repo, "list_accounts", query) + session = SimpleNamespace() + + filters = AccountFilter(kind=[AccountKind.AP, AccountKind.P], row_type=AccountRowType.account, is_off_balance=False) + assert await list_accounts(session, filters) == [] + query.assert_awaited_once_with( + session, kind=[AccountKind.AP, AccountKind.P], row_type=AccountRowType.account, is_off_balance=False + ) + + +def test_account_filters_are_optional_query_parameters() -> None: + parameters = app.openapi()["paths"]["/api/v1/directories/accounts"]["get"]["parameters"] + assert {item["name"] for item in parameters} == {"kind", "row_type", "is_off_balance"} + assert all(item["in"] == "query" and item["required"] is False for item in parameters) + kind = next(item for item in parameters if item["name"] == "kind") + assert kind["schema"]["anyOf"][0]["type"] == "array" diff --git a/api/tests/test_api_intercompany_matrix.py b/api/tests/test_api_intercompany_matrix.py index 950e7a7..1948a48 100644 --- a/api/tests/test_api_intercompany_matrix.py +++ b/api/tests/test_api_intercompany_matrix.py @@ -138,6 +138,28 @@ async def test_no_osv_for_selected_accounts(auth_client: AuthClientFactory, seed assert cell["skipped_osv_entry_count"] == 0 +async def test_all_excludes_off_balance_accounts_but_manual_can_select_them( + auth_client: AuthClientFactory, seeded: AsyncSession +) -> None: + world = await _world(seeded) + assert world.accounts["001"].is_off_balance is True + await _source(seeded, world, credit=False, amount="100", account="001") + client = await auth_client(KA_RF) + + all_response = await _request(client, world.version.id, "all", world.selection) + assert all_response.status_code == OK, all_response.text + assert all(Decimal(cell["amount_a"]) == 0 for cell in all_response.json()["cells"]) + + manual_selection = { + "debit_account_ids": [str(world.accounts["001"].id)], + "credit_account_ids": [str(world.accounts["60.01"].id)], + } + manual_response = await _request(client, world.version.id, "manual", manual_selection) + assert manual_response.status_code == OK, manual_response.text + cell = next(c for c in manual_response.json()["cells"] if c["company_a_id"] == str(world.members[0].id)) + assert Decimal(cell["amount_a"]) == Decimal("100") + + async def test_unmapped_account_source_is_visible_in_cell_count( auth_client: AuthClientFactory, seeded: AsyncSession ) -> None: @@ -170,7 +192,7 @@ async def test_pair_without_counterpart( cell = next(c for c in response.json()["cells"] if c["company_a_id"] == str(world.members[0].id)) assert Decimal(cell["amount_a"]) == (Decimal(0) if credit else Decimal(amount)) assert Decimal(cell["amount_b"]) == (Decimal(amount) if credit else Decimal(0)) - assert cell["one_sided"] is True + assert cell["one_sided"] is (Decimal(amount) != 0) assert cell["variance_percent"] is None assert cell["exceeds_threshold"] is False assert bool(cell["osv_entry_ids_credit"]) is credit diff --git a/api/tests/test_intercompany_matrix.py b/api/tests/test_intercompany_matrix.py index 971a135..dcd6227 100644 --- a/api/tests/test_intercompany_matrix.py +++ b/api/tests/test_intercompany_matrix.py @@ -3,6 +3,7 @@ import uuid from decimal import Decimal from types import SimpleNamespace +from unittest.mock import AsyncMock import pytest @@ -84,7 +85,50 @@ def test_routes_are_separate_and_matrix_expands_manual_accounts() -> None: ] -def test_one_sided_reflects_osv_sources_even_when_amount_is_zero() -> None: +async def test_all_excludes_off_balance_accounts_only(monkeypatch: pytest.MonkeyPatch) -> None: + company_a, company_b = uuid.uuid4(), uuid.uuid4() + off_balance = SimpleNamespace(id=uuid.uuid4(), kind=AccountKind.A, parent_id=None, is_off_balance=True) + off_balance_credit = SimpleNamespace(id=uuid.uuid4(), kind=AccountKind.P, parent_id=None, is_off_balance=True) + debit = SimpleNamespace(id=uuid.uuid4(), kind=AccountKind.A, parent_id=None, is_off_balance=False) + credit = SimpleNamespace(id=uuid.uuid4(), kind=AccountKind.P, parent_id=None, is_off_balance=False) + accounts = [off_balance, off_balance_credit, debit, credit] + monkeypatch.setattr(matrix.directory_repo, "list_accounts", AsyncMock(return_value=accounts)) + rows = [ + _row(company_a, company_b, off_balance.id, debit="100"), + _row(company_a, company_b, debit.id, debit="30"), + _row(company_b, company_a, off_balance_credit.id, credit="40"), + _row(company_b, company_a, credit.id, credit="20"), + ] + members = { + company_a: SimpleNamespace(id=company_a, name="Компания А"), + company_b: SimpleNamespace(id=company_b, name="Компания Б"), + } + osv_service = SimpleNamespace( + build_with_members=AsyncMock(return_value=(SimpleNamespace(rows=rows), None, None, members)) + ) + service = matrix.IntercompanyMatrixService(SimpleNamespace(), None, osv_service) + + all_matrix = await service.build_accounts(uuid.uuid4(), mode="ALL") + manual_matrix = await service.build_accounts( + uuid.uuid4(), mode="MANUAL", debit_account_ids=[off_balance.id], credit_account_ids=[off_balance_credit.id] + ) + assert all_matrix.cells[0].amount_a == Decimal("30") + assert all_matrix.cells[0].amount_b == Decimal("20") + assert manual_matrix.cells[0].amount_a == Decimal("100") + assert manual_matrix.cells[0].amount_b == Decimal("40") + + +@pytest.mark.parametrize( + ("debit_amount", "credit_amount", "expected"), + [ + ("100000000", "0", True), + ("0", "100000000", True), + ("0", "0", False), + ], +) +def test_one_sided_uses_amounts_even_with_zero_balance_rows( + debit_amount: str, credit_amount: str, expected: bool +) -> None: company_a, company_b = uuid.uuid4(), uuid.uuid4() debit_account, credit_account = uuid.uuid4(), uuid.uuid4() companies = [ @@ -92,15 +136,16 @@ def test_one_sided_reflects_osv_sources_even_when_amount_is_zero() -> None: IntercompanyMatrixCompanyOut(id=company_b, name="Компания Б"), ] selection = matrix.MatrixSelection(frozenset({debit_account}), frozenset({credit_account}), "closing") - debit = _row(company_a, company_b, debit_account) - credit = _row(company_b, company_a, credit_account) + debit = _row(company_a, company_b, debit_account, debit=debit_amount) + credit = _row(company_b, company_a, credit_account, credit=credit_amount) debit.entry_ids = (uuid.uuid4(),) credit.entry_ids = (uuid.uuid4(),) - for rows, expected in (([], False), ([debit], True), ([credit], True), ([debit, credit], False)): - cell = matrix.calculate_matrix(rows, companies, selection).cells[0] - assert cell.one_sided is expected - assert cell.model_dump(mode="json")["one_sided"] is expected + cell = matrix.calculate_matrix([debit, credit], companies, selection).cells[0] + assert cell.one_sided is expected + assert cell.exceeds_threshold is False + assert cell.variance_percent is None + assert cell.model_dump(mode="json")["one_sided"] is expected def test_unmapped_account_entries_are_counted_for_both_directions_of_pair() -> None: diff --git a/api/tests/test_intercompany_matrix_export.py b/api/tests/test_intercompany_matrix_export.py index 9b43dbd..09fd0bd 100644 --- a/api/tests/test_intercompany_matrix_export.py +++ b/api/tests/test_intercompany_matrix_export.py @@ -142,6 +142,39 @@ def test_matrix_export_has_three_rows_per_debit_company_and_highlights_threshold ) +@pytest.mark.parametrize(("amount", "highlighted"), [("100000000", True), ("0", False)]) +def test_xlsx_highlights_one_sided_amount_but_not_two_zero_balances(amount: str, highlighted: bool) -> None: + company_a = UUID("11111111-1111-1111-1111-111111111111") + company_b = UUID("22222222-2222-2222-2222-222222222222") + matrix = IntercompanyMatrixOut( + companies=[ + IntercompanyMatrixCompanyOut(id=company_a, name="Компания А"), + IntercompanyMatrixCompanyOut(id=company_b, name="Компания Б"), + ], + cells=[ + IntercompanyMatrixCellOut( + company_a_id=company_a, + company_b_id=company_b, + amount_a=amount, + amount_b="0", + variance_amount=amount, + variance_percent=None if highlighted else "0", + exceeds_threshold=False, + one_sided=highlighted, + skipped_osv_entry_count=0, + osv_entry_ids_debit=[], + osv_entry_ids_credit=[], + ) + ], + ) + + sheet = load_workbook(BytesIO(build_matrix_workbook(matrix, _info(mode="ALL")))).active + assert sheet is not None + assert all( + (sheet.cell(row, 4).fill.fgColor.rgb == THRESHOLD_FILL.fgColor.rgb) is highlighted for row in range(11, 15) + ) + + async def test_both_export_routes_use_matrix_calculation() -> None: version_id = UUID("11111111-1111-1111-1111-111111111111") account_id = UUID("22222222-2222-2222-2222-222222222222") From 0db60b7315d6c4275cf33d141ce67478a88aa81b Mon Sep 17 00:00:00 2001 From: Andrey Epifancev Date: Thu, 22 Oct 2026 23:45:57 +0400 Subject: [PATCH 2/2] =?UTF-8?q?docs:=20change=20intercompany-matrix-one-si?= =?UTF-8?q?ded=20=D0=B8=20README=20=E2=80=94=20one=5Fsided=20=D0=BF=D0=BE?= =?UTF-8?q?=20=D1=81=D1=83=D0=BC=D0=BC=D0=B0=D0=BC,=20ALL=20=D0=B1=D0=B5?= =?UTF-8?q?=D0=B7=20=D0=B7=D0=B0=D0=B1=D0=B0=D0=BB=D0=B0=D0=BD=D1=81=D0=BE?= =?UTF-8?q?=D0=B2=D1=8B=D1=85=20(AURORA-1651)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- README.md | 2 + .../.openspec.yaml | 2 + .../intercompany-matrix-one-sided/design.md | 31 ++++++++ .../intercompany-matrix-one-sided/proposal.md | 34 +++++++++ .../specs/consolidated-osv/spec.md | 72 +++++++++++++++++++ .../intercompany-matrix-one-sided/tasks.md | 8 +++ 6 files changed, 149 insertions(+) create mode 100644 openspec/changes/intercompany-matrix-one-sided/.openspec.yaml create mode 100644 openspec/changes/intercompany-matrix-one-sided/design.md create mode 100644 openspec/changes/intercompany-matrix-one-sided/proposal.md create mode 100644 openspec/changes/intercompany-matrix-one-sided/specs/consolidated-osv/spec.md create mode 100644 openspec/changes/intercompany-matrix-one-sided/tasks.md diff --git a/README.md b/README.md index a2a9eaa..ec0e19f 100644 --- a/README.md +++ b/README.md @@ -873,6 +873,8 @@ API: список счетов `GET /directories/accounts`, правила ве `GET …/intercompany-matrix/result-table` и её XLSX `GET …/intercompany-matrix/result-table/export` (аудит `EXPORT`, `report = "intercompany_result_table"`). Режим PRESET (счета и показатель из правила элиминации): `GET …/intercompany-matrix/preset/{rule_id}` и его выгрузка `…/preset/{rule_id}/export`. +Режим ALL — только балансовые счета (без 001–012), MANUAL принимает и забалансовые. `one_sided` — ровно одна сумма +пары нулевая; пара подсвечивается (и в xlsx) при `exceeds_threshold` или `one_sided` (AURORA-1651). `GET …/elimination-rules` отдаёт объект `{version_no, is_version_fixed, rules}` (у правила есть `id`): при незаданной версии правил — открытые правила (`valid_to IS NULL`) с максимальным `version_no`; ответ сообщает этот номер. Ошибки PRESET: 422 `RULE_REQUIRED`, `INVALID_RULE`, `ACCOUNTS_REQUIRED`; правило недействительное для версии или несуществующее — 404. Имя XLSX пресета оканчивается на diff --git a/openspec/changes/intercompany-matrix-one-sided/.openspec.yaml b/openspec/changes/intercompany-matrix-one-sided/.openspec.yaml new file mode 100644 index 0000000..7cc41bb --- /dev/null +++ b/openspec/changes/intercompany-matrix-one-sided/.openspec.yaml @@ -0,0 +1,2 @@ +schema: spec-driven +created: 2026-10-22 diff --git a/openspec/changes/intercompany-matrix-one-sided/design.md b/openspec/changes/intercompany-matrix-one-sided/design.md new file mode 100644 index 0000000..3a7225e --- /dev/null +++ b/openspec/changes/intercompany-matrix-one-sided/design.md @@ -0,0 +1,31 @@ +## Context + +PR RSHB/arm-core#165, задача AURORA-1651 (технический долг ревью PR #114). Шахматка — чистая функция от сводной ОСВ +версии (DECISION-5), контракт ответа не меняется: меняются смысл `one_sided`, состав счетов режима ALL и заливка xlsx. + +## Decisions + +1. `one_sided = (amount_a == 0) != (amount_b == 0)`. Формула из описания задачи (`min(amount_a, amount_b) == 0 and + variance_amount > 0`) на неотрицательных суммах даёт то же, но на отрицательном сальдо (возможно по §1) пропускает + пару: −50 против 0 → `min = −50`. Знак ненулевой суммы не важен. +2. Подсветка в API и в xlsx — `exceeds_threshold or one_sided`. Поле `exceeds_threshold` сохраняет смысл «процент > 5»; + экран шахматки красит пару по тому же правилу (PR #158, change `intercompany-matrix-ui`). +3. Забалансовые счета (`is_off_balance = true`) исключаются только в ALL; MANUAL выбирает их явно, это не ошибка. +4. Фильтры `GET /directories/accounts` (`kind[]`, `row_type`, `is_off_balance`) из первой редакции PR убраны: в задаче их + нет, потребителей нет, при фильтре по `kind` в ответе оставались `parent_id` на строки вне ответа. + +## Decisions made without discussion + +- 2026-10-22. Формула `one_sided` через «ровно одна сумма нулевая» вместо формулы из описания задачи. Обоснование — + отрицательное сальдо (решение 1). Цена ошибки: если аналитик решит, что отрицательная сторона — не «пара без + встречной стороны», меняется одна строка и тест. +- 2026-10-22. Влив `main` с #141 и разрешение конфликтов выполнил ревьюер (владелец: «доведём задачу до ума, потом + сольём»). В ALL сохранены и фильтр забалансовых, и `MatrixSelection(..., "closing")` из #141; тесты #141 на старый + смысл `one_sided` переписаны. Цена ошибки: низкая, расчёт PRESET не затронут (свои счета правила). + +## Решения владельца (2026-10-22) + +- Экран красит и по `one_sided` (а не бэкенд выставляет `exceeds_threshold`). +- Фильтр `/directories/accounts` убрать из PR. +- Счёт `000` «Вспомогательный» не трогать, вопрос — в `07-open-questions.md`. +- Процент при отрицательной меньшей стороне — вопрос в `07-open-questions.md`, в этом PR не меняется. diff --git a/openspec/changes/intercompany-matrix-one-sided/proposal.md b/openspec/changes/intercompany-matrix-one-sided/proposal.md new file mode 100644 index 0000000..ab1663e --- /dev/null +++ b/openspec/changes/intercompany-matrix-one-sided/proposal.md @@ -0,0 +1,34 @@ +## Why + +Технический долг повторного ревью PR #114 (AURORA-1537), задача AURORA-1651. Признак `one_sided` считался по наличию +строк ОСВ, а не по суммам: пара «100 млн против строки с нулевым сальдо» выглядела сошедшейся (`one_sided = false`, +`exceeds_threshold = false`), а «0.00 против 0.00» с одной строкой — подсвечивалась ложно. Книга xlsx заливала пару только +по порогу. Режим «все счета» брал забалансовые счета 001–012: например, 009 «Обеспечения выданные» на компанию группы +давал ложное расхождение (решение владельца 16.10.2026). + +Реализация — PR RSHB/arm-core#165 (ветка `AURORA-1651`, автор — Потапова), доведена ревьюером по решению владельца +22.10.2026. + +## What Changes + +- `one_sided` = ровно одна из сумм пары нулевая (знак не важен: сальдо в ОСВ бывает отрицательным). +- XLSX шахматки заливает пару, если `exceeds_threshold` или `one_sided`; в шапке режима ALL — «Все балансовые счета». +- Режим ALL — только балансовые счета (`is_off_balance = false`); MANUAL принимает любые, включая забалансовые. +- Правила — `../docs/context/05-domain-rules.md` §6 (docs-PR вместе с этим change), открытые вопросы — OQ про счёт `000` + и процент при отрицательной меньшей стороне. + +## Non-goals + +- Подсветка односторонней пары на экране шахматки — фронт, PR #158 (change `intercompany-matrix-ui`). +- Фильтры `GET /directories/accounts` (были в первой редакции PR, убраны решением владельца 22.10.2026). +- Процент расхождения при отрицательной меньшей стороне и исключение счёта `000` из ALL — открытые вопросы. + +## Capabilities + +### Modified Capabilities +- `consolidated-osv`: требования «Шахматка по сводной ОСВ версии» и «XLSX шахматки». + +## Impact + +- `api/src/services/intercompany_matrix.py`, `api/src/services/intercompany_matrix_export.py`; тесты шахматки. +- Контракт API не меняется (поля те же), меняется смысл `one_sided` и состав счетов режима ALL. diff --git a/openspec/changes/intercompany-matrix-one-sided/specs/consolidated-osv/spec.md b/openspec/changes/intercompany-matrix-one-sided/specs/consolidated-osv/spec.md new file mode 100644 index 0000000..15ddda3 --- /dev/null +++ b/openspec/changes/intercompany-matrix-one-sided/specs/consolidated-osv/spec.md @@ -0,0 +1,72 @@ +## MODIFIED Requirements + +### Requirement: Шахматка по сводной ОСВ версии +`GET /api/v1/consolidations/versions/{version_id}/intercompany-matrix/all` и +`POST /api/v1/consolidations/versions/{version_id}/intercompany-matrix/manual` +(`CONSOLIDATION_VIEW`, policy) SHALL рассчитывать матрицу без сохранения в БД, из строк сводной ОСВ версии +и её периметра. ALL включает балансовые счета (`is_off_balance = false`) вида `A`/`AP` для дебета и `P`/`AP` для +кредита; забалансовые счета (001–012) в ALL MUST NOT входить. MANUAL принимает обязательные непустые +`debit_account_ids: UUID[]` и `credit_account_ids: UUID[]`, раскрывает выбранные счета по иерархии и оставляет +подходящий вид; забалансовые счета в MANUAL допускаются. Неизвестный счёт SHALL давать 422 `ACCOUNT_NOT_FOUND`, неверный +вид — 422 `ACCOUNT_KIND_MISMATCH`; пустой массив — 422 валидации тела. Невидимая и несуществующая версия SHALL +отвечать одинаковым 404 `NOT_FOUND`. + +Ответ SHALL содержать `companies[] {id, name}` для всего периметра и `cells[]` для каждой упорядоченной пары +разных компаний: `company_a_id`, `company_b_id`, `amount_a`, `amount_b`, `variance_amount`, `variance_percent`, +`exceeds_threshold`, `one_sided`, `skipped_osv_entry_count`, `osv_entry_ids_debit`, `osv_entry_ids_credit`. +Для пары `(A, B)` `amount_a` — сумма `closing_debit` строк A с контрагентом B по дебетовым счетам, +`amount_b` — сумма `closing_credit` строк B с контрагентом A по кредитовым. Расхождение — модуль разности; +процент — расхождение / меньшую сумму × 100 или null при нуле. `exceeds_threshold` SHALL быть true при точном +проценте > 5, до округления; суммы и процент в JSON SHALL быть десятичными строками с двумя знаками после +запятой (`ROUND_HALF_UP`). `one_sided` (пара без встречной стороны) SHALL быть true тогда и только тогда, когда +ровно одна из сумм `amount_a`, `amount_b` равна нулю (знак ненулевой суммы не важен); наличие строк ОСВ с нулевым +сальдо на признак не влияет. Пара подсвечивается, если `exceeds_threshold` или `one_sided`. `skipped_osv_entry_count` +SHALL считать исходные строки ОСВ пары с `account_id = null` на обеих сторонах; они не входят в суммы. Массивы +`osv_entry_ids_debit/credit` SHALL содержать ID исходных записей соответствующей стороны. + +#### Scenario: Пустой периметр и отсутствие ОСВ +- **WHEN** у версии нет членов периметра +- **THEN** `companies = []`, `cells = []`; если компании есть, но ОСВ по выбранным счетам нет, ячейки присутствуют с нулевыми суммами + +#### Scenario: Только одна сторона пары +- **WHEN** у A есть строка ОСВ с контрагентом B и ненулевым сальдо, а у B встречной строки нет +- **THEN** для `(A, B)` `one_sided = true`, `variance_percent = null`, соответствующий массив `osv_entry_ids_*` пуст + +#### Scenario: Встречная строка с нулевым сальдо +- **WHEN** у A по B сальдо 100 000 000, а у B по A есть строка ОСВ с нулевым сальдо (одни обороты) +- **THEN** `one_sided = true`, `exceeds_threshold = false`, пара подсвечивается + +#### Scenario: Обе стороны нулевые +- **WHEN** у A и у B есть строки ОСВ друг на друга, но обе суммы равны 0 +- **THEN** `one_sided = false`, `exceeds_threshold = false`, пара не подсвечивается + +#### Scenario: Отрицательное сальдо +- **WHEN** у A по B сальдо −50, у B по A — 0 +- **THEN** `one_sided = true` + +#### Scenario: Забалансовые счета +- **WHEN** у A по B есть сальдо на счёте 001 (`is_off_balance = true`) +- **THEN** в режиме ALL оно в суммы не входит; в MANUAL с выбранным счётом 001 — входит + +#### Scenario: Счёт не сопоставлен +- **WHEN** у пары есть строка свода с `account_id = null` и двумя `entry_ids` +- **THEN** она не входит в суммы, `skipped_osv_entry_count` обеих направленных ячеек пары увеличивается на 2 + +#### Scenario: Эталон «Русский бисквит» +- **WHEN** матрица строится по ОСВ РБ и Пекарни Счастливочной из эталонных фикстур +- **THEN** суммы сравниваются с эталоном только для точных пар счетов и компаний; общая сумма элиминации эталона не приравнивается к минимуму по паре в API (решение владельца 08.10.2026) + +### Requirement: XLSX шахматки +`GET …/intercompany-matrix/all/export` и `POST …/intercompany-matrix/manual/export` SHALL использовать +те же режимы, тело и права, что и соответствующие JSON-маршруты. Ответ — XLSX с именем +`intercompany-matrix_<ГК>_<год>-<квартал>_v.xlsx`, шапкой (ГК, период, версия, единицы, режим, +выбранные счета; для ALL — «Все балансовые счета») и строками разницы, дебета, кредита и процента расхождения для +каждой пары. Пара SHALL заливаться цветом порога, если `exceeds_threshold` или `one_sided` — так же, как в API. + +#### Scenario: Экспорт выбранных счетов +- **WHEN** пользователь выгружает MANUAL для ГК «Русский бисквит» за 2024 Q1, версия 1 +- **THEN** имя содержит `Русский бисквит_2024-Q1_v1.xlsx`, шапка содержит выбранные счета, ячейки процента показывают два знака и символ `%` без повторного масштабирования + +#### Scenario: Подсветка пары без встречной стороны +- **WHEN** выгружается ALL, у пары `amount_a = 100000000`, `amount_b = 0` +- **THEN** все строки пары залиты цветом порога, в шапке «Режим» и «Счета дебета/кредита» — «Все балансовые счета» diff --git a/openspec/changes/intercompany-matrix-one-sided/tasks.md b/openspec/changes/intercompany-matrix-one-sided/tasks.md new file mode 100644 index 0000000..d1864ca --- /dev/null +++ b/openspec/changes/intercompany-matrix-one-sided/tasks.md @@ -0,0 +1,8 @@ +## 1. Реализация (PR RSHB/arm-core#165, AURORA-1651) + +- [x] 1.1 Автор: `one_sided` по суммам, заливка xlsx по `exceeds_threshold or one_sided`, ALL без забалансовых счетов. +- [x] 1.2 Ревьюер: влив `main` (#141), конфликты; `one_sided` на отрицательных суммах; шапка ALL «Все балансовые счета»; + фильтр `/directories/accounts` убран; тесты (суммы, нули, отрицательные, xlsx, ALL/MANUAL с 001). +- [x] 1.3 Ревьюер: правила §6 и OQ в `../docs` (docs-PR вместе с этим change), гайд фронта §5.7.1. +- [x] 1.4 Ревьюер: подсветка `one_sided` на экране — PR #158, change `intercompany-matrix-ui`. +- [ ] 1.5 После слияния: архив change.