zetavg/tripbook

大概可以暫時稱之為一個讓深度共通脈絡得以存在的社交平台。

TripBook

The TripBook Project.

Requirements

System

• Linux or macOS
• Ruby 2.4
• Node.js 6.0+
• ImageMagick

Database

• PostgreSQL 9.5+

Backing Services

• Facebook
  • Env FB_APP_ID, FB_APP_SECRET
  • Needs to enable FB Login, the OAuth redirect URI is: [your_host]/users/auth/facebook/callback

Setup

1. Run bin/setup.
2. Edit .env.
3. Edit config/database.yml and run bin/rails db:setup if needed.

Development

Tasks

• bin/rake js:install: Install JavaScript dependencies using NPM.
• bin/rake erd:generate: Generate ERD diagram for domain models (requires Graphviz 2.22+).
• bin/rake syntax:check: Check the code syntax using Rubocop.
• bin/rake syntax:check_js: Check JS code syntax using ESLint.
• bin/rake syntax:auto_correct: Auto correct the code syntax using Rubocop.
• bin/rake staging:bootstrap: Fill the database with testing data.

Guard

Run bin/guard for autotest and livereload.

tripbook's Issues

在 staging 或 develop 環境，全站前端介面加上提示的 header

給書的擁有者「建立旅程 + 邀請某使用者借書」一次完成的快捷功能

方便書的擁有者快速把書借給認識或想借給的人。未來就可以在書籍頁面加上「這些人想借」區域、「借給他！」按鈕。

在檢視書籍時按下「我想要借」按鈕，展開「想看的原因」+「確認」時 dim screen

@Boisonst 建議：使用者按下「我想要借」按鈕時，預期行為是直接完成登記，並不期待會展開表單，所以我們需要額外的手段來將使用者的注意力集中在「想看的原因」+「確認」上（可能是類似 FB 發布貼文時暗化除了貼文框以外的網站內容的效果）。

使用者接受一本書的借閱邀請後，要將相應的借閱登記標記為 fulfilled

登入頁面設計

增加「想借這本書的人」頁面

增加「想借這本書的人」頁面，列出想借某一本書（還沒借到）的人，以及他們想看這本書的原因。如果目前的使用者手上有這本書可供出借 *1，會顯示出「對___送出邀請」的按鈕。

*1:
有兩種狀況：

1. 使用者擁有這本書，書在手上且目前沒有旅程。
2. 使用者持有這本書，書是在可以出借的狀態。

對 2. 的狀況只要直接送出邀請即可，但針對 1.，必須要在同一個頁面填入旅程規則（「看完這本書之後，要 [還給我／借給下一個人]」之類的問答），再同時建立旅程並送出邀請。

升級 Rails 到 5.1.x

登記借書請求－可以指定想跟誰借

• 在檢視書籍「大家與書的故事」的地方，增加「我想跟這個人借書」的按鈕，按下之後可以填寫私人訊息和想看這本書的原因 (如果沒有登記過的話)。

設定 mailer

[BB #19] 在 staging 環境的登入介面，加上測試帳號的快速登入按鈕

在 staging 環境的登入介面，加上測試帳號的快速登入按鈕，方便非開發人員測試新功能。
需待 #19 完成。

設定 foreman

提供方式讓使用者填寫「可以當面借書的時間與地點」

邀請借書－在送出邀請頁面，可以看到「想借這本書的人」

在送出邀請頁面，可以看到所有已經登記想借某本書的人，還有他們想借的原因。如果有指定想跟目前的使用者借書的話，會特別顯示在最上面，並且可以看到私人訊息。

書的擁有者要能直接從「書架」為書建立新旅程

目前要建立新旅程只能透過「藏書」頁，會為新使用者的 first action circle 增加難度（需要多介紹「藏書」區）。把建立新旅程的功能搬到「書架」也有的話，就能日後再介紹「藏書」區的功能（可能是使用者已經把書借出的時候，介紹說「藏書」區可以一直追蹤你擁有的書的狀態）。

使用者 Onboarding Flow

• FB 登入進來的使用者，需要確認他們的常用信箱。
• 需要使用者決定 username。
• 跟使用者簡介網站功能。

Book::BorrowingInvitation 在被接受後，要記錄所產生的 borrowing ID

使用 yarn 取代 npm 指令

當使用者接受借書邀請時，接手方和送出方要能看到彼此的聯絡資料

未來需要設計一套方式，讓系統在使用者整個借書的過程中逐步和轉手的對象做資訊揭露，讓雙方逐漸建立信任或由當下知道的資訊來決定是否繼續（送出或接受邀請），現階段特別是當使用者接受借書邀請時，接手方和送出方要能看到彼此的聯絡資料。

未來一種做法是讓使用者在雙方沒有互相確認邀請前，只知道「平台方做了何種認證」+「會拿到什麼資料」，例如「已連結 FB 帳號 (接受後可檢視)」、「已認證手機號碼 (接受後仍不可檢視)」。

進階一點的話可以讓兩位互不相識的使用者檢視彼此的共同點，例如都曾參加過的活動、都看過的書等。

通知中心

增加一個 Notification model，用來記錄使用者的通知，格式大概如下：

• user_id
• created_at
• read_at
• completed_at
• subject_type
• subject_id
• verb
• object_type
• object_id
• complement

...

建立借書邀請時，要檢查目前書的旅程是否合法可以繼續借出