457 lines
14 KiB
Python
457 lines
14 KiB
Python
from __future__ import annotations
|
|
|
|
import json
|
|
import unittest
|
|
from dataclasses import dataclass
|
|
from datetime import UTC, datetime, timedelta
|
|
|
|
from sqlalchemy import create_engine
|
|
from sqlalchemy.orm import Session
|
|
|
|
from govoplan_core.core.dsar import (
|
|
DsarErasureActionRef,
|
|
DsarProvider,
|
|
DsarRecordRef,
|
|
DsarSubjectRef,
|
|
)
|
|
from govoplan_core.core.institutional import (
|
|
EvidenceReference,
|
|
InstitutionalReference,
|
|
PartyRepresentation,
|
|
PartySubjectReference,
|
|
ProcedureParty,
|
|
TemporalRevision,
|
|
)
|
|
from govoplan_core.db.base import Base
|
|
from govoplan_core.privacy.dsar_workflow import (
|
|
create_data_subject_request,
|
|
search_data_subject_request,
|
|
)
|
|
from govoplan_parties.backend.dsar_provider import (
|
|
PARTIES_DSAR_CAPABILITY,
|
|
PartiesDsarProvider,
|
|
)
|
|
from govoplan_parties.backend.manifest import manifest
|
|
from govoplan_parties.backend.service import record_procedure_party
|
|
|
|
|
|
NOW = datetime(2026, 8, 21, 10, 0, tzinfo=UTC)
|
|
|
|
|
|
@dataclass
|
|
class _Principal:
|
|
tenant_id: str
|
|
account_id: str
|
|
|
|
|
|
class _Registry:
|
|
def __init__(
|
|
self,
|
|
provider: PartiesDsarProvider,
|
|
*,
|
|
parties_active: bool = True,
|
|
) -> None:
|
|
self.provider = provider
|
|
self.parties_active = parties_active
|
|
|
|
def capability_names(self):
|
|
return (PARTIES_DSAR_CAPABILITY,)
|
|
|
|
def capability_owner(self, name):
|
|
self._assert_capability(name)
|
|
return "parties"
|
|
|
|
def tenant_entitlement_resolver(self):
|
|
parties_active = self.parties_active
|
|
|
|
class _Resolver:
|
|
@staticmethod
|
|
def resolve(session, tenant_id):
|
|
del session, tenant_id
|
|
return type(
|
|
"State",
|
|
(),
|
|
{"effective_modules": ("parties",) if parties_active else ()},
|
|
)()
|
|
|
|
return _Resolver()
|
|
|
|
def require_tenant_capability(self, name, session, **kwargs):
|
|
del session, kwargs
|
|
self._assert_capability(name)
|
|
return self.provider
|
|
|
|
def manifests(self):
|
|
return (type("Manifest", (), {"id": "parties"})(),)
|
|
|
|
@staticmethod
|
|
def _assert_capability(name: str) -> None:
|
|
if name != PARTIES_DSAR_CAPABILITY:
|
|
raise KeyError(name)
|
|
|
|
|
|
def _ref(
|
|
kind: str,
|
|
object_id: str,
|
|
owner: str,
|
|
*,
|
|
tenant_id: str,
|
|
version: str | None = "1",
|
|
) -> InstitutionalReference:
|
|
return InstitutionalReference(
|
|
kind=kind, # type: ignore[arg-type]
|
|
owner_module=owner,
|
|
object_id=object_id,
|
|
tenant_id=tenant_id,
|
|
version=version,
|
|
valid_at=NOW,
|
|
)
|
|
|
|
|
|
def _party(
|
|
party_id: str,
|
|
subject_id: str,
|
|
*,
|
|
tenant_id: str = "tenant-1",
|
|
revision: str = "1",
|
|
procedure_id: str = "case-1",
|
|
subject_kind: str = "identity",
|
|
subject_provider: str = "identity",
|
|
) -> ProcedureParty:
|
|
recorded_at = NOW + timedelta(minutes=int(revision) - 1)
|
|
representation = PartyRepresentation(
|
|
representative_party_ref=_ref(
|
|
"party",
|
|
party_id,
|
|
"parties",
|
|
tenant_id=tenant_id,
|
|
version="1",
|
|
),
|
|
represented_party_ref=_ref(
|
|
"party",
|
|
"counterparty-private-id",
|
|
"parties",
|
|
tenant_id=tenant_id,
|
|
version="1",
|
|
),
|
|
power_ref="power-1",
|
|
permitted_actions=("receive",),
|
|
temporal=TemporalRevision(
|
|
revision="1",
|
|
valid_from=NOW,
|
|
recorded_at=NOW,
|
|
change_reason="private-representation-reason-do-not-export",
|
|
),
|
|
evidence=(
|
|
EvidenceReference(
|
|
kind="document",
|
|
owner_module="files",
|
|
evidence_id="private-power-document-do-not-export",
|
|
tenant_id=tenant_id,
|
|
version="1",
|
|
),
|
|
),
|
|
)
|
|
return ProcedureParty(
|
|
reference=_ref(
|
|
"party",
|
|
party_id,
|
|
"parties",
|
|
tenant_id=tenant_id,
|
|
version=revision,
|
|
),
|
|
procedure_ref=_ref(
|
|
"case",
|
|
procedure_id,
|
|
"cases",
|
|
tenant_id=tenant_id,
|
|
),
|
|
role="representative",
|
|
subject=PartySubjectReference(
|
|
kind=subject_kind, # type: ignore[arg-type]
|
|
provider=subject_provider,
|
|
subject_id=subject_id,
|
|
tenant_id=tenant_id,
|
|
version="1",
|
|
),
|
|
temporal=TemporalRevision(
|
|
revision=revision,
|
|
valid_from=NOW,
|
|
recorded_at=recorded_at,
|
|
change_reason="private-party-change-reason-do-not-export",
|
|
),
|
|
preferred_channels=("postbox",),
|
|
permitted_channels=("postbox", "mail"),
|
|
delivery_recipient=True,
|
|
representations=(representation,),
|
|
contact_snapshot_refs=("addresses:snapshot-1",),
|
|
evidence=(
|
|
EvidenceReference(
|
|
kind="document",
|
|
owner_module="files",
|
|
evidence_id="private-party-document-do-not-export",
|
|
tenant_id=tenant_id,
|
|
version=revision,
|
|
),
|
|
),
|
|
)
|
|
|
|
|
|
class PartiesDsarProviderTests(unittest.TestCase):
|
|
def setUp(self) -> None:
|
|
self.engine = create_engine("sqlite+pysqlite:///:memory:")
|
|
Base.metadata.create_all(self.engine)
|
|
self.session = Session(self.engine)
|
|
self.provider = PartiesDsarProvider()
|
|
self.assertIsInstance(self.provider, DsarProvider)
|
|
|
|
operator = _Principal("tenant-1", "operator-1")
|
|
record_procedure_party(
|
|
self.session,
|
|
operator,
|
|
party=_party("party-1", "identity-1"),
|
|
)
|
|
record_procedure_party(
|
|
self.session,
|
|
operator,
|
|
party=_party("party-1", "identity-1", revision="2"),
|
|
expected_revision="1",
|
|
)
|
|
record_procedure_party(
|
|
self.session,
|
|
operator,
|
|
party=_party(
|
|
"party-unrelated",
|
|
"identity-unrelated",
|
|
procedure_id="case-private-unrelated",
|
|
),
|
|
)
|
|
record_procedure_party(
|
|
self.session,
|
|
_Principal("tenant-2", "operator-2"),
|
|
party=_party(
|
|
"party-other-tenant",
|
|
"identity-1",
|
|
tenant_id="tenant-2",
|
|
procedure_id="case-other-tenant",
|
|
),
|
|
)
|
|
self.session.commit()
|
|
|
|
def tearDown(self) -> None:
|
|
self.session.close()
|
|
self.engine.dispose()
|
|
|
|
def test_identity_search_is_tenant_scoped_minimized_and_versioned(self) -> None:
|
|
records = self.provider.search_subject(
|
|
self.session,
|
|
tenant_id="tenant-1",
|
|
subject=DsarSubjectRef(identity_id="identity-1"),
|
|
)
|
|
|
|
revisions = [
|
|
item
|
|
for item in records
|
|
if item.resource_type == "parties_procedure_party_revision"
|
|
]
|
|
current = [
|
|
item
|
|
for item in records
|
|
if item.resource_type == "parties_current_procedure_party"
|
|
]
|
|
self.assertEqual(2, len(revisions))
|
|
self.assertEqual(1, len(current))
|
|
self.assertEqual(["1", "2"], [item.data["revision"] for item in revisions])
|
|
self.assertTrue(all(item.immutable_evidence for item in revisions))
|
|
self.assertFalse(current[0].immutable_evidence)
|
|
|
|
exported = json.dumps([item.to_dict() for item in records], sort_keys=True)
|
|
self.assertIn("identity-1", exported)
|
|
self.assertIn("addresses:snapshot-1", exported)
|
|
self.assertNotIn("identity-unrelated", exported)
|
|
self.assertNotIn("case-private-unrelated", exported)
|
|
self.assertNotIn("case-other-tenant", exported)
|
|
self.assertNotIn("counterparty-private-id", exported)
|
|
self.assertNotIn("private-party-document-do-not-export", exported)
|
|
self.assertNotIn("private-power-document-do-not-export", exported)
|
|
self.assertNotIn("private-party-change-reason-do-not-export", exported)
|
|
self.assertNotIn("private-representation-reason-do-not-export", exported)
|
|
|
|
def test_account_attribution_does_not_export_unrelated_party_content(self) -> None:
|
|
records = self.provider.search_subject(
|
|
self.session,
|
|
tenant_id="tenant-1",
|
|
subject=DsarSubjectRef(account_id="operator-1"),
|
|
)
|
|
|
|
self.assertEqual(3, len(records))
|
|
self.assertTrue(
|
|
all(
|
|
item.resource_type == "parties_operator_attribution" for item in records
|
|
)
|
|
)
|
|
exported = json.dumps([item.to_dict() for item in records], sort_keys=True)
|
|
self.assertNotIn("identity-1", exported)
|
|
self.assertNotIn("identity-unrelated", exported)
|
|
self.assertNotIn("counterparty-private-id", exported)
|
|
self.assertNotIn("addresses:snapshot-1", exported)
|
|
|
|
def test_direct_references_and_canonical_conflicts_fail_closed(self) -> None:
|
|
direct = self.provider.search_subject(
|
|
self.session,
|
|
tenant_id="tenant-1",
|
|
subject=DsarSubjectRef(external_references={"parties.party": "party-1"}),
|
|
)
|
|
self.assertEqual(3, len(direct))
|
|
|
|
conflict = self.provider.search_subject(
|
|
self.session,
|
|
tenant_id="tenant-1",
|
|
subject=DsarSubjectRef(
|
|
identity_id="identity-1",
|
|
external_references={"parties.party": "party-unrelated"},
|
|
),
|
|
)
|
|
self.assertEqual((), conflict)
|
|
|
|
alias_conflict = self.provider.search_subject(
|
|
self.session,
|
|
tenant_id="tenant-1",
|
|
subject=DsarSubjectRef(
|
|
identity_id="identity-1",
|
|
external_references={"parties.identity": "identity-other"},
|
|
),
|
|
)
|
|
self.assertEqual((), alias_conflict)
|
|
|
|
def test_planning_retains_history_and_routes_current_fact_to_review(self) -> None:
|
|
subject = DsarSubjectRef(identity_id="identity-1")
|
|
records = self.provider.search_subject(
|
|
self.session,
|
|
tenant_id="tenant-1",
|
|
subject=subject,
|
|
)
|
|
actions = self.provider.plan_erasure(
|
|
self.session,
|
|
tenant_id="tenant-1",
|
|
subject=subject,
|
|
records=records,
|
|
)
|
|
|
|
self.assertEqual(2, sum(item.kind == "retain" for item in actions))
|
|
self.assertEqual(1, sum(item.kind == "manual_review" for item in actions))
|
|
self.assertTrue(all(not item.executable for item in actions))
|
|
results = self.provider.execute_erasure(
|
|
self.session,
|
|
tenant_id="tenant-1",
|
|
subject=subject,
|
|
actions=actions,
|
|
request_id="dsar-1",
|
|
)
|
|
self.assertTrue(all(item.status == "blocked" for item in results))
|
|
|
|
def test_foreign_records_and_actions_are_rejected(self) -> None:
|
|
subject = DsarSubjectRef(identity_id="identity-1")
|
|
foreign_record = DsarRecordRef(
|
|
provider_id="foreign",
|
|
module_id="foreign",
|
|
resource_type="foreign",
|
|
resource_id="foreign-1",
|
|
category="foreign",
|
|
title="Foreign record",
|
|
)
|
|
with self.assertRaisesRegex(ValueError, "foreign provider record"):
|
|
self.provider.plan_erasure(
|
|
self.session,
|
|
tenant_id="tenant-1",
|
|
subject=subject,
|
|
records=(foreign_record,),
|
|
)
|
|
|
|
foreign_action = DsarErasureActionRef(
|
|
action_id="foreign:delete:1",
|
|
provider_id="foreign",
|
|
module_id="foreign",
|
|
kind="delete",
|
|
resource_type="foreign",
|
|
resource_id="foreign-1",
|
|
title="Delete foreign",
|
|
rationale="No",
|
|
executable=True,
|
|
)
|
|
with self.assertRaisesRegex(ValueError, "foreign provider action"):
|
|
self.provider.execute_erasure(
|
|
self.session,
|
|
tenant_id="tenant-1",
|
|
subject=subject,
|
|
actions=(foreign_action,),
|
|
request_id="dsar-1",
|
|
)
|
|
|
|
def test_workflow_discovers_only_the_active_tenant_capability(self) -> None:
|
|
active = create_data_subject_request(
|
|
self.session,
|
|
tenant_id="tenant-1",
|
|
reference="DSAR-PARTIES-1",
|
|
request_kind="access",
|
|
subject=DsarSubjectRef(identity_id="identity-1"),
|
|
purpose="Subject access request",
|
|
legal_basis=None,
|
|
due_at=None,
|
|
requested_by_account_id="privacy-operator",
|
|
)
|
|
search_data_subject_request(
|
|
self.session,
|
|
registry=_Registry(self.provider),
|
|
row=active,
|
|
expected_revision=1,
|
|
)
|
|
self.assertEqual("searched", active.status)
|
|
self.assertEqual(
|
|
[PARTIES_DSAR_CAPABILITY], active.coverage["provider_capabilities"]
|
|
)
|
|
self.assertEqual(["parties"], active.coverage["covered_modules"])
|
|
|
|
inactive = create_data_subject_request(
|
|
self.session,
|
|
tenant_id="tenant-1",
|
|
reference="DSAR-PARTIES-2",
|
|
request_kind="access",
|
|
subject=DsarSubjectRef(identity_id="identity-1"),
|
|
purpose="Inactive module coverage",
|
|
legal_basis=None,
|
|
due_at=None,
|
|
requested_by_account_id="privacy-operator",
|
|
)
|
|
search_data_subject_request(
|
|
self.session,
|
|
registry=_Registry(self.provider, parties_active=False),
|
|
row=inactive,
|
|
expected_revision=1,
|
|
)
|
|
self.assertEqual([], inactive.coverage["provider_capabilities"])
|
|
self.assertEqual(
|
|
[PARTIES_DSAR_CAPABILITY],
|
|
inactive.coverage["inactive_provider_capabilities"],
|
|
)
|
|
self.assertEqual(0, inactive.search_result["record_count"])
|
|
|
|
def test_manifest_registers_and_documents_the_capability(self) -> None:
|
|
self.assertIn(PARTIES_DSAR_CAPABILITY, manifest.capability_factories)
|
|
self.assertIn(PARTIES_DSAR_CAPABILITY, manifest.capability_documentation)
|
|
self.assertIn(
|
|
PARTIES_DSAR_CAPABILITY,
|
|
{item.name for item in manifest.provides_interfaces},
|
|
)
|
|
self.assertTrue(
|
|
any(
|
|
topic.id == "parties.data-subject-requests"
|
|
and {"admin", "user"}.issubset(topic.documentation_types)
|
|
for topic in manifest.documentation
|
|
)
|
|
)
|
|
|
|
|
|
if __name__ == "__main__":
|
|
unittest.main()
|