support_backend/tests/integration/support-org-hierarchy.test.ts

import { describe, it, expect, beforeAll, afterAll } from 'vitest';
import { buildApp } from '@/app';
import { prismaClient } from '@/infrastructure/database';
import { FastifyInstance } from 'fastify';

/** Covers specs/006-support-organization/quickstart.md Scenario 3 against a real Postgres. */
describe('Support organization — dynamic hierarchy (User Story 3)', () => {
  let app: FastifyInstance;
  const rootName = `Test Root ${Date.now()}`;
  let rootId: string;
  let childId: string;

  beforeAll(async () => {
    app = await buildApp();
  });

  afterAll(async () => {
    await prismaClient.hierarchyNode.deleteMany({
      where: { name: { startsWith: 'Test' }, id: { in: [rootId, childId].filter(Boolean) } },
    });
    await prismaClient.auditLog.deleteMany({
      where: { entityType: 'HierarchyNode', entityId: { in: [rootId, childId].filter(Boolean) } },
    });
    await app.close();
  });

  it('Scenario 3: parent/child creation, order, nonexistent parent rejected, cycle rejected, deactivation does not cascade', async () => {
    const createRoot = await app.inject({
      method: 'POST',
      url: '/admin/hierarchy-nodes',
      payload: { name: rootName, order: 0, assignmentStrategy: 'ROUND_ROBIN' },
    });
    expect(createRoot.statusCode).toBe(201);
    rootId = createRoot.json().data.id;

    const createChild = await app.inject({
      method: 'POST',
      url: '/admin/hierarchy-nodes',
      payload: {
        name: `${rootName} Child`,
        parentId: rootId,
        order: 0,
        assignmentStrategy: 'ROUND_ROBIN',
      },
    });
    expect(createChild.statusCode).toBe(201);
    childId = createChild.json().data.id;

    const children = await app.inject({
      method: 'GET',
      url: `/admin/hierarchy-nodes/${rootId}/children`,
    });
    expect(children.json().data.map((n: { id: string }) => n.id)).toContain(childId);

    const badParent = await app.inject({
      method: 'POST',
      url: '/admin/hierarchy-nodes',
      payload: {
        name: 'Orphan',
        parentId: 'nonexistent-node-id',
        order: 0,
        assignmentStrategy: 'ROUND_ROBIN',
      },
    });
    expect(badParent.statusCode).toBe(404);

    const selfCycle = await app.inject({
      method: 'PUT',
      url: `/admin/hierarchy-nodes/${childId}`,
      payload: {
        name: `${rootName} Child`,
        parentId: childId,
        order: 0,
        assignmentStrategy: 'ROUND_ROBIN',
      },
    });
    expect(selfCycle.statusCode).toBe(400);
    expect(selfCycle.json().error.code).toBe('CYCLE_DETECTED');

    const transitiveCycle = await app.inject({
      method: 'PUT',
      url: `/admin/hierarchy-nodes/${rootId}`,
      payload: { name: rootName, parentId: childId, order: 0, assignmentStrategy: 'ROUND_ROBIN' },
    });
    expect(transitiveCycle.statusCode).toBe(400);
    expect(transitiveCycle.json().error.code).toBe('CYCLE_DETECTED');

    await app.inject({ method: 'PATCH', url: `/admin/hierarchy-nodes/${rootId}/deactivate` });
    const activeTree = await app.inject({
      method: 'GET',
      url: '/admin/hierarchy-nodes?active=true',
    });
    const activeIds = activeTree.json().data.map((n: { id: string }) => n.id);
    expect(activeIds).not.toContain(rootId);

    const childAfterParentDeactivation = await app.inject({
      method: 'GET',
      url: `/admin/hierarchy-nodes/${childId}`,
    });
    expect(childAfterParentDeactivation.json().data.active).toBe(true);
  });

  it('preserves sibling order under the same parent', async () => {
    const parent = await app.inject({
      method: 'POST',
      url: '/admin/hierarchy-nodes',
      payload: { name: `${rootName} Order Parent`, order: 0, assignmentStrategy: 'ROUND_ROBIN' },
    });
    const parentId = parent.json().data.id;

    const second = await app.inject({
      method: 'POST',
      url: '/admin/hierarchy-nodes',
      payload: { name: 'Second', parentId, order: 2, assignmentStrategy: 'ROUND_ROBIN' },
    });
    const first = await app.inject({
      method: 'POST',
      url: '/admin/hierarchy-nodes',
      payload: { name: 'First', parentId, order: 1, assignmentStrategy: 'ROUND_ROBIN' },
    });

    const children = await app.inject({
      method: 'GET',
      url: `/admin/hierarchy-nodes/${parentId}/children`,
    });
    const orderedIds = children.json().data.map((n: { id: string }) => n.id);
    expect(orderedIds).toEqual([first.json().data.id, second.json().data.id]);

    await prismaClient.hierarchyNode.deleteMany({
      where: { id: { in: [parentId, first.json().data.id, second.json().data.id] } },
    });
    await prismaClient.auditLog.deleteMany({
      where: {
        entityType: 'HierarchyNode',
        entityId: { in: [parentId, first.json().data.id, second.json().data.id] },
      },
    });
  });

  it('every create/edit/activate/deactivate writes exactly one audit log row', async () => {
    const created = await app.inject({
      method: 'POST',
      url: '/admin/hierarchy-nodes',
      payload: { name: `${rootName} Audited`, order: 0, assignmentStrategy: 'ROUND_ROBIN' },
    });
    const nodeId = created.json().data.id;

    await app.inject({ method: 'PATCH', url: `/admin/hierarchy-nodes/${nodeId}/deactivate` });
    await app.inject({ method: 'PATCH', url: `/admin/hierarchy-nodes/${nodeId}/activate` });

    const auditRows = await prismaClient.auditLog.findMany({
      where: { entityType: 'HierarchyNode', entityId: nodeId },
    });
    expect(auditRows).toHaveLength(3); // created, deactivated, activated

    await prismaClient.hierarchyNode.deleteMany({ where: { id: nodeId } });
    await prismaClient.auditLog.deleteMany({
      where: { entityType: 'HierarchyNode', entityId: nodeId },
    });
  });
});