合規框架 PDF 匯入兩階段化 — Frontend Spec

// src/config/router/index.js (摘錄)
{
  path: '/compliance-framework/import-version',
  name: 'compliance-framework-import-version',
  component: () => import('@/views/compliance-framework/FrameworkImportPage.vue'),
  meta: { /* 沿用 compliance-framework 模組權限 */ },
},
{
  path: '/compliance-framework/import-version/:parseUid',
  name: 'compliance-framework-import-version-resume',
  component: () => import('@/views/compliance-framework/FrameworkImportPage.vue'),
  props: true,
},
{
  // v1.1 新增 — 合規框架版本即時編輯
  path: '/compliance-framework/framework-version/:uid/edit',
  name: 'compliance-framework-version-edit',
  component: () => import('@/views/compliance-framework/FrameworkVersionEditView.vue'),
  props: true,
}

import { BaseService } from '@/service/BaseService'
import API from '@/config/api/api'

class FrameworkImportService extends BaseService {
  listJobs(params = {}) {
    return this.get(API.OSCAL_FRAMEWORK_PARSE_JOBS, params)
  }
  parse(formData) {
    return this.postFormData(`${API.OSCAL_FRAMEWORK_PARSE_JOBS}/parse`, formData)
  }
  getDetail(parseUid) {
    return this.get(`${API.OSCAL_FRAMEWORK_PARSE_JOBS}/${parseUid}`)
  }
  confirm(parseUid, payload) {
    return this.post(`${API.OSCAL_FRAMEWORK_PARSE_JOBS}/${parseUid}/confirm`, payload)
  }
  discard(parseUid) {
    return this.delete(`${API.OSCAL_FRAMEWORK_PARSE_JOBS}/${parseUid}`)
  }
}

export default new FrameworkImportService()

// src/config/api/api.js
OSCAL_FRAMEWORK_PARSE_JOBS: getUrl('/oscal-framework-parse-jobs'),

export function useFrameworkImportDraft(parseUid, userUid) {
  const STORAGE_KEY = `framework-import-draft:${parseUid}:${userUid}`

  const draft = ref({
    decisions: [],          // [{type, uid, action: 'delete'}]
    overrides: {            // 覆寫條目，以 uid 為 key
      groups: {},
      controls: {},
      assessments: {},
    },
  })

  function load() { /* localStorage */ }
  function save() { /* localStorage debounced */ }
  function clear() { /* localStorage */ }

  // edits API
  function markDeleted(type, uid) { ... }
  function unmarkDeleted(type, uid) { ... }
  function patch(type, uid, fields) { ... }     // override 欄位合併

  // 對外 export 給 component 收集編輯狀態的 helper
  function buildConfirmPayload() {
    return {
      decisions: draft.value.decisions,
      overrides: {
        groups: Object.values(draft.value.overrides.groups),
        controls: Object.values(draft.value.overrides.controls),
        assessments: Object.values(draft.value.overrides.assessments),
      }
    }
  }

  return { draft, load, save, clear, markDeleted, unmarkDeleted, patch, buildConfirmPayload }
}

{
  "compliance_framework_version_import": {
    "title": "匯入合規框架版本",
    "draft_banner": {
      "summary": "目前有 {total} 筆未完成草稿（其中 {mine} 筆是您的）",
      "view": "查看草稿",
      "open": "繼續編輯"
    },
    "step1": {
      "title": "上傳 PDF",
      "framework": "合規框架",
      "version": "版本",
      "release_date": "發行日期",
      "publish_status": "發佈狀態",
      "parser_type": "PDF 解析器",
      "parent_version": "父版本（建立子版本時填寫）",
      "submit": "開始解析"
    },
    "step2": {
      "title": "預覽編輯",
      "tab_groups": "群組",
      "tab_controls": "控制項",
      "tab_assessments": "評估目標",
      "discard": "捨棄草稿",
      "confirm": "確認匯入",
      "deleted_badge": "已標記刪除"
    },
    "error": {
      "parse_failed": "解析失敗",
      "retry_upload": "重新上傳",
      "empty_result": "解析結果為空，無控制項可匯入",
      "version_exists": "此版本已存在",
      "already_confirmed": "草稿已被 {user} 確認匯入"
    },
    "leave_confirm": "尚未儲存的編輯將會遺失，確定離開？"
  }
}

// FrameworkArticlePane 派發事件 → FrameworkVersionEditView 收
@patch="(payload) => FrameworkVersionEditService.updateGroup(uid, payload)"
@delete="(uid) => FrameworkVersionEditService.deleteControl(uid)"

class FrameworkVersionEditService extends BaseService {
  getCatalogTree(versionUid) { return this.get(`${API.OSCAL_FRAMEWORK_VERSION_CATALOG_TREE}/${versionUid}/catalog-tree`) }
  updateGroup(uid, fields) { return this.put(`${API.OSCAL_CATALOG_GROUP}/${uid}`, fields) }
  deleteGroup(uid) { return this.delete(`${API.OSCAL_CATALOG_GROUP}/${uid}`) }
  updateControl(uid, fields) { return this.put(`${API.OSCAL_CATALOG_CONTROL}/${uid}`, fields) }
  deleteControl(uid) { return this.delete(`${API.OSCAL_CATALOG_CONTROL}/${uid}`) }
  updateAssessment(uid, fields) { return this.put(`${API.OSCAL_CATALOG_CONTROL_ASSESSMENT}/${uid}`, fields) }
  deleteAssessment(uid) { return this.delete(`${API.OSCAL_CATALOG_CONTROL_ASSESSMENT}/${uid}`) }
}

OSCAL_FRAMEWORK_VERSION_CATALOG_TREE: getUrl('/oscal-framework-version'),  // GET /<uid>/catalog-tree
OSCAL_CATALOG_GROUP: getUrl('/oscal-catalog-group'),
OSCAL_CATALOG_CONTROL: getUrl('/oscal-catalog-control'),
OSCAL_CATALOG_CONTROL_ASSESSMENT: getUrl('/oscal-catalog-control-assessment'),