專案檔案追蹤清單：開發檔案

這份文件列出所有非資產檔案，方便團隊在改頁面、版型、樣式、腳本與文件時快速定位。

路徑顯示慣例：文件中可用 <template-root> 作為顯示別名，對應實體資料夾 WebTemplate.1.0.0.0。

WebTemplate.1.0.0.1 更新紀錄

新的異動請加在最上面（最新在前）；只記錄「這份文件本身」的重大異動，細節請看對應章節。

• 2026-10-01：補上原本空白的「UC07 其他頁面」章節，加入服務條款與隱私權政策頁 policy.html 的頁面資訊與待辦事項，並將命名規則表的 UC07 列改為可點擊連結。
• 2026-10-01：UC05 產生頁面新增「生成失敗頁」main_generating(error).html（main.error[data-step="generating"] 狀態，顯示 .error-msg 取代 .generate-wrap）；_ui_styleguide.scss 的 .icon-wrap 新增 .retry（重新生成按鈕，沿用 .raback-arrow 的返回箭頭圖示）。
• 2026-10-01：新增「會員帳戶中心」彈窗 _view_member.html（data-partial-slot="view-member"），已套用於 main_check.html、main_generating.html、main_result.html、main_setting.html、main_upload(login).html；登入後點擊 aside 使用者資料的頭像或「查看帳戶與使用紀錄」按鈕，由原本開啟 .history-wrap 改為開啟此彈窗（_common.js），並補上視窗右上角關閉鈕；彈窗開啟時會為 <body> 加上 no-scroll 鎖定背景捲動，同一機制同步套用到登入與付款彈窗（payment.js）。
• 2026-09-29：新增「UC04 設定頁面」（main_setting.html），原「產生頁面」以下重新編號為 UC05～UC07；新增「無障礙（Accessibility）調整記錄」章節；Layout 共用片段表補上原本漏列的「付款彈窗」_view_payment.html，並新增「讀取畫面」_view_loading.html。

工作區設定與根目錄文件

• PROJECT_FILE_TRACKING_SOURCE.md (目前閱讀檔案)
• README.md

主頁面 HTML

命名規則

檔名	頁面	備註
COM_*	[共用元件與訊息視窗]	彈窗、確認視窗、Toast、Loading 等
UC01_*	首頁	-
UC02_*	上傳頁面	-
UC03_*	確認頁面	-
UC04_*	設定頁面	-
UC05_*	產生頁面	-
UC06_*	結果頁面	-
UC07_*	其他頁面	服務條款、隱私權政策

狀態標記：[x] 已完成、[~] 已有前端骨架但尚未完成整合、[ ] 待處理。

UC01 首頁

頁面名稱	檔案路徑	參考頁面
首頁	index.html	參考頁待補

UC02 上傳頁面

頁面名稱	檔案路徑	參考頁面
上傳頁面(未登入)	main_upload.html	參考頁
上傳頁面	main_upload(login).html	參考頁

UC02 待辦事項

• [~] .subject-menu 已可在前端切換選項並關閉下拉選單；待由 API 載入學科選項，並將選取值保存至分析請求。
• [~] .function-wrap 已由 script/pages/_common.js 依 data-step 填入頁面路由；待接上登入、檔案與學科欄位驗證，以及 API 回傳後解除或維持 disabled 狀態。
• [~] 登入後點擊帳戶區的頭像或「查看帳戶與使用紀錄」已改為開啟「會員帳戶中心」彈窗（_view_member.html）；內含的付款紀錄 .payment-item 仍為假資料，待串接實際 API。
• 串接第三方登入 API，處理登入成功、失敗、登出、token 保存與登入後 UI 更新。
• 載入登入者資料：.user-wrap 的名稱、頭像與帳戶／消費紀錄。
• 載入 .history-item 的分析記錄標題、時間與記錄識別碼。
• 點擊 .history-item .icon-wrap.close 後呼叫刪除 API，成功後移除項目並顯示回饋，失敗時保留項目並顯示錯誤。
• Cookie：.btn-accept 寫入同意狀態、關閉視窗，並在後續載入時依保存狀態決定是否顯示；補上隱私權政策連結。
• 上傳錯誤狀態：限制 PDF 與 50 MB、處理加密／掃描 PDF、網路或 API 失敗，並將 Uppy 事件接到既有 feedback 元件。(09/08新增)

UC03 確認頁面

頁面名稱	檔案路徑	參考頁面
確認頁	main_check.html	參考頁

待辦事項

• 串接論文解析 API，載入標題與摘要，並處理加密、掃描影像或格式不符的 PDF。
• 將確認結果保存至後續設定與生成請求；未完成解析或欄位無效時不得進入下一步。
• [~] .function-wrap 的流程路由已有共用前端骨架；待補上確認頁的欄位驗證、錯誤回饋與 API 狀態處理。

UC04 設定頁面

頁面名稱	檔案路徑	參考頁面
設定頁	main_setting.html	參考頁待補

UC04 待辦事項

• [~] 快速選擇（簡易／一般模式）與客製化條件已可在前端切換；待將選取結果保存至生成請求。
• [~] 創新理論說明的細項卡片已可展開／收合選取；待將選取的理論保存至生成請求。
• .reminder 的預估生成時間與 .cost-info 應付金額待改由 API 依實際選擇條件計算，目前為固定示意值。
• [~] 付款彈窗（_view_payment.html，容器實際位於本頁）已有發票資訊與付款方式選取骨架；待串接實際金流、發票資料驗證與付款結果處理。彈窗語意與焦點管理待補項目見「無障礙（Accessibility）調整記錄」。
• [~] 讀取畫面（_view_loading.html）已套用於本頁：進頁時立即顯示、其餘 partial 載入完成後模擬 2~3 秒隱藏；待改為依實際資料載入完成時機關閉，而非固定模擬時間。
• .function-wrap 的上一步／下一步／開始生成／分析另一篇待接上欄位驗證與 API 呼叫。

UC05 產生頁面

頁面名稱	檔案路徑	參考頁面
產生頁	main_generating.html	參考頁
生成失敗頁	main_generating(error).html	參考頁待補

• 串接研究提案生成 API，傳送上傳檔案、學科與設定條件，並保存生成工作識別碼。
• 實作生成中的進度、逾時、失敗與重試狀態，改以實際進度顯示(目前秒數僅為示意)。
• 生成完成後保存結果，並依工作識別碼導向結果頁；離開或重新整理時可恢復狀態。
• [~] 生成失敗畫面（main_generating(error).html，main.error[data-step="generating"]）已有前端骨架，以 .error-msg 取代 .generate-wrap；待接上實際失敗事件觸發、${_errorMessage_$} 錯誤訊息，以及 .error-msg .function-wrap .icon-wrap.retry「重新生成」按鈕的 JS（目前與設定頁 .redo-generate 皆尚未串接，且 class 名稱不同，見 _common.js）。

UC06 結果頁面

頁面名稱	檔案路徑	參考頁面
結果頁	main_result.html	參考頁

• 依工作／歷史記錄識別碼載入研究提案與相關論文資料，並處理載入失敗與空結果。
• [~] 標題可編輯、複製、喜歡／不喜歡已有前端互動；待將標題更新與回饋結果送至 API。
• 將「重新生成」與「分析另一篇」由目前的提示訊息改為實際流程，包含清除舊狀態與導頁。
• 串接結果分頁、展開收合、回饋送出與歷史紀錄更新。

UC07 其他頁面

頁面名稱	檔案路徑	參考頁面
服務條款與隱私權政策	policy.html	參考頁待補

UC07 待辦事項

• 分頁籤（服務條款／隱私權政策）切換、導覽收合／展開、Scrollspy（捲動時同步 nav .is-active）與回到頂部按鈕，皆已由 _policy.js 實作完成，純前端互動、無需 API。
• 內容為靜態法律文字，條款或政策如有修訂，需同步更新頁面上的「最後更新日期」（目前寫死為「2026 年 9 月 1 日」）。

Layout 共用片段與說明

Legend: Y = 已套用, N = 尚未套用, TBD = 待確認

尚未套用檔案進IT開發評估，由工程師確認後回饋。

區塊／元件名稱	路徑	載入方式	使用狀況
Footer	footer.html	id="footer"	Y
Header	header.html	id="header"	Y
Aside	aside.html	data-partial-slot="aside-view"	Y
登入視窗	_view_login.html	data-partial-slot="popup-login"	Y
Cookie	_view_cookie.html	data-partial-slot="popup-cookie"	Y
付款彈窗	_view_payment.html	data-partial-slot="popup-payment"	Y（目前僅 main_setting.html 有容器）
會員帳戶中心	_view_member.html	data-partial-slot="view-member"	Y（main_check.html、main_generating.html、main_generating(error).html、main_result.html、main_setting.html、main_upload(login).html 皆有容器）
讀取畫面	_view_loading.html	data-partial-slot="loading-screen"	Y（純 CSS 動態讀取效果，main.js 進頁立即顯示、其餘 partial 載入完成後再模擬 2~3 秒隱藏；目前僅 main_setting.html 有容器，尚未套用到其他頁面）
訊息回饋（popup-interface-wrap）	_popup.html	class="popup-interface-wrap"（尚未接上 main.js 的 fetch 載入，各頁面為手動貼入或留空的 markup；完整說明見 feedback-notification.md）	TBD

無障礙（Accessibility）調整記錄

• 彈窗關閉鈕／歷史紀錄刪除鈕（.icon-wrap.close，共 15 處，分布於 _view_payment.html、_view_login.html、aside.html、main_generating.html、main_result.html）由 <span> 改為 <button type="button" aria-label="...">，並在圖示 <i> 補上 aria-hidden="true"，使鍵盤與螢幕報讀者可操作；_ui_styleguide.scss 的 .icon-wrap 基礎樣式同步補上 padding: 0 與 :focus-visible 外框，避免鍵盤聚焦時看不到焦點。
• 全站 <html lang="zh-CN"> 改為 lang="zh-TW"（9 個頁面），修正語言標記與實際繁體中文內容不符、導致螢幕報讀者誤用簡體發音引擎的問題。
• 付款／登入／會員帳戶中心彈窗尚未補上 role="dialog"、aria-modal="true"、aria-labelledby；開關彈窗時也未做焦點移動／鎖定與 Esc 鍵關閉（見 payment.js、_common.js）；目前僅實作背景 body.no-scroll 鎖定捲動，尚未處理鍵盤焦點。
• _view_payment.html 發票資訊區的 5 個輸入框（手機條碼、自然人憑證、統一編號、發票抬頭、捐獻碼）僅有 placeholder，未綁定 <label>，需補上對應 id/for。

SCSS 原始檔

樣式摘要，不逐一列檔名；若需追某個樣式，先依資料夾定位再全文搜尋。

區塊	路徑	檔案數	主要用途
Entry	<template-root>/src/scss/main.scss	1	SCSS 主入口，整合各分層 partial

Javascript 原始檔

類別	路徑	主要用途
共用載入	<template-root>/src/script/main.js	透過 fetch() 載入 header、footer、aside、各彈窗與讀取畫面 partial；有 loading-screen 容器的頁面會在進頁時立即顯示、partial 全部載入完成後再模擬 2~3 秒隱藏
共用路由與事件	<template-root>/src/script/pages/_common.js	依 data-step 設定流程路由，處理登入、付款開關與會員帳戶中心彈窗（開啟／關閉時同步切換 body.no-scroll）
上傳頁	<template-root>/src/script/pages/_upload.js	學科下拉選單的前端選取互動
設定頁	<template-root>/src/script/pages/_setting.js	生成模式與理論細項選取互動
結果頁	<template-root>/src/script/pages/_result.js	標題編輯、提案複製與喜歡／不喜歡互動
付款 UI	<template-root>/src/script/ui/payment.js	付款方式彈窗的選取、關閉與導頁骨架；開關時同步切換 body.no-scroll
回饋 UI	<template-root>/src/script/ui/feedback.js	共用成功、警告與資訊訊息（showFeedback/hideFeedback API 與訊息字典見 feedback-notification.md）

已知待修正項目

• 將各頁面的模板佔位符（例如 {$_..._$}）改由實際 API 資料填入，並移除對使用者可見的測試資料。
• 統一 popup-interface-wrap（回饋訊息 .feedback-wrap）的載入方式：目前僅 main_result.html 同時具備 markup 與 feedback.js，屬於唯一真正可用的頁面；其餘頁面現況與整改建議請見 feedback-notification.md 第 5 節。

更新項目狀態時，請保留對應的實際檔案、測試或 API 驗證依據。

文件維護原則

新增或移除檔案時，請同步更新本清單與對應的索引文件。