目前共部署在 3 個機台上，一個為測試機台；另兩個為正式機台。正式機台又分為大眾使用的正式版，以及為做推廣用途、以教學為目的的教育版。
機台的詳細資訊 (主機位置、設定、測試用帳密等) 還請再聯繫負責人獲取。
## Git Branches目前主要更新在三個 branches 上，其他都不太動。default main branch 非 Master branch 請注意。
1. **Authed** => 部署至 教育版 的分支。缺少 IR 及部分功能 (提醒功能、部分改以 Vue 重構的程式碼)。 2. **Authed-v2** => 部署至 正式版 的分支。缺少 IR 功能 (客戶要求)。 3. **merge-thermal-and-main** => 部署至 測試版 的分支。具完整功能。目前以第三個分支作為 develop branch。(因為目前分太多有點混亂，所以就不再獨立一個 develop branch)
最新版分支區分如下： (雲端管理與IR已正式合併) 1. **merge-thermal-and-main** =>正式版與教育版 2. **merge-test-main** =>測試機 理論上正式版/教育版為一致版本，僅資料不同，教育版供協會展覽教學模擬測試使用。 一般需求更新一律先至測試機確認後在更新至正式版/教育版，除bug會同步pick撿檔案合併。 ## How to Contribute 1. 先決定好你要新增的功能要部署在哪個機台，根據你的選擇先移動到該分支 (這邊以 Authed 分支舉例) ``` git checkout如果是多個分支都會用到的功能，通常是先從 Authed-v2 分支出去，然後用 cherry-pick 合併。
## What you need to ask for before developing 1. .env 2. DB data for developing 3. deployment data ## 其他 - 目前有點 SPA + SSR 混用，程式碼還在重構中... - 教育版帳號可透過 command 建立 - 信件透過 smtp 傳遞 ✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂ 我是分隔線 (∩´∀｀)∩ ✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂✂ # IR ## 操作 ### 一般使用者 1. **登入頁**: 登入帳號密碼的地方。目前 IR 跟職安平台已經連動帳號，我不知道這頁面還該不該留，總之留著。 2. **dashboard**: 登入成功後引導到的頁面，一個寫著「歡迎來到紅外線檢測網站」的首頁。不論是從登入頁登入還是從職安平台導入都會來這。 3. **單位**: 該公司基本資料的存放處，包含區域、廠區、單位、及箱體資訊。 4. **巡檢計畫**: 訂定巡檢計畫詳細內容、巡檢計畫時程的地方。 - 巡檢計畫就是一份稽查單，巡檢人員須在約定時間內填寫並上傳稽查單的結果。 5. **查核**: 巡檢人員依據計畫做了查訪後上傳的紀錄，我們稱為巡檢單。此處為巡檢單放置處。巡檢單需要由管理層級人員審核，因此此處被稱為查核區。 6. **系統管理**: 這裡會列出子帳號以及職務的一覽表。同時可在此設定子帳號的職務，職務會影響到子帳號對網站內容的修改權。 ### 管理員 1. **首頁**: 登入帳號密碼的地方。 2. **dashboard**: 登入成功後引導到的頁面，同樣也寫著「歡迎來到紅外線檢測網站」，但跟一般使用者的首頁屬於不同網址。左側欄顯示廠商一覽表跟風險等級評估。 3. **風險等級評估**: 巡檢單的結果會被評為「正常」或是「異常」，其依據為風險等級評估裡的資料。風險評估等級的設定可在此處做更改。 - 注意！！此功能僅供管理員使用，一般使用者無法使用此功能。 4. **廠商一覽**：此處顯示所有參與紅外線檢測的廠商。目前預設是廠商創建職安平台帳號時，同時會創建 IR 帳號，但之後此功能應該會修正。可在此頁點擊進入任一廠商，進入後可像廠商進入他們的頁面一樣管理他們的資料。除此之外，管理員才有對查核進行審核的功能。 - 注意！！此功能僅供管理員使用，一般使用者無法使用此功能。 ## 使用工具 - 見上方職安平台的「使用工具」列表 ## Directory Structure ``` └─── app └──── Checkers └──── Classes └──── Exports └──── Imports └──── Http └──── Controllers └──── Models └──── Repositories └──── Services └──── Supports └─── resources └──── js └──── middleware.js └──── router.js └──── store.js ``` - **Checkers**: 檢查使用者輸入是否符合所需條件，例如帳號密碼為必填等。 - 其實針對每個 Request 都應該要實作 checker，但實在太忙了後來都沒做。 - **Classes**: 自定義 custom classes。你可以在此隨時增加你所需的 Class。 - **middleware.js**: Vue-router Navigation Guard functions. Read [this official document](https://v3.router.vuejs.org/guide/advanced/navigation-guards.html) to learn more detail. - **store.js**: Vuex variables and mutation functions. - (剩下內容皆與職安平台相同) ## Git Branches 目前主要更新在 `merge-thermal-and-main` 這個分支上，此分支同時為開發分支及部署分支。 其他分支為 feature branches，**若非您所負責的 feature，請不要擅自改動它**。 ## Before you commit... 1. If you revise any `.vue` file, you need to run compile and bundle your `.vue` first. 2. So don't forget to run the command below before git committing. ``` npm run prod ``` 3. Don't forget to remove `Log::info()` or `console.log()` before you commit. 4. That's all! HAPPY CODING! ## How to Contribute ### General Usecase 1. First, you need to know which feature you should comtribute, then switch to that feature branch. ``` git checkout