Initial commit: Port Nimara CRM (Layers 0-4)
Full CRM rebuild with Next.js 15, TypeScript, Tailwind, Drizzle ORM, PostgreSQL, Redis, BullMQ, MinIO, and Socket.io. Includes 461 source files covering clients, berths, interests/pipeline, documents/EOI, expenses/invoices, email, notifications, dashboard, admin, and client portal. CI/CD via Gitea Actions with Docker builds. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
320
tests/integration/crud-audit.test.ts
Normal file
320
tests/integration/crud-audit.test.ts
Normal file
@@ -0,0 +1,320 @@
|
||||
/**
|
||||
* CRUD audit log integration tests.
|
||||
*
|
||||
* For each entity type (clients, interests, berths):
|
||||
* - Create → verify audit log entry with action='create'
|
||||
* - Update → verify audit log with action='update' and old/new values
|
||||
* - Archive → verify audit log with action='archive'
|
||||
* - Restore → verify audit log with action='restore'
|
||||
*
|
||||
* Skips gracefully when TEST_DATABASE_URL is not reachable.
|
||||
*/
|
||||
import { describe, it, expect, beforeAll, afterAll, vi } from 'vitest';
|
||||
|
||||
import { makeAuditMeta, makeCreateClientInput, makeCreateInterestInput } from '../helpers/factories';
|
||||
|
||||
const TEST_DB_URL =
|
||||
process.env.TEST_DATABASE_URL || 'postgresql://test:test@localhost:5433/portnimara_test';
|
||||
|
||||
let dbAvailable = false;
|
||||
|
||||
beforeAll(async () => {
|
||||
try {
|
||||
const postgres = (await import('postgres')).default;
|
||||
const sql = postgres(TEST_DB_URL, { max: 1, idle_timeout: 3, connect_timeout: 3 });
|
||||
await sql`SELECT 1`;
|
||||
await sql.end();
|
||||
dbAvailable = true;
|
||||
} catch {
|
||||
console.warn('[crud-audit] Test database not available — skipping integration tests');
|
||||
}
|
||||
});
|
||||
|
||||
function itDb(name: string, fn: () => Promise<void>) {
|
||||
it(name, async () => {
|
||||
if (!dbAvailable) return;
|
||||
await fn();
|
||||
});
|
||||
}
|
||||
|
||||
// ─── Helpers ─────────────────────────────────────────────────────────────────
|
||||
|
||||
async function seedPort(): Promise<string> {
|
||||
const postgres = (await import('postgres')).default;
|
||||
const sql = postgres(TEST_DB_URL, { max: 1 });
|
||||
const portId = crypto.randomUUID();
|
||||
await sql`
|
||||
INSERT INTO ports (id, name, slug, country, currency, timezone)
|
||||
VALUES (${portId}, 'Audit Test Port', ${'audit-' + portId.slice(0, 8)}, 'AU', 'AUD', 'UTC')
|
||||
`;
|
||||
await sql.end();
|
||||
return portId;
|
||||
}
|
||||
|
||||
async function cleanupPort(portId: string): Promise<void> {
|
||||
const postgres = (await import('postgres')).default;
|
||||
const sql = postgres(TEST_DB_URL, { max: 1 });
|
||||
await sql`DELETE FROM ports WHERE id = ${portId}`;
|
||||
await sql.end();
|
||||
}
|
||||
|
||||
async function getAuditEntries(
|
||||
portId: string,
|
||||
entityId: string,
|
||||
action?: string,
|
||||
): Promise<Array<Record<string, unknown>>> {
|
||||
const postgres = (await import('postgres')).default;
|
||||
const sql = postgres(TEST_DB_URL, { max: 1 });
|
||||
let rows: Array<Record<string, unknown>>;
|
||||
|
||||
if (action) {
|
||||
rows = await sql<Array<Record<string, unknown>>>`
|
||||
SELECT * FROM audit_logs
|
||||
WHERE port_id = ${portId}
|
||||
AND entity_id = ${entityId}
|
||||
AND action = ${action}
|
||||
ORDER BY created_at ASC
|
||||
`;
|
||||
} else {
|
||||
rows = await sql<Array<Record<string, unknown>>>`
|
||||
SELECT * FROM audit_logs
|
||||
WHERE port_id = ${portId}
|
||||
AND entity_id = ${entityId}
|
||||
ORDER BY created_at ASC
|
||||
`;
|
||||
}
|
||||
|
||||
await sql.end();
|
||||
return rows;
|
||||
}
|
||||
|
||||
// ─── Client Audit Tests ───────────────────────────────────────────────────────
|
||||
|
||||
describe('CRUD Audit — Clients', () => {
|
||||
let portId: string;
|
||||
|
||||
vi.mock('@/lib/socket/server', () => ({ emitToRoom: vi.fn() }));
|
||||
vi.mock('@/lib/queue', () => ({
|
||||
getQueue: () => ({ add: vi.fn().mockResolvedValue(undefined) }),
|
||||
}));
|
||||
|
||||
beforeAll(async () => {
|
||||
if (!dbAvailable) return;
|
||||
portId = await seedPort();
|
||||
});
|
||||
|
||||
afterAll(async () => {
|
||||
if (!dbAvailable) return;
|
||||
await cleanupPort(portId);
|
||||
});
|
||||
|
||||
itDb('create generates an audit log entry with action=create', async () => {
|
||||
const { createClient } = await import('@/lib/services/clients.service');
|
||||
const meta = makeAuditMeta({ portId });
|
||||
|
||||
const client = await createClient(portId, makeCreateClientInput({ fullName: 'Audit Create Client' }), meta);
|
||||
|
||||
await new Promise((r) => setTimeout(r, 100));
|
||||
|
||||
const logs = await getAuditEntries(portId, client.id, 'create');
|
||||
expect(logs.length).toBeGreaterThanOrEqual(1);
|
||||
|
||||
const log = logs[0]!;
|
||||
expect(log.entity_type).toBe('client');
|
||||
expect(log.action).toBe('create');
|
||||
const newVal = log.new_value as Record<string, unknown>;
|
||||
expect(newVal.fullName).toBe('Audit Create Client');
|
||||
});
|
||||
|
||||
itDb('update generates an audit log entry with action=update', async () => {
|
||||
const { createClient, updateClient } = await import('@/lib/services/clients.service');
|
||||
const meta = makeAuditMeta({ portId });
|
||||
|
||||
const client = await createClient(portId, makeCreateClientInput({ fullName: 'Before Update' }), meta);
|
||||
|
||||
await updateClient(client.id, portId, { fullName: 'After Update' }, meta);
|
||||
|
||||
await new Promise((r) => setTimeout(r, 100));
|
||||
|
||||
const logs = await getAuditEntries(portId, client.id, 'update');
|
||||
expect(logs.length).toBeGreaterThanOrEqual(1);
|
||||
|
||||
const updateLog = logs[logs.length - 1]!;
|
||||
expect(updateLog.action).toBe('update');
|
||||
const newVal = updateLog.new_value as Record<string, unknown>;
|
||||
expect(newVal.fullName).toBe('After Update');
|
||||
});
|
||||
|
||||
itDb('archive generates an audit log entry with action=archive', async () => {
|
||||
const { createClient, archiveClient } = await import('@/lib/services/clients.service');
|
||||
const meta = makeAuditMeta({ portId });
|
||||
|
||||
const client = await createClient(portId, makeCreateClientInput({ fullName: 'Audit Archive Client' }), meta);
|
||||
|
||||
await archiveClient(client.id, portId, meta);
|
||||
|
||||
await new Promise((r) => setTimeout(r, 100));
|
||||
|
||||
const logs = await getAuditEntries(portId, client.id, 'archive');
|
||||
expect(logs.length).toBeGreaterThanOrEqual(1);
|
||||
expect(logs[0]!.action).toBe('archive');
|
||||
});
|
||||
|
||||
itDb('restore generates an audit log entry with action=restore', async () => {
|
||||
const { createClient, archiveClient, restoreClient } = await import('@/lib/services/clients.service');
|
||||
const meta = makeAuditMeta({ portId });
|
||||
|
||||
const client = await createClient(portId, makeCreateClientInput({ fullName: 'Audit Restore Client' }), meta);
|
||||
|
||||
await archiveClient(client.id, portId, meta);
|
||||
await restoreClient(client.id, portId, meta);
|
||||
|
||||
await new Promise((r) => setTimeout(r, 100));
|
||||
|
||||
const logs = await getAuditEntries(portId, client.id, 'restore');
|
||||
expect(logs.length).toBeGreaterThanOrEqual(1);
|
||||
expect(logs[0]!.action).toBe('restore');
|
||||
});
|
||||
});
|
||||
|
||||
// ─── Interest Audit Tests ─────────────────────────────────────────────────────
|
||||
|
||||
describe('CRUD Audit — Interests', () => {
|
||||
let portId: string;
|
||||
let clientId: string;
|
||||
|
||||
vi.mock('@/lib/socket/server', () => ({ emitToRoom: vi.fn() }));
|
||||
vi.mock('@/lib/queue', () => ({
|
||||
getQueue: () => ({ add: vi.fn().mockResolvedValue(undefined) }),
|
||||
}));
|
||||
|
||||
beforeAll(async () => {
|
||||
if (!dbAvailable) return;
|
||||
portId = await seedPort();
|
||||
|
||||
const { createClient } = await import('@/lib/services/clients.service');
|
||||
const client = await createClient(portId, makeCreateClientInput({ fullName: 'Interest Audit Client' }), makeAuditMeta({ portId }));
|
||||
clientId = client.id;
|
||||
});
|
||||
|
||||
afterAll(async () => {
|
||||
if (!dbAvailable) return;
|
||||
await cleanupPort(portId);
|
||||
});
|
||||
|
||||
itDb('create generates audit log with action=create', async () => {
|
||||
const { createInterest } = await import('@/lib/services/interests.service');
|
||||
const meta = makeAuditMeta({ portId });
|
||||
|
||||
const interest = await createInterest(portId, makeCreateInterestInput({ clientId }), meta);
|
||||
|
||||
await new Promise((r) => setTimeout(r, 100));
|
||||
|
||||
const logs = await getAuditEntries(portId, interest.id, 'create');
|
||||
expect(logs.length).toBeGreaterThanOrEqual(1);
|
||||
|
||||
const log = logs[0]!;
|
||||
expect(log.entity_type).toBe('interest');
|
||||
const newVal = log.new_value as Record<string, unknown>;
|
||||
expect(newVal.pipelineStage).toBe('open');
|
||||
});
|
||||
|
||||
itDb('update generates audit log with action=update', async () => {
|
||||
const { createInterest, updateInterest } = await import('@/lib/services/interests.service');
|
||||
const meta = makeAuditMeta({ portId });
|
||||
|
||||
const interest = await createInterest(portId, { ...makeCreateInterestInput({ clientId }), notes: 'initial' }, meta);
|
||||
|
||||
await updateInterest(interest.id, portId, { notes: 'updated notes' }, meta);
|
||||
|
||||
await new Promise((r) => setTimeout(r, 100));
|
||||
|
||||
const logs = await getAuditEntries(portId, interest.id, 'update');
|
||||
expect(logs.length).toBeGreaterThanOrEqual(1);
|
||||
});
|
||||
|
||||
itDb('archive generates audit log with action=archive', async () => {
|
||||
const { createInterest, archiveInterest } = await import('@/lib/services/interests.service');
|
||||
const meta = makeAuditMeta({ portId });
|
||||
|
||||
const interest = await createInterest(portId, makeCreateInterestInput({ clientId }), meta);
|
||||
|
||||
await archiveInterest(interest.id, portId, meta);
|
||||
|
||||
await new Promise((r) => setTimeout(r, 100));
|
||||
|
||||
const logs = await getAuditEntries(portId, interest.id, 'archive');
|
||||
expect(logs.length).toBeGreaterThanOrEqual(1);
|
||||
expect(logs[0]!.action).toBe('archive');
|
||||
});
|
||||
|
||||
itDb('restore generates audit log with action=restore', async () => {
|
||||
const { createInterest, archiveInterest, restoreInterest } = await import('@/lib/services/interests.service');
|
||||
const meta = makeAuditMeta({ portId });
|
||||
|
||||
const interest = await createInterest(portId, makeCreateInterestInput({ clientId }), meta);
|
||||
|
||||
await archiveInterest(interest.id, portId, meta);
|
||||
await restoreInterest(interest.id, portId, meta);
|
||||
|
||||
await new Promise((r) => setTimeout(r, 100));
|
||||
|
||||
const logs = await getAuditEntries(portId, interest.id, 'restore');
|
||||
expect(logs.length).toBeGreaterThanOrEqual(1);
|
||||
});
|
||||
});
|
||||
|
||||
// ─── Berth Audit Tests ────────────────────────────────────────────────────────
|
||||
|
||||
describe('CRUD Audit — Berths', () => {
|
||||
let portId: string;
|
||||
let berthId: string;
|
||||
|
||||
vi.mock('@/lib/socket/server', () => ({ emitToRoom: vi.fn() }));
|
||||
vi.mock('@/lib/queue', () => ({
|
||||
getQueue: () => ({ add: vi.fn().mockResolvedValue(undefined) }),
|
||||
}));
|
||||
|
||||
beforeAll(async () => {
|
||||
if (!dbAvailable) return;
|
||||
portId = await seedPort();
|
||||
|
||||
const postgres = (await import('postgres')).default;
|
||||
const sql = postgres(TEST_DB_URL, { max: 1 });
|
||||
berthId = crypto.randomUUID();
|
||||
await sql`
|
||||
INSERT INTO berths (id, port_id, mooring_number, status)
|
||||
VALUES (${berthId}, ${portId}, 'AUDIT-B1', 'available')
|
||||
`;
|
||||
await sql.end();
|
||||
});
|
||||
|
||||
afterAll(async () => {
|
||||
if (!dbAvailable) return;
|
||||
await cleanupPort(portId);
|
||||
});
|
||||
|
||||
itDb('updateBerth generates audit log with action=update', async () => {
|
||||
const { updateBerth } = await import('@/lib/services/berths.service');
|
||||
const meta = makeAuditMeta({ portId });
|
||||
|
||||
await updateBerth(berthId, portId, { area: 'North Pier', berthApproved: true }, meta);
|
||||
|
||||
await new Promise((r) => setTimeout(r, 100));
|
||||
|
||||
const logs = await getAuditEntries(portId, berthId, 'update');
|
||||
expect(logs.length).toBeGreaterThanOrEqual(1);
|
||||
expect(logs[0]!.entity_type).toBe('berth');
|
||||
});
|
||||
|
||||
itDb('updateBerth on wrong portId throws NotFoundError', async () => {
|
||||
const { updateBerth } = await import('@/lib/services/berths.service');
|
||||
const { NotFoundError } = await import('@/lib/errors');
|
||||
const wrongPortId = crypto.randomUUID();
|
||||
const meta = makeAuditMeta({ portId: wrongPortId });
|
||||
|
||||
await expect(
|
||||
updateBerth(berthId, wrongPortId, { area: 'Should fail' }, meta),
|
||||
).rejects.toThrow(NotFoundError);
|
||||
});
|
||||
});
|
||||
Reference in New Issue
Block a user