Prof Assist Pro

مساعد الأستاذ — تطبيق ويب لتنظيم عمل الأستاذ الجزائري (الأقسام، التلاميذ، السنوات الدراسية، وأكثر).

Teacher-first SaaS for Algerian teachers. Phase 01 foundation: authentication, onboarding, dashboard, academic years, classes, students, and settings — with full Supabase Row Level Security.

Stack

• Next.js 15 (App Router) + TypeScript (strict)
• Tailwind CSS + shadcn/ui-style components (Radix)
• Supabase (Auth + PostgreSQL + Storage-ready)
• Arabic RTL, light/dark, responsive (desktop / tablet / mobile)

Local setup

1. Install dependencies

   npm install
   

2. Create a Supabase project at https://supabase.com and get your keys from Project Settings → API.

3. Environment variables — copy the example and fill it:

   cp .env.example .env.local
   

   NEXT_PUBLIC_SUPABASE_URL=https://YOUR-PROJECT-ref.supabase.co
   NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-public-key
   

4. Apply the database schema — open the Supabase SQL Editor and run the contents of supabase/migrations/0001_init.sql. This creates all tables, indexes, triggers, and RLS policies, and wires the handle_new_user trigger that auto-creates a profile on sign-up.

5. Auth redirect URLs — in Supabase Authentication → URL Configuration, add your site URL (e.g. http://localhost:3000) and the redirect …/auth/callback. For local testing you may disable "Confirm email" under Authentication → Providers → Email so sign-up logs you straight in.

6. Run the dev server

   npm run dev
   

   Open http://localhost:3000

Scripts

Command	Description
npm run dev	Start the dev server
npm run build	Production build
npm run start	Start the production server
npm run lint	ESLint
npm run typecheck	TypeScript type-check (no emit)

Deploy to Vercel

1. Push this repository to GitHub.
2. Import it in Vercel.
3. Add the two NEXT_PUBLIC_SUPABASE_* environment variables in the Vercel project settings.
4. Add your Vercel production URL + /auth/callback to Supabase Auth redirect URLs.
5. Deploy.

Never commit .env.local or any secret. Only the NEXT_PUBLIC_ anon key is used client-side; it is safe to expose and is protected by Row Level Security.

Phase 02 (planned)

Schedule, attendance, grades, lesson preparation, templates, PDF generation, analytics, and files. These modules currently show honest "قريباً" (coming soon) states in the UI.