#DocuFlow AI 📄✨

وب افزار DocuFlow AI یک ویرایشگر و مبدل هوشمند اسناد متنی Markdown به فایل‌های استاندارد Word (.doc) و PDF با طراحی حرفه‌ای، پشتیبانی کامل از زبان‌های راست‌چین (فارسی، عربی)، فرمول‌های ریاضی KaTeX، پنل مدیریت تلگرامی و اتصال به هوش مصنوعی است.

ساخته شده توسط Dr. Hafez Raei | HafezRaei.ir | HamiCourse.ir
Developed by Dr. Hafez Raei | HafezRaei.ir | HamiCourse.ir

#🌐 دموی آنلاین (Live Demo)

کاربران گرامی می‌توانند نسخه زنده و دموی آنلاین نرم‌افزار را از طریق پیوند زیر مشاهده و بررسی فرمایند:
👉 https://md.hamicourse.ir

#✨ ویژگی‌های کلیدی (Features)

• 📝 پیش‌نمایش زنده مارک‌داون (Live Preview): مشاهده آنی تغییرات متن و جدول‌ها به صورت صفحه سند A4.
• 🎨 ۴ قالب طراحی متنوع: انتخاب بین استایل‌های Modern، Academic، Creative و Minimal.
• 🇮🇷 پشتیبانی کامل از زبان فارسی و متون راست‌چین (RTL): فونت‌های استاندارد فارسی (وزیرمتن، نازنین، یکان) با تشخیص هوشمند جهت متن.
• 📐 رندر فرمول‌های ریاضی (KaTeX / LaTeX): نمایش دقیق عبارات ریاضی در حالت LTR حتی درون متون راست‌چین.
• 💾 خروجی مستقیم به فرمت‌های Word و PDF: دریافت فایل بدون به‌هم‌ریختگی جدول‌ها و استایل‌ها.
• 🔐 گیت‌کیپر ورود کاربر (Auth Gatekeeper): ورود سریع با ایمیل و موبایل با نگهداری امن سشن در SQLite.
• 🤖 پنل مدیریت تلگرامی (Telegram Admin Bot): تغییر لحظه‌ای متن‌های نوار متحرک، دریافت آمار زنده و ارسال روزانه خروجی اکسل (CSV) کاربران.
• 🐳 آماده اجرا در کانتینر (Docker & Docker Compose): بیلد چندمرحله‌ای بهینه برای سرور و لینوکس.

#🛠 پشته فنی (Tech Stack)

• Frontend: React 19, TypeScript, Vite, Tailwind CSS, Lucide Icons
• Markdown & Math: react-markdown, remark-gfm, remark-breaks, remark-math, rehype-katex
• Backend: Node.js (ESM), Express 5, SQLite3
• DevOps: Docker (Multi-stage), Caddy, Docker Compose

#🚀 راهنمای نصب و راه‌اندازی محلی (Getting Started)

#پیش‌نیازها

• Node.js نسخه ۲۰ یا بالاتر
• npm یا pnpm

#۱. کلون کردن مخزن

git clone https://github.com/hafez-raei/docuflow-ai.git
cd docuflow-ai

#۲. نصب وابستگی‌ها

npm install

#۳. تنظیم متغیرهای محیطی

یک فایل .env بر اساس نمونه موجود ایجاد کنید:

cp .env.example .env

مقادیر مربوطه (کلید هوش مصنوعی، توکن تلگرام و ...) را در صورت نیاز درون فایل وارد نمایید.

#۴. اجرای برنامه

npm run dev

برنامه در آدرس http://localhost:3000 آماده به کار خواهد بود.

#🐳 راه‌اندازی با داکر (Docker Deployment)

برای بیلد و اجرای مستقیم پروژه با داکر:

docker compose up -d --build

#⚙️ متغیرهای محیطی (Environment Variables)

#👨‍💻 سازنده و صاحب امتیاز (Creator & Rights)

این پروژه با افتخار توسعه داده شده است توسط:
Dr. Hafez Raei

• 🌐 وب‌سایت شخصی: HafezRaei.ir
• 🎓 آکادمی آموزشی: HamiCourse.ir

تمامی حقوق برای Dr. Hafez Raei | HafezRaei.ir | HamiCourse.ir محفوظ است.