<aside> ❗ Copyright and Ownership Notice

關於這個 notion page 以及其包含的所有 pages （以下統稱「本 page」），其著作權與所有權是屬於台大電機系黃鐘揚教授以及其所開設的網路服務程式設計課程之所有助教 (以下統稱「作者們」) 所擁有。

基於推廣技術與服務大眾之精神，本 page 採取 MIT 授權，即任何人皆可因任何目的使用、複製、修改、發布、與再散佈本 page，包括商業用途。不需簽署協議，也不需支付授權費，惟任何的使用與散佈必須包含本著作權與所有權聲明。如有違反本著作權與所有權聲明，本 page 之作者們仍保有相關的法律追朔權利。詳細關於 MIT 授權的規範請見 OSI 官網。

本 page 之內容以「現狀」提供 (provided "as-is")，不附帶任何保證。對於本 page 之內容如有任何疑問或是建議，請來信 [email protected].

The copyright and ownership of this Notion page and all pages it contains (hereinafter referred to as "this page") belongs to Professor Chung-Yang Huang of Department of Electrical Engineering, National Taiwan University, and all teaching assistants of this Web Programming course that he teaches.

In the spirit of promoting technology and serving the public, this page adopts the MIT License, meaning anyone can use, copy, modify, publish, and redistribute this page for any purpose, including commercial use. No agreement needs to be signed, and no licensing fee needs to be paid, provided that any distribution must include this copyright and ownership notice. In case of violation of this copyright and ownership notice, the authors of this page still retain the relevant legal right to take retroactive action. For detailed regulations regarding the MIT License, please see the OSI official website.

The content of this page is provided "as-is", without any warranty. If you have any questions or suggestions regarding the content of this page, please email [email protected].

</aside>

<aside> 🌐 Web Programming Home

</aside>

General Information

1. 有關分組方式、以及一些基本規定，請見 ：00. Course Introduction

2. 期末專題題目 & 分組名單：https://cool.ntu.edu.tw/courses/55502/files/8693009/download

   請確認分組名單是否有誤，並且記得自己的組別，在底下各項報告時需要使用。

   <aside> 💡

   [注意] 分組時所選定的題目只是參考！各組如果要調整或者是修改期末專題的題目，請自便，不用事先提出任何的申請或是登記。只要在期末時按照底下第 10~14 項繳交資料即可。

   </aside>

3. 期末專題目錄命名以及 GitHub 放置規定：為了讓助教可以順利的 clone 到你們的期末專題 (Note: 助教會把你的 code clone 到 local, 並在 local 環境進行測試)，請在你們組長 or 一位組員的 GitHub 的 wp1141 repo 底下，建立一個 “final-project” 的目錄，將你們的期末專題 push 至此。至於 final-project 底下你們想要怎麼安排、命名目錄，甚至想要獨立建立一個符合你們專題的目錄名稱，都 OK. 但請盡量 follow 一般 or 上課示範的 convention, 以利老師與助教閱讀你們的程式碼。

   • 由於你們的 wp1141 repo 為 private, 如果你們想要把期末專題 open source, 建議另外開一個 public 的 repo, 並自行維護兩者的關係。
     • 一個作法是先用一位組員的帳號建立此專題的 public repo, 把它取成以後你們開源以後想要取的名字，可以先做一點基礎建設 (or not)，然後使用另外一位組員的帳號把這個 repo “fork” 成一個 private repo (Note: GitHub 不允許同一個帳號進行 fork), 主要在此開發與測試，待有一個穩定、可 demo 的版本的時候，再發 PR (Pull Request) 改原來的那個 public repo，把 code push/merge 到上面
     • 另外一個(比較簡單的)做法是你們直接在 wp1141 的 private repo 完成你們的 final project, 待期末結束、專案做到一定值得分享的程度以後，再把整個 code clone 到一個新建的 public repo
   • Note: 雖然沒有硬性規定，但請不要在 deadline 之前將你的 wp1141 變成 public.
   • 為了可以共同協作，請將同組其他成員加入此 wp1141 repo 之 collaborators.

4. 雲端部署：本課程規定一定要將你們的網路服務部署到雲端，如果需要帳密登入你的服務，請提供註冊的服務，以利助教以及老師使用你們的服務和評分。不過請注意自己服務的網路安全性，如果因故被駭，請自行負責。如果有流量或者是開啟時間之限制，請在 README.md 中以及在底下第 12 項 “期末專題繳交資訊收集” 之備註中說明, 並且告知網管聯絡方式，以利助教或老師提出登入需求。

5. 地端測試：期末專題原則上是根據雲端部署的版本來評分，但有時候因故雲端版本發生問題，我們還是會需要參考地端版本來決定如何評分。因此，為了方便大家自己在開發時進行測試，或者是 in case 雲端當掉時我們還有辦法評分，請大家也要讓你們的專案可以在地端 (i.e. localhost) 跑起來。

   • By default, 應該在專案的根目錄使用 “yarn dev” 開啟 localhost 的服務。但如果你們有不一樣的開啟方式 (e.g. 多重指令、shell script, or from docker)，請務必在 README.md 中清楚描述
   • Localhost 使用的資料庫或是其他資源，可以與 deployed 版本相同或是各自獨立，請盡可能考量雲端部署失效時地端仍能順利執行的方案
   • 如果需要設定、改動 .env，或者是需要對 DB 進行 migration… 等，以利 localhost 啟動，請務必在 README.md 或是適當的 .md 檔案提供詳細的指引

6. 期中 Review：Due 12/05 (五) 9pm

   • 為了確保各組可以早一點開始進行 prototype, follow CI/CD 的原則，請各組在 12/05 之前完成你們 final project 的 prototyping, 部署到雲端，我們將會把你們的 prototype app 分發給其他五組進行評分

   • 有關於期中 review 的相關規定與評分標準，請見：

     <aside> ⚠️

     Final Project Midterm Review (5%)

     </aside>

7. 期末專題評分：

   • 每組的期末專題會由授課老師與四位助教(隨機)評分
   • 原則上會是評測雲端部署的版本，但必要時也會進行 local 的測試，或參考原始碼來評分
   • 評分加權：授課老師 40%，另四位助教各 15%

8. Deadline 過後/評分時期專題的維運與修正：

   • 我們可能會需要花一到兩週來批改大家的 final projects, 所以請盡量確保你的 deployment 在 deadline 過後的兩週可以保持穩定。如果因故需要先下架，請務必跟我們說一聲。
   • 在我們評分的時間，你們可以持續修改你們的專題並且更新至雲端，但我們不保證也不會揭露我們評分的順序，所以是否會採納到你們的更新，完全是命運的安排，請不要向我們提出重新評分的要求。同樣的，如果你們的修改造成雲端版本的失能，正好被我們測到，因此獲得低分，你們也不得提出異議。
   • 任何 deadline 過後的修正，請在專題跟目錄編輯一份 ChangeLog.md, 記錄修正項目，以利追蹤。
   • 原則上我們的 pull 回來的程式碼會以 deadline 當天 9pm 的 snapshot 為準，除非必要，不會重新下載 deadline 過後的任何修正。
   • 對於評分時的異常狀況，我們會視需要/看情況主動聯絡該組的同學 (by e-mails)，如果我們沒有聯絡，就表示我們覺得沒有必要，請體諒專題評分本身已經是一個十分繁重的工作，不要再主動要求我們重新評分，請自行確保你們的專題是維持在一個良好的狀態。
   • 我們評分完畢，開完討論會議之後，就會公告期末專題的評分，會有至少一天的時間讓大家提出疑問。

9. 期末專題 deadline: 12/23(二) 9pm, 除了專題的程式碼需要 push 到 GitHub、確保 deployed version 正常運作之外，請在此 deadline 之前完成底下事項 (10 ~ 14)，逾時未完成者則算遲交。

10. 期末 demo 影片 (以組為單位)：

    • 由於預期組數將超過 60 組，我們不可能舉行 demo day，因此，我們將 demo 改為 請大家自行錄製 demo 影片上傳
    • 影片長度不得超過 6 分鐘，請在專題 deadline 前，上傳至雲端空間 (preferrably a video hosting service)，如 NTU G Suite, Youtube, Vimeo, FB 等
    • 影片內容至少應包含：
      • 簡單自介 (組別、組員姓名、題目名稱)
      • 三句話內介紹你們的題目在做什麼
      • Project Demo
      • 程式碼架構/使用技術介紹
    • Optional 內容：動機/心得、投影片 or 其他輔助說明
    • 影片拍攝製作技巧、有沒有露臉、畫質 (只要不要真的太差)… 等，不在評分範圍，大家不需要在這方面軍備競賽

11. FB 社團貼文分享 (以組為單位)：為了促進修課同學分享，發揮開源的精神，請於專題 deadline (i.e. 12/23(二) 9pm) 之前至 FB 社團貼文公告作品，內容應包含 (建議按照此順序)：

    • PO 文的第一行請統一加上 [114-1] Web Programming Final 作為標題
    • 專題題目名稱 // 前面請加上組別: (Group xx) Your Title
    • Demo 影片連結
    • 描述這個服務在做什麼
    • Deployed 連結 (如有自己有安全性的疑慮，則可以不用在 FB 社團公告此項)
    • (如果有給 deployed 連結) 使用/操作方式 (含伺服器端以及使用者端)
    • (Optional, 如果你有另外建立一個開源的 repo) Github link (請不要給成你的 private wp1141 repo <= 別人看不到)
    • 其他說明
    • 使用與參考之框架/模組/原始碼
    • 使用之第三方套件、框架、程式碼
    • 專題製作心得

    <aside> ℹ️

    每組請至少派一名成員加入本課程之 FB 社團，提出申請後請稍後，我會在十二月開始處理入社申請。

    </aside>

12. 期末專題繳交資訊收集 (以組為單位，12/10 後開放填寫)：為了方便我們收集你們的專題的各項資訊，以利評分以及後續的分享，請在期末專題 deadline (i.e. 12/23(二) 9pm) 前至此 Google Form 填寫專題相關資訊，包含:

    • 組別
    • 組長中文姓名
    • 題目名稱
    • Deployed service 網址
    • Github Repo 網址
    • Demo 影片網址
    • FB 社團貼文網址
    • (Optionoal) 其他想提醒老師與助教評分之事項

13. 期末專題報告 (以組為單位)：請在 wp1141/final-project 目錄放上 README.md, 作為期末報告，除了上述公告在 FB 社團的內容之外，也請加上：

    • 如何在 localhost 安裝與測試之詳細步驟
      • 雖然不一定會針對你們的專題進行 local 的測試，但還是請務必詳述如何在 localhost 安裝與測試你們的專題，包含：基本的 yarn/npm 指令，後端如果使用其他語言所需要之安裝環境說明，資料庫串接與資料匯入方式，提供註冊機制或者是直接給登入之帳密 (if needed)… 等。
      • 助教/老師會完全按照此步驟執行安裝， 請不要期待助教/老師需要自己看懂你的系統架構/script 去猜測安裝之指令。
      • 如果助教/老師會按照此步驟安裝遇到任何的問題，導致無法 compile/執行，可歸因於同學之疏失者，如因此造成專題評分之損失，請同學自行承擔。
      • 至於測試，我們會按照你們提供的功能說明來測試，如有一些特別需要注意或是展示的地方，請說明清楚，或是提供測資。
    • 每位組員之負責項目 (請詳述)
    • 如果此專題是之前作品/專題的延伸，請務必在此說明清楚 (本學期的貢獻)
    • 對於此課程的建議

14. 組員互評 (以組為單位，評每一位 “修課” 組員)：雖然專題的分數是以組為單位，但最終的成績還是會把每位組員的貢獻納入考量。不過為了避免過度主觀而影響公平性，我們將採取底下的原則與公式來作為評分的調整因素：

15. 評分標準：

16. 關於有找外掛、或是延續先前題目組別的評分補充說明：