1. برنامه IntelliJ IDE را باز کنید.
   از منوی باز شده، روی Create New Project کلیک کنید.

   

   یا از طریق File > New > Project یک پروژه جدید ایجاد کنید.
2. از میان گزینه‌های ساخت پروژه جدید، appsan را انتخاب کرده و روی Next کلیک کنید.

   

3. برای پروژه جدید، نام مناسب انتخاب کرده و روی Finish کلیک کنید.

   

4. پروژه‌ای مشابه ساختار زیر ساخته خواهد شد:

   

از منو فایل، Settings را انتخاب کنید:

در پنجره باز شده، به Languages & Frameworks > Appsan مراجعه کرده و آدرس پوشه SDK دانلود شده را در قسمت Path to SDK وارد نمایید:

برای اجرای مینی‌اپ، در قسمت Run Config در بالا سمت راست IntelliJ روی Add Configuration یا Edit Configuration کلیک کنید. در پنجره باز شده، روی + زده و Appsan را انتخاب نمایید.

سپس نام موردنظر برای اجرا و فایل اجرایی را انتخاب کنید. Run type را روی Web قرار دهید.

پس از اجرای پروژه، آدرس وب نمایش داده شده در کنسول را کپی کرده و در مرورگر باز کنید.

برای ارتباط با دستگاه‌های اندرویدی، Android Platform Tools را دانلود کرده و پوشه platform-tools را در مسیر libs/bin/ جایگزین نمایید.

۵) خطاهای احتمالی

در این قسمت به احتمال زیاد با این خطای رایج مواجه می‌شوید: Project has no JDK configuration

برای رفع این مشکل، در پنجره تنظیمات بخش Project باید نسخه SDK را انتخاب کنید. نسخه Java 11 یا بالاتر را برگزینید و در صورت عدم وجود، روی Add کلیک کنید تا به‌صورت خودکار دانلود شود.

اپسان برخی از رخدادها و خطاها را به صورت log نمایش می‌دهد. یکی از این موارد، درخواست‌های وب است که متن ارسالی و پاسخ دریافتی آن داخل لاگ قابل مشاهده است.

دسترسی به لاگ‌ها از طریق CLI

برای دسترسی به لاگ‌ها، دستور زیر را اجرا کنید (به جای <device-id>، شناسه دستگاه خود را قرار دهید):

java -jar libs/Appsan-CLI-1.0-SNAPSHOT.jar logs -d <device-id>

برای به‌دست آوردن شناسه دستگاه اندرویدی خود، ابتدا این دستور را اجرا کنید:

java -jar libs/Appsan-CLI-1.0-SNAPSHOT.jar devices

پس از اجرای دستور logs، می‌توانید لاگ‌ها را در آدرس http://localhost:12982/logs/ در مرورگر دلخواه خود مشاهده کنید:

دسترسی به لاگ‌ها در IntelliJ IDEA

برای تنظیم اجرای لاگ‌ها در IntelliJ، از منوی اجرا Edit Configurations را باز کنید:

روی دکمه + کلیک کرده و JAR Application را انتخاب کنید:

در قسمت Name نام موردنظر را وارد کنید و در Path to JAR مسیر فایل Appsan-CLI-1.0-SNAPSHOT.jar را انتخاب نمایید. سپس در بخش Program arguments دستور زیر را وارد کنید:

logs -d <device-serial>

که <device-serial> همان شناسه دستگاه است که پیش‌تر از CLI دریافت کردید.

حالا با اجرای پیکربندی logs در IntelliJ، لاگ‌ها در مرورگر نمایش داده می‌شوند.

در این راهنما، نحوه افزودن یک پروژه وب به پروژه Appsan به صورت گام‌به‌گام توضیح داده می‌شود. با استفاده از این راهنما، شما می‌توانید پروژه‌های وب خود را به‌طور مؤثری درون Appsan ادغام کرده و از قابلیت‌های جدید عنصر web-page بهره‌مند شوید.

۱. ایجاد پوشه‌های مورد نیاز

1. ایجاد پوشه web:
   • در مسیر اصلی پروژه Appsan، پوشه‌ای به نام web ایجاد کنید.
   • این پوشه حاوی کد منبع پروژه‌های وب شما خواهد بود.
2. ایجاد پوشه webdist:
   • در کنار پوشه web، پوشه‌ای به نام webdist ایجاد کنید.
   • این پوشه فایل‌های ساخته‌شده (build) پروژه‌های وب شما را نگهداری می‌کند.

۲. اضافه کردن پروژه وب به پوشه web

1. ایجاد پوشه برای پروژه وب:
   • درون پوشه web، پوشه‌ای به نام پروژه وب خود بسازید (مثلاً MyWebProject).
2. افزودن کد منبع:
   • تمام فایل‌های HTML، CSS، JavaScript و سایر فایل‌های پروژه وب را در این پوشه کپی کنید.

۳. ساخت پروژه وب

1. ساخت پروژه:
   • با ابزار ساخت مناسب (مثل Webpack یا Parcel) پروژه وب خود را بسازید.
   • خروجی (build) شامل فایل‌های HTML، CSS و JavaScript بهینه شده خواهد بود.
2. کپی خروجی به webdist:
   • پس از ساخت، فایل‌های خروجی را در پوشه‌ای با همان نام پروژه در webdist قرار دهید.
   • مثلاً webdist/MyWebProject.

۴. استفاده از عنصر webpage در پروژه Appsan

1. افزودن عنصر webpage به فایل XML:
   • در فایل XML پروژه Appsan خود، تگ زیر را اضافه کنید:

   <webpage src="MyWebProject" title="پروژه وب من"/>

2. تست و اشکال‌زدایی:
   • پروژه Appsan را اجرا کرده و از بارگذاری صحیح صفحه وب اطمینان حاصل کنید.
   • در صورت بروز مشکل، تنظیمات پوشه‌های web، webdist و ساخت پروژه وب را بررسی کنید.

نکات مهم

• نام پوشه‌ها در web و webdist باید یکسان باشد.
• برای لینک‌های خارجی در src از URLهای HTTPS معتبر استفاده کنید.
• پس از هر تغییر در کد منبع، مجدداً پروژه وب را بسازید و خروجی را به webdist کپی کنید.

این راهنما به شما کمک می‌کند پروژه‌های وب خود را به‌طور مؤثر در Appsan ادغام کرده و از قابلیت‌های جدید بهره‌مند شوید.

در این راهنما، نحوه تنظیم پروژه Angular به گونه‌ای که فایل‌های ساخته شده (build) آن به پوشه webdist در پروژه Appsan منتقل شوند و همچنین پروژه Angular در پوشه web مدیریت شود، توضیح داده می‌شود. این تنظیمات به شما امکان می‌دهند که به راحتی از پروژه Angular خود در Appsan استفاده کنید.

۱. ایجاد پوشه‌های مورد نیاز

1. ایجاد پوشه web:
   • در مسیر اصلی پروژه Appsan، یک پوشه به نام web ایجاد کنید.
   • این پوشه حاوی کد منبع پروژه‌های وب شما خواهد بود.
2. ایجاد پوشه برای پروژه Angular:
   • درون پوشه web، پوشه‌ای به نام پروژه Angular خود بسازید (مثلاً MyAngularProject).

۲. ایجاد پروژه Angular در پوشه web

1. ایجاد پروژه Angular در مسیر مناسب:

   ng new MyAngularProject --directory web/MyAngularProject

2. تست پروژه:

   با دستور زیر پروژه را به صورت محلی اجرا کنید و از صحت عملکرد آن مطمئن شوید:

   ng serve

۳. تنظیم مسیر خروجی (outputPath) در angular.json

1. باز کردن فایل angular.json:

   در ریشه پروژه Angular، فایل angular.json را باز کنید.

2. یافتن تنظیمات outputPath:

   در بخش architect → build مقدار outputPath را پیدا کنید.

3. تغییر مسیر خروجی:

   مقدار outputPath را به مسیر زیر تغییر دهید:

   "outputPath": "../../webdist/MyAngularProject"

۴. تنظیم baseHref برای پروژه Angular

برای اطمینان از بارگذاری صحیح منابع، baseHref را به ./ تنظیم کنید:

• از طریق خط فرمان:

  ng build --base-href ./

• در angular.json:

  
  "build": {
    "options": {
      "outputPath": "../../webdist/MyAngularProject",
      "baseHref": "./"
    }
  }
        

۵. ساخت پروژه Angular

1. ساخت پروژه:

   ng build

2. بررسی فایل‌های ساخته شده:

   اطمینان حاصل کنید که فایل‌های خروجی در پوشه webdist/MyAngularProject قرار گرفته باشند.

۶. استفاده از پروژه Angular در Appsan

1. افزودن عنصر webpage در فایل XML:

   <webpage src="MyAngularProject" title="پروژه Angular من"/>

2. اجرای پروژه Appsan:

   پروژه Appsan را اجرا کرده و از بارگذاری صحیح پروژه Angular مطمئن شوید.

نکات مهم

• مطمئن شوید پوشه Angular در web/[project-name] قرار دارد.
• مسیر outputPath در angular.json دقیقاً به پوشه مناسب در webdist اشاره کند.
• همیشه baseHref را به ./ تنظیم کنید.
• پس از هر تغییر در پروژه Angular، مجدداً آن را بسازید و خروجی را به webdist کپی کنید.
• نام پوشه در webdist باید با مقدار src در عنصر webpage مطابقت داشته باشد.

در این راهنما، نحوه تنظیم یک پروژه React به‌گونه‌ای که فایل‌های build آن به پوشه webdist در پروژه Appsan منتقل شوند و همچنین پروژه در پوشه web مدیریت شود، آموزش داده می‌شود. این مراحل مشابه با تنظیمات پروژه Angular بوده ولی با در نظر گرفتن تفاوت‌های React و Vite تهیه شده است.

۱. ایجاد پوشه‌های مورد نیاز

ایجاد پوشه web:
در مسیر اصلی پروژه Appsan خود، یک پوشه به نام web ایجاد کنید. این پوشه محل قرارگیری پروژه‌های وب شماست.

ایجاد پوشه برای پروژه React:
در داخل پوشه web، یک پوشه به نام دلخواه برای پروژه React ایجاد کنید. مثلاً:

web/MyReactProject

۲. ایجاد پروژه React در مسیر مناسب

با استفاده از Vite و دستور زیر پروژه React را در مسیر دلخواه ایجاد کنید:

npm create vite@latest web/MyReactProject -- --template react

سپس وارد پوشه پروژه شده و پکیج‌ها را نصب کنید:

cd web/MyReactProject  
npm install

۳. تنظیم مسیر خروجی (build output)

برای ذخیره فایل‌های build در پوشه webdist، فایل vite.config.js را باز کرده و تنظیمات زیر را اضافه کنید:

export default defineConfig({
  base: './',
  build: {
    outDir: '../../webdist/MyReactProject',
    emptyOutDir: true,
  },
});

توجه: به جای MyReactProject در مسیر outDir نام پوشه‌ای که می‌خواهید در webdist بسازید را قرار دهید.

۴. تنظیم مسیر (Routing) برای استفاده از مسیرهای داینامیک

در صورتی که اپلیکیشن شما از مسیر داینامیک استفاده می‌کند، باید از HashRouter به جای BrowserRouter استفاده کنید.

مراحل:

1. نصب React Router:

   npm install react-router-dom

2. در فایل App.jsx به صورت زیر تغییر دهید:

   import { HashRouter, Routes, Route } from 'react-router-dom';
   function App() {
   return (
   <HashRouter>
   <Routes>
   <Route path="/" element={} />
   <Route path="/results" element={} />
   {/* مسیرهای دیگر */}
   </Routes>
   </HashRouter>
   );
   }

۵. ساخت پروژه

پس از اعمال تغییرات بالا، دستور زیر را برای ساخت پروژه اجرا کنید:

npm run build

با اجرای این دستور، فایل‌های نهایی در مسیر webdist/MyReactProject قرار می‌گیرند.

۶. استفاده از پروژه React در Appsan

در فایل XML مربوط به Appsan، عنصر <webpage> را به شکل زیر اضافه کنید:

<webpage src="MyReactProject" title="پروژه React من"/>

مطمئن شوید که src با نام پوشه‌ای که در webdist ساختید مطابقت داشته باشد.

نکات مهم

• پروژه React باید در مسیر web/[project-name] ایجاد شود.
• مسیر خروجی (outDir) در vite.config.js باید به ../../webdist/[project-name] تنظیم شود.
• مقدار base باید به './' تغییر یابد.
• برای جلوگیری از مشکلات در مسیرهای داینامیک، از HashRouter استفاده کنید.
• هر بار که تغییراتی در پروژه ایجاد می‌کنید، مجدداً دستور npm run build را اجرا نمایید.
• در فایل XML Appsan، مقدار src باید دقیقاً با نام خروجی در webdist یکسان باشد.

کتابخانه JavaScript اپسان وب با هدف تسهیل ارتباط بین صفحات وب و پلتفرم اپسان طراحی شده است. این مستند به شما کمک می‌کند تا از این کتابخانه در وب‌سایت‌های خود استفاده کنید.

نصب کتابخانه

برای نصب کتابخانه اپسان، کافی است از npm استفاده کنید:

npm i @appsan-web/mini-web-sdk

لینک کتابخانه

راه‌اندازی کتابخانه

در ابتدا نیاز است که کتابخانه را در پروژه خود وارد کنید:

import { AppsanWeb } from '@appsan-web/mini-web-sdk';

استفاده از کلاس AppsanWeb

کلاس اصلی برای تعامل با اپسان، AppsanWeb است. این کلاس مسئول مدیریت ارتباطات بین وب‌سایت شما و صفحه اپسان است.

1. راه‌اندازی اولیه

برای راه‌اندازی کتابخانه کافی است تابع initialize را فراخوانی کنید. این تابع به صورت خودکار بعد از بارگذاری کامل صفحه وب شما فعال می‌شود:

AppsanWeb.initialize();

2. وضعیت آماده بودن اپسان

می‌توانید با استفاده از getStatus() وضعیت آماده بودن اپسان را بررسی کنید. این تابع یک BehaviorSubject از نوع رشته بازمی‌گرداند که می‌توانید به تغییرات آن گوش دهید:

const status$ = AppsanWeb.getStatus();  
status$.subscribe(status => {  
  console.log("Appsan Status:", status);  
});

وضعیت می‌تواند یکی از مقادیر زیر باشد:

• not ready
• ready
• not available
• error

3. اجرای اکشن در اپسان

تابع runAction برای اجرای اکشن در اپسان استفاده می‌شود:

AppsanWeb.runAction('myAction').subscribe();

4. مدیریت دکمه بازگشت

برای کنترل رفتار دکمه بازگشت از متد setCustomBackHandler استفاده کنید. در حالت پیش‌فرض اپسان هیستوری مینی‌وب شما را مدیریت می‌کند و این تابع تنها برای مدیریت پیشرفته بازگشت کاربرد دارد:

AppsanWeb.setCustomBackHandler(() => {  
  // Custom back behavior  
});

5. ارسال درخواست HTTP

برای ارسال درخواست HTTP می‌توانید از متد httpCall استفاده کنید:

AppsanWeb.httpCall('https://api.example.com', 'GET', {}, {}).subscribe(response => {  
  console.log('HTTP Response:', response);  
});

6. دریافت اطلاعات بایند (Bind)

متد getBind برای دریافت اطلاعات یک بایند خاص استفاده می‌شود. این متد یک Subject برمی‌گرداند که می‌توانید به آن subscribe کنید تا اطلاعات بایند را دریافت کنید:

AppsanWeb.getBind('myBind').subscribe(data => {  
  console.log('Bind data:', data);  
});

7. تنظیم مقدار متغیر

با استفاده از متد setVariable می‌توانید مقدار یک متغیر را در اپسان تنظیم کنید:

AppsanWeb.setVariable('variableId', 'newValue').subscribe();

8. دریافت مقدار متغیر

برای دریافت مقدار یک متغیر از اپسان از متد getVariable استفاده کنید. این متد نیز یک Subject برمی‌گرداند که می‌توانید مقدار متغیر را دریافت نمایید:

AppsanWeb.getVariable('variableId').subscribe(variable => {  
  console.log('Variable:', variable);  
});

import { AppsanWeb, AvailableBackCountProvider } from "./AppsanWeb";

export class ConfirmableBackCountProvider implements AvailableBackCountProvider {
  private availableHistoryCount = 1;

  constructor() {
    // Patch history.pushState so we can track forward navigation
    const h = window.history as any;
    const originalPushState = h.pushState;
    h.pushState = (...args: any[]) => {
      this.onPushState();
      return originalPushState.apply(h, args);
    };

    // Track browser back/forward via popstate
    window.addEventListener("popstate", () => this.onPopState());

    // Hook custom back handler to show a confirmation dialog
    AppsanWeb.setCustomBackHandler(() => this.showConfirmationDialog());
  }

  private onPushState(): void {
    this.availableHistoryCount++;
    (AppsanWeb as any).instance.post(
      (AppsanWeb as any).MESSAGE_TYPE_AVAILABLE_HISTORY_COUNT,
      this.availableHistoryCount
    );
  }

  private onPopState(): void {
    this.availableHistoryCount = Math.max(0, this.availableHistoryCount - 1);
    (AppsanWeb as any).instance.post(
      (AppsanWeb as any).MESSAGE_TYPE_AVAILABLE_HISTORY_COUNT,
      this.availableHistoryCount
    );
  }

  getAvailableHistoryCount(): number {
    return this.availableHistoryCount;
  }

  clearBackStack(): void {
    this.availableHistoryCount = 1;
    (AppsanWeb as any).instance.post(
      (AppsanWeb as any).MESSAGE_TYPE_AVAILABLE_HISTORY_COUNT,
      1
    );
  }

  private showConfirmationDialog(): void {
    if (confirm("آیا مطمئن هستید می‌خواهید بازگشت کنید؟")) {
      history.back();
    }
  }
}

1. نمونه سازنده را بسازید:

   const backHandler = new ConfirmableBackCountProvider();

2. کلاس ساخته شده را به setAppsanBackCountProvider بدهید

• این کلاس از AppsanWeb.httpCall برای ارسال درخواست‌ها استفاده می‌کند که توسط سوپر‌اپ Appsan مدیریت می‌شود.
• داده‌های مربوط به احراز هویت به‌صورت خودکار توسط سوپر‌اپ اضافه می‌شوند.
• خروجی تمامی متدها از نوع Observable است و می‌توان با استفاده از RxJS آن‌ها را مدیریت کرد.
• گزینه‌های connectTimeout، readTimeout و writeTimeout همگی بر حسب میلی‌ثانیه هستند.
• Timeoutها را می‌توان با استفاده از setDefaultOptions برای تمامی درخواست‌ها تنظیم کرد یا از طریق options برای هر درخواست مقدار متفاوتی تعیین کرد.

مرحله نهایی: بیلد و انتشار مینی‌اپ

در این مرحله شما باید پروژه خود را بیلد کنید و باندل بگیرید. برای اتمام این مرحله، مراحل زیر را طی کنید:

مرحله 1

پس از ساخت فایل‌های build در پوشه webdist، از بالای سمت چپ روی گزینه بیلد کلیک کرده و سپس بیلد در اپسان را انتخاب کنید.

مرحله 2

فایل ساخته‌شده در پوشه dist را بردارید و در سامانه اپسان، در بخش نسخه‌ها آپلود کنید و درخواست بررسی دهید.

مرحله 3

پس از تأیید بررسی، مینی‌اپ شما منتشر شده است.

1. ایجاد Repository در گیت‌لب شرکت
   - ورود به https://git.mavaratech.com و لاگین با حساب کاربری شرکت
   - کلیک روی New Project و انتخاب Create blank project
   - وارد کردن نام، توضیحات و تنظیم سطح دسترسی
2. تنظیم کانفیگ پروژه بر اساس ساختار تعریف‌شده
   - ایجاد پوشه config/ و فایل‌های default.json و production.json
   - ست کردن پارامترهایی مثل database.url، baseUrl و تنظیمات SSO
   - بارگذاری متغیرهای محیطی (Environment Variables)
3. طراحی و پیاده‌سازی دیتابیس
   - مدل‌سازی ER-Diagram و تعریف جداول، ستون‌ها، PK و FK
   - نوشتن اسکریپت‌های DDL و اجرای آن‌ها در محیط توسعه
   - اضافه کردن seed data برای جداول پایه مثل کاربران و نقش‌ها
4. ایجاد Routeها، API و کنترلرها
   - تعریف نقشه مسیرها (routes) در src/routes
   - پیاده‌سازی کنترلرها (Controllers) برای هر endpoint در src/controllers
   - مستندسازی APIها با OpenAPI/Swagger
5. اطلاع‌رسانی به PMO درباره اتمام پروژه
   - ارسال ایمیل یا تیکت در سیستم PMO مبنی بر پایان کار
   - ارائه گزارش نهایی و لینک به مخزن کد و مستندات تکمیلی

مراحل گام‌به‌گام «ساخت Repository» در گیت‌لب شرکت

1. ورود به گیت‌لب
   ابتدا مرورگر خود را باز کنید و به آدرس زیر مراجعه کنید:

   https://git.mavaratech.com/

   سپس با حساب کاربری شرکت (نام کاربری و رمز عبور) وارد شوید.
2. ایجاد پروژه جدید
   • پس از ورود، از منوی سمت چپ یا بالای صفحه روی دکمه‌ی New project کلیک کنید.
   • گزینه‌ی Create blank project را انتخاب کنید.
3. وارد کردن اطلاعات پروژه
   • Project name: نام پروژه را به صورت انگلیسی و بدون فاصله (مثلاً my-awesome-app) وارد کنید.
   • Project slug: معمولاً خودکار پر می‌شود اما در صورت نیاز ویرایش کنید.
   • Project description (اختیاری): توضیح کوتاهی درباره‌ی هدف پروژه بنویسید.
   • Visibility Level: سطح دسترسی پروژه را مشخص کنید (Private، Internal یا Public).
4. ساخت ریپازیتوری
   پس از تکمیل اطلاعات، روی دکمه‌ی Create project کلیک کنید. گیت‌لب به طور خودکار مخزن خالی را برای شما ایجاد کرده و وارد صفحه‌ی پروژه می‌شوید.
5. پیکربندی اولیه (اختیاری)
   • در صورت نیاز، یک فایل README.md، .gitignore یا لایسنس (LICENSE) اضافه کنید.
   • با فعال کردن Initialize repository with a README یک فایل README به مخزن اضافه می‌شود.

اکنون ریپازیتوری شما آماده‌ی کار است و می‌توانید آن را کلون کرده، کدها را پوش کنید و توسعه را ادامه دهید.

در ادامه یک مثال از بخش طراحی دیتابیس آورده شده است

1. طراحی ساختار دیتابیس (ER-Diagram)
   - مشخص کردن موجودیت‌ها (Entities): User، Request و RequestStatus
   - تعریف روابط: هر User می‌تواند چند Request داشته باشد؛ هر Request چند RequestStatus
   - تعیین کلیدهای اصلی (PK) و خارجی (FK) در هر جدول
2. تنظیم کانفیگ Sequelize برای PostgreSQL
   - نصب پکیج‌ها:

   npm install sequelize pg pg-hstore

   - ایجاد فایل کانفیگ src/configs/database.js:

   import { Sequelize } from 'sequelize';
   const sequelize = new Sequelize(
     process.env.DB_NAME,
     process.env.DB_USER,
     process.env.DB_PASS,
     {
       host: process.env.DB_HOST,
       dialect: 'postgres',
       logging: false,
     }
   );
   export default sequelize;

3. ایجاد مدل User
   - تعریف فیلدهای پایه مثل userId، name، email و role
   

   import { DataTypes } from 'sequelize';
   import sequelize from '../configs/database.js';
   const User = sequelize.define('User', {
   userId: {
   type: DataTypes.INTEGER,
   autoIncrement: true,
   primaryKey: true,
   },
   name: {
   type: DataTypes.STRING(100),
   allowNull: false,
   },
   email: {
   type: DataTypes.STRING(150),
   allowNull: false,
   unique: true,
   },
   role: {
   type: DataTypes.ENUM('user', 'expert', 'admin'),
   defaultValue: 'user',
   },
   }, {
   tableName: 'users',
   timestamps: true,
   });
   export default User;

4. ایجاد مدل Request
   - فیلدهای requestId، userId، expertId، text و trackingCode
   

   import { DataTypes } from 'sequelize';
   import sequelize from '../configs/database.js';
   import User from './user.js';
   import { v4 as uuidv4 } from 'uuid';
   const Request = sequelize.define('Request', {
   requestId: {
   type: DataTypes.INTEGER,
   autoIncrement: true,
   primaryKey: true,
   },
   userId: {
   type: DataTypes.INTEGER,
   references: { model: User, key: 'userId' },
   allowNull: true,
   },
   expertId: {
   type: DataTypes.INTEGER,
   references: { model: User, key: 'userId' },
   allowNull: true,
   },
   text: {
   type: DataTypes.TEXT,
   allowNull: false,
   },
   trackingCode: {
   type: DataTypes.STRING(20),
   allowNull: false,
   unique: true,
   defaultValue: () => uuidv4().slice(0, 20),
   },
   }, {
   tableName: 'requests',
   timestamps: true,
   });
   export default Request;

5. ایجاد مدل RequestStatus
   - ENUM وضعیت‌ها، ارجاع به requestId و نگهداری previous_state
   

   import { DataTypes } from 'sequelize';
   import sequelize from '../configs/database.js';
   import Request from './request.js';
   const RequestStatus = sequelize.define('RequestStatus', {
   statusId: {
   type: DataTypes.INTEGER,
   autoIncrement: true,
   primaryKey: true,
   },
   requestId: {
   type: DataTypes.INTEGER,
   references: { model: Request, key: 'requestId' },
   allowNull: false,
   },
   statusType: {
   type: DataTypes.ENUM('started','pending','accepted','rejected','done'),
   defaultValue: 'started',
   },
   expertComment: {
   type: DataTypes.TEXT,
   defaultValue: '',
   },
   userComment: {
   type: DataTypes.TEXT,
   defaultValue: '',
   },
   files: {
   type: DataTypes.JSONB,
   allowNull: true,
   },
   previous_state: {
   type: DataTypes.INTEGER,
   references: { model: 'request_statuses', key: 'statusId' },
   allowNull: true,
   },
   }, {
   tableName: 'request_statuses',
   timestamps: true,
   hooks: {
   beforeCreate: async (status) => {
   const last = await RequestStatus.findOne({
   where: { requestId: status.requestId },
   order: [['statusId','DESC']],
   });
   if (last) status.previous_state = last.statusId;
   }
   }
   });
   export default RequestStatus;

6. تنظیم ارتباطات (Associations)
   - در فایل src/models/index.js یا انتهای هر مدل:
   

   import User from './user.js';
   import Request from './request.js';
   import RequestStatus from './requestStatus.js';
   // User ↔ Request
   User.hasMany(Request, { foreignKey: 'userId', as: 'Requests' });
   Request.belongsTo(User, { foreignKey: 'userId', as: 'Customer' });
   User.hasMany(Request, { foreignKey: 'expertId', as: 'ExpertRequests' });
   Request.belongsTo(User, { foreignKey: 'expertId', as: 'Expert' });
   // Request ↔ RequestStatus
   Request.hasMany(RequestStatus, { foreignKey: 'requestId', as: 'Statuses' });
   RequestStatus.belongsTo(Request, { foreignKey: 'requestId', as: 'Request' });
   export { User, Request, RequestStatus };

7. پیاده‌سازی الگوی وضعیت (State Pattern)
   - ساخت پوشه src/models/state/ و ایجاد کلاس‌های وضعیت:
   

   import { handleReqRejected } from '../../utils/status.utils.js';
   class AcceptedState {
   constructor(context) { this.context = context; }
   async transitionTo(statusType) {
   if (!statusType) throw new Error('Invalid statusType');
   if (statusType === 'rejected') {
   return await handleReqRejected(this.context);
   }
   throw new Error(`Cannot transition from accepted to ${statusType}`);
   }
   }
   export default AcceptedState;

   - در سرویس Request فراخوانی وضعیت:
   

   import AcceptedState from './state/acceptedState.js';
   import PendingState from './state/pendingState.js';
   // …
   class RequestService {
   constructor(request) {
   this.request = request;
   this.state = this._getStateInstance(request.currentStatus);
   }
   _getStateInstance(type) {
   switch(type) {
   case 'accepted': return new AcceptedState(this.request);
   // …
   }
   }
   async changeStatus(toType) {
   return this.state.transitionTo(toType);
   }
   }

1. ایجاد ساختار پوشه‌ها برای Route و Controller
   - در ریشه پروژه پوشه‌های src/routes/ و src/controllers/ را بسازید
   - هر موجودیت (مثلاً requests و users) یک فایل Route و یک فایل Controller دارد
   - ساختار نهایی:

   src/
   ├─ controllers/
   │  ├─ requestController.js
   │  └─ userController.js
   └─ routes/
      ├─ requestRoutes.js
      └─ userRoutes.js
   

2. تعریف Routeها با استفاده از Express
   - در src/routes/requestRoutes.js مسیرهای CRUD را تعریف کنید:

   import { Router } from 'express';
   import {
     createRequest,
     getAllRequests,
     getRequestById,
     updateRequest,
     deleteRequest
   } from '../controllers/requestController.js';
   const router = Router();
   router.post('/', createRequest);
   router.get('/', getAllRequests);
   router.get('/:id', getRequestById);
   router.put('/:id', updateRequest);
   router.delete('/:id', deleteRequest);
   export default router;

3. ایجاد Controllerها با منطق کاری
   - در src/controllers/requestController.js توابع CRUD را پیاده کنید:

   import Request from '../models/request.js';
   export const createRequest = async (req, res, next) => {
   try {
   const newReq = await Request.create({
   userId: req.body.userId,
   expertId: req.body.expertId,
   text: req.body.text
   });
   res.status(201).json(newReq);
   } catch (err) {
   next(err);
   }
   };
   export const getAllRequests = async (_req, res, next) => {
   try {
   const list = await Request.findAll();
   res.json(list);
   } catch (err) {
   next(err);
   }
   };
   export const getRequestById = async (req, res, next) => {
   try {
   const item = await Request.findByPk(req.params.id);
   if (!item) return res.status(404).json({ message: 'Not found' });
   res.json(item);
   } catch (err) {
   next(err);
   }
   };
   export const updateRequest = async (req, res, next) => {
   try {
   const [updated] = await Request.update(req.body, {
   where: { requestId: req.params.id }
   });
   if (!updated) return res.status(404).json({ message: 'Not found' });
   res.json({ message: 'Updated' });
   } catch (err) {
   next(err);
   }
   };
   export const deleteRequest = async (req, res, next) => {
   try {
   const deleted = await Request.destroy({
   where: { requestId: req.params.id }
   });
   if (!deleted) return res.status(404).json({ message: 'Not found' });
   res.status(204).end();
   } catch (err) {
   next(err);
   }
   };

4. وصل کردن Routeها به اپلیکیشن اصلی
   - در src/app.js یا index.js این کار را انجام دهید:

   import express from 'express';
   import bodyParser from 'body-parser';
   import requestRoutes from './routes/requestRoutes.js';
   import userRoutes    from './routes/userRoutes.js';
   const app = express();
   app.use(bodyParser.json());
   app.use('/api/requests', requestRoutes);
   app.use('/api/users',    userRoutes);
   // هندلینگ خطا
   app.use((err, _req, res, _next) => {
   console.error(err);
   res.status(500).json({ error: err.message });
   });
   export default app;

نکات مهم

• همیشه با تیم فرانت‌اند در تماس باشید تا پروژه در سریع‌ترین زمان ممکن پیش برود.
• با مسئول DevOps هماهنگ کنید تا تنظیمات و استقرار به‌درستی انجام شود.
• زمان‌بندی را با تیم PMO چک کنید و مطابق بازه‌ی اعلام‌شده کار را تحویل دهید.
• تست‌نویسی را فراموش نکنید تا کار برای تیم QA به‌سادگی قابل بررسی باشد.
• مستندات پروژه را کامل و شفاف تهیه کنید تا فرآیند نگهداری و توسعه آینده آسان شود.