Nightos Dev Patterns

NIGHTOS プロジェクト固有の開発パターン百科事典。 新機能実装・バグ修正・コードレビュー時に自動適用する。 トリガー: NIGHTOS開発全般、新規ページ作成、API追加、DB変更、 Supabaseクエリ、営業日ロジック、権限チェック、マルチ店舗対応 --- ## 1. Supabase クライアント戦略 ### 絶対ルール: `getFreshSupabase()` を使う ```typescript // ❌ 禁止: モジュールレベルのsupabaseは古いトークンを保持し続ける import { supabase } from '../lib/supabase' // ✅ 正解: 毎回新鮮なトークンでクライアント生成 import { getFreshSupabase } from '../lib/supabase' const sb = getFreshSupabase() ``` **Why:** `persistSession: false` 環境でトークン期限切れ→全REST API 401。 ### トークンリフレッシュ: 401時に `refreshStoredToken()` → `getFreshSupabase()` でリトライ ### 公開ページ（CheckinPage, MyPage）: `publicSupabase` を使用 ### ページネーション: `fetchAllRows()` で900件ずつ全件取得（max_rows=1000対策） --- ## 2. 認証・権限システム ### ロール階層（7段階） ``` platform_admin(7) > owner(6) > area_manager(5) > manager(4) > staff(3) > cast(2) > viewer(1) ``` ### 権限チェック関数（frontend/src/lib/permissions.ts） - `canEditCustomer(role, settings)` — staff+, cast設定拡張可 - `canDeleteCustomer(role)` — owner+ - `canManageCast(role)` — manager+ - `canAccessAccounting(role, settings)` — manager+, staff設定拡張可 - `canAccessKpi(role, settings)` — manager+, staff設定拡張可 - `canAccessSettings(role)` — owner+ - `canManageTenants(role)` — platform_admin ### プラン別機能ゲーティング（hooks/usePlanGating.ts） ```typescript const { canUse, requiredPlan } = usePlanGating() if (!canUse('ai_analysis')) return ``` プラン: free(0) → starter(1) → pro(2) → enterprise(3) → business(4) → business_plus(5) platform_admin は全機能override。 --- ## 3. 営業日ロジック（最重要） ### 必須: `parseBusinessStartHour()` を引数に渡す ```typescript // ❌ デフォルト6時が使われる const today = getBusinessDate(new Date()) // ✅ 店舗設定から取得 const startHour = parseBusinessStartHour(storeSettings?.business_hours_start) const today = getBusinessDate(new Date(), startHour) ``` 関数: `parseBusinessStartHour` / `getBusinessDate` / `getBusinessDayRange` / `getTodayBusinessDate`

インストール

購入後にターミナルで実行してください。

正規購入者にはインストールコマンド再実行で最新版が配信されます。

評価とレビュー