Renocheck

裝修公司風險參考搜尋（MVP）— 業主防禦向、聚合官方牌照與公開討論摘要。

Docs

• MVP 設計書 — 範圍、架構、資料模型、API
• 開發指南 — pnpm dev / test / env
• UI 原則
• AGENTS.md — Cursor / agent 入口
• V2 roadmap
• Notion： MVP project-裝修點評

Status

Next.js scaffold、主題與頁面殼已就緒。搜尋 API / Supabase 待下一階段。

Setup

pnpm install
cp .env.example .env.local
pnpm dev

Tests

pnpm test runs Vitest and does not call Supabase. The D2 filter golden parity check is opt-in and skips when RUN_D2_GOLDEN is unset.

Production anon can no longer read mwc_contractors. pnpm test:d2 does not read .env.local. Use a local Supabase stack (pnpm supabase start, then the local import below) or a dev project, and export that database's URL and anon key.

import:mwc 會讀 .env.local，而且 NEXT_PUBLIC_SUPABASE_URL 優先；一定要喺命令前面 export local 嘅 URL 同 key，否則會寫入 .env.local 指住嘅 project（通常係 prod）。

supabase start applies 20261018140000, so local anon cannot read until you run scripts/sql/d2-local-anon-read.sql. Never run it on production. 直接貼入 SQL editor 會被拒；只開 id/company_name/registration_no；唔好將呢個檔搬入 supabase/。

pnpm supabase start
NEXT_PUBLIC_SUPABASE_URL=http://127.0.0.1:54321 SUPABASE_SERVICE_ROLE_KEY=<local-service-role> pnpm import:mwc
PGOPTIONS='-c renocheck.d2_local_grant=yes' psql -v ON_ERROR_STOP=1 "postgresql://postgres:[email protected]:54322/postgres" -f scripts/sql/d2-local-anon-read.sql
NEXT_PUBLIC_SUPABASE_URL=http://127.0.0.1:54321 NEXT_PUBLIC_SUPABASE_ANON_KEY=<local-anon> pnpm test:d2

A production project ref is refused. scripts/write-judgment-d2-filter-golden.ts and scripts/filter-judgment-candidates-d2.ts use the same gate and do not read .env.local.

Do not source .env.local for this; it would also export SUPABASE_SERVICE_ROLE_KEY into the shell. See docs/development.md.

Agent setup

See AGENTS.md and .cursor/rules/.