sensetw/sensetw

gigantic repository

sensetw

• sensemap coverage:

Gigantic repository.

Directory Structure

1. sensemap - map editor.
2. sensemap-backend - API service.
3. smo - SSR service.

Get Involved

1. workspace :: https://beta.hackfoldr.org/sense-tw

License

• MIT

sensetw's Issues

Drag a Card in a Box

Job Story

• When: 在 Box 裡面加入卡片之後
• I want to: 我會想要在 Box 上把卡片拖拉排列
• So that 讓卡片之間的相對位置幫助我思考和分析議題

UI

https://zpl.io/V189Pek

Success Criteria

• 可以選取一張卡片後拖拉

Out of Scope

1. 卡片不重疊
2. 選取多張一起拖拉

待討論

Delete a Card in Box

Job Story

• When: 我覺得這張 card 不需要出現在 Map 上，
• I want to: 我會想要從 Map 上刪掉這張 card，
• So that 不會佔 Map 的空間。

UI

https://app.zeplin.io/project/5ae1980f28546a5bbf985063/screen/5ae198fb0d87b4cc088b1ea3

Success Criteria

1. 在 Box 選取一張 Card ，刪除。
2. Card 在 Map inbox 裡仍可以找到

Out Of Scope

1. Undo
2. confirmation of delete
3. multi-select to delete

Card type assign 顏色：Q, A, Box, Note, Normal

Q, A, Box, Note, Normal
顏色固定五種
（未來才需要改顏色）
https://zpl.io/V189PMX

（Type 對應到 color，color 對應到議題分析表的欄位。）

Create a Card in Box

Job Story

• When: 我想要新增分析議題所需的重要資訊時，
• I want to: 我會想要在 Box 頁面上新增 Card，
• So that 我和其他人可以收錄這個重要資訊，成為議題分析的基石，不需要跑到 Map 上開卡再加進 box 裡。

UI

https://zpl.io/V189PMX
https://zpl.io/2y7WrXG

Fields

Card Base (object)

使用者可以編輯的：

• summary: (string, required) - the summary of a card. Max 150 characters.
  重點：AI 技術跟不上
• tags: 產業, 人才 (string) - tags separated by comma.
• source_title: (string) - the title of the source. 資料來源 Max 50 characters.
  【AI全面啟動Ⅱ：台灣企業行不行？關鍵在老闆｜天下雜誌】
• source_link: https://o.sense.tw/abcd (string) - the source url of the key information.
• description (string) - the description of a card. Max 1000 characters.
  真正的問題是，很多想做AI的人，不知道自己沒跟上最新進展。
  常常與科技大老開會，這位學者發現，台灣科技界研發產品，習慣先把產品規格開好，然後大家才去做。但AI研發必須一步步改善其精準度，有點像是做實驗，一步步排除問題，被市場接受了，就可以成為規格制定者。
  「很多基礎技術在網路上都是開源資訊，關鍵在要有真實的數據去玩，非常動態地從頭到尾調整，來找到AI產品的被使用者喜愛的關鍵點，」他直言，台灣也缺少有經驗的AI專案經理。
• type (string) - Card type: Q, A, Note, Normal.
• said_by (string) - said by who.
• stakeholders: 大學, 半導體, IT company (string) - involving stakeholders, separated by comma. 目的：意見多元性與可信度，目前為單純欄位，未來再決定要不要做成 tag 或是其他連結應用。

Card [/cards/{card_id}]

A card represents a key information extracted from a source. Sources are anything on internet, such as PDF, webpages, blog post,
video or audio.

• Attributes (Card Base)
  • id: 250FF (string, required) - the id of a card. Max 50 characters
  • created: 1415203908 (number, required) - time stamp.
  • last_updated: 7815203908 (number, required) - time stamp.
  • owner (User) - who owns this card.
  • maps (array[Map]) - the maps a card belongs to.
  • boxes (array[Box]) - the boxes a card belongs to.

預填欄位顯示（引導使用者使用）

• summary: 說重點
• tags: tag1, tag2, tag3
• source_title: 資料來源，e.g. 【AI全面啟動Ⅱ：台灣企業行不行？關鍵在老闆｜天下雜誌】
• source_link: https://o.sense.tw/abcd
• description: 資料原文摘錄與補充資訊
• type (string) - Card type: Q, A, Note, Normal.
• said_by: 誰提出的意見？ e.g. XX 大學校長 XXX
• stakeholders: 誰會被影響？（用逗號隔開）e.g. 經濟部, 半導體廠商, 大學

Success Criteria

1. 有互動區可以輸入資訊在 Card 上
2. Required 欄位未填不允許創立新卡片
3. 點選新增卡片按鈕後，新增 Card 在 Box 上
4. 新增的 Card 出現在畫面**偏下，不會被側邊欄擋到
5. Card 的大小不因為字數改變

Out Of Scope

Show key info on card

Card

• summary
• tag
• source title
• type by color

Edit a card on Map on Inspector

Job Story

• When:

1. 當我在 map 上發現卡片資訊錯誤
2. 想加入補充資訊，

• I want to: 我會想要在 Map 上點選卡片編輯修改，
• So that 卡片的資訊更正確、有更多資訊，幫助我在 map 上分類跟其他人看懂卡片要傳達的資訊

UI

https://zpl.io/V189PMX

Fields

Card Base (object)

使用者可以編輯的：

• summary: (string, required) - the summary of a card. Max 150 characters.
  重點：AI 技術跟不上
• tags: 產業, 人才 (string) - tags separated by comma.
• source_title: (string) - the title of the source. 資料來源 Max 50 characters.
  【AI全面啟動Ⅱ：台灣企業行不行？關鍵在老闆｜天下雜誌】
• source_link: https://o.sense.tw/abcd (string) - the source url of the key information.
• description (string) - the description of a card. Max 1000 characters.
  真正的問題是，很多想做AI的人，不知道自己沒跟上最新進展。
  常常與科技大老開會，這位學者發現，台灣科技界研發產品，習慣先把產品規格開好，然後大家才去做。但AI研發必須一步步改善其精準度，有點像是做實驗，一步步排除問題，被市場接受了，就可以成為規格制定者。
  「很多基礎技術在網路上都是開源資訊，關鍵在要有真實的數據去玩，非常動態地從頭到尾調整，來找到AI產品的被使用者喜愛的關鍵點，」他直言，台灣也缺少有經驗的AI專案經理。
• type (string) - Card type: Q, A, Note, Normal.
• said_by (string) - said by who.
• stakeholders: 大學, 半導體, IT company (string) - involving stakeholders, separated by comma.

Card [/cards/{card_id}]

A card represents a key information extracted from a source. Sources are anything on internet, such as PDF, webpages, blog post,
video or audio.

• Attributes (Card Base)
  • id: 250FF (string, required) - the id of a card. Max 50 characters
  • created: 1415203908 (number) - time stamp.
  • last_updated: 7815203908 (number) - time stamp.
  • owner (User) - who owns this card.

預填欄位顯示（引導使用者使用）

• summary: 說重點
• tags: tag1, tag2, tag3
• source_title: 資料來源，e.g. 【AI全面啟動Ⅱ：台灣企業行不行？關鍵在老闆｜天下雜誌】
• source_link: https://o.sense.tw/abcd
• description: 資料原文摘錄與補充資訊
• type (string) - Card type: Q, A, Note, Normal.
• said_by: 誰提出的意見？ e.g. XX 大學校長 XXX
• stakeholders: 誰會被影響？（用逗號隔開）e.g. 經濟部, 半導體廠商, 大學

Success Criteria

1. 有互動區可以輸入資訊在 Card 上
2. Required 欄位空白不允許更改，跳警告
3. 超過字數限制不允許更改，跳警告
4. Card 的大小不因為字數改變
5. 編輯完按更新之後，側邊欄的 UI 設計要讓使用者覺得有變，不然一時之間找不到卡片的改變會覺得很奇怪。
6. Card type 用選的，不是用輸入的，改完 type 會變顏色

Out Of Scope

加上基本的 selection 邏輯

Edit a Card in Map Inbox

Job Story 1 (Quick Edit)

• When: 我瀏覽 Map Inbox 顯示的 Card 主要資訊
• I want to: 我想要更正 Card 在 Map Inbox 顯示的主要資訊：Summary, Source Title, Tag, Card Type
• So that: 卡片上的資訊更能幫助我在 Map 上分類卡片

Job Story 2

• When: 我閱讀 Card 的細節側邊欄時
• I want to: 我想要在細部欄位上更正錯誤、補充說明、加入連結、加 tag 、加利害關係人
• So that: 卡片上的資訊更豐富更正確，可以幫助之後閱讀卡片的人理解卡片意義。

UI

TBD

Success Criteria

Out Of Scope

1. 點擊兩下直接在 inbox 顯示 的 quick edit

Double-click a Card to open Inspector （側邊欄）to edit

Job Story

• When: 我在 Map 和 Map Inbox 選取 Card 時
• I want to: 我想要 double-click 打開 Inspector 編輯卡片資訊
• So that: 可以比較快速直覺地打開 Inspector

UI

TBD

Success Criteria

1. double-click 單張卡片時，可以打開側邊欄 Inspector 編輯
2. 在側邊欄打開狀態，已經 uncheck 其他卡片，再去 double-click 另一張卡片時，可以切換側邊欄內容。

Out Of Scope

1. 點擊兩下直接在 map 的顯示卡片上直接編輯

待討論

目前在 box 上 double click 會打開 box，所以如果 double click 卡片會是打開編輯的話，操作會不會很混亂？

Edit said by who 修正增加意見來源 by 卡片欄位資訊

空白輸入 text 的欄位
（能不能用選的再說）
https://zpl.io/V189PMX

意見多元性與可信度
是用欄位切換可以顯示呢？ 還是卡片上的標籤顯示？
或是有利害關係人架map，box 點開可以看到特定利害關係人的發言？

Inspect a Card which is in Map Inbox

Job Story

當我對一張 Card 的內容感興趣時，
我會想要可以讀更多 Card 的細節，
讓我可以決定這張 Card 要被加到 Map 哪裡。

UI

TBD

Success Criteria

1. 在 map inbox 點選卡片後可以開啟 Card detail 側邊欄
2. 可以關掉側邊欄
3. 跟在 map 上的操作一樣

Out Of Scope

1. 浮動顯示在卡片旁邊

Drag a box on Map

Job Story

• When: 在 Map 上看到散亂的 Box 後
• I want to: 我會想要在 Map 上把 Box 拖拉排列
• So that 讓卡片之間的相對位置幫助我思考和分析議題

UI

Success Criteria

• 可以選取 a Box 後拖拉

Out of Scope

1. Box 不重疊
2. 選取多張一起拖拉

待討論

Open a box 展開 box

點開 box 會進到 box。（在 box 裡面卡片可以拖拉。）
https://zpl.io/V189Pek

改進 Canvas styles 的管理

現在是寫一整排 constants。這應該可以從 TypeScript source 裡分出來比較方便修改吧。

Hypothesis and Sensemap account integration

sense.tw + h.sense.tw 的帳號連動

Prerequisites

• https://sensetw.productboard.com/feature-board/152248-progress-by-release/features/1049039/detail
• https://sensetw.productboard.com/feature-board/152248-progress-by-release/features/1049093/detail

Success Criteria

1. 在 sensemap 建的新帳號，會在 hypothesis 自己開一個新帳號
2. 同步登入狀態

Redux actions 組織問題

Action 命名問題
Action 能直接從名字看出它是 synchronous 的或是會 asynchronously request backend 的，會比較方便。可能要討論一組動詞來區分兩種 action，例如 update 開頭的都是 synchronous、(create|delete|add|remove|move) 開頭的都是 asynchronous。這要大概整理一下會有哪些 action 再來列表會比較完整。

卡西：我理想的 actions 全部都是 async actions ，這樣才方便組合。傳回的也不該是 Promise ，而是看狀況成為 Promise<ObjectData> 或 Promise<CardData> 。修改 state 都是 side-effect 。但既然整個生態圈沒有往這個方向發展，我怎樣都 Ok 。

Assign a Card in Inbox to a Box

Job Story

當我在瀏覽 inbox 大量的卡片時，
我會想要一次選取多張 card 加入一個 box，
讓我可以迅速在 map 上分類卡片。

UI

TBD

Out Of Scope

3. 卡片消失跟出現的動畫

Success Criteria

1. 可以選取多張卡片
2. 可以取消選取單張卡片
3. 可以取消選取全部卡片
4. 可以在 box 頁面同時加入卡片
5. 在 inbox 裡面的卡片如果被加入到 map ，則將其調暗。
6. 可以在 map 頁面，點選 box，加入一張卡片
7. 拖拉卡片進 box (not implemented)
8. 按 shift 連續選取多張卡片

待討論

1. 在 inbox 裡面的卡片如果被加入到 map ，要將其隱藏、調暗還是放到後面去呢？

• 隱藏：
  • 好處：使用者有清完卡片的感覺，很清楚知道哪些資訊還沒有被放到 map 上
  • 壞處：card 消失，在沒有搜尋功能的狀況下使得使用者很難記得要找的卡片位子在哪裡，因為卡片位置會一直變動。覺得用 list 的方式說不定比較好，因為是單一往下一直找。如果是格狀的 card，光是左右位置改變就很容易會找不到。（假設使用者會用位置記 card 在哪裡的印象）而且未來想要同一張卡片放到不同 box 裡會找不到在哪裡。
• 調暗：
  • 好處：card 位置固定方便尋找。
  • 壞處： card 數量永遠不變，下一個想要的資訊可能要換好幾頁才找到。
• 放到後面：
  • 好處：可以優先看到還沒加入的 card，也可以保留 card 讓之後尋找。
  • 壞處：開發成本高。

把 Map components 都移到 Map 底下

MapCard, MapBox, MapTag 移到 Map/Card, Map/Box, Map/Tag 等等。

Unit test

決定一套慣例，開始寫 unit test。

Unbox a box 解除一個 Box

Job Story

• When: 這個 Box 的分類方式不好
• I want to: 我想要 unbox this box
• So that: 可以重新使用這些在 box 裡面的卡片

UI

https://zpl.io/VK0yenP

Success Criteria

1. 在 Map 頁面選取 Box 後可以點選 unbox 讓這個box消失，讓所屬的卡片們自由回歸到map畫面上
2. 在 box 頁面， unbox 這個 Box ，讓所屬的卡片們自由回歸到map畫面上

Out Of Scope

待討論

Assign Cards into a box

Job Story

當我在 map 上瀏覽卡片時，
我會想要一次選取多張 card 加入一個 box，
讓我可以加速，不用一張一張慢慢加

UI

先不拖拉，先用 assign 的，但是 grouping method 要再定義

1. 先用快捷鍵做 grouping：ctrl + G
2. 測試時會有小抄
   https://zpl.io/agn6wg1

Out Of Scope

1. 拖拉卡片進 box
2. 卡片消失跟出現的動畫

Success Criteria

1. 可以選取多張卡片
2. 可以取消選取單張卡片
3. 可以取消選取全部卡片
4. 可以在 map 頁面，點選 box，同時加入多張卡片
5. 一起被加入的卡片在 map 要一起出現在附近，不可以互相重疊，但是可以重疊在既有的卡片上，預設出現在中間偏下。
6. 切換 map , box 頁面的時候，原有的 selection 會 unselect

用 stateless functional component + container 的慣例

先寫出 stateless functional component，再用 container 綁上 handler 跟 state，並且把 container 放在 containers 目錄。

雖然功能上不影響，但有個一致的慣例應該會比較好維護。

Create a new Box on Map

Job Story

• When:
  1. 我發現有一群卡片可以用一個抽象概念概括時，
  2. 我先有一個分析架構時，
• I want to: 我會想要在 Map 上新增 Box，
• So that 我可以把相關的 Cards 收在 Box 裡，減少最外層的畫面複雜度。

Fields

Box Base

使用者可以編輯的，按順序：

• title: 缺乏跨界人才 (string, required) - the title of a box. Max 40 characters.
• summary: (string) - Summary of a Box. Max 150 characters.
• tags: tag1, tag2, tag3 (string) - Tags on a Box, separated by comma.

Box

• Attributes (Box Base)
  • box_id: 780FF (string, required) - the id of a box.
  • created: 1415203908 (number) - time stamp.
  • last_updated: 7815203908 (number) - time stamp.
  • owner (User) - who own this box.
  • map_id (string, required) - the id of the map it belongs to.
  • cards (array[Card]) - the cards in this box.

UI

zpl.io/2y7WrXG
https://zpl.io/VK0yenP

Success Criteria

1. 新增 Box 在 Map 上
2. 新 Box 出現在畫面中間偏下
3. Box 長的跟卡片不一樣，要可以看得出來是一個可以把東西放進去的 Box
4. Box 大小不因字數改變
5. 多的字可以自動截短顯示，或是不讓使用者輸入過長字串。
6. 用跟卡片一樣的 Inspector 側邊欄

Out Of Scope

1. 選取多張卡片直接新增一個 box，然後卡片消失
2. 可選擇 Box color

待討論

1. Box title, summary, tag 的字數限制

Leave a Box to Map

Job Story

• When: 我看完 Box 內容
• I want to: 回去看 Map
• So that: 去把這個 box 放到對的位置上

UI

https://zpl.io/VK0yenP

Success Criteria

1. 在 Box 頁面上可以點選退出回到 Map

Out Of Scope

1. Zoom in/out

待討論

Edit Tags on a Card on Inspector

User Story

• When: 我在 Map Inbox 或是 Map 閱讀卡片時
• I want to: 更新卡片上一個 tag 的文字
• So that: 方便我之後可以更精確地在卡片上瀏覽 tag 和搜尋關鍵字找出相關的卡片。

UI

TBD

Success Criteria

1. 每個卡片的側邊欄的 tag 輸入區，可以去修改一個 tag 的字串。

Add a Card in Inbox to a map

Job Story

當我在瀏覽 inbox 大量的卡片時，
我會想要一次選取多張相關的 card 加入 map，
讓我可以在 map 上把相關的卡片放在物理位置附近。

UI

TBD

Out Of Scope

1. 拖拉卡片進 map
2. 按 shift 連續選取
3. 卡片消失跟出現的動畫

Success Criteria

1. 可以選取多張卡片
2. 可以取消選取單張卡片
3. 可以取消選取全部卡片
4. 可以同時加入多張卡片
5. 一起被加入的卡片在 map 要一起出現在附近，不可以互相重疊，但是可以重疊在既有的卡片上，預設出現在中間偏下。
6. inbox 中換頁，上一頁選取的卡片仍然被選取。

待討論

1. 在 inbox 裡面的卡片如果被加入到 map ，要將其隱藏、調暗還是放到後面去呢？

• 隱藏：
  • 好處：使用者有清完卡片的感覺，很清楚知道哪些資訊還沒有被放到 map 上
  • 壞處：card 消失，在沒有搜尋功能的狀況下使得使用者很難記得要找的卡片位子在哪裡，因為卡片位置會一直變動。覺得用 list 的方式說不定比較好，因為是單一往下一直找。如果是格狀的 card，光是左右位置改變就很容易會找不到。（假設使用者會用位置記 card 在哪裡的印象）而且未來想要同一張卡片放到不同 box 裡會找不到在哪裡。
• 調暗：
  • 好處：card 位置固定方便尋找。
  • 壞處： card 數量永遠不變，下一個想要的資訊可能要換好幾頁才找到。
• 放到後面：
  • 好處：可以優先看到還沒加入的 card，也可以保留 card 讓之後尋找。
  • 壞處：開發成本高。

在 Box 裡可以拖拉卡片自由排列

Add/Edit/Delete own cards on map

User Story

身為一個使用者，我想要在一張 Map 上新增/修改/刪除一張卡片。

Create a new card on Map

Job Story

• When: 我想要新增分析議題所需的重要資訊時，
• I want to: 我會想要在 Map 上新增 Card，
• So that 我和其他人可以收錄這個重要資訊，成為議題分析的基石。

UI

https://zpl.io/V189PMX
https://zpl.io/2y7WrXG

Fields

Card Base (object)

使用者可以編輯的：

• summary: (string, required) - the summary of a card. Max 150 characters.
  重點：AI 技術跟不上
• tags: 產業, 人才 (string) - tags separated by comma.
• source_title: (string) - the title of the source. 資料來源 Max 50 characters.
  【AI全面啟動Ⅱ：台灣企業行不行？關鍵在老闆｜天下雜誌】
• source_link: https://o.sense.tw/abcd (string) - the source url of the key information.
• description (string) - the description of a card. Max 1000 characters. Quote from Hypothesis
  真正的問題是，很多想做AI的人，不知道自己沒跟上最新進展。
  常常與科技大老開會，這位學者發現，台灣科技界研發產品，習慣先把產品規格開好，然後大家才去做。但AI研發必須一步步改善其精準度，有點像是做實驗，一步步排除問題，被市場接受了，就可以成為規格制定者。
  「很多基礎技術在網路上都是開源資訊，關鍵在要有真實的數據去玩，非常動態地從頭到尾調整，來找到AI產品的被使用者喜愛的關鍵點，」他直言，台灣也缺少有經驗的AI專案經理。
• type (string) - Card type: Q, A, Note, Normal.
• said_by (string) - said by who. 「發言人」
• stakeholders: 大學, 半導體, IT company (string) - involving stakeholders, separated by comma. 目的：意見多元性與可信度，目前為單純欄位，未來再決定要不要做成 tag 或是其他連結應用。「利害關係人」

Card [/cards/{card_id}]

A card represents a key information extracted from a source. Sources are anything on internet, such as PDF, webpages, blog post,
video or audio.

• Attributes (Card Base)
  • id: 250FF (string, required) - the id of a card. Max 50 characters
  • created: 1415203908 (number) - time stamp.
  • last_updated: 7815203908 (number) - time stamp.
  • owner (User) - who owns this card.
  • maps (array[Map]) - the maps a card belongs to.
  • boxes (array[Box]) - the boxes a card belongs to.

預填欄位顯示（引導使用者使用）

• Summary (summary): 說重點
• Tag (tags): tag1, tag2, tag3
• Source Title (source_title): 資料來源，e.g. 【AI全面啟動Ⅱ：台灣企業行不行？關鍵在老闆｜天下雜誌】
• Source Link (source_link): https://o.sense.tw/abcd
• Description (description): 資料原文摘錄與補充資訊
• Card type (string) - Card type: Q, A, Note, Normal.
• Said By (said_by): 誰提出的意見？ e.g. XX 大學校長 XXX
• Stakeholders (stakeholders): 誰會被影響？（用逗號隔開）e.g. 經濟部, 半導體廠商, 大學

Success Criteria

1. 在側邊欄輸入資訊在 Card 上
2. Required 欄位未填不允許創立新卡片
3. 點選新增卡片按鈕後，新增 Card 在 Map 上
4. 新增的 Card 出現在畫面正**，不會被側邊欄擋到
5. Card 的大小不因為字數改變
6. 看得出來是在編輯卡片不是編輯 box
7. 新增到 Map Inbox

Out Of Scope

Update a Box on Inspector

Job Story

• When:
  1. 當我發現有更適合的 Box 名稱
  2. 想要補充說明 Box 時
• I want to:
  1. 我會想要在 Map 上修正 Box title, summary, tags
  2. 我會想要在 Box 打開的頁面修正 Box title, summary, tags
• So that: Box 可以更精確表達有意義的概念，讓 Map 讓人看得懂

UI

https://zpl.io/VK0yenP
從前叫做 description

Fields

Box Base

使用者可以編輯的：

• title: 缺乏跨界人才 (string, required) - the title of a box. Max 40 characters.
• summary: (string) - Summary of a Box. Max 150 characters.
• tags: tag1, tag2, tag3 (string) - Tags on a Box, separated by comma.

Success Criteria

1. 在 Map 上點選 Box 編輯後，可以在 Inspector 編輯 title, summary, tags
2. 在 Box 打開的頁面時可以點選 {XX}編輯該 Box 的 title, summary, tags

Out Of Scope

待討論

對 card content 做 summary

從前叫做 description
https://zpl.io/V189PMX

Map Toolbar v.1

Job Story

• When: 我在 Map 上要作圖的時候
• I want to: 我會想要有個工具列的按鈕可以執行所有動作
• So that 我可以把分析架構做出來

UI

UI:

https://app.zeplin.io/project/5ae1980f28546a5bbf985063/screen/5b02718513965b310fc1ba3f

Fields

• Create: open inspector to create
  • a new card
  • a new box
• Edit: open inspector to edit
• Add cards into a box: select cards and on box to add
• Move cards out of a box: select cards in a box
• Unbox a box

Success Criteria

• 工具列不擋到右邊的編輯側邊欄
• 工具列不擋到左上的 map, box 狀態切換顯示的 bar
• 工具列在 box 中仍然存在
• 選取在切換 map 和 box 後自動 unselect
• 工具列會直列黏著 Map Inbox

Batch Archived Cards in Map Inbox

Job Story

• When: 我覺得多張 card 的資訊與這個 map 無關或是品質很爛，
• I want to: 我會想要 archived 這幾張 card，
• So that 不會佔我瀏覽其他卡片的空間和注意力。

UI

TBD

Success Criteria

1. 在 Map Inbox 選取多張 Card archived 掉。
2. 會連 Map 上的 Card 一起 archived 掉。

Out Of Scope

1. Undo

研究整合 Hypothesis 時可能要用的技術

目前想到要 review 一下的幾個主題：

• 登入，應該可以用 hypothesis 當 OAuth provide 做 2-legged flow authentication.
• Backend，Prisma + PostgreSQL

原本有列入 React state management #36，但考慮後覺得完成 MVP 以後再更動這件事。

View Cards in Map Inbox

Job Story

當我打開 map inbox 時，
我會想要可以清楚快速地瀏覽大量卡片獲得重要資訊（summary & tag），
讓我可以大概知道這個 map 要處理哪些資訊與開始在 map 上分類加 box。

Fields

Card

• summary
• tag
• source title
• type by color
• owner

UI

TBD

Success Criteria

1. map inbox 打開時仍然可以看到 map 編輯頁面。
2. map inbox 頁面可以關掉。
3. 使用者可以在十分鐘內看完一百張卡片，知道有哪些 summary 和 tag。
4. 使用者可以在 30 秒內找到他已經看過，想要加入 map 的卡
5. Map Inbox 用按鈕換頁
6. Map Inbox 按照內容 update time 排，最新的排前面。

Out Of Scope

1. 滑動換頁
2. Personal inbox
3. Search result
4. Filter by tag
5. Mark/flag certain cards
6. Recommendation algorithm
7. Sorted by time, owner
8. 切換排列方式，e.g. list view, card view
9. 在 Inbox 裡可以排序，例如往左移，或是拖拉換位置。
10. 可以點擊卡片或 source link 打開 original source
    ( Above can be features in the future but not now )

待討論 with designer

隱藏 InBox 裡面已經被加入 map 的卡片

在 inbox 裡面的卡片如果 被加入到 map ，則將其隱藏。

Delete a Card on Map

Job Story

• When: 我覺得這張 card 不需要出現在 Map 上，
• I want to: 我會想要從 Map 上刪掉這張 card，
• So that 不會佔 Map 的空間。

UI

https://app.zeplin.io/project/5ae1980f28546a5bbf985063/screen/5ae198fb0d87b4cc088b1ea3

Success Criteria

1. 在 Map 選取一張 Card ，刪除。
2. Card 在 Map inbox 裡仍可以找到，未刪到 Inbox 中的卡片

Out Of Scope

1. Undo
2. confirmation of delete
3. multi-select to delete

對 box 做 summary

從前叫做 description
https://zpl.io/VK0yenP

Add Tags on a Card on Inspector

Job Story

• When: 我閱讀卡片的詳細資訊時
• I want to: 我會想要對卡片利用 tag 做分類
• So that: 方便我之後可以在卡片上瀏覽 tag 和搜尋關鍵字找出相關的卡片。

UI

TBD

Out Of Scope

1. 巢狀 Tag。
2. different type of tags

Success Criteria

1. 每個卡片的側邊欄有一個字串輸入欄可以讓使用者輸入多個 tag ，plain text 即可。 範例： "tag1, tag2, tag3"
2. tag 之間用 " , " 分割。

待討論

就是 tag 輸入後在 inspector 上的樣子： UI & RD

Code review 與搬移 prototype 到 MVP repository

• Review https://github.com/g0vggv/prototype-april
• 在 sensetw repo 建立 projects structure，含 h config 與 sensemap
• 搬移要沿用的 code
• 建立 deploy routines

Note

• https://github.com/g0vggv/h 相關的遷移另開一個 issue 處理。

Inspect a Card's details: 側邊欄：檢視、編輯 Card 細節

Job Story

• When: 當我看到 Card 的 summary 的時候
• I want to: 我會想要進一步理解細節或是編輯補充詳細資訊
• So that 我可以更理解這張卡片

UI

https://zpl.io/V189PMX
側邊欄編輯卡片細節。卡片全部先都丟到畫布上

Fields

• Card's attributes
• Button: submit or save
• Button: close

Success Criteria

1. 可以完整看到卡片資訊
2. 重要欄位在前面：

• summary: AI 技術跟不上 (string, required) - the summary of a card. Max 150 characters.
• tags: 產業, 人才 (string) - tags separated by comma.
• source_title: (string) - the title of a card. Max 50 characters.
  【AI全面啟動Ⅱ：台灣企業行不行？關鍵在老闆｜天下雜誌】

3. 使用者不能改的資訊與可輸入的欄位清楚區分。
4. Inspector 側邊欄在右邊符合使用者習慣
5. 側邊欄不浮動開啟，打開就一直放著，關掉才收起。
6. 點選換卡片的時候，側邊欄資訊應該也要換成相對應卡片
7. 側邊欄不能擋到主選單、不能擋到新增卡片的位置。

Out Of Scope

1. 浮動 inspector，例如卡片右下角跳詳細資訊

Delete tags on a Card on Inspector

User Story

身為一個使用者，會想要刪除卡片上的一個 Tag。

UI

TBD

Out Of Scope

Success Criteria

1. 每個卡片的側邊欄，在輸入區的 plain text 去刪除 tag 字串。

Drag a card on Map

Job Story

• When: 在 Map 上看到散亂的卡片後
• I want to: 我會想要在 Map 上把卡片拖拉排列
• So that 讓卡片之間的相對位置幫助我思考和分析議題

UI

Success Criteria

• 可以選取一張卡片後拖拉

Out of Scope

1. 卡片不重疊
2. 選取多張一起拖拉

待討論

合併 Load actions

現在有 load(Cards|Boxes|Objects) 有點多餘。應該一個 load action 加上 updateAt filter 就可以了，合併在一起也可以修掉 race condition 問題。

Read a Box on Map (tag 爆掉)

Job Story

• When: 我在 Map 上看很多張卡片和 Box 的時候
• I want to: 我會想要知道 Box 聚集了什麼概念或是是什麼 argument
• So that 我可以不用看細節就可以開始將卡片分類，拉架構

UI

https://app.zeplin.io/project/5ae1980f28546a5bbf985063/screen/5ae69708704f1b180b6c5f34

Fields

• title (string, required) - the summary of a card. Max 18 中文字，超過截斷（20 characters in English?）
• tags: 產業, 人才 (string) - tags separated by comma. Max 32 中文字，超過截斷。
• card_count (number): 有幾張卡在 box 裡

Success Criteria

1. 使用者自己做的 Box 應該不需要打開詳細資料即可開始做分類
2. 要顯示 title, tags（有 tag 的設計樣字）

Out Of Scope

1. 過多不必要的顏色和 icon
2. 卡片可以超連結回原始資料
3. 展開塞不下的 tag

Read a Card on Map （tag 爆掉）

Job Story

• When: 我在 Map 上看很多張卡片的時候
• I want to: 我會想要知道卡片的重點資訊是什麼
• So that 我可以不用看細節就可以開始將卡片分類，拉架構

UI

https://app.zeplin.io/project/5ae1980f28546a5bbf985063/screen/5ae69708704f1b180b6c5f34

Fields

• summary: (string, required) - the summary of a card. Max 39 中文字，超過截斷
  重點：AI 技術跟不上
• tags: 產業, 人才 (string) - tags separated by comma. Max 32 中文字，超過截斷。
• source_title: (string) - the title of the source. 資料來源 。Max 50 characters.
  【AI全面啟動Ⅱ：台灣企業行不行？關鍵在老闆｜天下雜誌】

Success Criteria

1. 使用者自己做的卡片應該不需要打開詳細資料即可開始做分類
2. 要顯示 summary, tags（有 tag 的設計樣字）
3. source title 和 link 只需要顯示 domain name，要不顯眼，要看得出來是 Source title

Out Of Scope

1. 過多不必要的顏色和 icon
2. 卡片可以超連結回原始資料
3. 展開塞不下的 tag

研究 pan & zoom 的效能

Inbox 分頁

Create a Card in Map Inbox

Job Story

• When: 我發現缺乏某重要資訊的卡片時/當我獲得有用的新資訊，卻還不知道要放在 Map 上哪裡時，
• I want to: 我會想要在 Map Inbox 新增 Card，
• So that 我和其他人可以收錄這個重要資訊，成為議題分析的基石。

UI

TBD

Fields

Card Base (object)

使用者可以編輯的：

• summary: (string, required) - the summary of a card. Max 150 characters.
  重點：AI 技術跟不上
• tags: 產業, 人才 (string) - tags separated by comma.
• source_title: (string) - the title of the source. 資料來源 Max 50 characters.
  【AI全面啟動Ⅱ：台灣企業行不行？關鍵在老闆｜天下雜誌】
• source_link: https://o.sense.tw/abcd (string) - the source url of the key information.
• description (string) - the description of a card. Max 1000 characters.
  真正的問題是，很多想做AI的人，不知道自己沒跟上最新進展。
  常常與科技大老開會，這位學者發現，台灣科技界研發產品，習慣先把產品規格開好，然後大家才去做。但AI研發必須一步步改善其精準度，有點像是做實驗，一步步排除問題，被市場接受了，就可以成為規格制定者。
  「很多基礎技術在網路上都是開源資訊，關鍵在要有真實的數據去玩，非常動態地從頭到尾調整，來找到AI產品的被使用者喜愛的關鍵點，」他直言，台灣也缺少有經驗的AI專案經理。
• type (string) - Card type: Q, A, Note, Normal.
• said_by (string) - said by who.
• stakeholders: 大學, 半導體, IT company (string) - involving stakeholders, separated by comma. 目的：意見多元性與可信度，目前為單純欄位，未來再決定要不要做成 tag 或是其他連結應用。

Card [/cards/{card_id}]

A card represents a key information extracted from a source. Sources are anything on internet, such as PDF, webpages, blog post,
video or audio.

• Attributes (Card Base)
  • id: 250FF (string, required) - the id of a card. Max 50 characters
  • created: 1415203908 (number, required) - time stamp.
  • last_updated: 7815203908 (number, required) - time stamp.
  • owner (User) - who owns this card.
  • maps (array[Map]) - the maps a card belongs to.
  • boxes (array[Box]) - the boxes a card belongs to.

預填欄位顯示（引導使用者使用）

• summary: 說重點
• tags: tag1, tag2, tag3
• source_title: 資料來源，e.g. 【AI全面啟動Ⅱ：台灣企業行不行？關鍵在老闆｜天下雜誌】
• source_link: https://o.sense.tw/abcd
• description: 資料原文摘錄與補充資訊
• type (string) - Card type: Q, A, Note, Normal.
• said_by: 誰提出的意見？ e.g. XX 大學校長 XXX
• stakeholders: 誰會被影響？（用逗號隔開）e.g. 經濟部, 半導體廠商, 大學

Success Criteria

• 新增 Card 在 Map Inbox
• 新增 Card 跟在 Map 的操作一樣
• 使用者不會搞混是新增在 Map 還是新增在 Map Inbox 裡
• 新增的 Card 會排在最前面，自動跳到第一頁
• inbox 第二頁之後不顯示 new card 的按鈕。
• 新增的卡片的 Summary 預設寫上"New Card" 的字串。
• 自動打開 New Card 的 inspector

Select a Card to assign it into a Box

Job Story

當我在 map 上瀏覽卡片時，
我會想要選取一張 card 加入一個 box，
讓我可以幫卡片分類

UI

先不拖拉，先用 assign 的，但是 grouping method 要再定義
https://zpl.io/agn6wg1

Out Of Scope

1. 拖拉卡片進 box
2. 卡片消失跟出現的動畫

Success Criteria

1. 可以選取一張卡片
2. 可以取消選取單張卡片
3. 可以在 map 頁面，點選 box，加入一張卡片