# OSCVPass

## 關於我

我是 [ChAoS](https://github.com/ChAoSUnItY) ，於 2023 的暑期中在 OCF 實習，很榮幸地能夠被分配到 OSCVPass 的專案整治，也很感謝 [Toomore](https://github.com/toomore) 在實習期間指導。

## 目前進度

目前 OSCVPass 移植到 Pretalx 。已正式上線於[該網站](https://apply-for-oscvpass.ocf.tw/)。

### [GitHub](https://github.com/ocftw/OSCVPass)

GitHub 的部分已經大致上整治完成：

且新增了 project 和 tracking issue 的機制： project 用於追蹤各 issue / pull request 的進度及影響範圍，讓團隊成員及社群可以更方便的檢閱感興趣的 issue / pull request 的進度 ； tracking issue 則用於整合各 issue 到一個大項目 (issue) 中，方便檢閱該大項目中的進度是否有其他問題。

每個分支都有不同的作用：
- main 主要用於主持 OSCVPass 的靜態網頁並固定同步至 GitHub Pages ， 包括[介紹頁](https://oscvpass.ocf.tw/)以及[文檔](https://oscvpass.ocf.tw/docs/)。
- docs 要用來擺放暫存的靜態網頁和文檔，完善後透過 pull request 的機制合併至 main 分支中。
（需要注意的是如果其他成員有暫存的進度在 docs 分支上，請另外開一個分支防止進度衝突，並在 pull request 被合併後自行刪除，[當然我會更建議這樣做](#Pull-request)。）
- pretalx 用於存放pretalx docker設定檔。

關於 issue 和 pull requests 工作流程的機制，詳見[關於工作流程](#關於工作流程)。

### [Pretalx](https://apply-for-oscvpass.ocf.tw/)

已完成問卷和email寄送的部分，詳細的 remote control 可以參考[這裡](https://github.com/ocftw/OSCVPass/issues/19)。

- [x] 問卷
- [ ] Email寄送
- [x] 手動
- [ ] 自動 (參考 [Issue 9](https://github.com/ocftw/OSCVPass/issues/31))

## 給後續完善 OSCVPass 的成員

截至 8/29/23 ， Pretalx 尚未發布 2.3.2 後的正式版本，目前該版本存在以下幾個問題：
- 無法將 Additional Speaker 選項隱藏
Additional Speaker 在 OSCVPass 的申請表單是無效的資訊/欄位。
- Api 尚未研究完全
串接的部分目前是規劃使用 COSCUP SecretaryKit 裡面的 python 腳本，但由於 COSCUP 端的說明文檔尚未完善，且實習也接近尾聲，故目前暫緩轉移腳本。
- 自動化流程缺失
目前尚未實作自動化流程，無法自動定期將年會資訊寄送給合格的 OSCVPass 會員。
- 權限不明
根據 Pretalx 官方的文檔，雖然可以創建 superuser 作為初始管理員，但針對新創用戶的權限提拔目前尚未找到正確的流程，可能需要詢問官方或是對 COSCUP pretalx 有經驗之人員。

## 關於工作流程

> 若您是社群貢獻者，可以直接創建 issue / pull request ，後續團隊會自動幫你處理 issue / pull request 的分類以及 issue tracking 和 pull request review。

### Issue

Issue 創建後，若 issue 具有一定大小，需要後續追蹤，請在 OSCVPass 的 project 中的 tracking 類別裡面找最相似的類別，於該 tracking issue 中編輯新增你的 issue ；也請順道將創建的 issue 分類在 project 的對應狀態分類中。

若沒有編輯 tracking issue 的權限的話，請通知 [Toomore](https://github.com/toomore) 協助處理權限。

### Pull request

> 至後續完善 OSCVPass 的團隊成員，我建議本地端的進度放在自己的 fork 上，防止進度衝突和保持 OSCVPass 專案庫的分支整潔。

Pull requests 創建後，請待其他 OSCVPass 的成員分配分類標籤，並請等待至少 1 位成員 review 變更後再合併進去。

若該 pull request 是為了關閉 issue 的話，請在說明主旨中寫出 *Fixes #[...]* ，方便後續合併之後能夠自動關閉 issue ，詳細用語(法)與關閉機制請參考[官方說明文檔](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue#linking-a-pull-request-to-an-issue-using-a-keyword)。