dramaling-app/scripts/maintenance/check_consistency.sh

#!/bin/bash

# Drama Ling 文檔一致性檢查工具
# 使用方法: ./check_consistency.sh

echo "🔍 Drama Ling 文檔一致性檢查開始..."
echo "=================================================="

# 創建臨時目錄
mkdir -p /tmp/dramaling_check

# 檢查1: UI名稱一致性
echo "📋 1. UI名稱一致性檢查"
echo "----------------------------------------"

# 從system design提取UI (改進的regex)
grep -o '"view_id": "UI_[^"]*"' docs/01_requirement/system_structure_design.json | sed 's/"view_id": "//g' | sed 's/"//g' | sort | uniq > /tmp/dramaling_check/system_uis.txt

# 從user flow提取UI (修正regex以包含數字)
grep -o 'UI_[A-Za-z0-9_]*' docs/04_technical/user-flow-specification.md | sort | uniq > /tmp/dramaling_check/flow_uis.txt

# 驗證提取結果
echo "📝 提取結果驗證:"
echo "   System Design 樣本: $(head -3 /tmp/dramaling_check/system_uis.txt | tr '\n' ' ')"
echo "   User Flow 樣本: $(head -3 /tmp/dramaling_check/flow_uis.txt | tr '\n' ' ')"

# 計算數量
system_ui_count=$(cat /tmp/dramaling_check/system_uis.txt | wc -l)
flow_ui_count=$(cat /tmp/dramaling_check/flow_uis.txt | wc -l)

echo "System Design中的UI數量: $system_ui_count"
echo "User Flow中的UI數量: $flow_ui_count"

# 檢查差異
echo "System Design有但User Flow沒有的UI:"
comm -23 /tmp/dramaling_check/system_uis.txt /tmp/dramaling_check/flow_uis.txt | head -10

echo "User Flow有但System Design沒有的UI:"
comm -13 /tmp/dramaling_check/system_uis.txt /tmp/dramaling_check/flow_uis.txt | head -10

echo ""

# 檢查2: 模組架構一致性
echo "🏗️ 2. 模組架構一致性檢查"
echo "----------------------------------------"

# 檢查requirements.md中的模組數量
req_modules=$(grep -c "### [0-9]\. " docs/01_requirement/requirements.md)
echo "Requirements.md中定義的模組數: $req_modules"

# 檢查system design中的模組數量
sys_modules=$(grep -c '"module_name":' docs/01_requirement/system_structure_design.json)
echo "System Design中的模組數: $sys_modules"

# 檢查模組ID
echo "System Design中的模組ID:"
grep '"module_id":' docs/01_requirement/system_structure_design.json | sed 's/.*"module_id": "//g' | sed 's/".*//g' | sort

echo ""

# 檢查3: 介面數量統計
echo "📊 3. 介面數量統計檢查"
echo "----------------------------------------"

# 從requirements提取宣告的數量
echo "Requirements.md中宣告的介面數量:"
grep -o "([A-Z]* - [0-9]*個介面)" docs/01_requirement/requirements.md

# 實際UI數量
actual_ui_count=$(grep -c '"view_id":' docs/01_requirement/system_structure_design.json)
echo "System Design中實際UI數量: $actual_ui_count"

# 計算宣告的總數
declared_total=$(grep -o "([A-Z]* - [0-9]*個介面)" docs/01_requirement/requirements.md | grep -o "[0-9]*" | awk '{sum+=$1} END {print sum}')
echo "Requirements.md宣告的總數: $declared_total"

if [ "$actual_ui_count" -eq "$declared_total" ]; then
    echo "✅ UI數量一致"
else
    echo "❌ UI數量不一致，差異: $((actual_ui_count - declared_total))"
fi

echo ""

# 檢查4: 功能特性對照
echo "⚙️ 4. 功能特性對照檢查"
echo "----------------------------------------"

# 檢查features數量
feature_count=$(grep -c '"feature_name":' docs/01_requirement/system_structure_design.json)
echo "System Design中的功能特性數量: $feature_count"

# 檢查每個模組的功能分布
echo "各模組功能分布:"
grep -A 2 '"module_id":' docs/01_requirement/system_structure_design.json | grep -o '"MD_[^"]*"' | sort | uniq -c

echo ""

# 檢查5: 資料庫一致性檢查
echo "🗄️ 5. 資料庫架構一致性檢查"
echo "----------------------------------------"

if [ -f "docs/04_technical/database-schema.md" ]; then
    # 檢查data_binding與資料表的對應
    echo "System Design中的data_binding:"
    grep -A 5 '"data_binding":' docs/01_requirement/system_structure_design.json | grep '"[A-Z]' | sed 's/.*"//g' | sed 's/".*//g' | sort | uniq
    
    echo "Database Schema中的資料表:"
    grep -o "CREATE TABLE [a-zA-Z_]*" docs/04_technical/database-schema.md | sed 's/CREATE TABLE //g' | sort
else
    echo "⚠️ database-schema.md 檔案不存在"
fi

echo ""

# 檢查6: API端點一致性
echo "🔗 6. API端點一致性檢查"
echo "----------------------------------------"

if [ -f "docs/04_technical/api-specifications.md" ]; then
    # 檢查API端點數量
    api_count=$(grep -c "### " docs/04_technical/api-specifications.md)
    echo "API規格中的端點數量: $api_count"
    
    # 檢查API模組分布
    echo "API端點分布:"
    grep "### " docs/04_technical/api-specifications.md | head -10
else
    echo "⚠️ api-specifications.md 檔案不存在"
fi

echo ""

# 檢查7: 技術選型一致性
echo "💻 7. 技術選型一致性檢查"
echo "----------------------------------------"

if [ -f "docs/04_technical/tech-stack-decision.md" ]; then
    echo "Tech Stack Decision中提到的主要技術:"
    grep -o "Flutter\|PostgreSQL\|\.NET\|GPT-4\|Docker" docs/04_technical/tech-stack-decision.md | sort | uniq -c
else
    echo "⚠️ tech-stack-decision.md 檔案不存在"
fi

echo ""

# 生成總結報告
echo "📋 一致性檢查總結報告"
echo "=================================================="

# 計算一致性分數
total_checks=7
passed_checks=0

# UI名稱一致性評分
ui_diff=$(comm -3 /tmp/dramaling_check/system_uis.txt /tmp/dramaling_check/flow_uis.txt | wc -l)
if [ "$ui_diff" -lt 10 ]; then
    echo "✅ UI名稱一致性: 良好 (差異少於10個)"
    ((passed_checks++))
else
    echo "⚠️ UI名稱一致性: 需要改進 (差異$ui_diff個)"
fi

# 模組架構一致性評分
if [ "$req_modules" -eq "$sys_modules" ]; then
    echo "✅ 模組架構一致性: 優秀"
    ((passed_checks++))
else
    echo "❌ 模組架構一致性: 不一致"
fi

# 介面數量一致性評分
if [ "$actual_ui_count" -eq "$declared_total" ] 2>/dev/null; then
    echo "✅ 介面數量一致性: 完美匹配"
    ((passed_checks++))
else
    echo "⚠️ 介面數量一致性: 有差異"
fi

# 功能特性一致性評分（假設合理）
if [ "$feature_count" -gt 15 ]; then
    echo "✅ 功能特性定義: 豐富完整"
    ((passed_checks++))
else
    echo "⚠️ 功能特性定義: 可能不足"
fi

# 其他檢查項目的簡化評分
echo "✅ 資料庫架構檢查: 已執行"
((passed_checks++))
echo "✅ API端點檢查: 已執行"
((passed_checks++))
echo "✅ 技術選型檢查: 已執行"
((passed_checks++))

# 計算總分
score=$(echo "scale=1; $passed_checks * 10 / $total_checks" | bc -l)
echo ""
echo "🏆 總體一致性評分: $score/10"

if (( $(echo "$score >= 8" | bc -l) )); then
    echo "🎉 評級: 優秀 - 可以開始開發！"
elif (( $(echo "$score >= 6" | bc -l) )); then
    echo "👍 評級: 良好 - 建議修正部分問題後開發"
else
    echo "⚠️ 評級: 需要改進 - 建議先解決一致性問題"
fi

echo ""
echo "📝 建議執行以下操作："
echo "1. 檢查並統一UI命名"
echo "2. 確認模組架構定義"
echo "3. 驗證介面數量統計"
echo "4. 完善功能特性描述"
echo "5. 定期執行此檢查工具"

# 清理臨時文件
rm -rf /tmp/dramaling_check

echo ""
echo "✅ 檢查完成！詳細報告已生成。"