README.fa.md

تسک‌باکس (Task Box)

🇬🇧 English | 🇮🇷 فارسی

یک سامانهٔ سبک و خودمیزبان (self‑hosted) برای مدیریت آموزشگاه‌ها، معلمان و آموزشگاه‌های کوچک.

تسک‌باکس یک وب‌اپلیکیشن سریع و موبایل‌پسند است که به معلمان و آموزشگاه‌های کوچک کمک می‌کند کارهای روزمره — کلاس‌ها، دانش‌آموزان، آزمون‌ها، تکالیف، نمرات، اطلاعیه‌ها و گزارش‌های قابل چاپ — را از یک جا مدیریت کنند. این برنامه به‌صورت PWA با رابط کاملاً راست‌به‌چپ (RTL) و تقویم شمسی ارائه می‌شود.

• دموی زنده: https://clonerr.ir
• مخزن کد: https://github.com/Shayan-alinezhad/taskbox

ℹ️ دربارهٔ این مخزن. این یک مخزن عمومی برای معرفی محصول است. هدف آن مستندسازی محصول، معماری و رویکردهای امنیتی است. کد منبع بک‌اند نسخهٔ پروداکشن به عمد در اینجا منتشر نشده است.

---

معرفی پروژه

تسک‌باکس برای آموزشگاه‌های کوچک و معلمان مستقل طراحی شده که به جای درگیری با فایل‌های اکسل، گروه‌های پیام‌رسان و کاغذ، یک ابزار یکپارچه و ساده در اختیار آن‌ها قرار می‌دهد.

هدف پروژه

فراهم کردن یک سامانهٔ مدیریت آموزشی سبک، کم‌هزینه و بومی‌شده برای زبان فارسی که روی زیرساخت Serverless اجرا می‌شود و روی موبایل عالی کار می‌کند.

امکانات

• مدیریت کلاس، دانش‌آموز، آزمون، تکلیف و نمره
• اطلاعیه‌ها و صفحات محتوایی ساده
• آپلود تصویر با اعتبارسنجی نوع فایل و محدودیت نرخ
• کارنامه و گزارش‌های قابل چاپ
• شخصی‌سازی ظاهر (نام سایت، بنر، رنگ‌ها، منوها، اسلایدر)
• دسترسی مبتنی بر نقش (مدیر سایت در برابر کاربر عادی)
• قابلیت نصب به‌عنوان PWA با پوستهٔ آفلاین

فهرست کامل در FEATURES.md.

تکنولوژی‌ها

لایه	فناوری
اجرا	Cloudflare Workers (لبه، بدون سرور)
پایگاه داده	Cloudflare D1 (SQLite)
ذخیرهٔ فایل	ذخیره‌ساز شیءی قابل تعویض (مبتنی بر بات)
فرانت‌اند	جاوااسکریپت خالص (SPA) + PWA
بومی‌سازی	رابط فارسی (RTL) و تقویم شمسی

معماری کلی

سامانه در چند لایهٔ مشخص سازماندهی شده است: اپلیکیشن سمت کاربر (PWA)، لایهٔ API بدون وضعیت، لایهٔ داده، لایهٔ ذخیرهٔ فایل و لایهٔ امنیت. جزئیات در ARCHITECTURE.md.

نحوهٔ استفاده

1. نصب ابزار خط فرمان Cloudflare (wrangler).
2. ساخت پایگاه دادهٔ D1 و اتصال آن با نام DB.
3. کپی کردن .env.example و وارد کردن مقادیر خودتان.
4. استقرار با wrangler deploy.

راهنمای کامل در DEPLOYMENT.md.

امنیت

رویکردهای امنیتی در SECURITY.md و خلاصهٔ بهبودها در PATCHES.md مستند شده‌اند. لطفاً آسیب‌پذیری‌ها را به‌صورت مسئولانه گزارش کنید.

مشارکت

از مشارکت در مستندات و دارایی‌های عمومی استقبال می‌کنیم — CONTRIBUTING.md.

مجوز

تحت مجوز MIT منتشر شده است. فایل LICENSE.