維護說明
本網站是公司 ISO 9001 文件系統的**電子版文件總覽表(7043A)**與全文查詢平台。內容存放在 GitHub,每次修改都會自動留下版本紀錄,合併後約 1 分鐘內自動更新到網站。
網站內容從哪裡來
| 內容 | 存放位置 | 說明 |
|---|---|---|
| 文件清單(編號、名稱、版本、部門、狀態) | data/documents.yaml |
一份文件一行,是網站的主索引 |
| 文件全文與修訂紀錄 | docs/<文件編號>.md |
例如 docs/QP-704.md |
| 本頁說明 | docs/_guide.md |
網站顯示的是閱讀版。正式核准的 Word/PDF 原始檔仍存放在 Google Drive ISO 共用資料夾,每份文件頁面都有「在 Google Drive 開啟」的連結。
常見作業
一、修訂現有文件(例:QP-805 由 B 版改為 C 版)
依 QP-704 規定,先完成〔文件制、修、廢申請單〕(7041A)及核准,再更新網站:
- 打開 GitHub 上的
docs/QP-805.md,按右上角鉛筆圖示(Edit)。 - 修改內文。
- 在檔案最上方
history:加一筆修訂紀錄:- rev: C date: 2027-03-01 note: | 1. 修訂內容說明…… - 打開
data/documents.yaml,找到 QP-805 那一行,把rev: B改成rev: C、date改成新日期。 - 按 Commit changes,選「Create a new branch」並開 Pull Request,請管理代表審核後按 Merge。
- 合併後網站自動更新。
建置程式會檢查:
documents.yaml的版本必須和history最後一筆一致,否則網站不會更新,可避免版本對不上。
二、新增文件
- 在
data/documents.yaml對應階層區塊新增一行(編號不可與現有或已作廢的重複)。 - 若要提供全文,新增
docs/<編號>.md,格式可複製任一現有程序書。 - 表單(四階)通常只需在
documents.yaml加一行並填drive:原始檔 ID 即可。
三、廢止文件
把該文件在 documents.yaml 的 status 改為 作廢,並在 note 註明原因或取代文件。不要刪除那一行,編號依 QP-704 須列管不得重複使用。
四、核准發行(待核准 → 現行)
Rev.B 核准後,把 documents.yaml 中各文件的 status: 待核准 改為 status: 現行 即可(可用 GitHub 的搜尋取代)。
欄位說明(documents.yaml)
| 欄位 | 必填 | 說明 |
|---|---|---|
code |
✓ | 文件編號 |
title |
✓ | 文件名稱 |
level |
✓ | 一階/二階/三階/四階/外來 |
rev |
現行版本 | |
date |
發行或修訂日期,格式 2026-10-05 |
|
dept |
負責部門 | |
parent |
所屬程序(表單、三階文件填所屬 QP 編號) | |
status |
現行/待核准/作廢 | |
clause |
對應 ISO 9001:2015 條文,多個用「、」分隔,會自動產生「條文對照」頁 | |
drive |
Google Drive 檔案 ID(網址 /d/ 和 /view 之間那串) |
|
note |
備註 |
自動連結
內文裡出現的文件編號(如 QP-805、QI-8101、8054A)會自動變成連結,不需手動加。
在自己電腦預覽(選用)
npm install
npm run dev
然後打開瀏覽器 http://localhost:3000 。