dla-docs

報告

1. 目的

報告模組提供詳細的財務報告，協助您：

• 查看當月的財務概覽
• 分析收入和支出
• 追蹤儲蓄進度
• 預測月底支出
• 按類型查看報告（收入、支出、儲蓄、貸款）

2. 使用時機

當您想：

• 查看財務概覽時
• 分析支出趨勢時
• 檢查儲蓄目標進度時
• 預測預算超支風險時
• 按類型查看詳細報告時

3. 相關畫面

• 概覽報告
• 收入報告
• 支出報告
• 儲蓄報告
• 貸款報告

4. 主要使用方式

4.1 查看概覽報告

1. 前往底部導航中的報告標籤
2. 查看財務健康區段：
   • 儲蓄目標和實際儲蓄（帶有進度條和達成水準）
   • 淨現金流（帶有詳細公式）
   • 預算剩餘（如果已建立預算）
   • 與上月相比的支出速度（如果有資料）
   • 本月貸款義務（如有）
   • 按百分比的前 5 大支出類別
3. 查看未來趨勢預測區段（如果預算 > 0）：
   • 月底預期剩餘（帶有詳細公式）
   • 儲蓄目標達成機率
   • 即將到來的貸款付款（如有）
4. 點擊卡片捲動到對應的詳細報告

4.2 查看收入報告

1. 從報告畫面，點擊「詳細報告」區段中的選單項目 💵 收入
2. 查看本月總實際收入
3. 查看定期收入區段：總計、已收到、尚未收到、每個項目的詳細資訊
4. 查看額外收入區段（如有）：總計、每個項目的詳細資訊、% 增加/減少
5. 查看3 個月收入趨勢（如果有足夠資料）
6. 查看每月收入歷史
7. 查看收入分析（洞察）：百分比、穩定性水準、趨勢

4.3 查看支出報告

1. 從報告畫面，點擊「詳細報告」區段中的選單項目 🔥 支出
2. 查看本月總實際支出，與上月相比的 % 增加/減少
3. 查看定期支出區段：總計、已付、尚未付、每個項目的詳細資訊
4. 查看按類別的日常支出區段：前幾大類別，帶有金額和百分比
5. 查看支出激增區段（如果有上月資料）
6. 查看3 個月支出趨勢（如果有足夠資料）
7. 查看每月支出歷史

4.4 查看預算報告

1. 從報告畫面，點擊「詳細報告」區段中的選單項目 📉 預算（僅在已建立預算時顯示）
2. 查看本月預算概覽：每月預算、已支出（帶有明細）、剩餘、進度條
3. 點擊「每月預算」查看帶有計算方法的預算詳細對話框
4. 查看與計劃的差異區段：帶有差異的收入和支出項目、總差異
5. 查看按類別的支出區段：總計、每個類別帶有金額、百分比、進度條
6. 點擊類別查看該類別中的支出清單

4.5 查看儲蓄報告

1. 從報告畫面，點擊「詳細報告」區段中的選單項目 💾 儲蓄（僅在存在儲蓄帳戶時顯示）
2. 查看本月實際儲蓄，帶有淨現金流公式
3. 查看儲蓄分析區段：收入的 %、與上月比較、月底預測
4. 查看儲蓄帳戶清單區段：所有啟用中帳戶，按最近到期日期排序
5. 查看6 個月儲蓄成長圖表（如果有超過 1 個月的資料）

4.6 查看貸款報告

1. 從報告畫面，點擊「詳細報告」區段中的選單項目 💸 貸款（僅在存在貸款時顯示）
2. 查看貸款概覽：目前債務餘額、本月貸款成本（帶有本金 + 利息明細）
3. 查看最近付款區段：到期日期、狀態、距離下次付款的天數
4. 查看每月付款時間表區段：最近 3 個月，帶有金額和狀態
5. 查看貸款分析（洞察）區段：總已付、債務餘額趨勢、利率、逾期付款風險
6. 查看6 個月債務減少圖表（如果有超過 1 個月的資料）

5. 範例與介面說明

5.1 REPORT-01：查看財務健康概覽和趨勢預測

目標：查看當月的財務概覽，包括儲蓄進度、淨現金流、預算剩餘和月底預測。

步驟：

1. 前往底部導航中的報告標籤
2. 查看財務健康區段：
   • 儲蓄目標：18,000 TWD（收入的 20%）
   • 實際儲蓄：12,600 TWD
   • 進度條：70% - 達成水準：中等
   • 淨現金流：+8,400 TWD [正向] 帶有詳細公式
   • 預算剩餘：18,600 TWD [穩定]（62% 預算 ≈ 60% 時間）
   • 支出速度：比上月高 12%
   • 貸款義務：12,600 TWD [已付]
   • 前 5 大類別：飲食（32%）、購物（25%）、娛樂（18%）、交通（15%）、其他（10%）
3. 查看未來趨勢預測區段：
   • 月底預期剩餘：+6,900 TWD [盈餘] 帶有詳細公式
   • 目標達成機率：82% [接近達成]
   • 即將到來的貸款付款：第 25 天：12,600 TWD [資金充足]

線框圖：

┌──────────────────────┐  ┌──────────────────────┐
│ 🎯 儲蓄目標           │  │ 💾 實際儲蓄           │
│ 18,000 TWD           │  │ 12,600 TWD            │
│ 收入的 20%           │  │                      │
└──────────────────────┘  └──────────────────────┘

[██████████████----------------------] 70%
達成水準：中等

┌────────────────────────────────────────────────────────────┐
│ 淨現金流 = 實際儲蓄                                        │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ +8,400 TWD                      [正向]                  │ │
│ └────────────────────────────────────────────────────────┘ │
│ 淨現金流 = 收入（定期 + 額外）                              │
│                – 支出（定期 + 日常 + 貸款）                 │
└────────────────────────────────────────────────────────────┘

┌────────────────────────────────────────────────────────────┐
│ 📉 預算剩餘                                                │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ 18,600 TWD                      [穩定]                  │ │
│ └────────────────────────────────────────────────────────┘ │
│ • 62% 預算 ≈ 60% 時間 → 支出速度適當                       │
└────────────────────────────────────────────────────────────┘

┌────────────────────────────────────────────────────────────┐
│ 💹 月底預期剩餘                                            │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ 預期：+6,900 TWD             [盈餘]                    │ │
│ └────────────────────────────────────────────────────────┘ │
│ • 預期支出 = (平均每日支出 × 剩餘天數)                     │
│                + (待付固定支出)                            │
└────────────────────────────────────────────────────────────┘

5.2 REPORT-02：查看收入報告

目標：查看本月收入的詳細分析，包括定期收入、額外收入、趨勢和洞察。

步驟：

1. 從報告畫面，點擊「詳細報告」區段中的選單項目 💵 收入
2. 查看本月總實際收入：63,000 TWD
3. 查看定期收入區段：總計 45,000 TWD（已收到：39,000 TWD，尚未收到：6,000 TWD），每個項目的詳細資訊
4. 查看額外收入區段：總計 18,000 TWD（自由工作：9,000 TWD，出售物品：3,000 TWD，小獎金：6,000 TWD），比上月增加 5%
5. 查看3 個月收入趨勢（迷你圖表）
6. 查看每月收入歷史：本月、上月、2 個月前
7. 查看收入分析（洞察）：定期收入百分比、穩定性評估、% 增加/減少

線框圖：參考 wf-bao-cao-thu-nhap.md

5.3 REPORT-03：查看支出報告

目標：查看本月支出的詳細分析，包括定期支出、按類別的日常支出、趨勢和支出激增類別。

步驟：

1. 從報告畫面，點擊「詳細報告」區段中的選單項目 🔥 支出
2. 查看本月總實際支出：54,600 TWD（比上月增加 12%）
3. 查看定期支出區段：總計 25,500 TWD（已付：22,500 TWD，尚未付：3,000 TWD），每個項目的詳細資訊
4. 查看按類別的日常支出區段：飲食 19,500 TWD（36%）、購物 9,000 TWD（16%）、交通 6,300 TWD（12%）、娛樂 4,200 TWD（8%）、其他 3,000 TWD（5%）
5. 查看支出激增區段：飲食（+3,600 TWD，+22%）、購物（+2,400 TWD，+35%）
6. 查看3 個月支出趨勢（迷你圖表）
7. 查看每月支出歷史：本月、上月、2 個月前

線框圖：參考 wf-bao-cao-chi-tieu.md

5.4 REPORT-04：查看預算報告

目標：查看本月的預算概覽，包括預算已支出、剩餘、與計劃的差異和按類別的支出。

步驟：

1. 從報告畫面，點擊「詳細報告」區段中的選單項目 📉 預算
2. 查看本月預算概覽：
   • 每月預算：30,000 TWD（點擊查看計算詳細資訊）
   • 已支出：11,400 TWD（日常支出：7,500 TWD，支出差異：+1,500 TWD，收入差異：-600 TWD）
   • 剩餘：18,600 TWD
   • 進度條：38.0% 帶有動態提示文字
3. 點擊「每月預算」查看帶有公式的預算詳細對話框：預算 = 收入 - 支出
4. 查看與計劃的差異區段：每個收入/支出項目帶有差異、總差異
5. 查看按類別的支出區段：總計、每個類別帶有金額、百分比、進度條
6. 點擊類別查看該類別中的支出清單

線框圖：參考 wf-bao-cao-ngan-sach.md

5.5 REPORT-05：查看儲蓄報告

目標：查看本月儲蓄的詳細分析，包括實際儲蓄、儲蓄分析、儲蓄帳戶清單和趨勢。

步驟：

1. 從報告畫面，點擊「詳細報告」區段中的選單項目 💾 儲蓄
2. 查看本月實際儲蓄：12,600 TWD，帶有詳細的淨現金流公式
3. 查看儲蓄分析區段：儲蓄帳戶佔收入的 20%，比上月增加 12%，月底預測：15,300 TWD（≈目標的 85%）
4. 查看儲蓄帳戶清單區段：3 個帳戶（120,000 TWD、15,000 TWD、60,000 TWD），按最近到期日期排序
5. 查看6 個月儲蓄成長圖表（折線圖）

線框圖：參考 wf-bao-cao-tiet-kiem.md

5.6 REPORT-06：查看貸款報告

目標：查看貸款的詳細分析，包括目前債務餘額、本月貸款成本、付款時間表、洞察和趨勢。

步驟：

1. 從報告畫面，點擊「詳細報告」區段中的選單項目 💸 貸款
2. 查看貸款概覽：目前債務餘額 1,950,000 TWD，本月貸款成本 12,600 TWD（本金：10,500 TWD + 利息：2,100 TWD）
3. 查看最近付款區段：第 25 天 → 已付，下次付款在 14 天後
4. 查看每月付款時間表區段：最近 3 個月，帶有金額和狀態
5. 查看貸款分析（洞察）區段：最近 3 個月已付：37,800 TWD，債務餘額趨勢穩步下降，利息佔付款的 17%，逾期付款風險：低
6. 查看6 個月債務減少圖表（折線圖）

線框圖：參考 wf-bao-cao-khoan-vay.md

5.7 REPORT-07：從概覽報告分析按類別的支出

目標：從概覽報告，點擊「按類別的支出」區段查看詳細的支出報告和更深入的分析。

步驟：

1. 從報告概覽畫面，捲動到按類別的支出區段
2. 查看百分比最高的前 5 大類別
3. 點擊「按類別的支出」卡片（帶有右箭頭圖示）
4. 應用程式自動捲動到同一畫面中的支出報告區段
5. 查看完整詳細資訊：總支出、定期支出、按類別的日常支出（超過前 5 大）、支出激增、趨勢和歷史

線框圖：參考 wf-bao-cao.md -「按類別的支出」區段

5.8 REPORT-08：資料不足時查看報告（第一個月）

目標：新應用程式使用者在第一個月查看報告，此時沒有足夠的資料進行比較和趨勢分析。

步驟：

1. 前往報告標籤
2. 查看財務健康區段：
   • 儲蓄目標和實際儲蓄（如果存在預算）
   • 帶有公式的淨現金流
   • 預算剩餘（如果存在）
   • 不顯示：「支出速度」（沒有上月資料）
3. 查看未來趨勢預測區段（如果預算 > 0）
4. 點擊收入報告：本月總收入、定期和額外收入，不顯示「3 個月趨勢」，歷史中僅顯示「本月」
5. 點擊支出報告：本月總支出、定期和日常支出，不顯示「支出激增」、「3 個月趨勢」，歷史中僅顯示「本月」

線框圖：參考 wf-bao-cao.md - 帶有條件顯示的卡片

6. 邏輯與規則

6.1 淨現金流計算

公式：

淨現金流_月 = 
  (當月實際收到的定期收入 + 當月額外收入)
  - (當月實際支付的定期支出 + 當月日常支出 + 當月實際貸款付款)

詳細資訊：

• 收入：SUM(recurring_income_occurrence.amount_snapshot) WHERE status = ‘COMPLETED’ AND due_date in month + SUM(extra_income.amount) WHERE occurred_at in month
• 支出：SUM(recurring_expense_occurrence.amount_snapshot) WHERE status = ‘COMPLETED’ AND due_date in month + SUM(daily_expense.amount) WHERE occurred_at in month + SUM(bank_debt_payment.total_amount) WHERE due_date in month AND status != ‘CANCELLED’
• 實際儲蓄：max(NetCashflow_month, 0) - 如果淨現金流為正：儲蓄 = 淨現金流，如果淨現金流為負：儲蓄 = 0（超支）

6.2 儲蓄目標達成水準

公式：

ratio = Saving_month / budget.savings_amount
progress% = round(ratio × 100)

閾值：

• 良好：progress% ≥ 90
• 中等：70 ≤ progress% < 90
• 不佳：progress% < 70

6.3 預算剩餘

公式：

• % 預算剩餘 = (預算剩餘 / 總預算) × 100
• % 時間剩餘 = (剩餘天數 / 當月總天數) × 100

結論：

• 如果 % 預算 ≈ % 時間：支出速度合理
• 如果 % 預算 < % 時間：支出快於速度
• 如果 % 預算 > % 時間：支出慢於速度

注意：此卡片僅在已為本月建立預算時顯示。

6.4 月底預測

預期支出：

預期支出 = 
  (平均每日支出 × 當月剩餘天數)
  + 待付定期支出總額_剩餘月份
  + 當月待付銀行貸款付款總額

詳細資訊：

• Avg_Daily_Spending = (從月初到今天的總 daily_expense.amount) / 當月已過天數
• Total_Recurring_Expense_Pending = SUM(recurring_expense_occurrence.amount_snapshot) WHERE status = ‘PENDING’ AND due_date between tomorrow and end of month
• Total_Bank_Debt_Payment_Pending = SUM(bank_debt_payment.total_amount) WHERE due_date between tomorrow and end of month AND status = ‘PENDING’

月底預期剩餘：

月底預期剩餘 = NetCashflow_month - 預期支出

儲蓄目標達成機率：

ratio = 月底預期剩餘 / budget.savings_amount
progress% = round(ratio × 100)

標籤：

• ≥ 90% → 將達成
• 70–89% → 接近達成
• < 70% → 難以達成

注意：預測僅在預算 > 0 時顯示。

6.5 實際資料 vs 計劃

• 所有報告資料使用實際資料：
  • 收入：COMPLETED 發生事件 + extra_income
  • 支出：COMPLETED 發生事件 + daily_expense
  • 貸款付款：due_date 在當月的 bank_debt_payment（無論是否已付）
• 不使用計劃資料（尚未到期的 PENDING 發生事件）

7. 重要注意事項

• 僅當月資料：報告僅顯示當月的資料
• 顯示條件：
  • 「預算剩餘」卡片僅在已為本月建立預算時顯示
  • 「支出速度」卡片僅在有上月資料可供比較時顯示
  • 「貸款義務」卡片僅在存在貸款時顯示
  • 「預算」選單項目僅在已建立預算時顯示
  • 「儲蓄」選單項目僅在存在儲蓄帳戶時顯示
  • 「貸款」選單項目僅在存在貸款時顯示
  • 「未來趨勢預測」區段僅在預算 > 0 時顯示
• 預測僅供參考：基於目前趨勢和待付項目
• 第一個月：由於缺乏比較資料，某些卡片/區段不顯示（例如：「支出速度」、「3 個月趨勢」、「支出激增」）
• 卡片可點擊：點擊卡片會捲動到同一畫面中對應的詳細報告