মনচিত্র প্রজেক্ট গাইড

ডিপ্লয়মেন্ট গাইড

environment setup, schema rollout, preview validation, production release, monitoring ও rollback।

Environment ও configuration

Variable	উদ্দেশ্য	ব্যবস্থাপনা
NEXT_PUBLIC_SUPABASE_URL	Browser/server Supabase endpoint	Public URL; startup-এ validate
NEXT_PUBLIC_SUPABASE_ANON_KEY / PUBLISHABLE_KEY	RLS-সহ client-safe key	public হতে পারে; RLS কখনো বন্ধ নয়
SUPABASE_SERVICE_ROLE_KEY	শুধু privileged server maintenance	Secret; browser/log-এ নয়
AI Gateway	Server model access	Vercel-managed auth; UI-তে static key চাইবেন না

Preview setup

clean checkout-এ project-এর pnpm lockfile ও frozen-lockfile install ব্যবহার করুন।
environment secret project settings-এ রাখুন; blueprint বা repository-তে নয়।
নথিভুক্ত Next.js development service চালিয়ে actual listening port যাচাই করুন।
Production-এর আগে external callback ও browser behavior Preview deploy-এ যাচাই করুন।

Local verification command bash

pnpm install --frozen-lockfile
pnpm exec tsc --noEmit
pnpm run dev

Database rollout

migration SQL, constraint, index ও rollback plan review করুন।
connected Supabase migration tool দিয়ে apply করুন; production table হাতে edit নয়।
data access লেখার আগে live schema, nullability ও default আবার দেখুন।
owner, unrelated learner, guardian, teacher ও anonymous context দিয়ে RLS test করুন।
শুধু fictional, স্পষ্ট demo record seed করুন; সরাসরি fake auth user নয়।

Production release checklist

typecheck, lint ও targeted route test চালান।
CSP/report-only log ও অনুমোদিত external origin review করুন।
domain, redirect, metadata, manifest ও service worker scope নিশ্চিত করুন।
email callback, guardian approval ও unauthorized-access behavior যাচাই করুন।
content rights, localized page ও support contact নিশ্চিত করুন।
release SHA, owner, rollback target ও monitoring dashboard নথিভুক্ত করুন।

Monitoring, backup ও rollback

server error, authentication failure, query latency, AI rate usage ও offline cache failure monitor করুন।
database backup schedule ও restoration drill করুন; restore সফল না হওয়া পর্যন্ত backup যাচাইকৃত নয়।
সম্ভব হলে reversible migration ব্যবহার করুন; ঝুঁকিপূর্ণ পরিবর্তনে rollback migration লিখুন।
release-এর পর deployed domain-এ user flow যাচাই করে regression নথিভুক্ত করুন।

Operations ownership

pilot-এর আগে security report, content correction, account deletion request, database incident ও rollback approval-এর দায়িত্বপ্রাপ্ত ব্যক্তি নির্ধারণ করুন। বাস্তব student data নেওয়ার আগে privacy notice ও support contact প্রকাশ করুন।