Implements all 39 tasks from specs/003-ticketing/tasks.md across all
three user stories -- Phase 5 of the roadmap.
Schema (prisma/schema.prisma + migration):
- Ticket (code, status, version for optimistic concurrency,
idempotencyKey, customerId FK), Problem, TicketMessage,
TicketAttachment per docs/06, with Product/Category/
CustomerReference back-relations.
User Story 1 -- ticket/problem creation (P1, MVP):
- Explicit 12-state lifecycle adjacency table
(ticket-state-machine.ts), not "any transition allowed."
- Ticket code generation (<PRODUCT_CODE>-<YEAR>-<SEQUENCE>) scoped
by the actual code prefix, not productId -- see the collision bug
fixed below.
- Idempotency-key enforcement via atomic create-then-catch-conflict
(never a read-then-write race), completing the FR-012 placeholder
from 002-saas-integration.
- Explicit-reference-only recurring-problem linking (no fuzzy
matching -- that's a future AI-support concern).
- POST /v1/support/requests (002-saas-integration) now creates a
real ticket instead of echoing context back.
- PATCH /tickets/:id/status with expectedVersion-based optimistic
concurrency (409 on stale version, 400 on an invalid transition).
User Story 2 -- typed messages (P2):
- Message type -> visibleToCustomer mapping is a fixed constant map,
never caller-supplied; customer-scoped reads filter at the query
layer so an internal note is never fetched, not just hidden.
- POST/GET /tickets/:id/messages (customer-scoped) and
GET /agent/tickets/:id/messages (agent-scoped).
User Story 3 -- attachment pipeline (P3):
- Presigned-PUT upload (new getPresignedUploadUrl on the existing
storageService) -- file bytes never transit this API.
- A MalwareScanner interface with a fail-closed placeholder
(UnimplementedPlaceholderScanner) since no scanner exists in this
stack -- it always reports 'infected', never silently 'clean'.
- The existing attachments-queue job stub now actually calls the
scanner and updates scanStatus; registerAttachmentWorker() is
wired into bootstrapQueue() (previously defined but never called).
- Downloads are gated on scanStatus === 'clean' -- currently always
refused until a real scanner replaces the placeholder.
- MinIO added to docker-compose.{test,development}.yml for local/CI
S3-compatible storage, matching doc 04's explicit guidance.
Two real bugs found and fixed via integration testing against a
live Postgres/Redis/MinIO (not just typechecked):
- Ticket codes could collide across different products: the
sequence counter was scoped by internal productId, but the code
column's uniqueness is global, and deriveProductCode's 4-character
truncation means different products can share a prefix. Fixed by
counting against the actual code prefix instead.
- Three existing 002-saas-integration integration tests' cleanup
started failing an FK RESTRICT check once ticket creation was
wired in (deleting a Product before the Ticket/Problem that now
reference it). Fixed their afterAll ordering.
All 9 integration test files (24 tests, spanning this feature and
the pre-existing suite) verified passing against real Postgres,
Redis, and MinIO, including a genuine presigned-PUT/GET round trip.
Full quality gate (typecheck/lint/format/architecture/unit tests)
passes.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
115 lines
4.0 KiB
TypeScript
115 lines
4.0 KiB
TypeScript
import { describe, it, expect, beforeAll, afterAll } from 'vitest';
|
|
import { buildApp } from '@/app';
|
|
import { prismaClient } from '@/infrastructure/database';
|
|
import { FastifyInstance } from 'fastify';
|
|
import {
|
|
encryptCredential,
|
|
generateCredentialSecret,
|
|
issueIntegrationToken,
|
|
} from '@/modules/catalog/products';
|
|
import { MESSAGE_TYPES } from '@/modules/ticketing/messages/mapper/message-visibility';
|
|
|
|
/** Covers specs/003-ticketing/quickstart.md Scenario 4 against a real Postgres. */
|
|
describe('Ticket messages — type-scoped visibility', () => {
|
|
let app: FastifyInstance;
|
|
let ticketId: string;
|
|
const externalProductId = `TEST_MSG_PROD_${Date.now()}`;
|
|
|
|
beforeAll(async () => {
|
|
app = await buildApp();
|
|
|
|
const product = await prismaClient.product.create({
|
|
data: { externalProductId, name: 'Messages Test Product', status: 'active' },
|
|
});
|
|
const secret = generateCredentialSecret();
|
|
await prismaClient.productIntegration.create({
|
|
data: {
|
|
productId: product.id,
|
|
credentialRef: encryptCredential(secret),
|
|
authMechanism: 'signed_token',
|
|
allowedScope: { tenantIds: ['tenant-1'] },
|
|
status: 'active',
|
|
rateLimitPerMinute: 1000,
|
|
rateLimitPerUserPerMinute: 1000,
|
|
},
|
|
});
|
|
|
|
const token = issueIntegrationToken(secret, {
|
|
externalProductId,
|
|
tenantId: 'tenant-1',
|
|
userId: 'user-1',
|
|
});
|
|
const created = await app.inject({
|
|
method: 'POST',
|
|
url: '/v1/support/requests',
|
|
headers: { authorization: `Bearer ${token}` },
|
|
payload: {
|
|
productId: externalProductId,
|
|
tenantId: 'tenant-1',
|
|
userId: 'user-1',
|
|
source: 'test',
|
|
problem: 'message visibility check',
|
|
},
|
|
});
|
|
ticketId = created.json().data.ticketId;
|
|
|
|
for (const type of MESSAGE_TYPES) {
|
|
const response = await app.inject({
|
|
method: 'POST',
|
|
url: `/tickets/${ticketId}/messages`,
|
|
payload: { type, body: `Message of type ${type}` },
|
|
});
|
|
expect(response.statusCode).toBe(201);
|
|
}
|
|
});
|
|
|
|
afterAll(async () => {
|
|
await prismaClient.ticketMessage.deleteMany({ where: { ticketId } });
|
|
await prismaClient.ticket.deleteMany({ where: { product: { externalProductId } } });
|
|
await prismaClient.problem.deleteMany({ where: { product: { externalProductId } } });
|
|
await prismaClient.productIntegration.deleteMany({
|
|
where: { product: { externalProductId } },
|
|
});
|
|
await prismaClient.product.deleteMany({ where: { externalProductId } });
|
|
await app.close();
|
|
});
|
|
|
|
it('a customer-scoped read excludes internal-only types entirely', async () => {
|
|
const response = await app.inject({ method: 'GET', url: `/tickets/${ticketId}/messages` });
|
|
expect(response.statusCode).toBe(200);
|
|
const types = response.json().data.map((m: { type: string }) => m.type);
|
|
|
|
expect(types).toContain('CUSTOMER_MESSAGE');
|
|
expect(types).toContain('AI_MESSAGE');
|
|
expect(types).toContain('AGENT_MESSAGE');
|
|
expect(types).toContain('SYSTEM_EVENT');
|
|
expect(types).not.toContain('INTERNAL_NOTE');
|
|
expect(types).not.toContain('INVESTIGATION_NOTE');
|
|
expect(types).not.toContain('SOLUTION_NOTE');
|
|
});
|
|
|
|
it('an agent-scoped read includes every message type, including internal notes', async () => {
|
|
const response = await app.inject({
|
|
method: 'GET',
|
|
url: `/agent/tickets/${ticketId}/messages`,
|
|
});
|
|
expect(response.statusCode).toBe(200);
|
|
const types = response.json().data.map((m: { type: string }) => m.type);
|
|
|
|
for (const type of MESSAGE_TYPES) {
|
|
expect(types).toContain(type);
|
|
}
|
|
// +1 for the SYSTEM_EVENT ticket-creation message written by TicketsService itself.
|
|
expect(types.length).toBe(MESSAGE_TYPES.length + 1);
|
|
});
|
|
|
|
it('rejects a message with an undefined type', async () => {
|
|
const response = await app.inject({
|
|
method: 'POST',
|
|
url: `/tickets/${ticketId}/messages`,
|
|
payload: { type: 'NOT_A_REAL_TYPE', body: 'x' },
|
|
});
|
|
expect(response.statusCode).toBe(400);
|
|
});
|
|
});
|