feat(treasury): list debtors and creditors on the finance report

Show open receivable and payable balances on separate report tabs, and include each list in an Excel export.

Co-authored-by: Cursor <cursoragent@cursor.com>

apps/web/src/views/treasury/TreasuryReportsView.vue

@@ -1,5 +1,6 @@
 <script setup lang="ts">
 import { computed, onMounted, ref } from 'vue';
+import axios from 'axios';
 import {
   Alert as AAlert,
   Button as AButton,
@@ -9,16 +10,21 @@ import {
   Flex as AFlex,
   List as AList,
   Table as ATable,
+  Tabs as ATabs,
   Typography,
 } from 'ant-design-vue';
 import type { TableColumnsType } from 'ant-design-vue';
 import { DownloadOutlined } from '@ant-design/icons-vue';
+import * as XLSX from 'xlsx';
+import type { TreasuryPartyBalanceDto } from '@mento/shared';
 import { api } from '@/lib/api';
+import TreasuryPartyBalanceTable from '@/components/treasury/TreasuryPartyBalanceTable.vue';
 import { toman } from './treasury-format';
 
 const { Text: ATypographyText } = Typography;
 const AListItem = AList.Item;
 const AListItemMeta = AList.Item.Meta;
+const ATabPane = ATabs.TabPane;
 
 type Period = {
   bookedIncome: string;
@@ -41,7 +47,17 @@ const current = ref<Period | null>(null);
 const previous = ref<Period | null>(null);
 const payablesByMonth = ref<Array<{ month: string; amount: string }>>([]);
 const receivablesByParty = ref<Array<{ name: string; amount: string }>>([]);
+const debtors = ref<TreasuryPartyBalanceDto[]>([]);
+const creditors = ref<TreasuryPartyBalanceDto[]>([]);
+const reportTab = ref('periods');
 const error = ref('');
+const balanceError = ref('');
+
+const kindLabel: Record<string, string> = {
+  person: 'مشتری',
+  company: 'شرکت',
+  user: 'کاربر',
+};
 
 const lines = [
   ['درآمد ثبت‌شده', 'bookedIncome'],
@@ -81,6 +97,50 @@ async function load() {
   receivablesByParty.value = data.receivablesByParty;
 }
 
+function sumRemaining(rows: TreasuryPartyBalanceDto[]) {
+  return rows.reduce((sum, row) => sum + Number(row.remaining || 0), 0).toFixed(2);
+}
+
+function exportParties(
+  rows: TreasuryPartyBalanceDto[],
+  title: string,
+  settledLabel: string,
+  filename: string,
+) {
+  const body = rows.map((row) => [
+    row.partyName,
+    (row.partyKind && kindLabel[row.partyKind]) || 'ثبت قبلی',
+    Number(row.amount),
+    Number(row.settledAmount),
+    Number(row.remaining),
+  ]);
+  const totals = rows.reduce(
+    (sum, row) => ({
+      amount: sum.amount + Number(row.amount || 0),
+      settled: sum.settled + Number(row.settledAmount || 0),
+      remaining: sum.remaining + Number(row.remaining || 0),
+    }),
+    { amount: 0, settled: 0, remaining: 0 },
+  );
+  body.push(['جمع', '', totals.amount, totals.settled, totals.remaining]);
+  const sheet = XLSX.utils.aoa_to_sheet([
+    ['طرف حساب', 'نوع', 'مبلغ کل', settledLabel, 'مانده'],
+    ...body,
+  ]);
+  const book = XLSX.utils.book_new();
+  XLSX.utils.book_append_sheet(book, sheet, title);
+  XLSX.writeFile(book, filename);
+}
+
+async function loadBalances() {
+  const [income, expense] = await Promise.all([
+    api.get<TreasuryPartyBalanceDto[]>('/treasury/party-balances', { params: { kind: 'income' } }),
+    api.get<TreasuryPartyBalanceDto[]>('/treasury/party-balances', { params: { kind: 'expense' } }),
+  ]);
+  debtors.value = income.data;
+  creditors.value = expense.data;
+}
+
 async function download() {
   const { data } = await api.get<Blob>('/treasury/reports/export', { responseType: 'blob' });
   const url = URL.createObjectURL(data);
@@ -95,6 +155,14 @@ onMounted(() => {
   void load().catch(() => {
     error.value = 'گزارش بارگذاری نشد.';
   });
+  void loadBalances().catch((e: unknown) => {
+    if (axios.isAxiosError(e) && (e.response?.status === 404 || e.response?.status === 403)) {
+      debtors.value = [];
+      creditors.value = [];
+      return;
+    }
+    balanceError.value = 'مانده بدهکاران و بستانکاران بارگذاری نشد.';
+  });
 });
 </script>
 
@@ -108,9 +176,12 @@ onMounted(() => {
       </a-flex>
 
       <a-alert v-if="error" type="error" show-icon :message="error" />
+      <a-alert v-if="balanceError" type="error" show-icon :message="balanceError" />
 
       <a-card :bordered="false">
-        <a-divider orientation="right">مقایسه دوره‌ها</a-divider>
+        <a-tabs v-model:activeKey="reportTab">
+          <a-tab-pane key="periods" tab="مقایسه دوره‌ها">
+            <a-flex vertical :gap="16">
         <a-table
           v-if="metricRows.length"
           :columns="metricColumns"
@@ -168,6 +239,39 @@ onMounted(() => {
             </template>
           </a-list>
         </template>
+            </a-flex>
+          </a-tab-pane>
+
+          <a-tab-pane key="debtors" tab="بدهکاران">
+            <a-flex vertical :gap="16">
+              <a-flex justify="space-between" align="center">
+                <a-typography-text type="secondary">
+                  {{ debtors.length }} طرف حساب · جمع مانده {{ toman(sumRemaining(debtors)) }}
+                </a-typography-text>
+                <a-button @click="exportParties(debtors, 'بدهکاران', 'دریافت‌شده', 'debtors.xlsx')">
+                  <template #icon><DownloadOutlined /></template>
+                  خروجی اکسل
+                </a-button>
+              </a-flex>
+              <TreasuryPartyBalanceTable :rows="debtors" settled-label="دریافت‌شده" />
+            </a-flex>
+          </a-tab-pane>
+
+          <a-tab-pane key="creditors" tab="بستانکاران">
+            <a-flex vertical :gap="16">
+              <a-flex justify="space-between" align="center">
+                <a-typography-text type="secondary">
+                  {{ creditors.length }} طرف حساب · جمع مانده {{ toman(sumRemaining(creditors)) }}
+                </a-typography-text>
+                <a-button @click="exportParties(creditors, 'بستانکاران', 'پرداخت‌شده', 'creditors.xlsx')">
+                  <template #icon><DownloadOutlined /></template>
+                  خروجی اکسل
+                </a-button>
+              </a-flex>
+              <TreasuryPartyBalanceTable :rows="creditors" settled-label="پرداخت‌شده" />
+            </a-flex>
+          </a-tab-pane>
+        </a-tabs>
       </a-card>
   </a-flex>
 </template>