Paginate Tahesab customer list by code windows past the 5000 cap.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-04 11:09:40 +03:30
parent 60c16053a4
commit 236f73de93
3 changed files with 233 additions and 45 deletions
@@ -7,6 +7,7 @@ import {
  IsOptional,
  IsString,
  IsUrl,
+  Max,
  MaxLength,
  Min,
  MinLength,
@@ -155,10 +156,24 @@ export class ImportBulkFromTahesabDto {
  @Min(1)
  toCode?: number;

-  /** اگر true باشد همهٔ مشتریان با اسکن بازه‌ای خوانده می‌شوند */
+  /** اگر true باشد یک صفحه از مشتریان (بازهٔ کد) خوانده می‌شود */
  @IsOptional()
  @IsBoolean()
  listAll?: boolean;
+
+  /** صفحهٔ بازهٔ کد هنگام listAll (پیش‌فرض ۱) */
+  @IsOptional()
+  @Type(() => Number)
+  @IsInt()
+  @Min(1)
+  page?: number;
+
+  @IsOptional()
+  @Type(() => Number)
+  @IsInt()
+  @Min(100)
+  @Max(2000)
+  pageSize?: number;
 }

 export class SearchTahesabDto {
@@ -191,10 +206,28 @@ export class SearchTahesabDto {
  @Min(1)
  toCode?: number;

-  /** بازه خالی در UI → همهٔ مشتریان */
+  /** بازه خالی در UI → مرور صفحه‌ای همهٔ مشتریان */
  @IsOptional()
  @IsBoolean()
  listAll?: boolean;
+
+  /**
+   * صفحهٔ بازهٔ کد برای listAll (۱ = کد ۱…۲۰۰۰، ۲ = ۲۰۰۱…۴۰۰۰، …).
+   * سقف ۵۰۰۰ دیگر اعمال نمی‌شود.
+   */
+  @IsOptional()
+  @Type(() => Number)
+  @IsInt()
+  @Min(1)
+  page?: number;
+
+  /** اندازهٔ پنجرهٔ کد در هر صفحه (پیش‌فرض ۲۰۰۰، حداکثر ۲۰۰۰) */
+  @IsOptional()
+  @Type(() => Number)
+  @IsInt()
+  @Min(100)
+  @Max(2000)
+  pageSize?: number;
 }

 export class SearchTahesabProductsDto {
@@ -17,10 +17,9 @@ import {
 } from './dto';
 import { normalizeIranMobile, SanadBuilders, type TahesabApi } from './tahesab-methods';

-const LIST_ALL_CHUNK = 2000;
-/** سقف «همه» در یک درخواست ByCode — تکه‌تکه باعث ۵۰۲ پروکسی می‌شود */
-const LIST_ALL_MAX_CODE = 5_000;
-const LIST_ALL_TIMEOUT_MS = 55_000;
+/** اندازهٔ هر صفحهٔ «همه» (بازهٔ کد) — امن برای پروکسی/nginx */
+const LIST_PAGE_SIZE = 2000;
+const LIST_TIMEOUT_MS = 55_000;

 function asMoshtariList(raw: unknown): Array<Record<string, unknown>> {
  if (!raw) return [];
@@ -318,25 +317,32 @@ export class TahesabPersonLinkService {
  }

  /**
-   * لیست همهٔ مشتریان در یک درخواست (بازه ۱…LIST_ALL_MAX_CODE).
-   * تکه‌تکه کردن پشت‌سرهم معمولاً از مهلت nginx بیشتر می‌شود و ۵۰۲ می‌دهد.
+   * یک صفحه از مشتریان بر اساس بازهٔ کد:
+   * صفحه ۱ → ۱…pageSize، صفحه ۲ → pageSize+1…۲×pageSize، …
+   * سقف ۵۰۰۰ حذف شده؛ با پیجینیت می‌توان همه را مرور کرد.
   */
-  private async listAllMoshtari(api: TahesabApi) {
-    try {
-      return asMoshtariList(
-        await api.doListMoshtariByCode(1, LIST_ALL_MAX_CODE, {
-          timeoutMs: LIST_ALL_TIMEOUT_MS,
-        }),
-      );
-    } catch (err) {
-      // اگر بازهٔ بزرگ سمت ته‌حساب رد شد، همان سقف دستی ۲۰۰۰ را یک‌بار امتحان کن
-      if (LIST_ALL_MAX_CODE <= LIST_ALL_CHUNK) throw err;
-      return asMoshtariList(
-        await api.doListMoshtariByCode(1, LIST_ALL_CHUNK, {
-          timeoutMs: LIST_ALL_TIMEOUT_MS,
-        }),
-      );
-    }
+  private async listMoshtariPage(
+    api: TahesabApi,
+    page: number,
+    pageSize?: number,
+  ) {
+    const size = Math.min(
+      LIST_PAGE_SIZE,
+      Math.max(100, Math.floor(pageSize ?? LIST_PAGE_SIZE) || LIST_PAGE_SIZE),
+    );
+    const p = Math.max(1, Math.floor(page) || 1);
+    const fromCode = (p - 1) * size + 1;
+    const toCode = fromCode + size - 1;
+    const raw = await api.doListMoshtariByCode(fromCode, toCode, {
+      timeoutMs: LIST_TIMEOUT_MS,
+    });
+    return {
+      rows: asMoshtariList(raw),
+      fromCode,
+      toCode,
+      page: p,
+      pageSize: size,
+    };
  }

  async search(organizationId: string, dto: SearchTahesabDto) {
@@ -345,8 +351,28 @@ export class TahesabPersonLinkService {
      dto.connectionId,
    );
    let raw: unknown = [];
+    let listMeta:
+      | {
+          page: number;
+          pageSize: number;
+          fromCode: number;
+          toCode: number;
+        }
+      | undefined;
+
    if (dto.listAll) {
-      raw = await this.listAllMoshtari(api);
+      const listed = await this.listMoshtariPage(
+        api,
+        dto.page ?? 1,
+        dto.pageSize,
+      );
+      raw = listed.rows;
+      listMeta = {
+        page: listed.page,
+        pageSize: listed.pageSize,
+        fromCode: listed.fromCode,
+        toCode: listed.toCode,
+      };
    } else if (dto.fromCode != null && dto.toCode != null) {
      if (dto.toCode < dto.fromCode) {
        throw new BadRequestException('کد پایان باید بزرگ‌تر یا مساوی کد شروع باشد.');
@@ -354,7 +380,9 @@ export class TahesabPersonLinkService {
      if (dto.toCode - dto.fromCode > 2000) {
        throw new BadRequestException('بازهٔ کد حداکثر ۲۰۰۰ عدد است (مثلاً ۱ تا ۲۰۰۰). برای همه، بازه را خالی بگذارید.');
      }
-      raw = await api.doListMoshtariByCode(dto.fromCode, dto.toCode);
+      raw = await api.doListMoshtariByCode(dto.fromCode, dto.toCode, {
+        timeoutMs: LIST_TIMEOUT_MS,
+      });
    } else if (dto.moshtariCode) {
      raw = await api.doListMoshtariByCode(dto.moshtariCode, dto.moshtariCode);
    } else if (dto.phone) {
@@ -414,11 +442,23 @@ export class TahesabPersonLinkService {
        kind: 'search',
        status: 'success',
        request: dto as unknown as Prisma.InputJsonValue,
-        result: { count: results.length } as Prisma.InputJsonValue,
+        result: {
+          count: results.length,
+          ...(listMeta ?? {}),
+        } as Prisma.InputJsonValue,
      },
    });

-    return { results };
+    return {
+      results,
+      ...(listMeta
+        ? {
+            ...listMeta,
+            hasMore: results.length > 0,
+            note: `صفحه ${listMeta.page}: کد ${listMeta.fromCode} تا ${listMeta.toCode}. برای ادامه صفحه بعد را بزنید.`,
+          }
+        : {}),
+    };
  }

  async importFromTahesab(
@@ -516,10 +556,15 @@ export class TahesabPersonLinkService {
        organizationId,
        dto.connectionId,
      );
-      const listed = (await this.listAllMoshtari(api))
+      const listed = await this.listMoshtariPage(
+        api,
+        dto.page ?? 1,
+        dto.pageSize,
+      );
+      const listedCodes = listed.rows
        .map((row) => pickCode(row))
        .filter((c): c is number => c != null);
-      codes = [...new Set([...codes, ...listed])];
+      codes = [...new Set([...codes, ...listedCodes])];
    } else if (dto.fromCode != null && dto.toCode != null) {
      if (dto.toCode < dto.fromCode) {
        throw new BadRequestException('کد پایان باید بزرگ‌تر یا مساوی کد شروع باشد.');
@@ -545,10 +590,10 @@ export class TahesabPersonLinkService {
        'کد مشتری یا بازهٔ کد برای وارد کردن مشخص نشده است.',
      );
    }
-    const maxImport = dto.listAll ? 2000 : 500;
+    const maxImport = dto.listAll || (dto.fromCode != null && dto.toCode != null) ? 2000 : 500;
    if (codes.length > maxImport) {
      throw new BadRequestException(
-        `حداکثر ${maxImport} مشتری در هر بار وارد کنید (الان ${codes.length}). بازه را کوچک‌تر کنید.`,
+        `حداکثر ${maxImport} مشتری در هر بار وارد کنید (الان ${codes.length}). صفحه یا بازه را کوچک‌تر کنید.`,
      );
    }

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { onMounted, reactive, ref } from 'vue';
+import { computed, onMounted, reactive, ref } from 'vue';
 import { RouterLink } from 'vue-router';
 import axios from 'axios';
 import { api } from '@/lib/api';
@@ -16,6 +16,7 @@ import {
  UiField,
  UiInput,
  UiPageHeader,
+  UiPagination,
  UiSelect,
 } from '@/components/ui';
 import UiIcon from '@/components/UiIcon.vue';
@@ -55,6 +56,32 @@ type SyncResult = {
  personName?: string | null;
 };
 const syncResults = ref<SyncResult[]>([]);
+/** حالت آخرین جستجو — برای پیجینیت بازهٔ کد */
+const syncListMode = ref<'none' | 'listAll' | 'range' | 'filter'>('none');
+const syncListPage = ref(1);
+const syncListMeta = reactive({
+  fromCode: 0,
+  toCode: 0,
+  hasMore: false,
+  pageSize: 2000,
+});
+const SYNC_TABLE_PAGE_SIZE = 50;
+const syncTablePage = ref(1);
+
+const syncCodeTotalPages = computed(() => {
+  if (syncListMode.value !== 'listAll') return 1;
+  // اگر صفحه فعلی نتیجه دارد، صفحهٔ بعد هم قابل امتحان است
+  return syncListMeta.hasMore
+    ? syncListPage.value + 1
+    : Math.max(1, syncListPage.value);
+});
+const syncTableTotalPages = computed(() =>
+  Math.max(1, Math.ceil(syncResults.value.length / SYNC_TABLE_PAGE_SIZE)),
+);
+const syncPagedResults = computed(() => {
+  const start = (syncTablePage.value - 1) * SYNC_TABLE_PAGE_SIZE;
+  return syncResults.value.slice(start, start + SYNC_TABLE_PAGE_SIZE);
+});

 const productSync = reactive({
  connectionId: '',
@@ -255,7 +282,7 @@ async function removeConn(id: string) {
  }
 }

-async function searchTahesab(mode: 'range' | 'filter') {
+async function searchTahesab(mode: 'range' | 'filter', codePage?: number) {
  error.value = '';
  ok.value = '';
  if (!sync.connectionId) {
@@ -269,8 +296,13 @@ async function searchTahesab(mode: 'range' | 'filter') {
      const fromRaw = String(sync.fromCode ?? '').trim();
      const toRaw = String(sync.toCode ?? '').trim();
      if (!fromRaw && !toRaw) {
-        // API برای «همه» فلگ listAll دارد؛ ارسال ۱…۵۰۰۰ با سقف ۲۰۰۰ کد رد می‌شود
+        // همهٔ مشتریان — صفحه‌بندی بازهٔ کد (هر صفحه ۲۰۰۰ کد؛ بدون سقف ۵۰۰۰)
+        const page = Math.max(1, codePage ?? syncListPage.value);
        body.listAll = true;
+        body.page = page;
+        body.pageSize = 2000;
+        syncListPage.value = page;
+        syncListMode.value = 'listAll';
      } else {
        const fromCode = fromRaw ? Number(fromRaw) : 1;
        const toCode = toRaw ? Number(toRaw) : fromCode + 1999;
@@ -284,28 +316,59 @@ async function searchTahesab(mode: 'range' | 'filter') {
        }
        body.fromCode = fromCode;
        body.toCode = toCode;
+        syncListMode.value = 'range';
+        syncListMeta.hasMore = false;
      }
    } else if (sync.moshtariCode !== '' && sync.moshtariCode != null) {
      body.moshtariCode = Number(sync.moshtariCode);
+      syncListMode.value = 'filter';
+      syncListMeta.hasMore = false;
    } else if (sync.phone.trim()) {
      body.phone = sync.phone.trim();
+      syncListMode.value = 'filter';
+      syncListMeta.hasMore = false;
    } else if (sync.name.trim()) {
      body.name = sync.name.trim();
+      syncListMode.value = 'filter';
+      syncListMeta.hasMore = false;
    } else {
      error.value = 'موبایل، نام، کد مشتری یا بازهٔ کد را وارد کنید.';
      return;
    }
-    const { data } = await api.post<{ results: SyncResult[] }>(
+    const { data } = await api.post<{
+      results: SyncResult[];
+      page?: number;
+      pageSize?: number;
+      fromCode?: number;
+      toCode?: number;
+      hasMore?: boolean;
+      note?: string;
+    }>(
      '/integrations/tahesab/sync/search',
      body,
-      { timeout: body.listAll ? 180_000 : 60_000 },
+      { timeout: body.listAll ? 90_000 : 60_000 },
    );
    syncResults.value = data.results ?? [];
+    syncTablePage.value = 1;
+    if (data.page != null) {
+      syncListPage.value = data.page;
+      syncListMeta.fromCode = data.fromCode ?? 0;
+      syncListMeta.toCode = data.toCode ?? 0;
+      syncListMeta.hasMore = Boolean(data.hasMore);
+      syncListMeta.pageSize = data.pageSize ?? 2000;
+    }
    if (!syncResults.value.length) {
-      ok.value = 'نتیجه‌ای یافت نشد.';
+      ok.value =
+        data.note ??
+        (syncListMode.value === 'listAll' && syncListPage.value > 1
+          ? 'در این صفحه مشتری‌ای نیست. صفحه قبل را ببینید یا بازه دستی بزنید.'
+          : 'نتیجه‌ای یافت نشد.');
    } else {
      const linked = syncResults.value.filter((r) => r.alreadyLinked).length;
-      ok.value = `${syncResults.value.length} مشتری پیدا شد` + (linked ? ` (${linked} قبلاً لینک شده)` : '');
+      const base =
+        `${syncResults.value.length} مشتری پیدا شد` +
+        (linked ? ` (${linked} قبلاً لینک شده)` : '');
+      ok.value = data.note ? `${base} — ${data.note}` : base;
    }
  } catch (e) {
    error.value = apiErr(e, 'جستجو ناموفق');
@@ -314,6 +377,14 @@ async function searchTahesab(mode: 'range' | 'filter') {
  }
 }

+function onSyncCodePageChange(page: number) {
+  void searchTahesab('range', page);
+}
+
+function onSyncTablePageChange(page: number) {
+  syncTablePage.value = page;
+}
+
 async function importOne(moshtariCode: number) {
  error.value = '';
  ok.value = '';
@@ -362,14 +433,25 @@ async function importBulk(mode: 'results' | 'range') {
    const fromRaw = String(sync.fromCode ?? '').trim();
    const toRaw = String(sync.toCode ?? '').trim();
    if (!fromRaw && !toRaw) {
+      const page = syncListMode.value === 'listAll' ? syncListPage.value : 1;
+      const from =
+        syncListMode.value === 'listAll' && syncListMeta.fromCode
+          ? syncListMeta.fromCode
+          : (page - 1) * 2000 + 1;
+      const to =
+        syncListMode.value === 'listAll' && syncListMeta.toCode
+          ? syncListMeta.toCode
+          : from + 1999;
      if (
        !confirm(
-          `کل مشتریان قابل‌خواندن از ته‌حساب به‌عنوان شخص وارد ${brand.nameFa} می‌شوند. ادامه؟`,
+          `مشتریان صفحهٔ ${page} (کد ${from} تا ${to}) از ته‌حساب به‌عنوان شخص وارد ${brand.nameFa} می‌شوند. برای صفحات بعدی، پیجینیت را بزنید و دوباره وارد کنید. ادامه؟`,
        )
      ) {
        return;
      }
      body.listAll = true;
+      body.page = page;
+      body.pageSize = 2000;
    } else {
      const fromCode = fromRaw ? Number(fromRaw) : 1;
      const toCode = toRaw ? Number(toRaw) : fromCode + 1999;
@@ -668,7 +750,7 @@ onMounted(load);
        <div class="sync-sub-section">
          <h4 class="sync-subhead">۱) وارد کردن دسته‌ای با بازه کد مشتری</h4>
          <p class="sync-sub-desc">
-            بازهٔ دستی حداکثر ۲۰۰۰ کد است. اگر «از» و «تا» خالی باشد، همهٔ مشتریان خوانده می‌شوند.
+            بازهٔ دستی حداکثر ۲۰۰۰ کد است. اگر «از» و «تا» خالی باشد، مشتریان صفحه‌به‌صفحه (هر صفحه ۲۰۰۰ کد) خوانده می‌شوند — بدون سقف ۵۰۰۰.
          </p>
          <div class="crm-form-grid-2">
            <UiInput v-model="sync.fromCode" type="number" min="1" dir="ltr" placeholder="از کد (مثلاً ۱)" />
@@ -678,17 +760,31 @@ onMounted(load);
            <UiButton
              variant="secondary"
              :disabled="!sync.connectionId || syncBusy"
-              @click="searchTahesab('range')"
+              @click="searchTahesab('range', 1)"
            >
-              نمایش بازه
+              نمایش بازه / همه
            </UiButton>
            <UiButton
              :disabled="!sync.connectionId || syncBusy"
              @click="importBulk('range')"
            >
-              وارد کردن کل بازه
+              وارد کردن این صفحه / بازه
            </UiButton>
          </div>
+          <UiPagination
+            v-if="syncListMode === 'listAll' && (syncResults.length || syncListPage > 1)"
+            :page="syncListPage"
+            :total-pages="syncCodeTotalPages"
+            class="sync-code-pagination"
+            @update:page="onSyncCodePageChange"
+          />
+          <p
+            v-if="syncListMode === 'listAll' && syncListMeta.fromCode"
+            class="sync-sub-desc"
+          >
+            صفحه {{ syncListPage }} — کد {{ syncListMeta.fromCode }} تا {{ syncListMeta.toCode }}
+            <span v-if="syncListMeta.hasMore"> · صفحه بعد برای کدهای بالاتر</span>
+          </p>
        </div>

        <div class="sync-sub-section">
@@ -729,7 +825,7 @@ onMounted(load);
                </tr>
              </thead>
              <tbody>
-                <tr v-for="r in syncResults" :key="String(r.moshtariCode)">
+                <tr v-for="r in syncPagedResults" :key="String(r.moshtariCode)">
                  <td class="font-mono">{{ r.moshtariCode }}</td>
                  <td class="font-bold">{{ r.name || 'بدون نام' }}</td>
                  <td class="font-mono" dir="ltr">{{ r.tel }}</td>
@@ -761,6 +857,15 @@ onMounted(load);
              </tbody>
            </table>
          </div>
+          <UiPagination
+            v-if="syncTableTotalPages > 1"
+            :page="syncTablePage"
+            :total-pages="syncTableTotalPages"
+            :total-items="syncResults.length"
+            :page-size="SYNC_TABLE_PAGE_SIZE"
+            class="sync-table-pagination"
+            @update:page="onSyncTablePageChange"
+          />
        </div>
      </div>
    </UiCard>
@@ -1046,6 +1151,11 @@ onMounted(load);
  flex-wrap: wrap;
 }

+.sync-code-pagination,
+.sync-table-pagination {
+  margin-top: var(--sp-3);
+}
+
 .sync-results-box {
  display: flex;
  flex-direction: column;