###### tags: `shoutout`
([精華版](https://hackmd.io/CDgXH22fTVuS4z0qMTnh6g)；[對外文件](https://g0v.hackmd.io/s/S1JBzxNQ3)；[SO目錄](https://g0v.hackmd.io/@_rTAcCrLS7W71XaFfUyIMg/SJEX0znzh/https%3A%2F%2Fg0v.hackmd.io%2F%40_rTAcCrLS7W71XaFfUyIMg%2FSJEX0znzh))

# SOB & SO Page Spec
:::info
持續更新：
[20230523 會議列出SOP項目](https://g0v.hackmd.io/@noahyeh/HyPnZQqrn)
[20230504 SOB&SOP討論會議記錄](https://hackmd.io/9Vj_m-SeTLyMqw9d_0NVjw?view)

:::
Noah: Shoutout 在這整個系統中扮演的是讓貢獻『浮現』並被記錄的角色，我們應該讓這樣的貢獻記錄被多種方式量化、分析及獎勵，直到找到對社群來說最容易接受的方式。
Shoutout 本身還是有可能具備一些正向的心理激勵作用，但若是單獨存在，激勵作用可能不明顯，指向性也不夠明確，與其他基石堆疊效用可能更有效。

* 我們想像 Shoutout 成為其他激勵層所能運用的資料，Shoutout 的存在目的是讓社群的貢獻被大量且持續的『浮現』，也成為社群正面氣氛的創造工具。
* Shoutout 對於量化、視覺、獎勵、分析工具應該是中立的，其目的只存在於創造大量的貢獻資料。
* 我們期待更多的開源量化、視覺、獎勵、分析工具被建立在 Shoutout 上，這可能是透過 g0v 的 Hackathons 也可能透過其他場域。

## 前端&儀表板
### 整理：儀表板
:::spoiler 點開看詳細資料
介面複雜程度，不同功能需要的工不同
但如果有選擇時間(客製化，例如想看某個人，在某個頻道，)或呈現怎麼樣的統計數據，這個就比較多工，要讓Matt確認量能
以下是大家曾經提過的功能彙整：
**公共版**
1. 整體獲得與送出的SO數量、趨勢
時間、哪個坑、哪個場合(大活動highlight? 例如各種松)
2. 每月或每週?獲得與送出的SO數量、趨勢
3. 排行：獲得與送出者
4. 各坑/專案讚爆數量 etc
5. *在特定時間區段中出現哪些關鍵詞? (op，可能不會讓使用者更想使用)*
關鍵詞/文字雲/關係網絡/連結
7. 每個人都可以點擊任何人的個人版，去看每個人的狀態跟關鍵詞/文字雲，
8. 也可以去看任何坑的坑內版，看每個坑的互動與紀錄(不過這部分會牽涉到資料要集中的問題)

**坑內版** 由各坑需要什麼功能就自己決定-->**也就是串API或開源的做法**
(目前幾乎都是da0的so坑在使用，所以暫以公共板來用，坑內版優先度低)
**個人版**
1. 獲得SO數量、送出SO數量
2. 地點、場合、次數、趨勢...看想怎麼呈現)
3. 給讚或收讚排行榜，或呈現關係網絡
4. 可選擇時間
5. 可選擇看某個坑/專案
6. 關鍵詞文字雲 (個人收到或發送哪些關鍵詞、關鍵詞出現在哪些坑)etc
(技術問題：文字雲，要再確認怎麼做，因為抓太多字會太長串)
:::

### 更新-20230504 討論現階段先做好的功能
:::spoiler 點開看詳細
上述功能清單，已先用figma排出優先順序(黃-個人; 藍-公共)：
https://www.figma.com/file/bTxsXGkxWAYs3ETrjzgaFi/SO-Page%E4%BB%8B%E9%9D%A2%E5%8A%9F%E8%83%BD?node-id=0-1&t=VEMp5r79CHY6eGg6-0
#### 最優先做：
公共版 (下下禮拜)
1. 整體獲得與送出的SO數量、趨勢
時間、哪個坑、哪個場合(大活動highlight? 例如各種松)
2. 排行：獲得與送出者
3. 可以去看任何坑的坑內版，看每個坑的互動與紀錄 (filter)
個人版(下禮拜)
1. 獲得SO數量、送出SO數量
2. 可選擇看某個坑/專案
3. 排名：獲得與送出
(未來功能變多之後：可讓人自由編輯wedge，呈現自己想呈現的資料)
:::
### 5/22整理 (from5/15會議)
:::spoiler 點開看詳細資料
【公共頁面】
SO 卡片內容包含資訊：
發出者名字、收到者名字、時間、頻道、(排序編號??)
簡單統計：
- shoutout 總數 ☑
- - 使用人數
- 使用頻道數
- 各頻道使用數量 (長條圖/圓餅圖)--> 可以了解SO都在哪些頻道使用
- 一週使用趨勢 (長條圖/折線圖)--> 可以看近期社群使用SO的頻率
- 排行：誰給最多SO、誰收到最多SO
(疑慮待討論: 考慮不要放在公共版，想避免個人化。應以促進頻道使用為目標?)
- Filter (篩選):
時間、頻道、發送者、收到者、
選擇特定時間區間?
- Sort (排序):
-- 日期由近到遠或由遠到近
-- 頻道A-Z或Z-A
【個人頁面】
- 發出(YOU) & 收到 -->互酬
每張卡片包含資訊: 發送者及獲得者人名、時間、頻道、(排序編號??)
簡單統計：
- 收到數量、發出數量
- 給你SO的人數、你送SO的人數
- 排行：誰給你最多SO、你給誰最多SO-->了解彼此關係
- Filter (篩選):
時間、頻道、發送者、收到者、選擇特定時間區間?
- Sort (排序):
-- 日期由近到遠或由遠到近
-- 頻道A-Z或Z-A
:::

### 更新-[5/23會議列出SOP項目](https://g0v.hackmd.io/@noahyeh/HyPnZQqrn)

---
## UI (豆腐)
==**豆腐的儀表板：考慮把 dashboard 跟shoutout 分成兩個頁面？**==
1. 貢獻時間軸呈現上（week, month…or 顏色深淺）的優化 — for both 個人與社群page
2. SO者與被SO者可分成兩個頁面，或許用flip的方式切換。此部分技術待確認，也須確認SO者的資料有沒有被記錄 — for 個人page
3. UI因應儀表板功能升級（Tofu提供ref: worldcoin的介面） — for both 個人與社群page

以珮杏維人工作用的翻譯輔助軟體Termsoup為例跟示意

---
## 後端(昶惟)
[sob開發文件](https://g0v.hackmd.io/@_rTAcCrLS7W71XaFfUyIMg/SJEX0znzh/https%3A%2F%2Fg0v.hackmd.io%2F%40_rTAcCrLS7W71XaFfUyIMg%2Fr1CW3Wmf2%2Fhttps%253A%252F%252Fg0v.hackmd.io%252Fc%252Fr1CW3Wmf2%252Fedit%253Fedit)
### a. 後端：
1. **送出與收到的SO紀錄**，包含時間、地點（例如slack, discord, hackmd…）、場合（線下活動例如大松、線上活動例如da0-learning）--->可做到
2. 承上，同時結合POAP或是NFT增強其共有感或是紀錄的強度--->未做過，技術上可能有難度
3. 承 a. ，特定場合專用連結，從這個連結進去所發送的SO可以證明是在這個場合中發送的==--->未做過，技術上可行

### b. 資料庫：
統一的資料庫，讓未來所有人在不同平台使用的SO能夠互通且取得資料，是否使用分散式仍需要考量--->未做過，技術上可能有難度

**目前昶惟的資料庫，篩選出來的api有**：
shoutout的資料格式更新好了，包含以下：
text: 原本的shoutout
user: 這句shoutout來自誰
ts: 這句shoutout發出的timestamp
channel: 這個shoutout出現在哪個channel
有這些格式可以讓Matt後續新增在網頁顯示了(會給matt指示：哪個資料怎麼key，對應網址不一樣)~

**還可以繼續挑出來的資料：emoji**

---
### ==**工作優先順序：**==
1. 先把一些**常見bug修掉**，然後**把架構改好**，讓它在每次改動後比較不會出現bug
2. slack BOT首頁、私訊顯現資訊，或是主動發文
新加入者紀錄技能，坑主端會詢問BOT要找的人才類型，BOT可以搜尋資料庫通知坑主
3. 接著應該是**儀表板**，讓參與者用起來比較有感覺，我覺得在推廣的時候也比較好推，不然都是在背後運作感覺不到
4. Tim查data base
5. 再來是看時程，如果遇到大活動了，就試看看和活動的連結怎麼做，能不能做**專屬連結或者是專屬tag**，也結合NFT或POAP。
6. 如果沒有遇到大活動，會想把**資料庫建好讓後續的資料可以串進來**

### **更新-230509 昶惟[後端+slack介面工作時程安排](https://g0v.hackmd.io/@_rTAcCrLS7W71XaFfUyIMg/SJEX0znzh/https%3A%2F%2Fg0v.hackmd.io%2F%40_rTAcCrLS7W71XaFfUyIMg%2Fr1CW3Wmf2%2Fhttps%253A%252F%252Fg0v.hackmd.io%252Fc%252Fr1CW3Wmf2%252Fedit%253Fedit)**
* 5/12 現有bug修正，包含使用者編輯後會重複發文，以及有看到SO包含到bot發送的訊息
* 5/16 database工具選擇確定
* 5/20 開始建立database
* 5/20 收集shoutout方式變更有兩種可行方式：
* 改為使用slack內可操作的介面，可能會轉為使用modals讓使用者來輸入shoutout https://api.slack.com/surfaces/modals
* 只抓mention bot的訊息內容
* 5/31 database建立完成
* 6/07 建立操作手冊
* 6/10 開放給其他坑來使用

### **更新-230515 昶惟SOB更新
SOB更新：
1. 修改編輯之後會重複發文的bug (目前本地server可執行，雲端server遇到問題仍未解決，所以現在shoutout不會有SOB的回應:融化的臉:)
2. 修改SOB抓到自己發文的bug (完成)
3. api和邏輯檔案分開
4. SO計算有誤的問題目前不知道底層原因，推測是因為只抓7天的訊息，但是每次執行功能都只會依照最早deploy上去的資料版本進行更新，因此超過7天之後就會開始漏掉SO。暫時的解決方法先把更新訊息設定為90天份量的訊息，暫時不會有訊息漏掉的問題，實際解決問題我認為直接建制database會比較適合
5. database部分，redis and azure cache for redis設定完成，接下來要將過去的資料放進去，這部分我要再請問Tim怎麼做比較好
6. 後續再開始修改抓取SO的邏輯，利用mention bot直接將訊息送進資料庫

---
---
## 未來

L&T
DID - SBT與g0v錢包的想像可放在未來的milestone

珮杏：
未來個人史詩累積，可以進一步結合「成就背包」的概念，每個人的頁面可以彙整提及自己的句子，成為可以帶著走的成就背包。

先解決紀錄的問題，等很多人都習慣使用這套系統之後，再來處理資料所有權問題，這部分才需要用到web3工具，例如結合錢包?

昶惟：
短期來說，讓g0v and da0可以利用去增強社群的正向互動。長期來說，我希望他可以成為一個基礎建設，可以是各種工作通訊軟體的插件，就像是我們現在這樣的用法，也可以是各種內容的插件，像是一篇文章的讚賞插件、一部影片的讚賞插件，最終可以將使用者在各種地方的貢獻累積在一起並且具象出來，可以量化與質化的展示或是利用，後續可以作為DID、KYC的工具，或是其他證明的工具。

d. 連結：
與其他真人帳戶連結的方式，利用gitcoin passport--->未做過

e. 插件：
1. 讓不同的網站插入使用的方式--->未做過，技術上可能有難度
2. app上架，讓slack, discord等其他軟體的其他社群可以使用--->未做過，技術上可行

f. 開源：
讓其他人可以來完善功能或是開發屬於他們的fork--->可做到

---
## **其他問題**:
1. 可以想見這樣之後會出現大量的shoutout，有可能用字串的長度來篩選是否放進公共頁面？(關鍵詞這個方法是否困難重重? 有無替代?
2. 單純的shoutout，跟史詩紀錄的shoutout可能分別使用不同的圖或動畫嗎？關鍵詞?
3. emoji的資料可以抓嗎?
4. 圖片可以記錄嗎?
5. 可以SOP跟Slack可以雙向連結嗎?

---

## (討論中)可選擇是否顯示資訊？
珮杏：要上鏈或是如果要當成身分/貢獻的資訊應該偏向人肉的資訊，不然每條蒐集到的資訊無論類型內容都上鏈的話會叫做雜訊。

昶惟：可能要加上讓接收SO的人決定是否接受的功能，以濾掉雜訊和不符合事實的訊息。使用者即使不接受某些SO，也不會有所謂的「負評被隱藏的問題」，因為**這個工具不是全面的評價系統，不是要拿來給負評或是給意見用的**。

珮杏：注意到「選擇是否接受」和「選擇是否顯示」有所差異。很可能最後「選擇是否接受」*會做成*「選擇是否顯示」的型態，因為目前SO的內容很少不符合事實，多數是被分入雜訊。

比如「哇shoutout 昶惟，太棒了！！」，這種對當事人來說是正面的回饋，但對第三者來說是一條不知所云的資訊，所以可能會是雜訊。這種情況好像不是「選擇是否接受」，因為沒有不好接受的，而是「選擇是否顯示」成人肉資訊？

--
未來可能出現惡整的資訊或不小心寫錯的資訊，但功能需要做得更細緻，而且這裡會有個不對稱性：

對送出者來說，我講什麼話，顯示我是什麼樣的人，無論正面或負面，這跟對方接不接受是兩個獨立的事情。從言論自由跟言論負責的角度來看，只能「選擇是否顯示」
.
也就是說：
**送出者可以選擇刪除，但不能選擇不顯示，因為說話要負責；接收的人選擇是否顯示，但不能選擇刪除，因為那是別人的言論。**

在必要的時候，也可能需要有「刪除功能」，因為講錯話可以道歉，並作更正或刪除，不過刪除之後在那個時間戳記要顯示空白

**這樣初步構想，可能就會出現三個功能，依優先順序排列**：
1. 不對稱要討論，因為這牽涉到言論自由跟民主社會發言要負責任的議題，優先度高
2. 刪除功能要做，但優先度低
3. sob有無辦法跟著修正或刪除，優先度極低 (但因為目前sob有個狀況是編輯原文會重複發送，很可能狀況是同一個?

---