projax/db/migrations/0017_views_redesign.sql

-- 0017_views_redesign.sql
--
-- Phase 5j Slice A: paliad-shape redesign of projax.views.
--
-- 5i (0016) modelled views as overlays on existing pages keyed by uuid.
-- m's feedback: that's the wrong shape — views should be first-class
-- pages at /views/{slug}, mirroring paliad's user_views model.
--
-- This migration HARD-REPLACES the 5i table. m's pick on Q10 (2026-05-29):
-- hard-replace is fine because 5i was hours old with no persisted user
-- data of value. Any rows present get dropped along with the table.
--
-- m's other picks worth marking inline:
--   Q2 (2026-05-29): view_type lives INSIDE filter_json, not as a
--                    top-level column with a CHECK constraint. Keeps the
--                    schema lean — the renderer parses the JSON anyway.
--   Q9 (2026-05-29): is_default_for column dropped entirely. MRU
--                    (last_used_at) replaces the per-page-default model.
--   Q11 (2026-05-29): graph stays outside the views enum; no graph
--                    view_type ever lands in filter_json.

DROP TABLE IF EXISTS projax.views CASCADE;

CREATE TABLE projax.views (
  id            uuid PRIMARY KEY DEFAULT gen_random_uuid(),

  -- URL-routable identifier. Application-layer validator enforces the
  -- regex `^[a-z0-9][a-z0-9-]{0,62}$` + a reserved-slug list (system
  -- slugs + top-level route segments). Globally unique — single-user
  -- v1; no user_id prefix.
  slug          text NOT NULL,

  -- Display name. Free-form; user picks whatever language they think in.
  -- Rendered verbatim in the sidebar.
  name          text NOT NULL,

  -- Frontend icon-registry key. NULL → default folder glyph. Length cap
  -- keeps stored value sane even if the registry is bypassed.
  icon          text,

  -- Canonical view definition. Includes view_type (per m's Q2 pick),
  -- plus the standard TreeFilter dimensions (q, tags, management, …),
  -- plus optional sort/group hints. Renderer parses the JSON; the DB
  -- never has to look inside.
  filter_json   jsonb NOT NULL DEFAULT '{}'::jsonb,

  -- Sort + grouping hints used by the renderers (list/card/kanban).
  -- Kept as top-level columns so the editor can index them quickly,
  -- though they're conceptually part of the render spec.
  sort_field    text,
  sort_dir      text,
  group_by      text,

  -- Sidebar ordering. Server-assigned MAX+1 on create so two parallel
  -- inserts don't collide. Drag-reorder UI lands in slice G; this
  -- column is wired now so the data shape is stable.
  sort_order    integer NOT NULL DEFAULT 0,

  -- Opt-in count badge on the sidebar entry. Defaults false so casual
  -- views don't pay the COUNT(*) cost.
  show_count    boolean NOT NULL DEFAULT false,

  -- MRU landing on /views — `handleViewsLanding` 302s here when set.
  -- Touched fire-and-forget on every render.
  last_used_at  timestamptz,

  created_at    timestamptz NOT NULL DEFAULT now(),
  updated_at    timestamptz NOT NULL DEFAULT now(),

  CONSTRAINT views_sort_dir_chk
    CHECK (sort_dir IS NULL OR sort_dir IN ('asc','desc')),
  CONSTRAINT views_slug_format_chk
    CHECK (slug ~ '^[a-z0-9][a-z0-9-]{0,62}$')
);

CREATE UNIQUE INDEX views_slug_uniq ON projax.views (slug);
CREATE INDEX views_sort_order_idx ON projax.views (sort_order, name);
CREATE INDEX views_last_used_idx ON projax.views (last_used_at DESC NULLS LAST);

-- updated_at trigger. Re-created here (CREATE OR REPLACE on the function)
-- because 0016 dropped with CASCADE above.
CREATE OR REPLACE FUNCTION projax.views_touch_updated_at()
  RETURNS trigger LANGUAGE plpgsql AS $$
BEGIN
  NEW.updated_at := now();
  RETURN NEW;
END;
$$;

DROP TRIGGER IF EXISTS views_touch_updated_at ON projax.views;
CREATE TRIGGER views_touch_updated_at
  BEFORE UPDATE ON projax.views
  FOR EACH ROW EXECUTE FUNCTION projax.views_touch_updated_at();

DO $own$ BEGIN
  IF EXISTS (SELECT 1 FROM pg_roles WHERE rolname = 'projax_admin') THEN
    EXECUTE 'ALTER TABLE projax.views OWNER TO projax_admin';
    EXECUTE 'ALTER FUNCTION projax.views_touch_updated_at() OWNER TO projax_admin';
    EXECUTE 'GRANT SELECT, INSERT, UPDATE, DELETE ON projax.views TO projax_admin';
  END IF;
END $own$;