# COSCUP Volunteer 財務系統開發小抄

## 資料初始化步驟

為了準備能夠順利開發財務系統的資料，除了一般的系統初始化外，我們也需要設定好專案、組別，以及預算。

在以下步驟中，若在開頭有標注 `user` 的，則代表須使用非財務組帳號的 session 。若無特別標注，或標注 `admin` 的，則代表需使用財務組 chief 的 session。

1. 用 docker compose 執行開發環境
1. 根據[開發文件說明](https://volunteer.coscup.org/docs/dev/build-base-image/)，編譯 base image && docker compose up
> 如果有發生port 5000問題且為macOS，檢查一下AirPlay Receiver是否關閉，此port跟環境所需要的port會有衝突
> 或是port由"5000:5000"->改為其他port如"8080:8080"
3. 紀錄登入連結，在[開發文件的最後一步](https://volunteer.coscup.org/docs/dev/build-base-image/#create-first-user-account)裡，提到的 `http://localhost/dev/cookie/xxxx` ，記到自己的筆記中
2. 新增專案
1. 在開發者後台 `http://127.0.0.1/dev/` 的下方，點選 `To create a project
2. 可任意選擇 Pid & Name ，並做好紀錄
> 以下以 Pid = `2050` 為例，請自行代換為你指定的 Pid
4. 一個 project === 一屆的 COSCUP ，我們之後將以此專案作為開發測試的標的
3. 新增財務與其他組別
1. 要開發測試財務系統，需要建立財務組（才有管理界面），以及其他組別 x1 （才能測試一般使用者）
2. 打開 project / 編輯組別： `http://127.0.0.1/project/2050/edit/team`
3. 建立財務組
> name = finance, tid = finance, owner = 目前的帳號, chief = 目前的帳號
> 注意 tid 一定要填 `finance` ，否則系統無法辨認
5. 建立其他組別
> 各欄位數值隨喜，記得 chief 填別的帳號
6. `user` 使用其他瀏覽器，或是隱私分頁，並以其他組別的帳號登入
4. 建立預算報表
1. 從[這份 Google 試算表](https://docs.google.com/spreadsheets/d/e/2PACX-1vSeqzTJLbkNwvVANO4vBSJNf5os-5jm5r3D3-ex9Vw4_CDqQKhv0qQOe8A2WjaG-J_Id3Wuo9pK4uAn/pub?gid=0&single=true&output=csv)，下載範例預算表
1. 進入預算編輯畫面： `http://127.0.0.1/budget/2050`
3. 點選 `批次上傳預算項目` ，並匯入第一步下載的檔案
5. `user` 建立申請單
1. `user` 進入專案頁面 `http://127.0.0.1/team/2050`
2. `user` 點選左側選單的 `預算列表` ，就能新增預算

## 開發環境定期更新

1. 當後台系統、套件更新時，請參考[開發文件說明](https://volunteer.coscup.org/docs/dev/build-base-image/) ，重新編譯 coscupweb-base docker image & docker-compose 的所有 image
2. 當開發時間過久，例如超過一個月時，原本建立的帳號會過期，只要重新建立新的 session ，就可以繼續使用囉，原本的 user ID 都會流著，只是更新 session 而已
> docker compose run --rm cmdapp dev user_add

## 推薦記錄下來的頁面連結

你可以將以下連結，替換為系統的實際設定，方便之後開發切換呦～

以下接以 pid = 2050 為例

1. 開發者登入連結： `http://localhost/dev/cookie/xxxx`
1. 請至少紀錄 `admin` & `user` 兩組登入連結，減少日後查詢的時間
2. 系統管理員：
1. 本次專案的連結： http://localhost/project/2050
2. 編輯組別： http://127.0.0.1/project/2050/edit/team
5. 財務組管理後台：
1. 申請單列表： http://127.0.0.1/team/2050/finance/expense/lists
4. 一般帳號建立申請單：
1. http://127.0.0.1/team/2050

## 常用頁面、概念說明

==歡迎認領或共筆==

## 推薦的開發流程

==歡迎認領或共筆==

## git 使用注意事項

==歡迎認領或共筆==