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

UChat | پلتفرم گفت‌وگوی آنلاین

پلتفرم گفتگوی چندکسب‌وکاری بر پایه Django، Channels و Tailwind CSS؛ هر کسب‌وکار ثبت‌نام می‌کند، پشتیبان اضافه می‌کند و با مشتریان خود به‌صورت بلادرنگ گفتگو می‌کند.

UChat | پلتفرم گفت‌وگوی آنلاین

یوچت (UChat) یک پلتفرم گفتگوی بلادرنگ و چندکسب‌وکاری است که با Django، Django Channels و Tailwind CSS از پایه توسعه یافته است. هر کسب‌وکار می‌تواند روی این پلتفرم ثبت‌نام کند، پشتیبان (agent) اضافه کند و با مشتریان خود به‌صورت real-time گفتگو کند؛ رابط کاربری کاملاً فارسی و راست‌به‌چپ است، حالت تیره دارد و با فونت دانا در موبایل و دسکتاپ یکسان روان اجرا می‌شود.

معماری پلتفرم چندکسب‌وکاری (multi-tenant) است: هر «کسب‌وکار» یک tenant مستقل با نام، لوگو، رنگ برند و اطلاعات تماس خودش است و کاربران در سه نقش مالک (owner)، پشتیبان (agent) و مشتری (customer) سازمان‌دهی می‌شوند. مالک، پشتیبان‌ها را اضافه می‌کند و هر پشتیبان می‌تواند گفتگوی اختصاصی خودش را با هر مشتری داشته باشد؛ اتاق گفتگو برای هر سه‌گانه «کسب‌وکار، مشتری و پشتیبان» یکتاست، پس تاریخچه گفتگوها بین پاسخ‌دهندگان مختلف در هم نمی‌ریزد. مسدودسازی و حذف اتاق نیز به‌عنوان اقدام‌های مدیریت، فقط در اختیار تیم کسب‌وکار است.

قلب بلادرنگ پلتفرم روی WebSocket بنا شده است: اتصال ws/chat/<room_id>/ اتاق گفتگو را زنده نگه می‌دارد و ws/business/inbox/ صندوق ورودی کسب‌وکار را به‌صورت لحظه‌ای به‌روز می‌کند. نشانگر «در حال تایپ»، رویدادهای فعالیت مانند «در حال ضبط ویس» و «در حال انتخاب فایل»، وضعیت آنلاین و آفلاین، شمارش پیام‌های خوانده‌نشده هر اتاق و به‌روزرسانی زنده صندوق ورودی همه از همین مسیر و با لایه کانال Redis منتقل می‌شوند؛ حضور کاربران با احتساب دیده‌شدن تب مرورگر و با TTL و heartbeat روی Redis نگه‌داری می‌شود.

پیام‌ها از چهار نوع متن، تصویر، ویس و فایل پشتیبانی می‌کنند و برای هرکدام پاسخ (reply) با پیش‌نمایش پیام مرجع، ویرایش، حذف و کپی در دسترس است. زمان‌های ارسال و تاریخ‌ها در سراسر پلتفرم با تقویم شمسی (جلالی) نمایش داده می‌شوند و وضعیت خوانده‌شدن برای هر دو سمت هر گفتگو ثبت می‌شود.

قواعد پیوست‌ها سمت سرور اعمال می‌شود: تصاویر تا ۵ مگابایت با فرمت‌های استاندارد وب، پیام‌های صوتی تا ۲ دقیقه با بررسی واقعی مدت فایل، و پیوست‌های عمومی تا ۲۰ مگابایت. فایل‌های پیوست در فضای ذخیره‌سازی خصوصی نگه‌داری می‌شوند، کلید ذخیره‌سازی آن‌ها UUID تصادفی است و نه نام فایل کاربر، و دانلود فقط از طریق نقطه‌پایانی اختصاصی ممکن است که مجوز دسترسی به اتاق را در هر درخواست دوباره بررسی می‌کند؛ محافظت‌های ضد بمب فشرده نیز برای فایل‌های ZIP لحاظ شده است.

احراز هویت در سه حالت قابل تنظیم است: نام کاربری با رمز عبور، شماره موبایل با کد یک‌بارمصرف پیامکی (OTP) و شماره موبایل با رمز عبور. شماره‌های موبایل ایران به قالب استاندارد نرمال‌سازی می‌شوند، کد شش‌رقمی OTP مهلت اعتبار، فاصله ارسال مجدد و سقف تلاش دارد و لایه‌های محدودیت نرخ (rate limit) جداگانه، ورود، ثبت‌نام و بررسی شماره را برای هر IP و هر حساب مهار می‌کند. دستگاه‌های مورد اعتماد، الزام تغییر رمز برای حساب‌های خودکار ساخته‌شده و اعتبارسنجی و برش تصویر پروفایل در سمت سرور نیز بخشی از همین لایه‌اند.

مدل تجاری پلتفرم بر پلن‌های اشتراک استوار است: هر پلن قیمت به تومان، مدت اعتبار، سقف تعداد پشتیبان و سهمیه پیام ماهانه خود را تعریف می‌کند و کسب‌وکار پس از خرید، با یک کد ثبت‌نام یک‌بارمصرف (با قالب UCHAT-XXXX-XXXX) که به شماره خریدار گره خورده و تاریخ انقضا دارد فعال می‌شود. همه تصمیم‌های دسترسی تجاری — اعتبار پلن، سقف پشتیبان و سهمیه پیام — در یک ماژول سیاست متمرکز گرفته می‌شوند تا دقیق اعمال شوند و هرگز کنترل‌های امنیتی و فنی را دور نزنند.

هر کسب‌وکار یک توکن عمومی و در نتیجه یک «آدرس چت شناور» (embed URL) می‌گیرد که می‌تواند آن را در وب‌سایت خود قرار دهد. صفحه فرودِ همین آدرس، پشتیبان‌های فعال کسب‌وکار را همراه وضعیت حضور زنده‌شان فهرست می‌کند و مشتری می‌تواند گفتگو را با پشتیبان دلخواه یا به‌صورت عمومی آغاز کند؛ رنگ اصلی برند هر کسب‌وکار نیز در همان رابط اعمال می‌شود.

حریم خصوصی در دو لایه طراحی شده است. بازدیدکننده می‌تواند بدون ثبت‌نام کامل گفتگو را آغاز کند: در مسیر مهمانِ حفظ حریم خصوصی، شروع گفتگو فقط با نام و نام خانوادگی ممکن است، حساب مهمان موقتی است (به‌طور پیش‌فرض ۷ روز) و پس از پایان مهلت همراه داده‌های مرتبطش به‌صورت خودکار حذف می‌شود، در حالی که یک اعلان یادآور او را به تکمیل ثبت‌نام و حفظ تاریخچه گفتگو دعوت می‌کند. در سمت تیم، «حالت شبح» حضور مالک را از دید مشتری پنهان می‌کند و «حالت سکوت» و بی‌صدا کردن هر اتاق، اعلان‌ها را دقیق کنترل می‌کنند.

اعلان‌ها هم درون‌برنامه‌ای هستند و هم وب‌پوش: مرکز اعلان، اعلان‌های هر گفتگو را در یک کارت گروه‌بندی می‌کند و سطوح شدت و لینک مقصد را نگه می‌دارد؛ اشتراک‌های Web Push مرورگر با کلیدهای VAPID مدیریت می‌شوند تا اعلان‌ها حتی وقتی مرورگر بسته است برسند. ساخت اعلان‌ها یکتا (idempotent) است تا رویدادهای تکراری، اعلان تکراری نسازند.

زیرساخت اجرایی برای محیط عملیاتی آماده است: سرو کردن ASGI با Daphne، لایه کانال و کش روی Redis، PostgreSQL در عملیات (و SQLite با تسهیل همزمانی در توسعه)، تحویل فایل‌های ایستا با WhiteNoise، اعتبارسنجی Origin همه اتصال‌های WebSocket برای جلوگیری از ربایش Cross-Site WebSocket، هدرهای امنیتی و HSTS و کوکی‌های ایزوله برای استقرار روی زیرمسیر.

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

تیم پروژه

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

سهیل محمدی

بنیان‌گذار