پرش به محتوای اصلی
Uzap
معرفی پروژه udo

UDo | سامانه مدیریت وظایف

سامانه مدیریت کار فارسی‌محور و کاملاً راست‌به‌چپ با Django، Channels و Tailwind CSS؛ کارها با دسته‌بندی، اولویت و سررسید شمسی، یادآور قابل‌تنظیم، به‌روزرسانی بلادرنگ روی WebSocket و مرکز اعلان دائمی.

UDo | سامانه مدیریت وظایف

یودو (UDo) یک سامانه مدیریت کار فارسی‌محور و راست‌به‌چپ است که با Django 5.2، Django Channels 4، Tailwind CSS 3.4 و جاوااسکریپت خالص — بدون هیچ فریم‌ورک فرانت‌اند — از پایه توسعه یافته است. تمام رابط کاربری، از صفحات خطا تا تقویم، فارسی و راست‌به‌چپ است؛ حالت تیره دارد، با فونت دانا حروف‌چینی می‌شود و اسکریپت راه‌انداز پوسته با nonce مخصوص همان درخواست اجرا می‌شود تا ترجیح ذخیره‌شدهٔ حالت تیره هرگز با «فلش روشنایی» همراه نباشد.

دامنهٔ کار حول «سازنده» و «مسئول» اختیاری طراحی شده است: هر کار عنوان، توضیحات، دسته، وضعیت (انجام‌نشده، در حال انجام، انجام‌شده، لغوشده)، اولویت (کم، عادی، زیاد، فوری)، سررسید و زمان انجام دارد و دسته‌ها شخصی و قابل استفادهٔ دوباره‌اند — نام هر دسته برای هر کاربر یکتاست. مجوزها در سمت سرور اعمال می‌شود: سازنده کار را ویرایش و حذف می‌کند، مسئول می‌تواند آن را کامل کند و ببیند و ابرکاربر به همه چیز دسترسی دارد؛ فهرست کارها هم دقیقاً با همین قواعد فیلتر می‌شود تا دسترسی فهرست و دسترسی مستقیم به هر کار همیشه یکسان بماند.

فهرست کارها جست‌وجو و فیلتر بر اساس وضعیت، اولویت، دسته و سررسید (گذشته، امروز، این هفته، بدون سررسید) را دارد و بر اساس سررسید، تازه‌ترین، اولویت یا عنوان مرتب می‌شود. برچسب همهٔ گزینه‌های فیلتر از سمت سرور در پاسخ JSON می‌آید تا دسته‌های جدید — حتی وقتی از کانال بلادرنگ می‌رسند — بی‌درنگ و همیشه هماهنگ در منوها ظاهر شوند.

برای هر کار می‌توان «زمان اطلاع» تعیین کرد: چند روز، ساعت یا دقیقه پیش از سررسید. زمان یادآور همیشه در لحظه از «سررسید منهای فاصلهٔ انتخابی» محاسبه می‌شود، پس ویرایش سررسید یا فاصله، یادآور را به‌طور خودکار دوباره فعال می‌کند. ارسال یادآورها یکتا (idempotent) است: هر کار پیش از ارسال با یک به‌روزرسانی اتمیک تصاحب می‌شود تا اجراهای همزمان هرگز یادآور تکراری نسازند؛ موتور یادآور هم به‌صورت رشتهٔ پس‌زمینه هر ۶۰ ثانیه اجرا می‌شود و هم به‌صورت فرمان مدیریتی برای زمان‌بندی با cron آماده است.

زیرساخت تقویم جلالی در یک ماژول واحد جمع شده است: تبدیل دوجهتهٔ میلادی–جلالی، تجزیهٔ ورودی کاربر (مثل «۱۴۰۴/۰۸/۰۹ ۱۶:۳۰»)، قالب‌بندی نمایش («۹ آبان ۱۴۰۴، ساعت ۱۶:۳۰»)، زمان‌های نسبی («۳ دقیقه پیش») و ارقام فارسی. سیاست زمانی صریح است: ورودی همیشه به وقت تهران تفسیر و در UTC ذخیره می‌شود و برای ماشین با ISO و برای انسان با تقویم شمسی نمایش داده می‌شود. فیلدهای فرم جلالی، فیلترهای قالب و انتخابگر تاریخ/زمان قابل استفادهٔ دوباره همگی روی همین هسته سوارند.

قلب بلادرنگ روی WebSocket بنا شده است: هر کاربر تأییدشده دو کانال شخصی user.<id>.tasks و user.<id>.notifications دارد و رویدادهای ساخت، به‌روزرسانی و حذف کار و اعلان‌های جدید را در همان لحظه دریافت می‌کند؛ اتصال WebSocket هم از همان گیت تأیید حساب می‌گذرد و اتصال کاربران تأییدنشده بسته می‌شود. کلاینت‌ها با عقب‌نشینی نمایی دوباره وصل می‌شوند و اگر شبکه اجازه ندهد، خودکار به polling به‌عنوان جایگزین روی می‌آورند تا داده‌ها هرگز کهنه نمانند.

اعلان‌ها هم دائمی‌اند و هم عملیاتی: هر اعلان با نوع، عنوان، متن و پیوند در پایگاه داده ذخیره می‌شود و زنگولهٔ درون‌برنامه‌ای شمار خوانده‌نشده‌ها را زنده نگه می‌دارد. دکمه‌های عملیاتی از یک رجیستری کنترل‌شده می‌آیند — «انجام دادم»، «بررسی کردم» و «مشاهده جزئیات» — و دادهٔ عملیات آن‌ها JSON غیرشفاف است و هرگز به‌عنوان کد اجرا نمی‌شود؛ ثبت هر عملیات هم جلوی اجرای دوبارهٔ آن را می‌گیرد. اعلان‌های مرورگری فقط با ژست کاربر مجوز می‌گیرند و نتیجهٔ هر عمل — حتی خطا — با یک toast فارسی اعلام می‌شود؛ شکست بی‌صدا ممنوع است.

احراز هویت پشت گردش‌کار تأیید مدیر کار می‌کند: ثبت‌نام، حسابی فعال اما تأییدنشده می‌سازد و تا تأیید مدیر — با ثبت تأییدکننده و زمان آن و ارسال ایمیل خبر — ورود ممکن نیست؛ ابرکاربرها همیشه تأییدشده‌اند و اگر تأیید کاربری پس از ورود لغو شود، نشست او در همان درخواست بعدی بسته می‌شود. همهٔ مسیرهای حساس با محدودیت نرخ جداگانه مهار می‌شوند (ورود، ثبت‌نام و بازیابی رمز عبور) و محافظت از مسیرها به‌صورت پیش‌فرض روی کل فهرست urlpatterns اعمال می‌شود تا «فراموش‌کردن محافظت از یک نما» عملاً ناممکن باشد.

لایهٔ امنیتی چندوجهی است: پنل مدیریت فقط در اختیار ابرکاربرهاست و هر آدرس آن — حتی صفحهٔ ورود — به بقیه ۴۰۴ برمی‌گرداند تا اصلاً آشکار نشود و مسیر نصب پنل هم از متغیر محیطی قابل تغییر است. هدر CSP با nonce هر درخواست روی همهٔ پاسخ‌ها نشسته، صفحات خطا (۴۰۰، ۴۰۳، ۴۰۴، ۵۰۰ و خطای CSRF) همگی فارسی و راست‌به‌چپند و پاسخ‌های POST همیشه پاکت JSON استاندارد موفقیت/خطا دارند که اعتبارسنجی مرجع، سمت سرور است.

فرانت‌اند فقط Tailwind CSS و جاوااسکریپت خالص است: باندل‌ها با esbuild به تکه‌های جداگانه برای هر صفحه شکسته و کوچک‌سازی می‌شوند و کل مجموعهٔ کامپوننت رابط — از مودال و کشو تا toast و اسکلتون — بدون هیچ کتابخانهٔ شخص ثالث ساخته شده است. زیرساخت اجرایی هم برای عملیات آماده است: نقطهٔ ورود ASGI در یک فرایند واحد HTTP و WebSocket را سرو می‌کند، لایهٔ کانال و کش روی Redis قرار می‌گیرد تا نشست‌ها و محدودیت‌های نرخ بین فرایندها مشترک بمانند، PostgreSQL در عملیات (و SQLite در توسعه) استفاده می‌شود، فایل‌های ایستا با WhiteNoise تحویل داده می‌شوند و SSL و HSTS اجباری‌اند. همهٔ فازهای پیاده‌سازی — از احراز هویت و دامنهٔ کار تا تقویم شمسی، بلادرنگ و اعلان‌ها — کامل و سرتاسر شده‌اند.

فناوری‌ها
Python Django Tailwind CSS WebSocket

تیم پروژه

تصویر سهیل محمدی

سهیل محمدی

بنیان‌گذار