FR-049 問卷流程規則（跳題）+ 子題 Designer 接線 Implementation Plan

non_translatable_fields = [
    field.key for field in mapper.column_attrs
    if field not in self._translatable_fields   # BUG：field 是 ColumnProperty 物件，
                                                   # self._translatable_fields 是字串 list，
                                                   # 兩者永遠不相等（正確寫法應為 field.key not in ...）
       and hasattr(model_instance, field.key)
       and field.key not in update_exclude_fields
]

jedi-survey = { path = "/Users/chouraymond/Projects/Jedicogy/module/jedi-python-package/jedi-survey", develop = true }

python3 -c "import jedi_survey; print(jedi_survey.__file__)"

def test_add_question_rejects_goto_on_non_radio_type(survey_question_domain_service, mock_survey_question_repo, mock_survey_page_repo):
    """非單選題帶 goto_question_uid 應被拒絕"""
    mock_survey_page_repo.get_by_id.return_value = SurveyPageEntity(id=1, survey_id=1, name="p1")
    mock_survey_question_repo.get_all_by_fields.return_value = []
    entity = SurveyQuestionEntity(
        page_id=1, no="Q1", question="測試", type="checkbox",
        options=[{"name": "A", "goto_question_uid": "some-uid"}],
    )
    with pytest.raises(ConflictError):
        survey_question_domain_service.add_question(entity, locale="zh_Hant_TW")


def test_add_question_rejects_self_reference(survey_question_domain_service, mock_survey_question_repo, mock_survey_page_repo):
    """goto_question_uid 指向自己應被拒絕"""
    mock_survey_page_repo.get_by_id.return_value = SurveyPageEntity(id=1, survey_id=1, name="p1")
    mock_survey_question_repo.get_all_by_fields.return_value = []
    entity = SurveyQuestionEntity(
        page_id=1, no="Q1", question="測試", type="radio", uid="self-uid",
        options=[{"name": "A", "goto_question_uid": "self-uid"}],
    )
    with pytest.raises(ConflictError):
        survey_question_domain_service.add_question(entity, locale="zh_Hant_TW")


def test_add_question_rejects_cross_survey_target(survey_question_domain_service, mock_survey_question_repo, mock_survey_page_repo):
    """goto_question_uid 指向其他問卷的題目應被拒絕（review 補強：避免規則存進去但填答不生效）"""
    mock_survey_page_repo.get_by_id.return_value = SurveyPageEntity(id=1, survey_id=10, name="p1")
    mock_survey_question_repo.get_all_by_fields.return_value = []
    mock_survey_question_repo.get_by_uid.return_value = SurveyQuestionEntity(
        id=99, uid="other-survey-target", page_id=1, no="Q1", question="別份問卷的題", type="text", survey_id=20)
    entity = SurveyQuestionEntity(
        page_id=1, no="Q1", question="測試", type="radio", uid="self-uid", survey_id=10,
        options=[{"name": "A", "goto_question_uid": "other-survey-target"}],
    )
    with pytest.raises(ConflictError):
        survey_question_domain_service.add_question(entity, locale="zh_Hant_TW")

cd ~/Projects/Jedicogy/module/jedi-python-package/jedi-survey
pytest tests/unittest/domain/service/test_survey_question_domain_service.py -k "goto" -v

SURVEY_FLOW_RULE_INVALID_TYPE = ("流程規則只能設定在單選題", "SURVEY_409010")
SURVEY_FLOW_RULE_SELF_REFERENCE = ("流程規則不可指向自己", "SURVEY_409011")
SURVEY_FLOW_RULE_TARGET_NOT_FOUND = ("流程規則目標題目或題組不存在", "SURVEY_409012")
SURVEY_FLOW_RULE_CROSS_SURVEY = ("流程規則目標必須與來源題屬於同一份問卷", "SURVEY_409013")

def _validate_flow_rules(self, question_entity: SurveyQuestionEntity, locale: str = None):
    """驗證 options 內的流程規則（goto_question_uid / goto_page_uids）"""
    options = question_entity.options or []
    has_goto = any(
        opt.get("goto_question_uid") or opt.get("goto_page_uids")
        for opt in options if isinstance(opt, dict)
    )
    if not has_goto:
        return
    if question_entity.type != "radio":
        raise ConflictError(ErrorCode.SURVEY_FLOW_RULE_INVALID_TYPE)

    for opt in options:
        if not isinstance(opt, dict):
            continue
        target_q_uid = opt.get("goto_question_uid")
        if target_q_uid:
            if target_q_uid == question_entity.uid:
                raise ConflictError(ErrorCode.SURVEY_FLOW_RULE_SELF_REFERENCE)
            target = self.survey_question_repo.get_by_uid(target_q_uid, locale)
            if target is None:
                raise ConflictError(ErrorCode.SURVEY_FLOW_RULE_TARGET_NOT_FOUND)
            if target.survey_id != question_entity.survey_id:
                raise ConflictError(ErrorCode.SURVEY_FLOW_RULE_CROSS_SURVEY)

        goto_page_uids = opt.get("goto_page_uids") or []
        for page_uid in goto_page_uids:
            if self.survey_page_repo is None:
                continue
            page = self.survey_page_repo.get_by_uid(page_uid, locale)
            if page is None:
                raise ConflictError(ErrorCode.SURVEY_FLOW_RULE_TARGET_NOT_FOUND)
            if page.survey_id != question_entity.survey_id:
                raise ConflictError(ErrorCode.SURVEY_FLOW_RULE_CROSS_SURVEY)

pytest tests/unittest/domain/service/test_survey_question_domain_service.py -k "goto" -v

def test_add_question_allows_valid_goto_question(survey_question_domain_service, mock_survey_question_repo, mock_survey_page_repo):
    mock_survey_page_repo.get_by_id.return_value = SurveyPageEntity(id=1, survey_id=1, name="p1")
    mock_survey_question_repo.get_all_by_fields.return_value = []
    # 同問卷（survey_id=1）——與新增的 cross-survey 檢查對齊，否則本案例會被 §Step4 補強的 SURVEY_FLOW_RULE_CROSS_SURVEY 誤擋
    mock_survey_question_repo.get_by_uid.return_value = SurveyQuestionEntity(
        id=5, uid="target-uid", page_id=1, no="Q5", question="目標題", type="text", survey_id=1)
    mock_survey_question_repo.add.side_effect = lambda e, locale=None: e
    entity = SurveyQuestionEntity(
        page_id=1, no="Q1", question="測試", type="radio", uid="self-uid", survey_id=1,
        options=[{"name": "A", "goto_question_uid": "target-uid"}],
    )
    result = survey_question_domain_service.add_question(entity, locale="zh_Hant_TW")
    assert result is not None


def test_add_question_no_goto_keys_unaffected(survey_question_domain_service, mock_survey_question_repo, mock_survey_page_repo):
    """無 goto 鍵的既有問卷行為零變化（驗收標準 5）"""
    mock_survey_page_repo.get_by_id.return_value = SurveyPageEntity(id=1, survey_id=1, name="p1")
    mock_survey_question_repo.get_all_by_fields.return_value = []
    mock_survey_question_repo.add.side_effect = lambda e, locale=None: e
    entity = SurveyQuestionEntity(
        page_id=1, no="Q1", question="測試", type="text",
        options=None,
    )
    result = survey_question_domain_service.add_question(entity, locale="zh_Hant_TW")
    assert result is not None

pytest tests/unittest/domain/service/test_survey_question_domain_service.py -v

cd ~/Projects/Jedicogy/module/jedi-python-package/jedi-survey
git add jedi_survey/domain/service/survey_question_domain_service.py jedi_survey/common/enum/error_code.py tests/unittest/domain/service/test_survey_question_domain_service.py
git commit -m "feat(survey): FR-049 options goto_question_uid/goto_page_uids 流程規則驗證（單選限定/禁自指/目標存在性）"

def test_delete_question_cleans_orphan_goto_question_refs(survey_question_domain_service, mock_survey_question_repo):
    """刪除題目後，其他題目 options 內指向它的 goto_question_uid 應被清除，且清理範圍限定同一份問卷"""
    # target 明確賦值 survey_id=10（review 補強：舊版案例沒設，預設值 0 會讓「同問卷篩選」條件形同虛設，測試通過但沒真正驗證到篩選邏輯）
    target = SurveyQuestionEntity(id=1, uid="target-uid", page_id=1, no="Q1", question="被刪的題", type="text", survey_id=10)
    referencer = SurveyQuestionEntity(
        id=2, uid="ref-uid", page_id=1, no="Q2", question="有規則的題", type="radio", survey_id=10,
        options=[{"name": "A", "goto_question_uid": "target-uid"}],
    )
    mock_survey_question_repo.get_by_uid.return_value = target
    mock_survey_question_repo.get_all_by_fields.return_value = [referencer]
    mock_survey_question_repo.delete_by_uid.return_value = True

    survey_question_domain_service.delete_question("target-uid", locale="zh_Hant_TW")

    # 應以 target.survey_id 查詢範圍（同問卷限定），而非全庫掃描
    call_args = mock_survey_question_repo.get_all_by_fields.call_args
    query_entity = call_args[0][0]
    assert query_entity.survey_id == 10

    # 應呼叫 update 清除 referencer 的 goto_question_uid
    mock_survey_question_repo.update.assert_called_once()
    updated_entity = mock_survey_question_repo.update.call_args[0][0]
    assert "goto_question_uid" not in updated_entity.options[0]

pytest tests/unittest/domain/service/test_survey_question_domain_service.py -k "orphan" -v

@transaction
def delete_question(self, uid: str, locale: str = None) -> bool:
    """
    刪除問題（連動清理其他題目指向本題的流程規則）
    """
    question = self.get_question(uid, locale)
    if not question:
        return True

    self._cleanup_goto_question_refs(uid, question.survey_id, locale)
    return self.survey_question_repo.delete_by_uid(uid)


def _cleanup_goto_question_refs(self, deleted_uid: str, survey_id: int, locale: str = None):
    """掃描同問卷所有題目，移除指向 deleted_uid 的 goto_question_uid"""
    all_questions = self.survey_question_repo.get_all_by_fields(
        SurveyQuestionQueryEntity(survey_id=survey_id), locale)
    for q in all_questions:
        if q.uid == deleted_uid or not q.options:
            continue
        changed = False
        for opt in q.options:
            if isinstance(opt, dict) and opt.get("goto_question_uid") == deleted_uid:
                del opt["goto_question_uid"]
                changed = True
        if changed:
            self.survey_question_repo.update(q, locale)

pytest tests/unittest/domain/service/ -v

cd ~/Projects/Jedicogy/module/jedi-python-package/jedi-survey
git add jedi_survey/domain/service/survey_question_domain_service.py jedi_survey/domain/service/survey_page_domain_service.py tests/unittest/domain/service/
git commit -m "fix(survey): FR-049 刪除題目/頁面時清理其他題目指向它的流程規則孤兒引用"

export function mapOptionFromApi(o, idx = 0) {
    return {
        id: o.key || o.name || `opt-${idx}`,
        label: o.name || '',
        description: o.content || '',
        hasSupplementInput: !!o.ext_answer,
        supplementDescription: o.ext_answer_desc || '',
        sortOrder: o.sort_order ?? 0,
        gotoQuestionUid: o.goto_question_uid || null,
        gotoPageUids: Array.isArray(o.goto_page_uids) ? o.goto_page_uids : [],
    }
}

export function mapOptionToApi(o) {
    const out = {
        key: o.id || '',
        name: o.label || '',
        content: o.description || '',
        ext_answer: !!o.hasSupplementInput,
        ext_answer_desc: o.supplementDescription || '',
    }
    if (o.gotoQuestionUid) out.goto_question_uid = o.gotoQuestionUid
    if (o.gotoPageUids?.length) out.goto_page_uids = o.gotoPageUids
    return out
}

export function mapQuestionFromApi(q) {
    return {
        id: q.uid,
        _dbId: q.id,
        questionNumber: q.no || '',
        question: q.question || '',
        type: q.type || 'text',
        helpText: q.description || '',
        isRequired: q.required === 1,
        weight: q.weights ?? 1,
        sortOrder: q.sort ?? 0,
        parentId: null,   // FE 樹狀 id 對應需在載入後由呼叫端解析 pid→uid，見 Task 2-3
        _pid: q.pid ?? null,
        options: (q.options || []).map((o, idx) => mapOptionFromApi(o, idx)),
        subQuestions: (q.sub_questions || []).map((sq) => mapQuestionFromApi(sq)),
        flowRules: [],   // 由呼叫端在載入後從 options goto 鍵重組，見 Task 2-3
        supplementDescription: '',
    }
}

export function mapQuestionToApi(q) {
    const out = {
        no: q.questionNumber || '',
        question: q.question || '',
        type: q.type || 'text',
        description: q.helpText || '',
        required: q.isRequired ? 1 : 0,
        weights: q.weight ?? 1,
        sort: q.sortOrder ?? 0,
        options: (q.options || []).map((o) => mapOptionToApi(o)),
    }
    if (q.id && !String(q.id).startsWith('mock-')) {
        out.uid = q.id
    }
    if (q._parentDbId) {
        out.pid = q._parentDbId
    }
    return out
}

async function createQuestion(pageUid, qData) {
    const payload = {
        page_uid: pageUid,
        no: qData.questionNumber || '',
        question: qData.question || '',
        type: qData.type || 'text',
        weights: qData.weight ?? 1,
        sort: qData.sortOrder ?? 0,
        required: qData.isRequired ? 1 : 0,
        pid: qData.parentDbId ?? null,
        options: (qData.options || []).map((o) => ({
            key: o.id || '',
            name: o.label || '',
            content: o.description || '',
            ext_answer: !!o.hasSupplementInput,
            ext_answer_desc: o.supplementDescription || '',
            ...(o.gotoQuestionUid ? { goto_question_uid: o.gotoQuestionUid } : {}),
            ...(o.gotoPageUids?.length ? { goto_page_uids: o.gotoPageUids } : {}),
        })),
        description: qData.helpText || null,
    }
    const data = await baseService.post(API.SURVEY_QUESTION, payload)
    return mapQuestionFromApi(data)
}

async function onQuestionSubmit(data) {
    if (!selectedPage.value) return
    showQuestionDialog.value = false

    // D-3a: 解析父題目 uid → db id
    let parentDbId = null
    if (data.parentId) {
        const parentQ = (selectedPage.value.questions || []).find((q) => q.id === data.parentId)
        parentDbId = parentQ?._dbId || null
    }

    // flowRules 攤平回對應 option 的 goto_question_uid（同題組內跳題，目前僅支援單選題目標）
    const optionsWithRules = (data.options || []).map((o) => {
        const rule = (data.flowRules || []).find((r) => r.optionId === o.id)
        return {
            ...o,
            gotoQuestionUid: rule?.targetQuestionId || null,
            gotoPageUids: rule?.targetPageIds || [],
        }
    })

    try {
        if (editQuestionData.value) {
            const updated = await apiUpdateQuestion(editQuestionData.value.id, {
                questionNumber: data.questionNumber,
                question: data.question,
                helpText: data.helpText,
                isRequired: data.isRequired,
                weight: data.weight,
                type: data.type,
                options: optionsWithRules,
            })
            const questions = selectedPage.value.questions
            const idx = questions.findIndex((q) => q.id === editQuestionData.value.id)
            if (idx !== -1) {
                questions.splice(idx, 1, updated)
            }
            toast.add({ severity: 'success', summary: t('lang.survey_v2.success.question_updated'), life: 3000 })
        } else {
            const q = await apiCreateQuestion(selectedPage.value.id, {
                questionNumber: data.questionNumber,
                question: data.question,
                helpText: data.helpText,
                isRequired: data.isRequired,
                weight: data.weight,
                type: data.type,
                options: optionsWithRules,
                parentDbId,
                sortOrder: insertIndex.value >= 0 ? insertIndex.value + 1 : 0,
            })
            const questions = selectedPage.value.questions
            if (insertIndex.value >= 0) {
                questions.splice(insertIndex.value, 0, q)
                const orders = questions.map((item, i) => ({ uid: item.id, sort: i + 1 }))
                reorderQuestions(selectedPage.value.id, orders).catch(() => {})
            } else {
                questions.push(q)
            }
            toast.add({ severity: 'success', summary: t('lang.survey_v2.success.question_created'), life: 3000 })
        }
    } catch {
        toast.add({ severity: 'error', summary: t('lang.common.error'), life: 3000 })
    }
}

function onSubmit() {
    if (!validate()) return

    const flowRules = form.value.flowRules
        .filter((r) => r.optionId && (r.targetQuestionId || r.targetPageIds?.length))
        .map((r) => {
            const opt = form.value.options.find((o) => o.id === r.optionId)
            const target = allQuestionsFlat.value.find((q) => q.value === r.targetQuestionId)
            const targetPages = (r.targetPageIds || [])
                .map((pid) => allPagesFlat.value.find((p) => p.value === pid))
                .filter(Boolean)
            return {
                optionId: r.optionId,
                optionLabel: opt?.label || '',
                targetQuestionId: r.targetQuestionId || null,
                targetQuestionLabel: target?.label || '',
                targetPageIds: r.targetPageIds || [],
                targetPageLabels: targetPages.map((p) => p.label),
            }
        })

    emit('submit', {
        ...form.value,
        flowRules,
    })
}

const allPagesFlat = computed(() => {
    const result = []
    collectPages(props.allPages, result)
    return result
})

function collectPages(pages, result) {
    for (const p of pages) {
        result.push({ label: p.name, value: p.id })
        if (p.children) collectPages(p.children, result)
    }
}

function addFlowRule() {
    form.value.flowRules.push({
        optionId: '',
        optionLabel: '',
        targetQuestionId: '',
        targetQuestionLabel: '',
        targetPageIds: [],
        targetPageLabels: [],
    })
}

<span class="aqd-flow-label">{{ t('lang.survey_v2.designer.jump_to_pages') }}</span>
<MultiSelect v-model="rule.targetPageIds"
             :options="allPagesFlat"
             optionLabel="label" optionValue="value"
             display="chip"
             :placeholder="t('lang.survey_v2.designer.question_group')"
             class="aqd-flow-select" />

"jump_to_pages": "跳轉至題組（可複選）",
"question_group": "題組"

function hydrateFlowRules(surveyData) {
    const allQ = flattenAllQuestions(surveyData.pages)
    const allP = []
    ;(function collect(pages) {
        for (const p of pages) {
            allP.push(p)
            if (p.children) collect(p.children)
        }
    })(surveyData.pages)

    for (const q of allQ) {
        const rules = []
        for (const opt of (q.options || [])) {
            if (!opt.gotoQuestionUid && !opt.gotoPageUids?.length) continue
            const target = opt.gotoQuestionUid ? allQ.find((tq) => tq.id === opt.gotoQuestionUid) : null
            const targetPages = (opt.gotoPageUids || [])
                .map((pid) => allP.find((p) => p.id === pid))
                .filter(Boolean)
            rules.push({
                optionId: opt.id,
                optionLabel: opt.label,
                targetQuestionId: opt.gotoQuestionUid || null,
                targetQuestionLabel: target?.question || '',
                targetPageIds: opt.gotoPageUids || [],
                targetPageLabels: targetPages.map((p) => p.name),
            })
        }
        q.flowRules = rules
    }
}

cd ~/Projects/Billows/Audit-Manager/compliance-manager-fe
git add src/views/survey-v2/utils/survey-mapper.js src/views/survey-v2/composables/useSurveyApi.js src/views/survey-v2/SurveyDesigner.vue src/views/survey-v2/components/AddQuestionDialog.vue src/config/locales/i18n/zh-tw/survey-v2.json src/config/locales/i18n/en/survey-v2.json
git commit -m "fix(survey-v2): FR-049 Designer 接線——flowRules 存讀落地 + 子題 parentId 接線（D-3a）"

/**
 * 純函數：依全部規則 + 全部當前答案，算出可見的題目/題組集合。
 * 語意：初始/未作答 = 全可見；規則來源題答了才生效略過。
 */
export function computeVisibility(allQuestions, allPages, answers) {
    // 1. 收集所有規則：{ sourceQuestionId, optionId, gotoQuestionUid, gotoPageUids }
    const rules = []
    for (const q of allQuestions) {
        if (q.type !== 'radio') continue
        for (const opt of (q.options || [])) {
            if (opt.gotoQuestionUid || opt.gotoPageUids?.length) {
                rules.push({
                    sourceQuestionId: q.id,
                    sourcePageId: q._pageId,
                    optionId: opt.id,
                    gotoQuestionUid: opt.gotoQuestionUid || null,
                    gotoPageUids: opt.gotoPageUids || [],
                })
            }
        }
    }

    // 無規則的問卷：全可見（驗收標準 5 的零變化保證）
    if (rules.length === 0) {
        return {
            visibleQuestionIds: new Set(allQuestions.map((q) => q.id)),
            visiblePageIds: new Set(allPages.map((p) => p.id)),
        }
    }

    const hiddenQuestionIds = new Set()
    const hiddenPageIds = new Set()

    // 同一頁面內題目的線性順序（供「同題組內跳題」起訖判斷）
    const questionsByPage = new Map()
    for (const q of allQuestions) {
        const list = questionsByPage.get(q._pageId) || []
        list.push(q)
        questionsByPage.set(q._pageId, list)
    }
    for (const list of questionsByPage.values()) {
        list.sort((a, b) => a.sortOrder - b.sortOrder)
    }

    // 所有「被任一規則提及」的題組 id（goto_page 語意：只影響被提及者，未提及者不受影響）
    const mentionedPageIds = new Set()
    for (const r of rules) {
        for (const pid of r.gotoPageUids) mentionedPageIds.add(pid)
    }

    for (const rule of rules) {
        const sourceQ = allQuestions.find((q) => q.id === rule.sourceQuestionId)
        if (!sourceQ) continue
        const ans = answers[rule.sourceQuestionId]
        const answerValue = ans && typeof ans === 'object' && 'answer' in ans ? ans.answer : ans
        // 未作答：規則不生效
        if (answerValue === undefined || answerValue === null || answerValue === '') continue
        // 這條規則不是「當前選中的選項」設的規則：不生效
        if (answerValue !== rule.optionId) continue

        // 同題組內跳題：Q(source) 之後、Q(target) 之前的同頁題目略過；target 之後照常
        if (rule.gotoQuestionUid) {
            const pageList = questionsByPage.get(sourceQ._pageId) || []
            const sourceIdx = pageList.findIndex((q) => q.id === rule.sourceQuestionId)
            const targetIdx = pageList.findIndex((q) => q.id === rule.gotoQuestionUid)
            if (sourceIdx !== -1 && targetIdx !== -1 && targetIdx > sourceIdx) {
                for (let i = sourceIdx + 1; i < targetIdx; i++) {
                    hiddenQuestionIds.add(pageList[i].id)
                }
            }
        }

        // goto_page：本規則指到的題組留下可見；同層級其他「被提及但這次沒被選中」的題組隱藏
        if (rule.gotoPageUids.length > 0) {
            for (const pid of mentionedPageIds) {
                if (!rule.gotoPageUids.includes(pid)) {
                    hiddenPageIds.add(pid)
                }
            }
            // 這條規則自己指到的題組：確保不被其他規則誤隱藏（後面統一從 hidden 移除）
            for (const pid of rule.gotoPageUids) {
                hiddenPageIds.delete(pid)
            }
        }
    }

    const visibleQuestionIds = new Set(
        allQuestions.filter((q) => !hiddenQuestionIds.has(q.id) && !hiddenPageIds.has(q._pageId)).map((q) => q.id)
    )
    const visiblePageIds = new Set(
        allPages.filter((p) => !hiddenPageIds.has(p.id)).map((p) => p.id)
    )

    return { visibleQuestionIds, visiblePageIds }
}

import { computeVisibility } from './composables/useSurveyVisibility'

function collectAllQuestions(pages) {
    const result = []
    function walkPages(list) {
        for (const p of list) {
            for (const q of (p.questions || [])) {
                result.push({ ...q, _pageId: p.id })
                if (q.subQuestions?.length) {
                    result.push(...q.subQuestions.map((sq) => ({ ...sq, _pageId: p.id })))
                }
            }
            if (p.children?.length) walkPages(p.children)
        }
    }
    walkPages(pages)
    return result
}

const visibility = computed(() => {
    if (!survey.value) return { visibleQuestionIds: new Set(), visiblePageIds: new Set() }
    return computeVisibility(allQuestions.value, allPagesFlat.value, answers.value)
})

const totalRequired = computed(() =>
    allQuestions.value.filter((q) => q.isRequired && visibility.value.visibleQuestionIds.has(q.id)).length
)

const answeredCount = computed(() => {
    return allQuestions.value
        .filter((q) => visibility.value.visibleQuestionIds.has(q.id))
        .filter((q) => isAnswered(q.id)).length
})

const progress = computed(() => {
    const visibleCount = allQuestions.value.filter((q) => visibility.value.visibleQuestionIds.has(q.id)).length
    if (visibleCount === 0) return 0
    return Math.round((answeredCount.value / visibleCount) * 100)
})

const currentQuestions = computed(() => {
    if (!currentPage.value) return []
    return (currentPage.value.questions || [])
        .filter((q) => visibility.value.visibleQuestionIds.has(q.id))
        .sort((a, b) => a.sortOrder - b.sortOrder)
})

const allPagesFlat = computed(() => {
    if (!survey.value) return []
    const flat = flattenPagesWithDepth(survey.value.pages)
    return flat.filter((p) => visibility.value.visiblePageIds.has(p.id))
})

const allPagesRaw = computed(() => {
    if (!survey.value) return []
    return flattenPagesWithDepth(survey.value.pages)
})

const visibility = computed(() => {
    if (!survey.value) return { visibleQuestionIds: new Set(), visiblePageIds: new Set() }
    return computeVisibility(allQuestions.value, allPagesRaw.value, answers.value)
})

const allPagesFlat = computed(() => {
    return allPagesRaw.value.filter((p) => visibility.value.visiblePageIds.has(p.id))
})

if (status === 2 || status === 9) {
    const missing = allQuestions.value.filter(
        (q) => q.isRequired && visibility.value.visibleQuestionIds.has(q.id) && !isAnswered(q.id)
    )
    if (missing.length > 0) {
        // ...既有 toast 邏輯不變
    }
}

const progressItems = computed(() =>
    allPagesFlat.value.map((p, idx) => {
        const questions = (p.questions || []).filter((q) => visibility.value.visibleQuestionIds.has(q.id))
        let totalQ = 0
        let answeredQ = 0
        for (const q of questions) {
            totalQ++
            if (isAnswered(q.id)) answeredQ++
            for (const sq of (q.subQuestions || [])) {
                if (!visibility.value.visibleQuestionIds.has(sq.id)) continue
                totalQ++
                if (isAnswered(sq.id)) answeredQ++
            }
        }
        return {
            ...p, index: idx, answered: answeredQ, total: totalQ,
            complete: totalQ > 0 && answeredQ === totalQ,
        }
    })
)

cd ~/Projects/Billows/Audit-Manager/compliance-manager-fe
git add src/views/survey-v2/composables/useSurveyVisibility.js src/views/survey-v2/SurveyPreview.vue
git commit -m "feat(survey-v2): FR-049 填答端可見性計算引擎——渲染/進度/必填三消費點同源"

cd ~/Projects/Jedicogy/module/jedi-python-package/jedi-survey
pytest tests/unittest/domain/service/test_survey_question_domain_service.py tests/unittest/domain/service/test_survey_page_domain_service.py -v