---
title: 黑熊通報系統 - 開發流程
description: 建立黑熊通報系統用的開發流程
tags: ohshown, TBBCA, TW
---
Homepage: [黑熊通報系統 - Running Meeting Minute](/BJaWcBAe9)

# OH!SHOWN - 黑熊通報系統 - 開發流程
（成熟後改為專案的 README）

## 初心者秘笈：

### clone 前後端 code base
- `git clone https://github.com/tai271828/disfactory-backend.git` to get the backend source code.
- `git clone https://github.com/tai271828/disfactory-frontend.git` to get the frontend source code.

### Pre-requisite
1. 安裝 nvm
https://github.com/nvm-sh/nvm
`curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
`
2. 使用nvm 安裝node.js
`nvm install 15`
這個專案目前使用 latest v15
(v14, v16 皆無法）

3. 安裝docker
https://docs.docker.com/get-docker/

# backend 開發

參考[Disfactory backend readme.md](https://github.com/tai271828/disfactory-backend/tree/main-tbbca/backend)

## 設定開發環境

以下的環境設定都是以 Mac 與 Linux 為主， Windows 的話需要使用 WSL2 + Docker Desktop 才有辦法依照下面的步驟設定。

### 建立 .env 檔
`cp .env.sample .env`

### 開發環境懶人包 - Docker + docker-compose
- `cd disfactory-backend/backend`
- `make run-dev` or `docker-compose -f docker-compose.dev.yml up -d`
- 使用 `docker ps` 確認container 是否已經開始運作。PORTS 顯示在browser 應該如何連
- `docker-compose exec web python manage.py createsuperuser`
- Login to django backend `http://localhost:8888/admin`
- 觀察backend 的動作請見log: `docker-compose logs --tail 100 -f web`

### 或⚠️在本機開發
參考[Disfactory backend readme.md](https://github.com/tai271828/disfactory-backend/tree/main-tbbca/backend)

# Frontend 開發

參考 frontend [README.md](https://github.com/tai271828/disfactory-frontend/blob/main-tbbca/README.md)

## Notes
- Enabled CI for each push and pull request of the backend and frontend code

## Typical Agenda for sprints:
- 專案更新
- github action 開了，fork 完要記得去打開
- 個人進度更新與回報、交流
- 有什麼可以做、issue
- Sprint!!
- 當天成果回顧