create-protobase 0.23.13 → 0.24.0

package/dist/templates/real-estate/config/vendors/data.ts

@@ -0,0 +1,21 @@
+import { f, resource } from '@protobase/schema'
+import { access } from '../roles'
+
+/** maintenance.vendors: the contractors who carry out work orders. */
+export const vendors = resource('vendors')
+  .table('maintenance.vendors')
+  .fields({
+    id: f.integer().readOnly().filterable().sortable().dbDefault(),
+    organization_id: f.relation('organizations').filterable().sortable(),
+    name: f.text(),
+    trade: f.enum(['plumbing', 'heating', 'electrical', 'roofing', 'carpentry', 'locksmith', 'pest_control', 'general']).filterable().sortable(),
+    email: f.text().optional(),
+    phone: f.text().optional(),
+    hourly_rate: f.decimal({ precision: 8, scale: 2 }),
+    active: f.boolean().default(true),
+    created_at: f.timestamp().readOnly().dbDefault(),
+    updated_at: f.timestamp().readOnly().dbDefault(),
+  })
+  .primaryKey((r) => r.id)
+  .tenant((r) => r.organization_id)
+  .access(access('vendors'))

package/dist/templates/real-estate/config/vendors/ui.ts

@@ -0,0 +1,18 @@
+import { view } from '@protobase/schema'
+import type { vendors } from './data'
+
+export const vendorsView = view<typeof vendors>('vendors')
+  .title((r) => r.name)
+  .names({ singular: 'Vendor', plural: 'Vendors' })
+  .fields((r) => ({ trade: r.trade.format('badge').valueLabels({
+      plumbing: 'Plumbing',
+      heating: 'Heating',
+      electrical: 'Electrical',
+      roofing: 'Roofing',
+      carpentry: 'Carpentry',
+      locksmith: 'Locksmith',
+      pest_control: 'Pest control',
+      general: 'General',
+    }), hourly_rate: r.hourly_rate.prefix('€').decimals(2) }))
+  .list((r) => ({ columns: [r.name, r.trade, r.phone, r.hourly_rate, r.active] }))
+  .filters((r, w) => [w.facets(r.trade)])

package/dist/templates/real-estate/config/work_orders/data.ts

@@ -0,0 +1,22 @@
+import { f, resource } from '@protobase/schema'
+import { access } from '../roles'
+
+/** maintenance.work_orders: a vendor's visit for a ticket. */
+export const workOrders = resource('work_orders')
+  .table('maintenance.work_orders')
+  .fields({
+    id: f.bigint().readOnly().filterable().sortable().dbDefault(),
+    organization_id: f.relation('organizations').filterable().sortable(),
+    ticket_id: f.relation('tickets').filterable().sortable(),
+    vendor_id: f.relation('vendors').filterable().sortable(),
+    scheduled_for: f.date().filterable().sortable(),
+    completed_on: f.date().optional(),
+    hours: f.decimal({ precision: 5, scale: 2 }).optional(),
+    cost: f.decimal({ precision: 10, scale: 2 }).optional(),
+    notes: f.text().optional(),
+    created_at: f.timestamp().readOnly().dbDefault(),
+    updated_at: f.timestamp().readOnly().dbDefault(),
+  })
+  .primaryKey((r) => r.id)
+  .tenant((r) => r.organization_id)
+  .access(access('work_orders'))

package/dist/templates/real-estate/config/work_orders/ui.ts

@@ -0,0 +1,18 @@
+import { l, view } from '@protobase/schema'
+import type { workOrders } from './data'
+
+export const workOrdersView = view<typeof workOrders>('work_orders')
+  .names({ singular: 'Work order', plural: 'Work orders' })
+  .fields((r) => ({
+    ticket_id: r.ticket_id.label('Ticket'),
+    vendor_id: r.vendor_id.label('Vendor'),
+    scheduled_for: r.scheduled_for.label('Visit'),
+    completed_on: r.completed_on.label('Completed'),
+    cost: r.cost.help('Labour and materials, as invoiced by the vendor.').prefix('€').decimals(2),
+  }))
+  .list((r) => ({ columns: [r.ticket_id, r.vendor_id, r.scheduled_for, r.completed_on, r.cost], sort: [[r.scheduled_for, 'desc']] }))
+  .filters((r, w) => [w.facets(r.vendor_id), w.dateRange(r.scheduled_for, { presets: ['7d', '30d', '90d'] })])
+  .layout((r) => [
+    l.section('Visit', [r.ticket_id, r.vendor_id, r.scheduled_for, r.completed_on]),
+    l.section('Invoice', [r.hours, r.cost, r.notes]),
+  ])

package/dist/templates/real-estate/db/connection.ts

@@ -0,0 +1,7 @@
+import postgres from 'postgres'
+
+export const databaseUrl = process.env.DATABASE_URL ?? 'postgres://protobase:protobase@localhost:55432/real_estate'
+
+export const connect = (options: postgres.Options<{}> = {}) => postgres(databaseUrl, { onnotice: () => {}, ...options })
+
+export type Db = ReturnType<typeof connect>

package/dist/templates/real-estate/db/drop.ts

@@ -0,0 +1,9 @@
+import { connect } from './connection'
+
+const sql = connect({ max: 1 })
+
+await sql.unsafe('drop schema if exists core, portfolio, leasing, billing, maintenance cascade')
+await sql.unsafe('drop table if exists public.schema_migrations, public.seed_info')
+console.log('dropped all real estate schemas')
+
+await sql.end()

package/dist/templates/real-estate/db/kysely.ts

@@ -0,0 +1,13 @@
+import { Kysely, PostgresDialect } from 'kysely'
+import pg from 'pg'
+import { databaseUrl } from './connection'
+
+// date and timestamp (without zone) stay text; the API formats them itself
+const types = {
+  getTypeParser: (oid: number, format?: 'text' | 'binary') =>
+    oid === 1082 || oid === 1114 ? (value: string) => value : pg.types.getTypeParser(oid, format as 'text'),
+}
+
+/** Kysely over node-postgres, the way a deployment of the API would connect. */
+export const createDb = (max = 10) =>
+  new Kysely<any>({ dialect: new PostgresDialect({ pool: new pg.Pool({ connectionString: databaseUrl, max, types }) }) })

package/dist/templates/real-estate/db/migrate.ts

@@ -0,0 +1,30 @@
+import { readdir, readFile } from 'node:fs/promises'
+import { fileURLToPath } from 'node:url'
+import { connect } from './connection'
+
+// Applies the migrations not applied yet, the app's and the auth schema's alike, in file name order and in one
+// transaction: when one fails, none is applied and the database stays as the running version expects it. Run it before
+// a new version serves, while nothing else writes. A statement Postgres runs only outside a transaction, such as
+// `create index concurrently`, does not belong in these files.
+
+const directory = fileURLToPath(new URL('./migrations/', import.meta.url))
+// Any constant shared by every run of this script: two runs at once take turns.
+const lockKey = 7_311_946_202
+
+const sql = connect({ max: 1 })
+const files = (await readdir(directory)).filter((file) => file.endsWith('.sql')).sort()
+
+const applied = await sql.begin(async (tx) => {
+  await tx`select pg_advisory_xact_lock(${lockKey})`
+  await tx`create table if not exists public.schema_migrations (name text primary key, applied_at timestamptz not null default now())`
+  const done = new Set((await tx`select name from public.schema_migrations`).map((row) => row.name))
+  const pending = files.filter((file) => !done.has(file))
+  for (const file of pending) {
+    await tx.unsafe(await readFile(directory + file, 'utf8'))
+    await tx`insert into public.schema_migrations (name) values (${file})`
+  }
+  return pending
+})
+for (const file of applied) console.log(`applied ${file}`)
+
+await sql.end()

package/dist/templates/real-estate/db/migrations/001_core.sql

@@ -0,0 +1,33 @@
+create extension if not exists pg_trgm;
+create extension if not exists btree_gist;
+
+create table public.seed_info (
+  scale text not null,
+  seeded_at timestamptz not null default now()
+);
+
+create schema core;
+
+create table core.organizations (
+  id integer generated by default as identity primary key,
+  name text not null,
+  slug text not null unique,
+  city text not null,
+  kvk_number text not null,
+  created_at timestamptz not null default now(),
+  updated_at timestamptz not null default now()
+);
+
+create table core.users (
+  id integer generated by default as identity primary key,
+  organization_id integer not null references core.organizations (id),
+  email text not null,
+  name text not null,
+  role text not null check (role in ('admin', 'manager', 'finance', 'maintenance')),
+  active boolean not null default true,
+  created_at timestamptz not null default now(),
+  updated_at timestamptz not null default now(),
+  unique (organization_id, email)
+);
+
+create index users_role_idx on core.users (organization_id, role);

package/dist/templates/real-estate/db/migrations/002_portfolio.sql

@@ -0,0 +1,97 @@
+create schema portfolio;
+
+create table portfolio.amenities (
+  code text primary key,
+  name text not null
+);
+
+create table portfolio.owners (
+  id bigint generated by default as identity primary key,
+  organization_id integer not null references core.organizations (id),
+  name text not null,
+  kind text not null check (kind in ('private', 'company', 'pension_fund', 'housing_association')),
+  email text,
+  phone text,
+  iban text not null,
+  management_fee_percent numeric(4, 2) not null default 6 check (management_fee_percent between 0 and 20),
+  created_at timestamptz not null default now(),
+  updated_at timestamptz not null default now()
+);
+
+create index owners_organization_idx on portfolio.owners (organization_id, created_at);
+create index owners_kind_idx on portfolio.owners (organization_id, kind);
+create index owners_name_trgm_idx on portfolio.owners using gin (name gin_trgm_ops);
+
+create table portfolio.properties (
+  id bigint generated by default as identity primary key,
+  organization_id integer not null references core.organizations (id),
+  owner_id bigint not null references portfolio.owners (id),
+  name text not null,
+  kind text not null check (kind in ('apartment_building', 'single_family', 'mixed_use')),
+  street text not null,
+  house_number text not null,
+  postal_code text not null check (postal_code ~ '^[1-9][0-9]{3} [A-Z]{2}$'),
+  city text not null,
+  latitude numeric(8, 6) not null check (latitude between -90 and 90),
+  longitude numeric(9, 6) not null check (longitude between -180 and 180),
+  built_year smallint not null,
+  created_at timestamptz not null default now(),
+  updated_at timestamptz not null default now()
+);
+
+create index properties_organization_idx on portfolio.properties (organization_id, created_at);
+create index properties_owner_idx on portfolio.properties (owner_id);
+create index properties_city_idx on portfolio.properties (organization_id, city);
+create index properties_kind_idx on portfolio.properties (organization_id, kind);
+create index properties_location_idx on portfolio.properties (latitude, longitude);
+create index properties_name_trgm_idx on portfolio.properties using gin (name gin_trgm_ops);
+
+create table portfolio.units (
+  id bigint generated by default as identity primary key,
+  organization_id integer not null references core.organizations (id),
+  property_id bigint not null references portfolio.properties (id),
+  label text not null,
+  floor smallint not null default 0,
+  bedrooms smallint not null check (bedrooms >= 0),
+  area_m2 integer not null check (area_m2 > 0),
+  energy_label text not null check (energy_label in ('A++++', 'A+++', 'A++', 'A+', 'A', 'B', 'C', 'D', 'E', 'F', 'G')),
+  base_rent numeric(10, 2) not null check (base_rent > 0),
+  status text not null default 'vacant' check (status in ('let', 'vacant', 'renovation')),
+  created_at timestamptz not null default now(),
+  updated_at timestamptz not null default now(),
+  unique (property_id, label)
+);
+
+create index units_organization_idx on portfolio.units (organization_id, created_at);
+create index units_status_idx on portfolio.units (organization_id, status);
+create index units_rent_idx on portfolio.units (organization_id, base_rent);
+create index units_energy_label_idx on portfolio.units (organization_id, energy_label);
+
+create table portfolio.unit_amenities (
+  unit_id bigint not null references portfolio.units (id),
+  amenity_code text not null references portfolio.amenities (code),
+  organization_id integer not null references core.organizations (id),
+  added_at timestamptz not null default now(),
+  primary key (unit_id, amenity_code)
+);
+
+create index unit_amenities_amenity_idx on portfolio.unit_amenities (amenity_code);
+create index unit_amenities_organization_idx on portfolio.unit_amenities (organization_id);
+
+-- Valuations over time: the yearly WOZ value every property gets, and the odd appraisal.
+create table portfolio.valuations (
+  id bigint generated by default as identity primary key,
+  organization_id integer not null references core.organizations (id),
+  property_id bigint not null references portfolio.properties (id),
+  valued_on date not null,
+  value numeric(14, 2) not null check (value > 0),
+  source text not null check (source in ('woz', 'appraisal')),
+  created_at timestamptz not null default now(),
+  updated_at timestamptz not null default now(),
+  unique (property_id, source, valued_on)
+);
+
+create index valuations_organization_idx on portfolio.valuations (organization_id, valued_on);
+create index valuations_source_idx on portfolio.valuations (organization_id, source);
+
+create index units_label_trgm_idx on portfolio.units using gin (label gin_trgm_ops);

package/dist/templates/real-estate/db/migrations/003_leasing.sql

@@ -0,0 +1,78 @@
+create schema leasing;
+
+create table leasing.tenants (
+  id bigint generated by default as identity primary key,
+  organization_id integer not null references core.organizations (id),
+  first_name text not null,
+  last_name text not null,
+  email text not null,
+  phone text,
+  date_of_birth date not null,
+  iban text not null,
+  monthly_income numeric(10, 2) not null check (monthly_income >= 0),
+  created_at timestamptz not null default now(),
+  updated_at timestamptz not null default now()
+);
+
+create index tenants_organization_idx on leasing.tenants (organization_id, created_at);
+create index tenants_last_name_trgm_idx on leasing.tenants using gin (last_name gin_trgm_ops);
+create index tenants_email_trgm_idx on leasing.tenants using gin (email gin_trgm_ops);
+
+-- end_date is the last day of the tenancy, null while it runs for an indefinite term.
+-- Two leases of one unit never overlap: Postgres refuses the second with an exclusion constraint.
+create table leasing.leases (
+  id bigint generated by default as identity primary key,
+  organization_id integer not null references core.organizations (id),
+  number text not null,
+  unit_id bigint not null references portfolio.units (id),
+  term text not null check (term in ('indefinite', 'fixed')),
+  start_date date not null,
+  end_date date,
+  monthly_rent numeric(10, 2) not null check (monthly_rent > 0),
+  service_costs numeric(10, 2) not null default 0 check (service_costs >= 0),
+  notice_given_on date,
+  created_at timestamptz not null default now(),
+  updated_at timestamptz not null default now(),
+  unique (organization_id, number),
+  check (end_date is null or end_date >= start_date),
+  check (term = 'indefinite' or end_date is not null),
+  constraint leases_no_overlap exclude using gist (unit_id with =, daterange(start_date, end_date, '[]') with &&)
+);
+
+create index leases_organization_idx on leasing.leases (organization_id, created_at);
+create index leases_unit_idx on leasing.leases (unit_id);
+create index leases_start_idx on leasing.leases (organization_id, start_date);
+create index leases_end_idx on leasing.leases (organization_id, end_date);
+
+-- Everyone who signed a lease: one primary tenant, and co-signers.
+create table leasing.lease_tenants (
+  lease_id bigint not null references leasing.leases (id),
+  tenant_id bigint not null references leasing.tenants (id),
+  organization_id integer not null references core.organizations (id),
+  role text not null check (role in ('primary', 'co_signer')),
+  added_at timestamptz not null default now(),
+  primary key (lease_id, tenant_id)
+);
+
+create unique index lease_tenants_primary_idx on leasing.lease_tenants (lease_id) where role = 'primary';
+create index lease_tenants_tenant_idx on leasing.lease_tenants (tenant_id);
+create index lease_tenants_organization_idx on leasing.lease_tenants (organization_id);
+
+create table leasing.deposits (
+  id bigint generated by default as identity primary key,
+  organization_id integer not null references core.organizations (id),
+  lease_id bigint not null unique references leasing.leases (id),
+  amount numeric(10, 2) not null check (amount > 0),
+  received_on date not null,
+  status text not null default 'held' check (status in ('held', 'returned', 'partially_returned', 'withheld')),
+  returned_amount numeric(10, 2) not null default 0 check (returned_amount >= 0 and returned_amount <= amount),
+  returned_on date,
+  created_at timestamptz not null default now(),
+  updated_at timestamptz not null default now(),
+  check ((status = 'held') = (returned_on is null))
+);
+
+create index deposits_organization_idx on leasing.deposits (organization_id, created_at);
+create index deposits_status_idx on leasing.deposits (organization_id, status);
+
+create index leases_number_trgm_idx on leasing.leases using gin (number gin_trgm_ops);

package/dist/templates/real-estate/db/migrations/004_billing.sql

@@ -0,0 +1,88 @@
+create schema billing;
+
+-- One charge per lease and month, due on the first. paid_amount is the sum of its payments, kept by the triggers
+-- below; the check on it means the payments of a charge never add up to more than the charge.
+create table billing.rent_charges (
+  id bigint generated by default as identity primary key,
+  organization_id integer not null references core.organizations (id),
+  lease_id bigint not null references leasing.leases (id),
+  period date not null check (extract(day from period) = 1),
+  due_on date not null,
+  description text not null,
+  amount numeric(10, 2) not null check (amount > 0),
+  paid_amount numeric(10, 2) not null default 0 check (paid_amount >= 0 and paid_amount <= amount),
+  created_at timestamptz not null default now(),
+  updated_at timestamptz not null default now(),
+  unique (lease_id, period)
+);
+
+create index rent_charges_organization_idx on billing.rent_charges (organization_id, period);
+create index rent_charges_due_idx on billing.rent_charges (organization_id, due_on);
+create index rent_charges_amount_idx on billing.rent_charges (organization_id, amount);
+-- The open charges, a few percent of the table: what the arrears view reads.
+create index rent_charges_open_idx on billing.rent_charges (organization_id, lease_id) where paid_amount < amount;
+
+create table billing.payments (
+  id bigint generated by default as identity primary key,
+  organization_id integer not null references core.organizations (id),
+  charge_id bigint not null references billing.rent_charges (id),
+  paid_on date not null,
+  amount numeric(10, 2) not null check (amount > 0),
+  method text not null check (method in ('direct_debit', 'bank_transfer', 'ideal')),
+  reference text,
+  created_at timestamptz not null default now(),
+  updated_at timestamptz not null default now()
+);
+
+create index payments_charge_idx on billing.payments (charge_id);
+create index payments_organization_idx on billing.payments (organization_id, paid_on);
+create index payments_method_idx on billing.payments (organization_id, method);
+
+create function billing.refresh_paid_amounts(ids bigint[]) returns void language sql as $$
+  update billing.rent_charges c
+  set paid_amount = s.paid, updated_at = now()
+  from (
+    select ch.id, coalesce((select sum(p.amount) from billing.payments p where p.charge_id = ch.id), 0) as paid
+    from billing.rent_charges ch
+    where ch.id = any (ids)
+  ) s
+  where c.id = s.id and c.paid_amount is distinct from s.paid
+$$;
+
+create function billing.payments_inserted() returns trigger language plpgsql as $$
+begin
+  perform billing.refresh_paid_amounts(array(select distinct charge_id from new_rows));
+  return null;
+end $$;
+
+create function billing.payments_updated() returns trigger language plpgsql as $$
+begin
+  perform billing.refresh_paid_amounts(array(select charge_id from old_rows union select charge_id from new_rows));
+  return null;
+end $$;
+
+create function billing.payments_deleted() returns trigger language plpgsql as $$
+begin
+  perform billing.refresh_paid_amounts(array(select distinct charge_id from old_rows));
+  return null;
+end $$;
+
+-- Transition tables cannot be combined with several events, so one trigger per event.
+create trigger payments_inserted after insert on billing.payments
+  referencing new table as new_rows for each statement execute function billing.payments_inserted();
+create trigger payments_updated after update on billing.payments
+  referencing old table as old_rows new table as new_rows for each statement execute function billing.payments_updated();
+create trigger payments_deleted after delete on billing.payments
+  referencing old table as old_rows for each statement execute function billing.payments_deleted();
+
+-- Outstanding balance per lease: every charge minus its payments, for leases that still owe something.
+create view billing.arrears as
+select
+  c.lease_id,
+  c.organization_id,
+  count(*)::integer as open_charges,
+  sum(c.amount - c.paid_amount) as balance,
+  min(c.due_on) as oldest_due_on
+from billing.rent_charges c
+where c.paid_amount < c.amount
+group by c.lease_id, c.organization_id;

package/dist/templates/real-estate/db/migrations/005_maintenance.sql

@@ -0,0 +1,105 @@
+create schema maintenance;
+
+create type maintenance.ticket_status as enum ('reported', 'scheduled', 'done', 'cancelled');
+
+create table maintenance.vendors (
+  id integer generated by default as identity primary key,
+  organization_id integer not null references core.organizations (id),
+  name text not null,
+  trade text not null check (trade in ('plumbing', 'heating', 'electrical', 'roofing', 'carpentry', 'locksmith', 'pest_control', 'general')),
+  email text,
+  phone text,
+  hourly_rate numeric(8, 2) not null check (hourly_rate > 0),
+  active boolean not null default true,
+  created_at timestamptz not null default now(),
+  updated_at timestamptz not null default now()
+);
+
+create index vendors_trade_idx on maintenance.vendors (organization_id, trade);
+
+create table maintenance.tickets (
+  id bigint generated by default as identity primary key,
+  organization_id integer not null references core.organizations (id),
+  number text not null,
+  property_id bigint not null references portfolio.properties (id),
+  unit_id bigint references portfolio.units (id),
+  reported_by bigint references leasing.tenants (id),
+  assigned_to integer references core.users (id),
+  category text not null check (category in ('heating', 'plumbing', 'electrical', 'leak', 'mould', 'locks', 'appliances', 'windows_doors', 'garden', 'pests')),
+  priority text not null default 'normal' check (priority in ('low', 'normal', 'high', 'urgent')),
+  status maintenance.ticket_status not null default 'reported',
+  title text not null,
+  description text,
+  reported_at timestamptz not null default now(),
+  closed_at timestamptz,
+  created_at timestamptz not null default now(),
+  updated_at timestamptz not null default now(),
+  unique (organization_id, number),
+  check ((status in ('done', 'cancelled')) = (closed_at is not null))
+);
+
+create index tickets_organization_idx on maintenance.tickets (organization_id, created_at);
+create index tickets_status_idx on maintenance.tickets (organization_id, status);
+create index tickets_priority_idx on maintenance.tickets (organization_id, priority);
+create index tickets_category_idx on maintenance.tickets (organization_id, category);
+create index tickets_reported_idx on maintenance.tickets (organization_id, reported_at);
+create index tickets_property_idx on maintenance.tickets (property_id);
+create index tickets_unit_idx on maintenance.tickets (unit_id);
+create index tickets_reported_by_idx on maintenance.tickets (reported_by);
+create index tickets_assigned_idx on maintenance.tickets (assigned_to);
+create index tickets_title_trgm_idx on maintenance.tickets using gin (title gin_trgm_ops);
+
+-- A ticket moves forward only: reported -> scheduled -> done, and reported or scheduled -> cancelled.
+-- Closing it stamps closed_at; the check on the table keeps the two in step.
+create function maintenance.ticket_status_changed() returns trigger language plpgsql as $$
+begin
+  if new.status = old.status then return new; end if;
+  if not ((old.status = 'reported' and new.status in ('scheduled', 'cancelled'))
+       or (old.status = 'scheduled' and new.status in ('done', 'cancelled'))) then
+    raise exception 'a ticket cannot go from % to %', old.status, new.status using errcode = 'check_violation';
+  end if;
+  if new.status in ('done', 'cancelled') then new.closed_at := coalesce(new.closed_at, now()); end if;
+  return new;
+end $$;
+
+create trigger ticket_status_changed before update of status on maintenance.tickets
+  for each row execute function maintenance.ticket_status_changed();
+
+create table maintenance.work_orders (
+  id bigint generated by default as identity primary key,
+  organization_id integer not null references core.organizations (id),
+  ticket_id bigint not null references maintenance.tickets (id),
+  vendor_id integer not null references maintenance.vendors (id),
+  scheduled_for date not null,
+  completed_on date,
+  hours numeric(5, 2),
+  cost numeric(10, 2),
+  notes text,
+  created_at timestamptz not null default now(),
+  updated_at timestamptz not null default now(),
+  check (completed_on is null or completed_on >= scheduled_for)
+);
+
+create index work_orders_ticket_idx on maintenance.work_orders (ticket_id);
+create index work_orders_vendor_idx on maintenance.work_orders (vendor_id);
+create index work_orders_scheduled_idx on maintenance.work_orders (organization_id, scheduled_for);
+
+create table maintenance.inspections (
+  id bigint generated by default as identity primary key,
+  organization_id integer not null references core.organizations (id),
+  unit_id bigint not null references portfolio.units (id),
+  lease_id bigint references leasing.leases (id),
+  inspector_id integer not null references core.users (id),
+  kind text not null check (kind in ('move_in', 'move_out', 'periodic')),
+  inspected_on date not null,
+  condition text not null check (condition in ('good', 'fair', 'poor')),
+  notes text,
+  created_at timestamptz not null default now(),
+  updated_at timestamptz not null default now()
+);
+
+create index inspections_organization_idx on maintenance.inspections (organization_id, inspected_on);
+create index inspections_unit_idx on maintenance.inspections (unit_id);
+create index inspections_lease_idx on maintenance.inspections (lease_id);
+create index inspections_inspector_idx on maintenance.inspections (inspector_id);
+create index inspections_kind_idx on maintenance.inspections (organization_id, kind);

package/dist/templates/real-estate/db/migrations/006_outstanding.sql

@@ -0,0 +1,14 @@
+-- What is still owed on a charge, as a column so it can be filtered, sorted and indexed. Postgres computes it on every
+-- write, so it follows paid_amount whether the payment triggers or the seed loader (triggers off) sets it.
+alter table billing.rent_charges add column outstanding numeric(10, 2) generated always as (amount - paid_amount) stored;
+
+create or replace view billing.arrears as
+select
+  c.lease_id,
+  c.organization_id,
+  count(*)::integer as open_charges,
+  sum(c.outstanding) as balance,
+  min(c.due_on) as oldest_due_on
+from billing.rent_charges c
+where c.paid_amount < c.amount
+group by c.lease_id, c.organization_id;

package/dist/templates/real-estate/db/migrations/007_auth.sql

@@ -0,0 +1,36 @@
+-- The auth schema changes this version of Protobase needs, written by `protobase auth migration`.
+-- Applied with the project's other migrations; edit or remove statements the project handles differently.
+
+create schema if not exists "auth";
+
+create table if not exists "auth"."user" ("id" text not null primary key, "name" text not null, "email" text not null unique, "email_verified" boolean not null, "image" text, "created_at" timestamptz default CURRENT_TIMESTAMP not null, "updated_at" timestamptz default CURRENT_TIMESTAMP not null, "role" text, "banned" boolean, "ban_reason" text, "ban_expires" timestamptz, "two_factor_enabled" boolean);
+
+create table if not exists "auth"."session" ("id" text not null primary key, "expires_at" timestamptz not null, "token" text not null unique, "created_at" timestamptz default CURRENT_TIMESTAMP not null, "updated_at" timestamptz not null, "ip_address" text, "user_agent" text, "user_id" text not null references "auth"."user" ("id") on delete cascade, "impersonated_by" text);
+
+create table if not exists "auth"."account" ("id" text not null primary key, "account_id" text not null, "provider_id" text not null, "user_id" text not null references "auth"."user" ("id") on delete cascade, "access_token" text, "refresh_token" text, "id_token" text, "access_token_expires_at" timestamptz, "refresh_token_expires_at" timestamptz, "scope" text, "password" text, "created_at" timestamptz default CURRENT_TIMESTAMP not null, "updated_at" timestamptz not null);
+
+create table if not exists "auth"."verification" ("id" text not null primary key, "identifier" text not null, "value" text not null, "expires_at" timestamptz not null, "created_at" timestamptz default CURRENT_TIMESTAMP not null, "updated_at" timestamptz default CURRENT_TIMESTAMP not null);
+
+create table if not exists "auth"."jwks" ("id" text not null primary key, "public_key" text not null, "private_key" text not null, "created_at" timestamptz not null, "expires_at" timestamptz, "alg" text, "crv" text);
+
+create table if not exists "auth"."two_factor" ("id" text not null primary key, "secret" text not null, "backup_codes" text not null, "user_id" text not null references "auth"."user" ("id") on delete cascade, "verified" boolean, "failed_verification_count" integer, "locked_until" timestamptz);
+
+create table if not exists "auth"."passkey" ("id" text not null primary key, "name" text, "public_key" text not null, "user_id" text not null references "auth"."user" ("id") on delete cascade, "credential_id" text not null, "counter" integer not null, "device_type" text not null, "backed_up" boolean not null, "transports" text, "created_at" timestamptz, "aaguid" text);
+
+create table if not exists "auth"."sign_in_policy" ("id" text not null primary key, "password" text not null, "email_code" text not null, "passkey" text not null, "two_factor" text not null, "staff_access" text not null, "platform_sign_in" text not null, "created_at" timestamptz not null, "created_by" text);
+
+create table if not exists "auth"."staff_sign_in" ("id" text not null primary key, "user_id" text not null, "user_email" text not null, "staff" text not null, "staff_name" text, "staff_subject" text not null, "issuer" text not null, "reason" text not null, "session_id" text not null, "started_at" timestamptz not null, "expires_at" timestamptz not null, "ended_at" timestamptz);
+
+create index if not exists "session_user_id_idx" on "auth"."session" ("user_id");
+
+create index if not exists "account_user_id_idx" on "auth"."account" ("user_id");
+
+create index if not exists "verification_identifier_idx" on "auth"."verification" ("identifier");
+
+create index if not exists "two_factor_secret_idx" on "auth"."two_factor" ("secret");
+
+create index if not exists "two_factor_user_id_idx" on "auth"."two_factor" ("user_id");
+
+create index if not exists "passkey_user_id_idx" on "auth"."passkey" ("user_id");
+
+create index if not exists "passkey_credential_id_idx" on "auth"."passkey" ("credential_id");