کارشناس مستندات فنی 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   # ماژول‌های عملکردی مرتبط با کسب و کار، مانند تنظیمات عامل و پنجره توسعه افزونه
├── hooks      # هوک‌های سفارشی قابل استفاده مجدد در کل برنامه
├── layout     # کامپوننت‌های طراحی برنامه، مانند نوار ناوبری و نوار کناری
├── locales    # فایل‌های زبان بین‌المللی‌سازی
├── services   # رابط‌های خدمات پشتیبان بسته‌بندی شده، مانند درخواست‌های HTTP
├── store      # فروشگاه zustand برای مدیریت وضعیت
├── types      # فایل‌های تعریف نوع TypeScript
└── utils      # توابع ابزار عمومی
\`\`\`