feat(phase-4b): backend business-logic, 8 entities, 32 endpoints, 58 tests

tests/conftest.py

@@ -142,3 +142,134 @@ async def second_user(
         "password": payload["password"],
         "name": payload["name"],
     }
+
+
+@pytest_asyncio.fixture
+async def seed_data(
+    client: AsyncClient,
+    registered_user: dict[str, Any],
+    session_factory: async_sessionmaker[AsyncSession],
+) -> dict[str, Any]:
+    """Seed a representative data set for business-logic tests.
+
+    Creates (via the API to exercise FK constraints end-to-end):
+    - 2 accounts owned by the bootstrap admin user
+    - 3 contacts (2 attached to accounts, 1 standalone)
+    - 5 deals across various stages
+    - 10 activities (some overdue, some completed)
+    - 3 tags (VIP, Strategic, Enterprise)
+    - 4 notes (mixed parents)
+
+    Returns a dict with all IDs + a ref to the auth headers for convenience.
+    """
+    headers = registered_user["headers"]
+
+    # 2 accounts
+    acc1 = await client.post(
+        "/api/v1/accounts/",
+        json={"name": "Acme Corp", "industry": "sme", "size": "sme", "website": "https://acme.test"},
+        headers=headers,
+    )
+    assert acc1.status_code == 201, f"seed acc1: {acc1.status_code} {acc1.text}"
+    acc1_id = acc1.json()["id"]
+
+    acc2 = await client.post(
+        "/api/v1/accounts/",
+        json={"name": "Globex GmbH", "industry": "enterprise", "size": "enterprise"},
+        headers=headers,
+    )
+    assert acc2.status_code == 201, f"seed acc2: {acc2.status_code} {acc2.text}"
+    acc2_id = acc2.json()["id"]
+
+    # 3 contacts (2 with account, 1 standalone)
+    c1 = await client.post(
+        "/api/v1/contacts/",
+        json={"first_name": "Anna", "last_name": "Schmidt", "email": "anna@acme.example", "account_id": acc1_id},
+        headers=headers,
+    )
+    assert c1.status_code == 201, c1.text
+    c1_id = c1.json()["id"]
+
+    c2 = await client.post(
+        "/api/v1/contacts/",
+        json={"first_name": "Bob", "last_name": "Mueller", "email": "bob@globex.example", "account_id": acc2_id},
+        headers=headers,
+    )
+    assert c2.status_code == 201, c2.text
+    c2_id = c2.json()["id"]
+
+    c3 = await client.post(
+        "/api/v1/contacts/",
+        json={"first_name": "Clara", "last_name": "Weber", "email": "clara@x.example"},
+        headers=headers,
+    )
+    assert c3.status_code == 201, c3.text
+    c3_id = c3.json()["id"]
+
+    # 5 deals (different stages)
+    deal_ids: list[int] = []
+    for i, (title, stage) in enumerate([
+        ("Deal A", "lead"),
+        ("Deal B", "qualified"),
+        ("Deal C", "proposal"),
+        ("Deal D", "negotiation"),
+        ("Deal E", "won"),
+    ]):
+        d = await client.post(
+            "/api/v1/deals/",
+            json={
+                "title": title,
+                "value": str(1000 * (i + 1)),
+                "stage": stage,
+                "account_id": acc1_id if i % 2 == 0 else acc2_id,
+            },
+            headers=headers,
+        )
+        assert d.status_code == 201, d.text
+        deal_ids.append(d.json()["id"])
+
+    # 10 activities (4 overdue, 4 future, 2 completed)
+    from datetime import UTC, datetime, timedelta
+    past = (datetime.now(UTC) - timedelta(days=2)).isoformat()
+    future = (datetime.now(UTC) + timedelta(days=2)).isoformat()
+    future2 = (datetime.now(UTC) + timedelta(days=10)).isoformat()
+    activity_ids: list[int] = []
+    for i in range(10):
+        if i < 4:
+            due = past
+            body_data: dict[str, object] = {"type": "task", "subject": f"Overdue task {i}", "due_date": due, "deal_id": deal_ids[i % 5]}
+        elif i < 8:
+            due = future if i % 2 == 0 else future2
+            body_data = {"type": "call", "subject": f"Upcoming call {i}", "due_date": due, "account_id": acc1_id}
+        else:
+            body_data = {"type": "meeting", "subject": f"Done meeting {i}", "account_id": acc1_id}
+        a = await client.post("/api/v1/activities/", json=body_data, headers=headers)
+        assert a.status_code == 201, a.text
+        activity_ids.append(a.json()["id"])
+
+    # 3 tags
+    tag_ids: list[int] = []
+    for name in ["VIP", "Strategic", "Enterprise"]:
+        t = await client.post("/api/v1/tags/", json={"name": name, "color": "#FF0080"}, headers=headers)
+        assert t.status_code == 201, t.text
+        tag_ids.append(t.json()["id"])
+
+    # 4 notes (mixed parents: 2 account, 1 contact, 1 deal)
+    n1 = await client.post("/api/v1/notes/", json={"body": "Note on Acme", "parent_type": "account", "parent_id": acc1_id}, headers=headers)
+    assert n1.status_code == 201, n1.text
+    n2 = await client.post("/api/v1/notes/", json={"body": "Note on Globex", "parent_type": "account", "parent_id": acc2_id}, headers=headers)
+    assert n2.status_code == 201, n2.text
+    n3 = await client.post("/api/v1/notes/", json={"body": "Note on Anna", "parent_type": "contact", "parent_id": c1_id}, headers=headers)
+    assert n3.status_code == 201, n3.text
+    n4 = await client.post("/api/v1/notes/", json={"body": "Note on Deal A", "parent_type": "deal", "parent_id": deal_ids[0]}, headers=headers)
+    assert n4.status_code == 201, n4.text
+
+    return {
+        "account_ids": [acc1_id, acc2_id],
+        "contact_ids": [c1_id, c2_id, c3_id],
+        "deal_ids": deal_ids,
+        "activity_ids": activity_ids,
+        "tag_ids": tag_ids,
+        "note_ids": [n1.json()["id"], n2.json()["id"], n3.json()["id"], n4.json()["id"]],
+        "headers": headers,
+    }