M2: the full job lifecycle — chat, hiring, geocoding, quotes, bookings, reviews

Closes the funnel. Before this the product could match two people and then
stopped: `quotes`, `bookings` and `reviews` had tables and state machines and
nothing that wrote a row, the entry deck's right swipe was wired to an empty
handler, and every address resolved to the city centre.

Jobs tab and chat
- message router: thread, send, markRead, unreadTotal. A thread is a MATCH, not
  a job — one job with three interested pros is three private conversations.
- Current/Past segments derived from ACTIVE_JOB_STATUSES, job detail listing the
  pros who accepted, and the conversation itself with attachments.

Hiring from the deck
- A right swipe on the entry deck opened nothing. It now resolves "which job?"
  through a sheet — sign in, pick an open job, or post one — and calls the same
  deck.swipe the per-job deck does, so the open-request cap and row lock apply
  exactly once. Swipes are vetoable so closing the sheet returns the card.

Geocoding
- ST_Distance and ST_DWithin rank and filter every deck, and both operands were
  placeholders. Addresses now resolve through Mapbox (permanent=true, which is
  what licenses storing the coordinates), the server resolves points rather than
  trusting client-supplied lat/lng, and every stored point records how it was
  obtained. A `city`-precision base cannot reach the verification queue.

Quote -> booking -> review
- The commercial chain, minus payments. Accepting a quote is the only place a
  booking is created; confirming completion is what unlocks reviews and moves
  the pro's completed_jobs.
- Reviews publish double-blind with no sweeper: each is written with
  published_at already set to its embargo deadline and every read filters
  published_at <= now(), so it publishes itself. The second review pulls both
  forward. A silent counterparty cannot bury a bad review by never replying.

State machine changes, both deliberate
- booked -> matched: a cancelled booking is not a cancelled job.
- scheduled -> awaiting_confirmation: in_progress is optional, so a pro who
  never tapped Start can still say the work is done.

Test suite
- api tests ran files in parallel against one database and failed roughly one
  run in three on whichever file lost the race. Serialised, and three fixtures
  that grabbed "the first client" pinned to the seeded accounts.

Also includes work from a parallel session: admin verification queue, pro
public profile and reviews read path, notification sending, denormalised stats
recompute, search, and observability.

318 tests passing; typecheck and lint clean across 7 packages.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
serfa
2026-08-21 06:29:59 -04:00
co-authored by Claude Opus 5
parent 8f3509d1dd
commit 974e312534
115 changed files with 19994 additions and 569 deletions
+89
View File
@@ -0,0 +1,89 @@
import { sql, type SQL } from 'drizzle-orm';
import type { Db } from '../client';
/**
* Recompute the denormalised ranking counters on `pro_profiles`.
*
* `rating_avg`, `rating_count`, `completed_jobs`, `response_rate` and
* `avg_response_minutes` are inputs to `score()` in @linkder/shared, and until
* this existed nothing ever wrote them after the seed. The deck ranked on
* numbers that were invented once and never moved, and the card told customers
* "usually replies in 25 min" on the strength of it.
*
* They stay denormalised rather than being computed per query: the deck scores
* every candidate pro on every load, and four correlated subqueries per card is
* the kind of cost that only shows up once a city is full. The trade is that
* they must be refreshed when their inputs change — see the callers.
*
* Written as one statement over a filtered set so a single pro and a full
* backfill cannot drift apart. It is idempotent by construction: it derives
* every value from source rows rather than incrementing anything, so running it
* twice is the same as running it once, and running it after a missed event
* repairs the counter rather than compounding the mistake.
*/
function recomputeWhere(where: SQL): SQL {
return sql`
UPDATE pro_profiles p SET
-- Multi-column assignment so each source table is scanned once rather
-- than once per column. An aggregate with no GROUP BY always returns a
-- row, so a pro with no history gets (NULL, 0) and not a failed update.
(rating_avg, rating_count) = (
SELECT round(avg(rating)::numeric, 2), count(*)::int
FROM reviews
-- Published only, and the same predicate pro.reviews reads with. A
-- count that included embargoed reviews would put a number in the
-- header that the list underneath it can never reach.
WHERE subject_id = p.user_id
AND published_at IS NOT NULL
AND published_at <= now()
),
completed_jobs = (
SELECT count(*)::int
FROM bookings bk
JOIN matches m ON m.id = bk.match_id
WHERE m.pro_id = p.user_id
AND bk.status = 'completed'
),
(response_rate, avg_response_minutes) = (
SELECT
/*
* Answered over decided — NOT over sent.
*
* A request still inside its window has not been ignored yet, so
* counting it as a miss would punish a pro for work that just
* arrived and let them recover only once it expired. The ones that
* count against them are those past their expiry with no response,
* whether or not the lazy sweeper has relabelled the row yet.
*/
CASE WHEN count(*) FILTER (
WHERE responded_at IS NOT NULL OR expires_at < now()
) = 0
THEN NULL
ELSE round(
count(*) FILTER (WHERE responded_at IS NOT NULL)::numeric
/ count(*) FILTER (WHERE responded_at IS NOT NULL OR expires_at < now()),
3)
END,
round(avg(
EXTRACT(EPOCH FROM (responded_at - created_at)) / 60
) FILTER (WHERE responded_at IS NOT NULL))::int
FROM requests
WHERE pro_id = p.user_id
),
updated_at = now()
WHERE ${where}
`;
}
/** Refresh one pro. Call after anything that changes their history. */
export async function recomputeProStats(db: Db, proId: string): Promise<void> {
await db.execute(recomputeWhere(sql`p.user_id = ${proId}`));
}
/**
* Refresh every pro. For the seed, for a backfill, and for a nightly sweep that
* repairs anything a missed event left behind.
*/
export async function recomputeAllProStats(db: Db): Promise<void> {
await db.execute(recomputeWhere(sql`true`));
}