راهنمای پروژه: جریان کاربران · معماری فنی · ارتباط API · عملیات · امنیت و کیفیت
سامانه یکپارچه ثبت آزمون، تحلیل اشتباهات، مشاهده پیشرفت و مشاوره تحصیلی
فارسی، راستچین، امن و آماده اجرای production
وباپلیکیشن فارسی و راستچین آینده سبز برای مدیریت آزمونها، تحلیل اشتباهات، گزارشهای عملکرد تحصیلی و مدیریت دانشآموزان. این برنامه فقط با تنظیمات محیط production اجرا میشود.
- Next.js 16 با App Router، React 19 و TypeScript در حالت strict
- Tailwind CSS 4 به همراه فونت متغیر وزیرمتن با میزبانی آفلاین
- TanStack Query برای دادههای سرور و Zustand برای وضعیت احراز هویت بدون نگهداری توکن
- React Hook Form و Zod برای فرمهای type-safe و اعتبارسنجی دادهها
- کامپوننتهای Radix UI، آیکنهای Lucide، نمودارهای Recharts و اعلانهای Sonner
- نشست رمزنگاریشده BFF در کوکی HttpOnly؛ توکن دسترسی و refresh هیچگاه وارد مرورگر نمیشوند
- Vitest، Testing Library، MSW، Playwright و axe-core برای تست خودکار
Docker روش استاندارد اجرای پروژه است. دستورهای زیر را از پوشه frontend اجرا کنید:
docker compose up --build -d
docker compose psسامانه از نشانی http://localhost در دسترس خواهد بود. Compose سرویسهای PostgreSQL، Redis، بکاند
Go، فرانتاند Next.js و gateway مبتنی بر Nginx را اجرا میکند.
برای توقف سرویسها:
docker compose downگزینه -v را فقط زمانی اضافه کنید که حذف کامل دادههای پایگاه داده، Redis و فایلهای آپلودشده مدنظر
باشد.
npm ci
npm run qualityاین دستور کنترل فرمت، typecheck، ESLint، تستهای خودکار، build محیط production، بودجه عملکرد و سناریوهای E2E دسکتاپ و موبایل را اجرا میکند.
حالت اجرایی برنامه همواره production است. متغیرهای محیطی فقط مقادیر وابسته به استقرار را تنظیم میکنند و امکان تغییر رفتار برنامه به development یا test را ندارند.
وضعیت مستندات: هماهنگ با پیادهسازی فعلی frontend و backend