Added Documents Feature

backend/src/features/documents/domain/documents.service.ts

@@ -0,0 +1,55 @@
+import { randomUUID } from 'crypto';
+import type { CreateDocumentBody, DocumentRecord, DocumentType, UpdateDocumentBody } from './documents.types';
+import { DocumentsRepository } from '../data/documents.repository';
+import pool from '../../../core/config/database';
+
+export class DocumentsService {
+  private readonly repo = new DocumentsRepository(pool);
+
+  async createDocument(userId: string, body: CreateDocumentBody): Promise<DocumentRecord> {
+    await this.assertVehicleOwnership(userId, body.vehicle_id);
+    const id = randomUUID();
+    return this.repo.insert({
+      id,
+      user_id: userId,
+      vehicle_id: body.vehicle_id,
+      document_type: body.document_type as DocumentType,
+      title: body.title,
+      notes: body.notes ?? null,
+      details: body.details ?? null,
+      issued_date: body.issued_date ?? null,
+      expiration_date: body.expiration_date ?? null,
+    });
+  }
+
+  async getDocument(userId: string, id: string): Promise<DocumentRecord | null> {
+    return this.repo.findById(id, userId);
+  }
+
+  async listDocuments(userId: string, filters?: { vehicleId?: string; type?: DocumentType; expiresBefore?: string }) {
+    return this.repo.listByUser(userId, filters);
+  }
+
+  async updateDocument(userId: string, id: string, patch: UpdateDocumentBody) {
+    const existing = await this.repo.findById(id, userId);
+    if (!existing) return null;
+    if (patch && typeof patch === 'object') {
+      return this.repo.updateMetadata(id, userId, patch as any);
+    }
+    return existing;
+  }
+
+  async deleteDocument(userId: string, id: string): Promise<void> {
+    await this.repo.softDelete(id, userId);
+  }
+
+  private async assertVehicleOwnership(userId: string, vehicleId: string) {
+    const res = await pool.query('SELECT id FROM vehicles WHERE id = $1 AND user_id = $2', [vehicleId, userId]);
+    if (!res.rows[0]) {
+      const err: any = new Error('Vehicle not found or not owned by user');
+      err.statusCode = 403;
+      throw err;
+    }
+  }
+}
+

backend/src/features/documents/domain/documents.types.ts

@@ -0,0 +1,46 @@
+import { z } from 'zod';
+
+export const DocumentTypeSchema = z.enum(['insurance', 'registration']);
+export type DocumentType = z.infer<typeof DocumentTypeSchema>;
+
+export interface DocumentRecord {
+  id: string;
+  user_id: string;
+  vehicle_id: string;
+  document_type: DocumentType;
+  title: string;
+  notes?: string | null;
+  details?: Record<string, any> | null;
+  storage_bucket?: string | null;
+  storage_key?: string | null;
+  file_name?: string | null;
+  content_type?: string | null;
+  file_size?: number | null;
+  file_hash?: string | null;
+  issued_date?: string | null;
+  expiration_date?: string | null;
+  created_at: string;
+  updated_at: string;
+  deleted_at?: string | null;
+}
+
+export const CreateDocumentBodySchema = z.object({
+  vehicle_id: z.string().uuid(),
+  document_type: DocumentTypeSchema,
+  title: z.string().min(1).max(200),
+  notes: z.string().max(10000).optional(),
+  details: z.record(z.any()).optional(),
+  issued_date: z.string().optional(),
+  expiration_date: z.string().optional(),
+});
+export type CreateDocumentBody = z.infer<typeof CreateDocumentBodySchema>;
+
+export const UpdateDocumentBodySchema = z.object({
+  title: z.string().min(1).max(200).optional(),
+  notes: z.string().max(10000).nullable().optional(),
+  details: z.record(z.any()).optional(),
+  issued_date: z.string().nullable().optional(),
+  expiration_date: z.string().nullable().optional(),
+});
+export type UpdateDocumentBody = z.infer<typeof UpdateDocumentBodySchema>;
+