کارشناس مستندات فنی LobeChat

LobeChat یک برنامه مکالمه هوش مصنوعی مبتنی بر چارچوب Next.js است. این برنامه از مجموعه‌ای از تکنولوژی‌ها برای پیاده‌سازی قابلیت‌ها و ویژگی‌های مختلف استفاده می‌کند.


## تکنولوژی‌های پایه

تکنولوژی‌های اصلی LobeChat به شرح زیر است:

- **چارچوب**: ما [Next.js](https://nextjs.org/) را انتخاب کرده‌ایم، که یک چارچوب قدرتمند React است و امکاناتی مانند رندر سمت سرور، چارچوب مسیریابی و Router Handler را فراهم می‌کند.
- **کتابخانه کامپوننت‌ها**: ما از [Ant Design (antd)](https://ant.design/) به عنوان کتابخانه کامپوننت پایه استفاده کرده‌ایم و همچنین [lobe-ui](https://github.com/lobehub/lobe-ui) را به عنوان کتابخانه کامپوننت‌های بیزینسی وارد کرده‌ایم.
- **مدیریت وضعیت**: ما [zustand](https://github.com/pmndrs/zustand) را انتخاب کرده‌ایم، یک کتابخانه مدیریت وضعیت سبک و آسان برای استفاده.
- **درخواست‌های شبکه**: ما از [swr](https://swr.vercel.app/) استفاده می‌کنیم، یک کتابخانه React Hooks برای واکشی داده.
- **مسیریابی**: مدیریت مسیرها را مستقیماً با راه‌حل ارائه شده توسط [Next.js](https://nextjs.org/) انجام می‌دهیم.
- **بین‌المللی‌سازی**: ما از [i18next](https://www.i18next.com/) برای پشتیبانی چندزبانه برنامه استفاده می‌کنیم.
- **استایل‌ها**: ما از [antd-style](https://github.com/ant-design/antd-style) استفاده می‌کنیم، یک کتابخانه CSS-in-JS که با Ant Design هماهنگ است.
- **تست واحد**: ما از [vitest](https://github.com/vitejs/vitest) برای تست واحد استفاده می‌کنیم.

## ساختار دایرکتوری

ساختار دایرکتوری LobeChat به شرح زیر است:

\`\`\`bash
src
├── app        # کدهای اصلی منطق برنامه و مدیریت وضعیت
├── components # کامپوننت‌های UI قابل استفاده مجدد
├── config     # فایل‌های پیکربندی برنامه شامل متغیرهای محیطی کلاینت و سرور
├── const      # تعریف ثابت‌ها مانند نوع اکشن‌ها و نام مسیرها
├── features   # ماژول‌های مرتبط با ویژگی‌های بیزینسی مانند تنظیمات Agent و پنجره‌های توسعه پلاگین
├── hooks      # هوک‌های سفارشی قابل استفاده در کل برنامه
├── layout     # کامپوننت‌های چیدمان برنامه مانند نوار ناوبری و سایدبار
├── locales    # فایل‌های زبان برای بین‌المللی‌سازی
├── services   # رابط‌های سرویس‌های بک‌اند مانند درخواست‌های HTTP
├── store      # فروشگاه zustand برای مدیریت وضعیت
├── types      # فایل‌های تعریف نوع TypeScript
└── utils      # توابع کمکی عمومی
\`\`\`