feat(01-02): create complete Drizzle schema with all 10 tables
- clients: token as separate text field (notNull, unique, nanoid) — never PK - accepted_total denormalized on clients — client API never touches quote_items - deliverables.approved_at immutable timestamp (TIMESTAMPTZ) — audit trail - payments: label (Acconto 50% / Saldo 50%), status (da_saldare/inviata/saldato) - comments: polymorphic entity_type+entity_id pattern - service_catalog + quote_items: admin-only, never exposed to client API - Full relations defined for all FK chains - TypeScript types exported: Client, Phase, Task, Deliverable, etc. - ID strategy: text + nanoid() via $defaultFn (cryptographically secure, URL-safe)
This commit is contained in:
Simone Cavalli
@@ -0,0 +1,245 @@
|
|||||||
|
import {
|
||||||
|
pgTable,
|
||||||
|
text,
|
||||||
|
integer,
|
||||||
|
numeric,
|
||||||
|
timestamp,
|
||||||
|
boolean,
|
||||||
|
} from "drizzle-orm/pg-core";
|
||||||
|
import { relations } from "drizzle-orm";
|
||||||
|
import { nanoid } from "nanoid";
|
||||||
|
|
||||||
|
// ============ CLIENTS ============
|
||||||
|
export const clients = pgTable("clients", {
|
||||||
|
id: text("id")
|
||||||
|
.primaryKey()
|
||||||
|
.$defaultFn(() => nanoid()),
|
||||||
|
name: text("name").notNull(),
|
||||||
|
brand_name: text("brand_name").notNull(),
|
||||||
|
brief: text("brief").notNull(),
|
||||||
|
// token is SEPARATE from id — rotatable secret for client link access
|
||||||
|
token: text("token")
|
||||||
|
.notNull()
|
||||||
|
.unique()
|
||||||
|
.$defaultFn(() => nanoid()),
|
||||||
|
// accepted_total is DENORMALIZED — client API never exposes quote_items
|
||||||
|
accepted_total: numeric("accepted_total", { precision: 10, scale: 2 }).default(
|
||||||
|
"0"
|
||||||
|
),
|
||||||
|
created_at: timestamp("created_at", { withTimezone: true })
|
||||||
|
.notNull()
|
||||||
|
.defaultNow(),
|
||||||
|
});
|
||||||
|
|
||||||
|
// ============ PHASES ============
|
||||||
|
export const phases = pgTable("phases", {
|
||||||
|
id: text("id")
|
||||||
|
.primaryKey()
|
||||||
|
.$defaultFn(() => nanoid()),
|
||||||
|
client_id: text("client_id")
|
||||||
|
.notNull()
|
||||||
|
.references(() => clients.id, { onDelete: "cascade" }),
|
||||||
|
title: text("title").notNull(),
|
||||||
|
sort_order: integer("sort_order").notNull().default(0),
|
||||||
|
status: text("status").notNull().default("upcoming"), // upcoming | active | done
|
||||||
|
});
|
||||||
|
|
||||||
|
// ============ TASKS ============
|
||||||
|
export const tasks = pgTable("tasks", {
|
||||||
|
id: text("id")
|
||||||
|
.primaryKey()
|
||||||
|
.$defaultFn(() => nanoid()),
|
||||||
|
phase_id: text("phase_id")
|
||||||
|
.notNull()
|
||||||
|
.references(() => phases.id, { onDelete: "cascade" }),
|
||||||
|
title: text("title").notNull(),
|
||||||
|
description: text("description"),
|
||||||
|
status: text("status").notNull().default("todo"), // todo | in_progress | done
|
||||||
|
sort_order: integer("sort_order").notNull().default(0),
|
||||||
|
});
|
||||||
|
|
||||||
|
// ============ DELIVERABLES ============
|
||||||
|
export const deliverables = pgTable("deliverables", {
|
||||||
|
id: text("id")
|
||||||
|
.primaryKey()
|
||||||
|
.$defaultFn(() => nanoid()),
|
||||||
|
task_id: text("task_id")
|
||||||
|
.notNull()
|
||||||
|
.references(() => tasks.id, { onDelete: "cascade" }),
|
||||||
|
title: text("title").notNull(),
|
||||||
|
url: text("url"), // external link only — no file hosting in v1
|
||||||
|
status: text("status").notNull().default("pending"), // pending | submitted | approved
|
||||||
|
// approved_at is IMMUTABLE once set — audit trail, cannot be unset by client
|
||||||
|
approved_at: timestamp("approved_at", { withTimezone: true }),
|
||||||
|
});
|
||||||
|
|
||||||
|
// ============ COMMENTS ============
|
||||||
|
export const comments = pgTable("comments", {
|
||||||
|
id: text("id")
|
||||||
|
.primaryKey()
|
||||||
|
.$defaultFn(() => nanoid()),
|
||||||
|
entity_type: text("entity_type").notNull(), // task | deliverable
|
||||||
|
entity_id: text("entity_id").notNull(),
|
||||||
|
author: text("author").notNull(), // client | admin
|
||||||
|
body: text("body").notNull(),
|
||||||
|
created_at: timestamp("created_at", { withTimezone: true })
|
||||||
|
.notNull()
|
||||||
|
.defaultNow(),
|
||||||
|
});
|
||||||
|
|
||||||
|
// ============ PAYMENTS ============
|
||||||
|
export const payments = pgTable("payments", {
|
||||||
|
id: text("id")
|
||||||
|
.primaryKey()
|
||||||
|
.$defaultFn(() => nanoid()),
|
||||||
|
client_id: text("client_id")
|
||||||
|
.notNull()
|
||||||
|
.references(() => clients.id, { onDelete: "cascade" }),
|
||||||
|
label: text("label").notNull(), // "Acconto 50%" | "Saldo 50%"
|
||||||
|
amount: numeric("amount", { precision: 10, scale: 2 }).notNull(),
|
||||||
|
status: text("status").notNull().default("da_saldare"), // da_saldare | inviata | saldato
|
||||||
|
paid_at: timestamp("paid_at", { withTimezone: true }),
|
||||||
|
});
|
||||||
|
|
||||||
|
// ============ DOCUMENTS ============
|
||||||
|
export const documents = pgTable("documents", {
|
||||||
|
id: text("id")
|
||||||
|
.primaryKey()
|
||||||
|
.$defaultFn(() => nanoid()),
|
||||||
|
client_id: text("client_id")
|
||||||
|
.notNull()
|
||||||
|
.references(() => clients.id, { onDelete: "cascade" }),
|
||||||
|
label: text("label").notNull(),
|
||||||
|
url: text("url").notNull(), // external URL only — no file hosting in v1
|
||||||
|
created_at: timestamp("created_at", { withTimezone: true })
|
||||||
|
.notNull()
|
||||||
|
.defaultNow(),
|
||||||
|
});
|
||||||
|
|
||||||
|
// ============ NOTES (Decision Log — admin writes, client reads) ============
|
||||||
|
export const notes = pgTable("notes", {
|
||||||
|
id: text("id")
|
||||||
|
.primaryKey()
|
||||||
|
.$defaultFn(() => nanoid()),
|
||||||
|
client_id: text("client_id")
|
||||||
|
.notNull()
|
||||||
|
.references(() => clients.id, { onDelete: "cascade" }),
|
||||||
|
body: text("body").notNull(),
|
||||||
|
created_at: timestamp("created_at", { withTimezone: true })
|
||||||
|
.notNull()
|
||||||
|
.defaultNow(),
|
||||||
|
});
|
||||||
|
|
||||||
|
// ============ SERVICE CATALOG (admin-only, used for quote generation) ============
|
||||||
|
export const service_catalog = pgTable("service_catalog", {
|
||||||
|
id: text("id")
|
||||||
|
.primaryKey()
|
||||||
|
.$defaultFn(() => nanoid()),
|
||||||
|
name: text("name").notNull(),
|
||||||
|
description: text("description"),
|
||||||
|
unit_price: numeric("unit_price", { precision: 10, scale: 2 }).notNull(),
|
||||||
|
active: boolean("active").notNull().default(true),
|
||||||
|
});
|
||||||
|
|
||||||
|
// ============ QUOTE ITEMS (admin-only — NEVER exposed via client API) ============
|
||||||
|
export const quote_items = pgTable("quote_items", {
|
||||||
|
id: text("id")
|
||||||
|
.primaryKey()
|
||||||
|
.$defaultFn(() => nanoid()),
|
||||||
|
client_id: text("client_id")
|
||||||
|
.notNull()
|
||||||
|
.references(() => clients.id, { onDelete: "cascade" }),
|
||||||
|
service_id: text("service_id")
|
||||||
|
.notNull()
|
||||||
|
.references(() => service_catalog.id, { onDelete: "restrict" }),
|
||||||
|
quantity: numeric("quantity", { precision: 10, scale: 2 }).notNull(),
|
||||||
|
unit_price: numeric("unit_price", { precision: 10, scale: 2 }).notNull(), // snapshot at time of quote
|
||||||
|
subtotal: numeric("subtotal", { precision: 10, scale: 2 }).notNull(),
|
||||||
|
});
|
||||||
|
|
||||||
|
// ============ RELATIONS ============
|
||||||
|
|
||||||
|
export const clientsRelations = relations(clients, ({ many }) => ({
|
||||||
|
phases: many(phases),
|
||||||
|
payments: many(payments),
|
||||||
|
documents: many(documents),
|
||||||
|
notes: many(notes),
|
||||||
|
quote_items: many(quote_items),
|
||||||
|
}));
|
||||||
|
|
||||||
|
export const phasesRelations = relations(phases, ({ one, many }) => ({
|
||||||
|
client: one(clients, { fields: [phases.client_id], references: [clients.id] }),
|
||||||
|
tasks: many(tasks),
|
||||||
|
}));
|
||||||
|
|
||||||
|
export const tasksRelations = relations(tasks, ({ one, many }) => ({
|
||||||
|
phase: one(phases, { fields: [tasks.phase_id], references: [phases.id] }),
|
||||||
|
deliverables: many(deliverables),
|
||||||
|
}));
|
||||||
|
|
||||||
|
export const deliverablesRelations = relations(deliverables, ({ one }) => ({
|
||||||
|
task: one(tasks, { fields: [deliverables.task_id], references: [tasks.id] }),
|
||||||
|
}));
|
||||||
|
|
||||||
|
export const commentsRelations = relations(comments, (_) => ({
|
||||||
|
// Polymorphic: no direct FK relation — entity_type + entity_id used at query time
|
||||||
|
}));
|
||||||
|
|
||||||
|
export const paymentsRelations = relations(payments, ({ one }) => ({
|
||||||
|
client: one(clients, {
|
||||||
|
fields: [payments.client_id],
|
||||||
|
references: [clients.id],
|
||||||
|
}),
|
||||||
|
}));
|
||||||
|
|
||||||
|
export const documentsRelations = relations(documents, ({ one }) => ({
|
||||||
|
client: one(clients, {
|
||||||
|
fields: [documents.client_id],
|
||||||
|
references: [clients.id],
|
||||||
|
}),
|
||||||
|
}));
|
||||||
|
|
||||||
|
export const notesRelations = relations(notes, ({ one }) => ({
|
||||||
|
client: one(clients, { fields: [notes.client_id], references: [clients.id] }),
|
||||||
|
}));
|
||||||
|
|
||||||
|
export const quoteItemsRelations = relations(quote_items, ({ one }) => ({
|
||||||
|
client: one(clients, {
|
||||||
|
fields: [quote_items.client_id],
|
||||||
|
references: [clients.id],
|
||||||
|
}),
|
||||||
|
service: one(service_catalog, {
|
||||||
|
fields: [quote_items.service_id],
|
||||||
|
references: [service_catalog.id],
|
||||||
|
}),
|
||||||
|
}));
|
||||||
|
|
||||||
|
export const serviceCatalogRelations = relations(
|
||||||
|
service_catalog,
|
||||||
|
({ many }) => ({
|
||||||
|
quote_items: many(quote_items),
|
||||||
|
})
|
||||||
|
);
|
||||||
|
|
||||||
|
// ============ TYPESCRIPT TYPES (for use in API routes and Server Components) ============
|
||||||
|
|
||||||
|
export type Client = typeof clients.$inferSelect;
|
||||||
|
export type NewClient = typeof clients.$inferInsert;
|
||||||
|
export type Phase = typeof phases.$inferSelect;
|
||||||
|
export type NewPhase = typeof phases.$inferInsert;
|
||||||
|
export type Task = typeof tasks.$inferSelect;
|
||||||
|
export type NewTask = typeof tasks.$inferInsert;
|
||||||
|
export type Deliverable = typeof deliverables.$inferSelect;
|
||||||
|
export type NewDeliverable = typeof deliverables.$inferInsert;
|
||||||
|
export type Comment = typeof comments.$inferSelect;
|
||||||
|
export type NewComment = typeof comments.$inferInsert;
|
||||||
|
export type Payment = typeof payments.$inferSelect;
|
||||||
|
export type NewPayment = typeof payments.$inferInsert;
|
||||||
|
export type Document = typeof documents.$inferSelect;
|
||||||
|
export type NewDocument = typeof documents.$inferInsert;
|
||||||
|
export type Note = typeof notes.$inferSelect;
|
||||||
|
export type NewNote = typeof notes.$inferInsert;
|
||||||
|
export type ServiceCatalog = typeof service_catalog.$inferSelect;
|
||||||
|
export type NewServiceCatalog = typeof service_catalog.$inferInsert;
|
||||||
|
export type QuoteItem = typeof quote_items.$inferSelect;
|
||||||
|
export type NewQuoteItem = typeof quote_items.$inferInsert;
|
||||||
Reference in New Issue
Block a user