senior's post-demo changes: parent report in the student's own account, Jalali birth date, invoices, math-only tutor, priced quotas

- remove the family app from the root (separate parent accounts, invite codes, parental
  settings); progress.0006 drops its tables, permissions and migration history, and
  Profile.parent_phone, the two family notification types and ?userId= on
  /api/progress/nodes go with it
- GET /api/user/weekly-report: last 7 days next to the 7 before (estimated minutes,
  questions, accuracy, islands, tutor questions) for the "parent report" page
- profile birthDate in Jalali (accounts/jalali.py), ages 5-99, birthYear derived from it
- GET /api/payment/invoices; orders now snapshot list price and plan title
- tutor answers only math: server pre-filter, scope rule in the prompt (tutor-v11),
  refusal marker replaced with fixed text; self-harm gets a help line instead
- streamed answers now record token usage (it was always 0)
- daily tutor quota: AI_DAILY_QUOTA_FREE (default 3) vs Plan.ai_daily_quota
- delete_users management command for wiping test accounts across every app
- docs/ai-cost-and-guardrails.md: measured cost per question and guardrail results

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

docs/technical-handbook.md

@@ -32,8 +32,8 @@
 | کاربر | چه می‌کند | کجای کد |
 |---|---|---|
 | دانش‌آموزِ مهمان | بدونِ شماره وارد می‌شود، پایه‌اش را انتخاب می‌کند و بازی می‌کند. اگر بعداً با شماره ثبت‌نام کند، همان حساب می‌ماند و امتیازش گم نمی‌شود. | `accounts/views.py` |
-| دانش‌آموز | با شماره‌ی موبایل و کدِ پیامکی وارد می‌شود؛ جزیره‌ها را بازی می‌کند، از دستیار می‌پرسد، امتیاز و سکه و زنجیره‌ی روزانه جمع می‌کند، همراه انتخاب می‌کند، اشتراک می‌خرد، تیکتِ پشتیبانی می‌فرستد. | `content/` `progress/` `ai_tutor/` |
-| والد | به حسابِ فرزند وصل می‌شود و گزارشِ هفتگی و پیشرفتش را می‌بیند. | `family/` |
+| دانش‌آموز | از هر سنی (بزرگسالی که فقط یک مبحث را می‌خواهد هم پایه‌ی همان مبحث را انتخاب می‌کند). با شماره‌ی موبایل و کدِ پیامکی وارد می‌شود؛ جزیره‌ها را بازی می‌کند، از دستیار می‌پرسد، امتیاز و سکه و زنجیره‌ی روزانه جمع می‌کند، همراه انتخاب می‌کند، اشتراک می‌خرد، تیکتِ پشتیبانی می‌فرستد. | `content/` `progress/` `ai_tutor/` |
+| والد | حسابِ جدا ندارد: «گزارشِ والدین» را در حسابِ خودِ دانش‌آموز می‌بیند — زمانِ تمرین، سوال‌ها و مقایسه با هفته‌ی پیش، با دو نمودار. | `progress/report.py` |
 | ادمین (کارمندِ شرکت) | از پنلِ `/admin/` سؤال، درس، پلن، همراه و تیکت را بدونِ برنامه‌نویس ویرایش می‌کند؛ سؤال‌ها را فله‌ای وارد و خارج می‌کند. | `*/admin.py` |
 
 ### تاریخچه‌ی کوتاه
@@ -50,7 +50,7 @@
 
 ![مدل سناریو (Use Case)](images/technical-handbook/use-case-model.png)
 
-*شکلِ ۱-۱ — مدلِ سناریو: سه نقشِ کاربری، دوازده کارِ اصلی، و سه سرویسِ بیرونی.*
+*شکلِ ۱-۱ — مدلِ سناریو: سه نقشِ کاربری (والد با حسابِ خودِ دانش‌آموز)، یازده کارِ اصلی، و سه سرویسِ بیرونی.*
 
 ### واحدهای محتوا (این واژه‌ها در کلِ سند تکرار می‌شوند)
 
@@ -77,7 +77,7 @@
 | فرانت | **React 18** + **TypeScript** (strict) + **Vite** + **Tailwind** | فرانتِ اولیه را توسعه‌دهنده‌ی قبلی با React ساخته بود؛ در بازسازی نگه داشته شد چون بزرگ‌ترین اکوسیستم را دارد و نیروی جایگزینش راحت پیدا می‌شود. TypeScript ناهمخوانیِ شکلِ داده با API را در زمانِ build می‌گیرد. Vite buildِ سریع و Tailwind رنگ و فاصله‌ی یکدست. وبِ موبایل‌محور یعنی بدونِ نصب و بدونِ فروشگاه روی هر گوشی باز می‌شود. | React Native / Flutter نیازِ انتشار در فروشگاه و build جدا داشت؛ نسخه‌ی اندروید (کافه‌بازار) بعداً می‌تواند اضافه شود. | بدونِ کتابخانه‌ی router و state؛ کمتر وابستگی، ولی الگوی داخلی را باید خواند (بخشِ ۴). |
 | دیتابیس | **SQLite** (فعلاً) | روی سرورِ مشترکِ شرکت صفر نگهداری دارد: یک فایل، بکاپ با یک دستور. برای حجمِ فعلی کافی است. کد از ORM استفاده می‌کند و به SQLite گره نخورده. | Postgres روی همان سرور موجود است؛ مهاجرت به هماهنگی با ادمینِ سرور نیاز دارد و به مرحله‌ی بعد موکول شده است. | **فقط یک نویسنده در لحظه.** اولین گلوگاهِ مقیاس است (بخشِ ۱۴). |
 | جست‌وجوی کتاب | **Qdrant** (بانکِ برداری) | تیمِ دیگرِ شرکت کتاب‌های سوم/ششم/هفتم را از قبل در یک Qdrantِ مشترک گذاشته بود؛ همان را ادامه دادیم تا داده دوباره ساخته نشود. فیلتر روی فیلدِ «فصل» دارد. | pgvector به Postgres نیاز داشت؛ FAISS سرور ندارد و بینِ دو تیم اشتراک‌پذیر نیست. | سرویسِ مشترک با تیمِ دیگر؛ پاک‌کردن باید با احتیاط باشد (بخشِ ۹). |
-| مدلِ زبانی | **GapGPT** ← `gpt-4.1-mini` | GapGPT یک واسطِ سازگار با OpenAI است که از داخلِ ایران جواب می‌دهد. مدل با سنجش انتخاب شد، نه با جدولِ قیمت: روی ۱۰۲ مسئله‌ی تصحیح‌شده ۹۵–۹۶ درست در برابرِ ۸۵–۹۰ برای `gpt-4o-mini` ؛ هر جواب حدودِ ۰٫۱۲ سنت. | OpenAIِ مستقیم از ایران در دسترس نیست. مدل‌های گران‌تر در دورِ اولِ سنجش (۱۴ مدل) مزیتی نشان ندادند. | کُندیِ سرویس (حتی «سلام» ۷ ثانیه) دستِ ما نیست؛ اعتبار دو بار تمام شده. |
+| مدلِ زبانی | **GapGPT** ← `gpt-4.1-mini` | GapGPT یک واسطِ سازگار با OpenAI است که از داخلِ ایران جواب می‌دهد. مدل با سنجش انتخاب شد، نه با جدولِ قیمت: روی ۱۰۲ مسئله‌ی تصحیح‌شده ۹۵–۹۶ درست در برابرِ ۸۵–۹۰ برای `gpt-4o-mini` ؛ هر جواب با پرامپتِ امروز حدودِ ۰٫۲ سنت (≈ ۶۰۰ تومان؛ `docs/ai-cost-and-guardrails.md`). دستیار فقط درباره‌ی ریاضی حرف می‌زند و سقفِ روزانه‌اش برای کاربرِ رایگان ۳ و برای مشترک به اندازه‌ی پلن است. | OpenAIِ مستقیم از ایران در دسترس نیست. مدل‌های گران‌تر در دورِ اولِ سنجش (۱۴ مدل) مزیتی نشان ندادند. | کُندیِ سرویس (حتی «سلام» ۷ ثانیه) دستِ ما نیست؛ اعتبار دو بار تمام شده. |
 | ورود | **توکنِ امضاشده‌ی خودمان** + کدِ پیامکی | کاربرها با شماره وارد می‌شوند، نه نام‌کاربری/رمز؛ مدلِ کاربرِ جنگو به این نمی‌خورد. توکن با `django.core.signing` امضا می‌شود؛ یک وابستگیِ کمتر از کتابخانه‌ی JWT. | JWT همان کار را می‌کند با یک کتابخانه‌ی اضافه. | امنیتش به کلیدِ امضا بسته است (بخشِ ۱۲، موردِ ۱). |
 | پیامک / پرداخت | **کاوه‌نگار** · **زرین‌پال** · **کافه‌بازار** | سرویس‌های ایرانیِ رایج؛ کاوه‌نگار با «ارسال با الگو» که روی خطِ شرکت فعال است؛ زرین‌پال برای وب، بازار برای خریدِ درون‌برنامه‌ایِ اندروید. | — | پرداختِ واقعی تا انتها هنوز آزموده نشده. |
 | اجرا | **gunicorn** (gthread) پشتِ **nginx** پشتِ **ArvanCloud** | الگوی استانداردِ اجرای جنگو. آروان CDN و سپرِ حمله‌ی ایرانی است. WhiteNoise فایل‌های استاتیکِ ادمین را از خودِ جنگو سرو می‌کند. | — | سرور مشترک است؛ مالِ ما فقط یک پوشه و یک سرویس. |
@@ -111,7 +111,6 @@
 | `affiliate` | معرفی به دوستان و پورسانت | `AffiliateAccount Conversion` |
 | `notifications` | اعلان‌های داخلِ اپ | `Notification` |
 | `support` | تیکت و گزارشِ باگ | `Ticket TicketMessage BugReport` |
-| `family` | اتصالِ والد و فرزند، گزارشِ هفتگی | `FamilyLink ParentalSettings WeeklyReportLog` |
 | `campaigns` | پیامِ گروهی (ذخیره و هدف‌گیری؛ زمان‌بندیِ خودکار ندارد) | `MessageCampaign CampaignDelivery` |
 | `statuslog` | ثبتِ عمومیِ «وضعیتِ فلان چیز از X به Y رفت» | `StatusChangeLog` |
 | `config` | تنظیمات، مسیرهای اصلی، middleware، سلامت، مدیریتِ خطا | — |
@@ -154,7 +153,7 @@ MathApp/
 │   ├── health.py           GET /api/health: دیتابیس، migration، کش، محتوا، هشدارها
 │   └── log_formatters.py   قالبِ JSONِ لاگ
 ├── accounts/  content/  progress/  ai_tutor/  rag/  subscription/  payment/
-├── discount/  affiliate/  notifications/  support/  family/  campaigns/  statuslog/
+├── discount/  affiliate/  notifications/  support/  campaigns/  statuslog/
 ├── content/seed/            curriculum.json و questions.json — کلِ محتوا به‌صورتِ فایل در git
 ├── data/textbooks/          PDFِ کتاب‌ها (در git نیست؛ فقط README)
 ├── templates/tadrisino/     پوسته‌ی راست‌به‌چپِ Swagger و ReDoc
@@ -197,7 +196,7 @@ src/
 ├── app/                  App.tsx: جریانِ ورود · MainApp.tsx: تب‌ها و صفحه‌ها
 ├── nav/                  ناوبریِ پشته‌ای خودمان، هماهنگ با دکمه‌ی back گوشی
 ├── state/                داده‌ی مشترک (پروفایل، نقشه) و گفتگوی دستیار
-├── screens/              یک فایل برای هر صفحه: HomeScreen، QuizScreen، AskScreen، FamilyScreen، …
+├── screens/              یک فایل برای هر صفحه: HomeScreen، QuizScreen، AskScreen، ReportScreen، …
 ├── components/           اجزای مشترک: مسیرِ جزیره‌ها، برگه‌ی پایین، نوارِ پایین
 ├── mascots/              سیگما، دلتا، پی، تدی — SVG از کد، ۶ حالتِ چهره
 ├── diagram/              JSONِ شکلِ دستیار → SVG؛ مختصات، ریشه، زاویه این‌جا حساب می‌شود
@@ -330,14 +329,17 @@ with transaction.atomic():
 >
 > آزموده‌نشده زرین‌پال درخواستِ پرداخت را با کدِ ۱۰۰ می‌پذیرد، ولی یک پرداختِ واقعی تا انتها هنوز انجام نشده.
 
-### ۶-۵ والد
+### ۶-۵ گزارشِ والدین
+
+والد حسابِ جدا و کدِ دعوت ندارد (تا مهرِ ۱۴۰۵ داشت؛ به تصمیمِ پس از ارائه حذف شد). صفحه‌ی «گزارشِ والدین» در پروفایلِ خودِ دانش‌آموز است.
 
 | # | درخواست | چه می‌شود |
 |---|---|---|
-| ۱ | `POST /api/family/link/invite` | والد یک کدِ اتصال می‌گیرد (سقف ۵ در ساعت). |
-| ۲ | `POST /api/family/link/accept` | فرزند کد را در اپِ خودش وارد می‌کند؛ `FamilyLink` «accepted» می‌شود. یک والد می‌تواند چند فرزند داشته باشد. |
-| ۳ | `GET /api/family/weekly-report` | امتیاز، درس، جزیره و زنجیره‌ی فرزند از شنبه. |
-| ۴ | `GET /api/progress/nodes?userId=` | فقط وقتی مجاز است که اتصالِ تأییدشده وجود داشته باشد؛ وگرنه ۴۰۳. (نمونه‌ی جلوگیری از دیدنِ داده‌ی دیگران.) |
+| ۱ | `GET /api/user/weekly-report` | برای هر یک از ۷ روزِ اخیر و ۷ روزِ قبلش: زمانِ تمرین، سوالِ حل‌شده و درست، امتیاز، درس و جزیره‌ی تمام‌شده، سوال از دستیار. فقط دیتای خودِ صاحبِ توکن. |
+| ۲ | — | فرانت جمله‌ی مقایسه («آفرین! این هفته ۲۰ دقیقه بیشتر…») و دو نمودار می‌سازد: زمانِ هر روز در برابرِ همان روزِ هفته‌ی پیش، و سوال‌های درست/نادرستِ هر روز. |
+| ۳ | `GET /api/progress/nodes?userId=` | فقط شناسه‌ی خودِ کاربر پذیرفته است؛ هر شناسه‌ی دیگری ۴۰۳. |
+
+> **تخمینی:** «زمانِ تمرین» اندازه‌گیری نیست: از فاصله‌ی جواب‌ها و پرسش‌ها حساب می‌شود (فاصله‌ی بیش از ۱۰ دقیقه وقفه است). خواندنِ درس بدونِ جواب دادن در آن نیست، پس عدد معمولاً از زمانِ واقعی کمتر است.
 
 ## ۷. مدلِ داده
 
@@ -399,9 +401,7 @@ with transaction.atomic():
 - `BugReport`
 - `Notification user_id, title, body, is_read`
 
-**family · campaigns · statuslog**
-- `FamilyLink parent_user_id, child_user_id, status`
-- `ParentalSettings, WeeklyReportLog`
+**campaigns · statuslog**
 - `MessageCampaign, CampaignDelivery یکتا: کمپین × کاربر × کانال`
 - `StatusChangeLog label, object_id, old_status → new_status`
 
@@ -479,6 +479,7 @@ with transaction.atomic():
 | GET | `/api/subscription/status` | ورود | وضعیتِ اشتراک (و بازسنجیِ پرداختِ جاافتاده) |
 | POST | `/api/payment/orders` | ورود | ساختِ سفارش |
 | GET | `/api/payment/orders/{id}` | ورود | وضعیتِ سفارش |
+| GET | `/api/payment/invoices` | ورود | پرداخت‌ها و فاکتورهای کاربر (شماره‌ی فاکتور، تخفیف، کدِ پیگیری) |
 | GET | `/api/payment/orders/{id}/pay` | عمومی | رفتن به درگاهِ زرین‌پال |
 | GET | `/api/payment/zarinpal/callback` | عمومی | برگشت از درگاه + تأییدِ سرور-به-سرور |
 | POST | `/api/payment/bazaar/verify` | ورود | تأییدِ خریدِ کافه‌بازار |
@@ -492,7 +493,7 @@ with transaction.atomic():
 | GET · POST | `/api/support/tickets` | ورود | تیکت‌های من / تیکتِ تازه |
 | GET · POST | `/api/support/tickets/{id}` · `/messages` | ورود | جزئیات و پیامِ تازه |
 | POST | `/api/support/bug-reports` | ورود | گزارشِ باگ |
-| GET · POST · PATCH | `/api/family/link` · `/invite` · `/accept` · `/settings` · `/weekly-report` | ورود | اتصالِ والد، تنظیمات، گزارشِ هفتگی |
+| GET | `/api/user/weekly-report` | ورود | «گزارشِ والدین»: ۷ روزِ اخیر در کنارِ ۷ روزِ قبلش |
 | **سیستم** |  |  |  |
 | GET | `/api/health` | عمومی | سلامتِ سرویس (بخشِ ۱۳) |