768 lines
27 KiB
Markdown
768 lines
27 KiB
Markdown
# Pivot Module 執行計劃
|
||
|
||
## 概述
|
||
建立多頁籤數據透視查詢模組，參考 transfer 模組的設計架構，使用相同的技術棧與 UI/UX 模式，實現法會報名資料的多維度分析與展示。
|
||
|
||
---
|
||
|
||
## 技術架構
|
||
|
||
### 前端技術
|
||
- **框架**: Vue.js 2.x + Vuetify 2.x（與 transfer 模組一致）
|
||
- **表格元件**: v-data-table（Vuetify 內建表格元件）
|
||
- **頁籤元件**: v-tabs / v-tab / v-tab-item（Vuetify 頁籤）
|
||
- **UI 框架**: Bootstrap 5 + Bootstrap Icons（MasterPage）
|
||
- **樣式**: 與 transfer 模組保持一致的視覺風格
|
||
|
||
### 後端 API
|
||
- **框架**: ASP.NET Web API（C#）
|
||
- **ORM**: Entity Framework + LINQ
|
||
- **控制器**: `App_Code/api/pivotController.cs`（已建立）
|
||
- **資料庫視圖**: `報名明細查詢`（SQL View）
|
||
|
||
### 資料流架構（重要）★
|
||
```
|
||
查詢流程:
|
||
┌─────────────┐
|
||
│ Tab 1 │ → 選擇法會 → API 查詢一次 →
|
||
│ 查詢條件 │ (完整資料集)
|
||
└─────────────┘
|
||
↓
|
||
┌─────────────────────────────────────────┐
|
||
│ Vue Data (存於前端 this.rawData) │
|
||
│ - 完整報名明細 │
|
||
│ - 一次性載入，不重複查詢 │
|
||
└─────────────────────────────────────────┘
|
||
↓
|
||
┌──────┬──────┬──────┬──────┬──────┐
|
||
│Tab 2 │Tab 3 │Tab 4 │Tab 5 │Tab 6 │
|
||
│明細 │信眾 │收入 │趨勢 │對比 │
|
||
│ │ │ │ │ │
|
||
│ 純前端計算 / 過濾 / 分組 / 統計 │
|
||
│ 使用 computed / methods / filters │
|
||
└──────────────────────────────────────┘
|
||
```
|
||
|
||
**優點**:
|
||
1. ✅ **效能優化**: API 只查詢一次，減少伺服器負載
|
||
2. ✅ **即時響應**: 切換頁籤無延遲，使用者體驗佳
|
||
3. ✅ **離線分析**: 資料載入後可離線操作（過濾、排序、統計）
|
||
4. ✅ **減少流量**: 不重複傳輸相同資料
|
||
5. ✅ **一致性**: 所有頁籤基於同一份資料，確保一致性
|
||
|
||
**技術實現**:
|
||
- `this.rawData`: 原始完整資料（Tab 1 查詢後存入）
|
||
- `computed properties`: 各頁籤的資料來源（動態計算）
|
||
- `methods`: 過濾、分組、統計邏輯
|
||
- `watch`: 監聽過濾條件變化
|
||
|
||
### 元件規格
|
||
1. **日期選擇器**: `v-date-picker` 或 `<input type="date">`
|
||
2. **下拉選單**: `v-select`（年份、月份、法會選擇）
|
||
3. **資料表格**: `v-data-table`（分頁、排序、過濾）
|
||
4. **頁籤切換**: `v-tabs`（Tab 1~N）
|
||
5. **按鈕群組**: `v-btn`（查詢、匯出、重設）
|
||
6. **載入狀態**: `:loading="loading"`
|
||
7. **視覺標記**: Bootstrap Badge（橙、藍、綠、紫色標籤）
|
||
|
||
---
|
||
|
||
## 頁籤設計
|
||
|
||
### Tab 1: 查詢條件設定
|
||
**功能目標**: 提供查詢條件，篩選法會並選擇目標法會
|
||
|
||
#### UI 布局
|
||
```
|
||
+--------------------------------------------------------------+
|
||
| [查詢條件] |
|
||
|--------------------------------------------------------------|
|
||
| 時間範圍: [年份 ▼] [月份 ▼] [查詢法會] |
|
||
|--------------------------------------------------------------|
|
||
| 法會清單: |
|
||
| +----------------------------------------------------------+ |
|
||
| | 序號 | 法會名稱 | 開始日期 | 結束日期 | 報名人數 | 操作 | |
|
||
| +----------------------------------------------------------+ |
|
||
| | 1 | 2025春季法會 | 2025-03-01 | 2025-03-15 | 120 | [選擇] | |
|
||
| | 2 | 2025夏季法會 | 2025-06-01 | 2025-06-20 | 85 | [選擇] | |
|
||
| +----------------------------------------------------------+ |
|
||
+--------------------------------------------------------------+
|
||
```
|
||
|
||
#### 查詢流程
|
||
1. 選擇年份（2020~2025）或月份（1~12）
|
||
2. 點擊「查詢法會」按鈕
|
||
3. API 回傳該期間的法會清單（`api/pivot/activity_stats`）
|
||
4. 表格呈現法會清單（法會名稱、日期、統計）
|
||
5. 點擊「選擇」按鈕，載入該法會的詳細資料
|
||
6. 自動切換到 Tab 2（詳細資料頁籤）
|
||
|
||
#### API 整合
|
||
- **端點**: `GET api/pivot/activity_stats?startDate={start}&endDate={end}`
|
||
- **回傳**: 法會清單（含報名統計）
|
||
|
||
#### 資料查詢策略
|
||
```javascript
|
||
// 選擇法會後，一次性載入完整資料
|
||
selectActivity(item) {
|
||
this.loading = true;
|
||
this.selectedActivity = item;
|
||
|
||
// 一次性查詢完整報名明細（不分頁）
|
||
axios.get('/api/pivot/registration_details', {
|
||
params: {
|
||
activityNum: item.法會ID,
|
||
pageSize: 9999 // 取得全部資料
|
||
}
|
||
}).then(response => {
|
||
// 存入原始資料（供所有頁籤使用）
|
||
this.rawData = response.data.data.list;
|
||
|
||
// 自動切換到 Tab 2
|
||
this.activeTab = 1;
|
||
this.loading = false;
|
||
});
|
||
}
|
||
```
|
||
|
||
#### 元件範例
|
||
```html
|
||
<v-select
|
||
:items="yearOptions"
|
||
v-model="selectedYear"
|
||
label="年份"
|
||
dense
|
||
outlined
|
||
></v-select>
|
||
<v-select
|
||
:items="monthOptions"
|
||
v-model="selectedMonth"
|
||
label="月份"
|
||
dense
|
||
outlined
|
||
clearable
|
||
></v-select>
|
||
<v-btn color="primary" @click="loadActivities">查詢法會</v-btn>
|
||
|
||
<v-data-table
|
||
:headers="activityHeaders"
|
||
:items="activities"
|
||
:loading="loading"
|
||
item-key="法會ID"
|
||
>
|
||
<template v-slot:item.actions="{ item }">
|
||
<v-btn small color="success" @click="selectActivity(item)">選擇</v-btn>
|
||
</template>
|
||
</v-data-table>
|
||
```
|
||
|
||
---
|
||
|
||
### Tab 2: 報名明細資料
|
||
**功能目標**: 完整呈現該場法會的所有報名明細
|
||
|
||
#### UI 布局
|
||
```
|
||
+--------------------------------------------------------------+
|
||
| [報名明細] 法會: 2025春季法會 (2025-03-01 ~ 2025-03-15) |
|
||
|--------------------------------------------------------------|
|
||
| 過濾: [信眾姓名] [功德類型 ▼] [狀態 ▼] [查詢] [匯出Excel] |
|
||
|--------------------------------------------------------------|
|
||
| +----------------------------------------------------------+ |
|
||
| | 報名編號 | 報名日期 | 信眾姓名 | 功德名稱 | 數量 | 金額 | |
|
||
| +----------------------------------------------------------+ |
|
||
| | 20250301001 | 2025-03-01 | 張三 | 點燈 | 1 | 500 | |
|
||
| | 20250301002 | 2025-03-01 | 李四 | 安太歲 | 1 | 300 | |
|
||
| +----------------------------------------------------------+ |
|
||
| 第 1 頁，共 10 頁（共 200 筆） |
|
||
+--------------------------------------------------------------+
|
||
```
|
||
|
||
#### 功能特性
|
||
1. **欄位顯示**: 報名編號、報名日期、信眾姓名、功德名稱、數量、金額、已收、未收
|
||
2. **過濾條件**: 信眾姓名（模糊搜尋）、功德類型（下拉選單）、功德主（是/否）
|
||
3. **排序**: 可依任意欄位排序（升序/降序）
|
||
4. **分頁**: 預設每頁 50 筆，可調整（10/20/50/100）
|
||
5. **匯出**: 匯出 Excel/CSV
|
||
|
||
#### 欄位色彩標記（參考 Excel 視圖）
|
||
- **橙色（法會資料）**: 法會ID、法會名稱、開始日期、結束日期
|
||
- **藍色（信眾資料）**: 信眾編號、信眾姓名
|
||
- **綠色（功德資訊）**: 報名編號、報名日期、功德主、功德類型、功德名稱
|
||
- **紫色（計算欄位）**: 數量、金額、已收、未收
|
||
|
||
使用 Bootstrap Badge 或背景色區隔：
|
||
```html
|
||
<span class="badge bg-warning text-dark">法會</span>
|
||
<span class="badge bg-info">信眾</span>
|
||
<span class="badge bg-success">功德</span>
|
||
<span class="badge bg-secondary">計算</span>
|
||
```
|
||
|
||
#### 資料來源（前端計算）
|
||
```javascript
|
||
computed: {
|
||
// Tab 2: 報名明細（前端分頁、過濾）
|
||
filteredRegistrations() {
|
||
let data = this.rawData;
|
||
|
||
// 過濾：信眾姓名
|
||
if (this.filter.followerName) {
|
||
data = data.filter(x => x.信眾姓名.includes(this.filter.followerName));
|
||
}
|
||
|
||
// 過濾：功德類型
|
||
if (this.filter.itemKind) {
|
||
data = data.filter(x => x.功德類型 === this.filter.itemKind);
|
||
}
|
||
|
||
// 過濾：功德主
|
||
if (this.filter.isParent !== null) {
|
||
data = data.filter(x => x.功德主 === (this.filter.isParent ? '是' : '否'));
|
||
}
|
||
|
||
return data;
|
||
},
|
||
|
||
// 前端分頁
|
||
paginatedRegistrations() {
|
||
const start = (this.currentPage - 1) * this.pageSize;
|
||
const end = start + this.pageSize;
|
||
return this.filteredRegistrations.slice(start, end);
|
||
}
|
||
}
|
||
```
|
||
|
||
#### 元件範例
|
||
```html
|
||
<v-data-table
|
||
:headers="detailHeaders"
|
||
:items="registrations"
|
||
:loading="loading"
|
||
:server-items-length="totalCount"
|
||
:options.sync="options"
|
||
item-key="報名編號"
|
||
class="elevation-1"
|
||
>
|
||
<template v-slot:item.信眾姓名="{ item }">
|
||
<span class="badge bg-info me-1">信</span>{{ item.信眾姓名 }}
|
||
</template>
|
||
<template v-slot:item.金額="{ item }">
|
||
<span class="badge bg-secondary me-1">計</span>{{ item.金額 | currency }}
|
||
</template>
|
||
</v-data-table>
|
||
```
|
||
|
||
---
|
||
|
||
### Tab 3: 信眾參與分析
|
||
**功能目標**: 統計信眾的參與情況（參與次數、金額、最近參與）
|
||
|
||
#### UI 布局
|
||
```
|
||
+--------------------------------------------------------------+
|
||
| [信眾參與分析] |
|
||
|--------------------------------------------------------------|
|
||
| 過濾: [信眾編號] [參與次數 ≥] [總金額 ≥] [查詢] |
|
||
|--------------------------------------------------------------|
|
||
| +----------------------------------------------------------+ |
|
||
| | 信眾編號 | 姓名 | 參與次數 | 總金額 | 最近參與日期 | |
|
||
| +----------------------------------------------------------+ |
|
||
| | F001 | 張三 | 5 | 2500 | 2025-03-01 | |
|
||
| | F002 | 李四 | 3 | 1500 | 2025-02-15 | |
|
||
| +----------------------------------------------------------+ |
|
||
+--------------------------------------------------------------+
|
||
```
|
||
|
||
#### 功能特性
|
||
1. **統計欄位**: 參與次數、總金額、平均金額、最近參與日期
|
||
2. **過濾條件**: 信眾編號、參與次數閾值、總金額閾值
|
||
3. **排序**: 預設依參與次數降序
|
||
4. **分頁**: 預設每頁 50 筆
|
||
|
||
#### 資料來源（前端計算）
|
||
```javascript
|
||
computed: {
|
||
// Tab 3: 信眾參與分析（從 rawData 計算）
|
||
followerAnalysis() {
|
||
const followerMap = {};
|
||
|
||
this.rawData.forEach(item => {
|
||
const fNum = item.信眾編號;
|
||
if (!followerMap[fNum]) {
|
||
followerMap[fNum] = {
|
||
信眾編號: fNum,
|
||
姓名: item.信眾姓名,
|
||
參與次數: 0,
|
||
總金額: 0,
|
||
最近參與日期: item.報名日期
|
||
};
|
||
}
|
||
|
||
followerMap[fNum].參與次數++;
|
||
followerMap[fNum].總金額 += (item.金額 * item.數量);
|
||
|
||
// 更新最近參與日期
|
||
if (new Date(item.報名日期) > new Date(followerMap[fNum].最近參與日期)) {
|
||
followerMap[fNum].最近參與日期 = item.報名日期;
|
||
}
|
||
});
|
||
|
||
// 轉換為陣列，並計算平均金額
|
||
return Object.values(followerMap).map(f => ({
|
||
...f,
|
||
平均金額: Math.round(f.總金額 / f.參與次數)
|
||
})).sort((a, b) => b.參與次數 - a.參與次數); // 依參與次數降序
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### Tab 4: 收入統計分析
|
||
**功能目標**: 依時間、法會、功德類型統計收入
|
||
|
||
#### UI 布局
|
||
```
|
||
+--------------------------------------------------------------+
|
||
| [收入統計分析] |
|
||
|--------------------------------------------------------------|
|
||
| 分組方式: ( ) 月份 ( ) 年度 (•) 法會 ( ) 功德類型 |
|
||
|--------------------------------------------------------------|
|
||
| +----------------------------------------------------------+ |
|
||
| | 分組名稱 | 報名人數 | 總金額 | 已收 | 未收 | 收款率 | |
|
||
| +----------------------------------------------------------+ |
|
||
| | 2025春季法會 | 120 | 60000 | 50000 | 10000 | 83.3% | |
|
||
| | 2025夏季法會 | 85 | 45000 | 40000 | 5000 | 88.9% | |
|
||
| +----------------------------------------------------------+ |
|
||
+--------------------------------------------------------------+
|
||
```
|
||
|
||
#### 功能特性
|
||
1. **分組方式**: 月份、年度、法會、功德類型
|
||
2. **統計欄位**: 報名人數、總金額、已收、未收、收款率
|
||
3. **圖表呈現**: 可加入 CanvasJS 長條圖/圓餅圖（選配）
|
||
4. **匯出**: 支援 Excel/CSV
|
||
|
||
#### 資料來源（前端計算）
|
||
```javascript
|
||
computed: {
|
||
// Tab 4: 收入統計分析（從 rawData 計算）
|
||
incomeStats() {
|
||
const statsMap = {};
|
||
const groupBy = this.groupBy; // 'monthly', 'yearly', 'activity', 'itemKind'
|
||
|
||
this.rawData.forEach(item => {
|
||
let key;
|
||
switch(groupBy) {
|
||
case 'monthly':
|
||
key = item.報名日期.substring(0, 7); // YYYY-MM
|
||
break;
|
||
case 'yearly':
|
||
key = item.報名日期.substring(0, 4); // YYYY
|
||
break;
|
||
case 'activity':
|
||
key = item.法會名稱;
|
||
break;
|
||
case 'itemKind':
|
||
key = item.功德類型;
|
||
break;
|
||
}
|
||
|
||
if (!statsMap[key]) {
|
||
statsMap[key] = {
|
||
分組名稱: key,
|
||
報名人數: 0,
|
||
總金額: 0,
|
||
已收: 0,
|
||
未收: 0
|
||
};
|
||
}
|
||
|
||
statsMap[key].報名人數++;
|
||
const amount = item.金額 * item.數量;
|
||
statsMap[key].總金額 += amount;
|
||
statsMap[key].已收 += item.已收 || 0;
|
||
statsMap[key].未收 += item.未收 || amount;
|
||
});
|
||
|
||
// 計算收款率
|
||
return Object.values(statsMap).map(s => ({
|
||
...s,
|
||
收款率: s.總金額 > 0 ? ((s.已收 / s.總金額) * 100).toFixed(1) + '%' : '0%'
|
||
}));
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### Tab 5: 趨勢分析
|
||
**功能目標**: 顯示時間序列趨勢（收入、參與人數、法會數量）
|
||
|
||
#### UI 布局
|
||
```
|
||
+--------------------------------------------------------------+
|
||
| [趨勢分析] |
|
||
|--------------------------------------------------------------|
|
||
| 指標: ( ) 收入 (•) 參與人數 ( ) 法會數量 |
|
||
| 時間間隔: ( ) 月份 (•) 季度 ( ) 年度 |
|
||
|--------------------------------------------------------------|
|
||
| [折線圖] |
|
||
| |
|
||
| +----------------------------------------------------------+ |
|
||
| | 時間 | 數值 | 成長率 | |
|
||
| +----------------------------------------------------------+ |
|
||
| | 2025-01 | 120 | +10% | |
|
||
| | 2025-02 | 132 | +10% | |
|
||
| +----------------------------------------------------------+ |
|
||
+--------------------------------------------------------------+
|
||
```
|
||
|
||
#### 功能特性
|
||
1. **指標選擇**: 收入、參與人數、法會數量
|
||
2. **時間間隔**: 月份、季度、年度
|
||
3. **成長率計算**: 較前期成長率
|
||
4. **圖表**: CanvasJS 折線圖（選配）
|
||
|
||
#### 資料來源（前端計算）
|
||
```javascript
|
||
computed: {
|
||
// Tab 5: 趨勢分析（從 rawData 計算）
|
||
trendAnalysis() {
|
||
const metric = this.trendMetric; // 'income', 'followers', 'count'
|
||
const interval = this.trendInterval; // 'monthly', 'quarterly', 'yearly'
|
||
const trendMap = {};
|
||
|
||
this.rawData.forEach(item => {
|
||
let key;
|
||
switch(interval) {
|
||
case 'monthly':
|
||
key = item.報名日期.substring(0, 7); // YYYY-MM
|
||
break;
|
||
case 'quarterly':
|
||
const month = parseInt(item.報名日期.substring(5, 7));
|
||
const quarter = Math.ceil(month / 3);
|
||
key = `${item.報名日期.substring(0, 4)}-Q${quarter}`;
|
||
break;
|
||
case 'yearly':
|
||
key = item.報名日期.substring(0, 4); // YYYY
|
||
break;
|
||
}
|
||
|
||
if (!trendMap[key]) {
|
||
trendMap[key] = { 時間: key, 收入: 0, 人數: 0, 次數: 0 };
|
||
}
|
||
|
||
trendMap[key].收入 += (item.金額 * item.數量);
|
||
trendMap[key].人數++; // 簡化計算，實際可用 Set 去重
|
||
trendMap[key].次數++;
|
||
});
|
||
|
||
// 轉換為陣列並排序
|
||
const result = Object.values(trendMap).sort((a, b) => a.時間.localeCompare(b.時間));
|
||
|
||
// 計算成長率
|
||
return result.map((item, index) => {
|
||
if (index === 0) {
|
||
return { ...item, 數值: item[metric === 'income' ? '收入' : metric === 'followers' ? '人數' : '次數'], 成長率: '-' };
|
||
}
|
||
const prev = result[index - 1];
|
||
const currentValue = item[metric === 'income' ? '收入' : metric === 'followers' ? '人數' : '次數'];
|
||
const prevValue = prev[metric === 'income' ? '收入' : metric === 'followers' ? '人數' : '次數'];
|
||
const growthRate = prevValue > 0 ? (((currentValue - prevValue) / prevValue) * 100).toFixed(1) : '0';
|
||
return { ...item, 數值: currentValue, 成長率: growthRate + '%' };
|
||
});
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### Tab 6: 對比分析（選配）
|
||
**功能目標**: 不同時期、法會的對比分析
|
||
|
||
#### UI 布局
|
||
```
|
||
+--------------------------------------------------------------+
|
||
| [對比分析] |
|
||
|--------------------------------------------------------------|
|
||
| 對比類型: (•) 法會對比 ( ) 年度對比 |
|
||
| 期間1: [2025春季法會 ▼] 期間2: [2024春季法會 ▼] |
|
||
|--------------------------------------------------------------|
|
||
| +----------------------------------------------------------+ |
|
||
| | 指標 | 期間1 | 期間2 | 差異 | 差異率 | |
|
||
| +----------------------------------------------------------+ |
|
||
| | 報名人數 | 120 | 100 | +20 | +20% | |
|
||
| | 總金額 | 60000 | 50000 | +10000 | +20% | |
|
||
| +----------------------------------------------------------+ |
|
||
+--------------------------------------------------------------+
|
||
```
|
||
|
||
#### 資料來源（前端計算）
|
||
```javascript
|
||
computed: {
|
||
// Tab 6: 對比分析（從 rawData 計算）
|
||
// 注意：對比分析可能需要跨法會資料，如需要可額外查詢
|
||
comparativeAnalysis() {
|
||
// 如果只在單一法會內對比（如月份對比），可用 rawData
|
||
// 如果需要跨法會對比，建議另外查詢或在 Tab 1 時一併載入多場法會資料
|
||
const period1Data = this.rawData.filter(x => {
|
||
// 依 period1 條件過濾
|
||
return this.isPeriod1(x);
|
||
});
|
||
|
||
const period2Data = this.rawData.filter(x => {
|
||
// 依 period2 條件過濾
|
||
return this.isPeriod2(x);
|
||
});
|
||
|
||
const stats1 = this.calculateStats(period1Data);
|
||
const stats2 = this.calculateStats(period2Data);
|
||
|
||
return [
|
||
{ 指標: '報名人數', 期間1: stats1.count, 期間2: stats2.count, 差異: stats1.count - stats2.count },
|
||
{ 指標: '總金額', 期間1: stats1.amount, 期間2: stats2.amount, 差異: stats1.amount - stats2.amount },
|
||
// ... 其他指標
|
||
];
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 視覺設計規範
|
||
|
||
### 色彩系統（參考 transfer）
|
||
- **主色調**: Bootstrap 5 預設配色
|
||
- **成功/確認**: `bg-success` / `text-success`
|
||
- **警告**: `bg-warning` / `text-warning`
|
||
- **危險/錯誤**: `bg-danger` / `text-danger`
|
||
- **資訊**: `bg-info` / `text-info`
|
||
- **次要**: `bg-secondary` / `text-muted`
|
||
|
||
### 欄位色彩標記（對應 Excel）
|
||
```html
|
||
<!-- 橙色：法會資料 -->
|
||
<span class="badge bg-warning text-dark">法</span>
|
||
|
||
<!-- 藍色：信眾資料 -->
|
||
<span class="badge bg-info">信</span>
|
||
|
||
<!-- 綠色：功德資訊 -->
|
||
<span class="badge bg-success">功德</span>
|
||
|
||
<!-- 紫色：計算欄位 -->
|
||
<span class="badge bg-secondary">計</span>
|
||
```
|
||
|
||
### 表格樣式
|
||
```css
|
||
/* 與 transfer 保持一致 */
|
||
.v-data-table th {
|
||
background-color: #f5f5f5 !important;
|
||
font-weight: bold;
|
||
}
|
||
|
||
.v-data-table tbody tr:hover {
|
||
background-color: #f0f8ff !important;
|
||
}
|
||
|
||
/* 欄位色彩標記 */
|
||
.field-activity { border-left: 3px solid #ffc107; } /* 橙 */
|
||
.field-follower { border-left: 3px solid #17a2b8; } /* 藍 */
|
||
.field-merit { border-left: 3px solid #28a745; } /* 綠 */
|
||
.field-calculated { border-left: 3px solid #6c757d; } /* 紫 */
|
||
```
|
||
|
||
---
|
||
|
||
## API 端點總覽
|
||
|
||
| 端點 | 方法 | 功能 | 對應頁籤 | 使用時機 |
|
||
|------|------|------|----------|----------|
|
||
| `/api/pivot/activity_stats` | GET | 查詢法會清單與統計 | Tab 1 | 選擇查詢條件時 |
|
||
| `/api/pivot/registration_details` | GET | 報名明細查詢（**完整資料**） | Tab 1 | **選擇法會後一次性載入** ★ |
|
||
| `/api/pivot/registration_details_export` | GET | 報名明細匯出 | Tab 2 | 匯出 Excel 時（選配） |
|
||
| `/api/pivot/excel_data_structured` | GET | Excel 數據連接 | 外部 | Power Query/Power Pivot |
|
||
|
||
**重要說明**:
|
||
- ✅ **Tab 2~6 不呼叫 API**，全部使用前端 `computed` 計算
|
||
- ✅ `registration_details` 查詢時使用 `pageSize=9999` 取得完整資料
|
||
- ✅ 原 `follower_analysis`, `income_stats`, `trend_analysis`, `comparative_analysis` 端點**保留備用**，但前端優先使用 computed
|
||
- ✅ 如資料量過大（>5000 筆），可調整策略改用分頁查詢
|
||
|
||
---
|
||
|
||
## 檔案結構
|
||
|
||
```
|
||
admin/pivot/
|
||
├── index.aspx # 首頁（已完成）
|
||
├── index.aspx.cs # 首頁邏輯（已完成）
|
||
├── query.aspx # 多頁籤查詢頁面（待建立）★
|
||
├── query.aspx.cs # 查詢頁面邏輯（待建立）★
|
||
└── README.md # 本文件
|
||
|
||
App_Code/api/
|
||
└── pivotController.cs # API 控制器（已完成）
|
||
```
|
||
|
||
---
|
||
|
||
## 實作步驟
|
||
|
||
### Phase 1: 建立查詢頁面骨架
|
||
1. ✅ 建立 `query.aspx`（參考 transfer/verify.aspx）
|
||
2. ✅ 建立 `query.aspx.cs`（參考 transfer/verify.aspx.cs）
|
||
3. ✅ 引入 Vue.js + Vuetify
|
||
4. ✅ 建立頁籤結構（v-tabs）
|
||
|
||
### Phase 2: 實作 Tab 1（查詢條件）
|
||
1. ✅ 年份/月份選擇器
|
||
2. ✅ 查詢法會按鈕與 API 整合（`activity_stats`）
|
||
3. ✅ 法會清單表格（v-data-table）
|
||
4. ✅ 選擇法會邏輯（一次性載入完整資料）
|
||
5. ✅ `this.rawData` 資料結構設計
|
||
|
||
### Phase 3: 實作 Tab 2（報名明細）
|
||
1. ✅ 報名明細表格（前端分頁、排序、過濾）
|
||
2. ✅ `computed: filteredRegistrations` 實作
|
||
3. ✅ 欄位色彩標記（badge）
|
||
4. ✅ 匯出功能（選配）
|
||
|
||
### Phase 4: 實作 Tab 3~6（分析頁籤）
|
||
1. ✅ 信眾參與分析（Tab 3）- `computed: followerAnalysis`
|
||
2. ✅ 收入統計分析（Tab 4）- `computed: incomeStats`
|
||
3. ✅ 趨勢分析（Tab 5）- `computed: trendAnalysis`
|
||
4. ✅ 對比分析（Tab 6，選配）- `computed: comparativeAnalysis`
|
||
|
||
### Phase 5: 優化與測試
|
||
1. ✅ UI/UX 調整（與 transfer 保持一致）
|
||
2. ✅ 效能優化（分頁、快取）
|
||
3. ✅ 瀏覽器相容性測試
|
||
4. ✅ 權限控制（ezAuthorize）
|
||
|
||
---
|
||
|
||
## 參考範例
|
||
|
||
### 1. transfer/verify.aspx
|
||
- 多階段流程設計（程序1、程序2）
|
||
- v-data-table 表格元件使用
|
||
- 信眾選擇對話框（v-dialog）
|
||
- 狀態選擇（v-select）
|
||
|
||
### 2. transfer/verify1.aspx
|
||
- 單階段流程設計
|
||
- 簡潔的查詢與確認流程
|
||
|
||
### 3. transfer/index.aspx
|
||
- 功能入口頁面設計
|
||
- Bootstrap Icons + Badge
|
||
- 三欄式布局
|
||
|
||
---
|
||
|
||
## 注意事項
|
||
|
||
1. **元件一致性**: 所有元件、樣式、命名均與 transfer 模組保持一致
|
||
2. **API 規範**: 遵循 RESTful 設計，統一回傳格式
|
||
3. **權限控制**: 所有 API 加上 `[ezAuthorize]`
|
||
4. **效能考量**:
|
||
- ✅ **前端計算策略**: Tab 1 查詢一次，Tab 2~6 使用 Vue computed 計算
|
||
- ✅ **資料量控制**: 單一法會報名明細預估 <5000 筆，適合前端處理
|
||
- ⚠️ **大資料處理**: 若單場法會 >5000 筆，可改用 API 分頁查詢
|
||
- ✅ **記憶體管理**: 切換法會時清除舊資料（`this.rawData = []`）
|
||
5. **視覺區隔**: 使用 Badge、邊框色、背景色標記欄位類型
|
||
6. **使用者體驗**: 載入狀態（loading）、錯誤提示（alert）、空資料提示
|
||
7. **前端效能優化**:
|
||
- 使用 `computed` 而非 `methods`（自動快取）
|
||
- 大型陣列操作使用 `Object.freeze()` 凍結原始資料
|
||
- v-data-table 啟用虛擬滾動（`:virtual-scroll="true"`，資料量 >1000 時）
|
||
|
||
---
|
||
|
||
## SQL View 參考
|
||
|
||
```SQL
|
||
CREATE VIEW [dbo].[報名明細查詢]
|
||
AS
|
||
SELECT dbo.activity.num AS 法會ID, dbo.activity.subject AS 法會名稱, dbo.activity.startDate_solar AS 開始日期, dbo.activity.endDate_solar AS 結束日期,
|
||
dbo.followers.f_number AS 信眾編號, dbo.followers.u_name AS 信眾姓名, dbo.pro_order.order_no AS 報名編號, dbo.pro_order.up_time AS 報名日期,
|
||
CASE WHEN parent_num IS NOT NULL THEN '是' ELSE '否' END AS 功德主, dbo.actItem_kind.kind AS 功德類型, dbo.actItem.subject AS 功德名稱,
|
||
dbo.pro_order_detail.qty AS 數量, dbo.pro_order_detail.price AS 金額, 0 AS 已收, dbo.pro_order_detail.price * dbo.pro_order_detail.qty - 0 AS 未收
|
||
FROM dbo.pro_order_detail INNER JOIN
|
||
dbo.pro_order ON dbo.pro_order_detail.order_no = dbo.pro_order.order_no INNER JOIN
|
||
dbo.actItem ON dbo.pro_order_detail.actItem_num = dbo.actItem.num INNER JOIN
|
||
dbo.activity ON dbo.pro_order.activity_num = dbo.activity.num INNER JOIN
|
||
dbo.followers ON dbo.pro_order.f_num = dbo.followers.num INNER JOIN
|
||
dbo.actItem_kind ON dbo.actItem.kind = dbo.actItem_kind.num
|
||
GO
|
||
```
|
||
|
||
---
|
||
|
||
## 資料結構範例
|
||
|
||
```javascript
|
||
// Vue data 結構
|
||
data() {
|
||
return {
|
||
// 原始完整資料（Tab 1 查詢後存入，供所有頁籤使用）
|
||
rawData: [], // Array<報名明細物件>
|
||
|
||
// 選中的法會
|
||
selectedActivity: null,
|
||
|
||
// 當前頁籤索引
|
||
activeTab: 0, // 0=Tab1, 1=Tab2, 2=Tab3...
|
||
|
||
// Tab 2 過濾條件
|
||
filter: {
|
||
followerName: '',
|
||
itemKind: null,
|
||
isParent: null
|
||
},
|
||
|
||
// Tab 4 分組方式
|
||
groupBy: 'activity', // 'monthly', 'yearly', 'activity', 'itemKind'
|
||
|
||
// Tab 5 趨勢設定
|
||
trendMetric: 'income', // 'income', 'followers', 'count'
|
||
trendInterval: 'monthly', // 'monthly', 'quarterly', 'yearly'
|
||
|
||
// 載入狀態
|
||
loading: false
|
||
}
|
||
}
|
||
```
|
||
|
||
## Vue Computed 效能考量
|
||
|
||
```javascript
|
||
computed: {
|
||
// 使用 Object.freeze() 凍結大型陣列，提升效能
|
||
frozenRawData() {
|
||
return Object.freeze(this.rawData);
|
||
},
|
||
|
||
// 各頁籤 computed 基於 frozenRawData
|
||
filteredRegistrations() {
|
||
return this.frozenRawData.filter(/* 過濾邏輯 */);
|
||
}
|
||
}
|
||
```
|
||
|
||
## 執行確認
|
||
|
||
請檢視以上計劃，確認以下事項：
|
||
|
||
1. ✅ 頁籤設計（Tab 1~6）符合需求
|
||
2. ✅ 查詢流程（年/月 → 法會清單 → 明細資料）清晰
|
||
3. ✅ 視覺區隔（色彩標記、Badge）符合 Excel 概念
|
||
4. ✅ 技術架構（Vue + Vuetify + API）與 transfer 一致
|
||
5. ✅ 功能完整性（查詢、過濾、排序、匯出）
|
||
6. ✅ **資料流架構（一次查詢 + 前端計算）**合理且高效 ★
|
||
|
||
**確認後即開始實作 Phase 1（建立查詢頁面骨架）。** |