# 加點播播

## 規格文件



## 專案初始化流程

### Step 1: 先 fork 一個自己的專案

![p-2016-06-06-002](https://cloud.githubusercontent.com/assets/1639206/15809412/3a984f0c-2bc3-11e6-815f-279e1346a9b7.jpg)

### Step 2: 將 fork 後的專案從 GitHub 上 clone 回來

```bash
git clone {Github URL}
```

### Step 3: Checkout to staging branch

```bash
git checkout staging
```

### Step 4: 設定 `.env`

```bash
cp .env.dist .env
EDITOR .env # Use your own editor to modify it
```

接著填入 database 資訊

#### 與 AddMusic 連結

由於音樂與資料是共用的，有些圖片會連結到 AddMusic，`.env` 內可以設定 AddMusic 的所在路徑與網址

```dotenv
# AddMusic
ADDMUSIC_PATH=/var/www/addmusic
ADDMUSIC_URL=http://addmusic.tw/
```

但記得不要去編輯音樂

#### 測試播放音樂

如果要測試播放音樂，要去找正式站的 S3 key 來填入。但一旦使用正式站的 S3，就絕對不要更新音樂，不然會蓋掉音樂家的檔案。

### Step 5: 初始化

安裝套件

``` bash
composer install
```

初始化系統設定 (會同時跑 yarn install 與 migration)

``` bash
php windwalker run preparedev
```

> **注意** 不要使用 `composer update`

### Step 6: 匯入資料

**注意：可以加上 --init 來初始化 AddMusic 的資料表**

建立資料表與測試資料 (Step 5 跑 `preparedev` 時會自動執行)

```bash
php windwalker migration migrate --init --seed
```

> 若不需要測試資料，可以省略 `--seed`

接下來打開 `http://{your_project}/www/dev.php` 即可

### Step 7: 編譯 CSS, JS

```bash
yarn build
```

前面跑 preparedev 時也會提前編譯好

## 後台

使用 UserInit Migration 內建立的帳號登入

## 佈景

- 後台佈景參考檔案在 theme/{admin_theme} 內。
- 前台佈景參考檔案在 theme/{front_theme} 內。

## CSS JS 編寫

加入要增加的 scss js 檔案在 `fusionfile.js` 內，參考 [Windwalker Fusion](https://github.com/ventoviro/windwalker-fusion)

執行 `yarn build` 或 `yarn watch` 來編譯 assets

或是另寫特殊 task 來用 `yarn build {task1} {task2}`

## SMTP 測試帳號

Mailtrap: https://mailtrap.io

- Host: `mailtrap.io`
- Username: `**********`
- Password: `**********`
- Security: `tls`
- Post: `2525`

帳密請自行上 doc 網站或 1Password 查詢

## 測試機

網址: {Test Server URL}