ARAY - HackMD

# ARAY ## 2024/11 ## 2024/10/06 基礎松討論可整合、優化功能 + 參考 civitech https://directory.civictech.guide/ + 增加坑、提案的分類標籤 or 既有使用技術等資料 + civitech 頁面欄位： + Categories + Project Type + Tags + Open source + Organization Type + Countries + 參考 Find tech-for-good projects https://democracylab.org/projects + Issue Areas + Technologies Used + Project Stage + Roles Needed + Organization Type + Location + 新增 chewei 整理的 SDGs、數位解方標籤到 AWS 欄位 ## 2024/10/02 Shoutout 與 ARAY 整合的討論與會者: Kay、Annie Shoutout 的功能: 這是一個slack機器人，稱為shoutout，專門紀錄大家彼此的感謝跟彼此互動 (節錄自[簡報](https://docs.google.com/presentation/d/1Nga5oUMfG3GkfFea7GImygRlZH_sX4ZJL5C7dYGK2OY/edit#slide=id.g256554d8631_0_119))，整合 slack ID，登入後可以查看個人被 shoutout 感謝的紀錄。目前 shoutout 正在找尋有沒有新的 usecase 能夠讓 shoutout 有更多得延伸應用及活化。因緣際會從基礎松的 Yvonne 得知 ARAY，看到 ARAY 也有貢獻時數及貢獻資料，所以發起這次討論看是否有機會跟 ARAY 做整合，讓 shoutout 的 data pool 能夠流動活用。由於目前 ARAY 還在資料整合階段，要等到資料整合完畢之後才會進行功能的實作及優化，暫定資料整合時間會到今年底，功能實作時間安排會在今年底或明年年初。由於坑主是 John，ARAY 的功能規劃跟實做還是會尊重 John的想法，等資料整合完畢之後，開始進行功能實作的時候再行討論 shoutout 整合的規劃及實做。 ## 2024/08/27 進度 (8/29更新) 嘗試轉換 awesome-g0v-project owner to ARAY User 1. 將 ARAY AWS 的 DynamoDB 的 Schema 下載下來 2. 透過 JS 抓出 Type 為 User 的 schema 3. 只保留 schema 中 kind 為 NON_NULL 的欄位 4. 將 schema 的 field name 轉換成 json key 5. 將 Owner json 的 value 套入上述的 json中 + Awesome g0v project Owner ```json { "source": "manual", "name": "jhuang", "github_id": "chunyenHuang", "slack_id": "@John Huang", "email": "" } ``` + Aray Schema 對應的 JSON ```json { "username": uuidv1 or v4, // 也可以用名字(jhuang)或名字加uuid (jhuang_{{uuid}}) 比較好對資料 "status": "active", "name": "jhuang", "email": "", "selfIntroduction": "", "location": "", "timeZone": "", "slackId": "@John Huang", "slackIdUrl": "", "githubId": "chunyenHuang", // 這個欄位可以加一下只需要改一下grpahql schema "githubId: String" "urlWebsite": "", "urlGithub": "", "urlLinkedIn": "", "urlFacebook": "", "urlTwitter": "", "urlInstagram": "", "totalCompletedHours": "", "totalCompletedTasks": "", "createdAt": "2024-08-27T16:08:57.623Z", // ISO timestamp "createdBy": "awesome-g0v", // 資料來源 "updatedAt": "2024-08-27T16:08:57.623Z", // ISO timestamp "updatedBy": "awesome-g0v" } /** 最後只保留 schema 中註記 kind 為 NON_NULL 的欄位 */ { "username": "jhuang_a6f2db03-77a0-4dfd-a9fc-4e243c41d1da", "status": "active", "name": "jhuang", "email": "", "createdAt": "2024-08-28T17:12:58.057Z", "createdBy": "awesome-g0v", "updatedAt": "2024-08-28T17:12:58.057Z", "updatedBy": "awesome-g0v", "slackId": "@John Huang", "githubId": "chunyenHuang" } ``` 最後，把轉好的 json 檔案放到 `https://github.com/g0v/aray/tree/develop/data/scripts` 最後會使用 script 將 json 轉進 DynamoDB 中 ## 2024/08/18 討論 ARAY 初衷: 由於目前 g0v 提案資料還是透過人工在每次大松時才新增 google sheet上的資料，相同提案、提案人容易出現不同時期新增的資料會有不同敘述或有大小寫不同的，在查找提案歷史資料或相關資源具有一定的複雜度設計ARAY是為了提升 g0v 各提案資料查詢的維護性及方便性，開放給提案者跟參與者能自行維護資料，也提升提案與提案人的資料關聯與歷史資料查找的方便性期望的目標是能夠將 goole sheet 的使用轉移至ARAY上，讓提案資料格式一致，提升資料使用跟查找上的方便性，減少人為維護的疏失 + ARAY 短中長目標 + 短期目標: 將 Awesome g0v project 既有 CSV 資料對應 ARAY GraphQL Schema 轉換成 JSON，轉換 JSON 完再透過 script 轉進 ARAY DynamoDB + ARAY 中長期目標 + 修復使用者權限功能 + 依循初衷持續完善網站功能 ## 資料轉換對應表 |Awesome g0v project| ARAY Table| |--|--| owners.csv| User| projects.csv| Project| ### ARAY User Table 資料對應(8/29更新) |Schema欄位|資料來源/參考 [Owner CSV](https://github.com/chunyenHuang/awesome-g0v-projects/blob/master/data/owners.csv)|備註 |--|--|--| username|`Awesome-g0v-project.oweners.name_{{uuid v4}}`|先暫定 name_uuid 方便未來改用 aws cognito 時回填aws cognito id 回來 name|`Awesome-g0v-project.oweners.name` slackId|`Awesome-g0v-project.oweners.slack_id` githubId|`Awesome-g0v-project.oweners.github_id` createdAt|ISO timestamp|建立 json 當下的 datetime轉 ISO格式 createdBy|"awesome-g0v"|從 awesome-g0v 來的資料固定寫死 updatedAt|ISO timestamp|建立 json 當下的 datetime轉 ISO格式 updatedBy|"awesome-g0v"|從 awesome-g0v 來的資料固定寫死 ### ARAY Event Table 資料對應 |Schema欄位|資料來源/參考| |--|--| name|g0v database.[大松提案列表](https://docs.google.com/spreadsheets/d/1C9-g1pvkfqBJbfkjPB0gvfBbBxVlWYJj6tTVwaI5_x8/edit?gid=1563040282#gid=1563040282&fvid=1102076775).event name ### ARAY Project Table 資料對應 ![image](https://hackmd.io/_uploads/B1tPY3wbkl.png) [projects CSV](https://github.com/chunyenHuang/awesome-g0v-projects/blob/master/data/projects.csv) + Awesome g0v project 資料(JSON版) ```json { "source": "g0v_db", "name": "g0v underground", "description": "", "g0v_db_rows": 879, "owners": "Sam", "tags": "待確認", "github_repos": "", "homepage": "#g0vpodcast" } ``` + ARAY JSON 格式 ```json { "id": "c6d53e20-f134-11ec-bd73-ef5ea4e8c08e", "__typename": "Project", "createdAt": "2022-06-21T07:35:51.809Z", "createdBy": "analeighg0v", "description": "{\"\"blocks\"\":[{\"\"key\"\":\"\"cdqhm\"\",\"\"text\"\":\"\"「不要問為什麼沒有人錄這個？你就是「沒有人」！」\"\",\"\"type\"\":\"\"unstyled\"\",\"\"depth\"\":0,\"\"inlineStyleRanges\"\":[],\"\"entityRanges\"\":[],\"\"data\"\":{}},{\"\"key\"\":\"\"6u3cn\"\",\"\"text\"\":\"\"\"\",\"\"type\"\":\"\"unstyled\"\",\"\"depth\"\":0,\"\"inlineStyleRanges\"\":[],\"\"entityRanges\"\":[],\"\"data\"\":{}},{\"\"key\"\":\"\"41orc\"\",\"\"text\"\":\"\"g0v 是一個公民社群，致力於加深公民對社會的貢獻以及彼此間的連結。透過 g0v 社群，你可以在這裡尋找志同道合的夥伴，實踐你的理念，並將成果以開放授權模式釋出，讓更多的人可以站在你的成果上接力賽跑。\"\",\"\"type\"\":\"\"unstyled\"\",\"\"depth\"\":0,\"\"inlineStyleRanges\"\":[],\"\"entityRanges\"\":[],\"\"data\"\":{}},{\"\"key\"\":\"\"4batk\"\",\"\"text\"\":\"\"\"\",\"\"type\"\":\"\"unstyled\"\",\"\"depth\"\":0,\"\"inlineStyleRanges\"\":[],\"\"entityRanges\"\":[],\"\"data\"\":{}},{\"\"key\"\":\"\"98qpq\"\",\"\"text\"\":\"\"「g0v underground podcast」是 g0v 成立十週年後，再次從原本「g0v underground 零時電台」重啟展開的社群專案。接下來我們將會在這個 podcast 節目中跟聽眾分享 g0v專案、g0v貢獻者，以及很多關於 g0v 公民科技社群的專案幕後故事。\"\",\"\"type\"\":\"\"unstyled\"\",\"\"depth\"\":0,\"\"inlineStyleRanges\"\":[],\"\"entityRanges\"\":[],\"\"data\"\":{}}],\"\"entityMap\"\":{}}", "intros": [], "links": [ { "M": { "name": { "S": "收聽平台" }, "url": { "S": "https://linktr.ee/g0vpodcast" } } }, { "M": { "name": { "S": "節目共筆" }, "url": { "S": "https://g0v.hackmd.io/@podcast/main" } } } ], "managers": [], "name": "g0v Underground 零時電台", "owner": "analeighg0v", "slackChannel": "#g0vpodcast", "slackChannelUrl": "https://g0v-tw.slack.com/archives/C02QA1JNHAR", "status": "active", "summary": "g0v 社群 Podcast 節目 by g0v 沒有人。節目隔週更新。與聽眾分享 g0v專案、g0v貢獻者，以及很多關於 g0v 公民科技社群的專案幕後故事。", "totalCompletedHours": 10, "totalCompletedTasks": 1, "totalContributors": "", "updatedAt": "2022-06-21T08:57:37.306Z", "updatedBy": "System" } ``` |Schema欄位|資料來源/參考 [projects CSV](https://github.com/chunyenHuang/awesome-g0v-projects/blob/master/data/projects.csv)|備註 |--|--|--| |altName| |categorys| |contributors| createdAt|| description||專案首頁內文 governmentAgencies| id| intros| links||文件連結 managers| name| needs| owner||坑主 slackChannel||channel `#頻道名` slackChannelUrl||channel url status| summary||專案側邊欄介紹文 tags| totalCompletedHours| totalCompletedTasks| totalContributors| updatedAt| updatedBy ### Owner 整併對應表整併相似名字判斷依據: 1. 重複的名字，以最早出現名字的為主 2. 同名同字只有大小寫差異的，會以大寫為優先 3. 如果英文名字同名，但也有冠姓氏的同名英文名字暫時不合併，除非提案看起來是有類似的內容才會替換成有姓氏的英文名字 2024/10/13 更新 |名稱|相似名稱/替換後名稱|相關提案|備註 |---|---|---|---| MrOrz (Johnson)|MrOrz| mrorz|MrOrz| Bestian|bestian|教育元語言克羅依 / ddio|克羅依,ddio| (有誰可以幫我廣告 XD 沒人的話就刪掉吧 =w=)|unkown|公民運動後勤表單、SOP|會先替換成 unknow ETblue ipa|ETBlue,ipa|g0v基礎建設- 首頁2.0 etblue|ETBlue|憲動盟野生官網野生部落格 ET Blue|ETblue|動民主 404失蹤兒童協尋計畫 eddie|Eddie|信差 - 社運鄉民出來走 eli|Eli|n/a fi|Fi|市議員在幹嘛 hc|HC|政治獻金開放 irvin|Irvin|CC0 中文句庫 - 統計工具 Common Voice 語音庫 Mozilla Common Voice 語音資料庫收集 新的 Firefox 出 4 週了，沒有人來更新 moztw.org 跟 release notes 啊～, 來 slack #rand0m 聊天 Common Voice 來錄音 & 整理 #rand0m 文字語料 Firefox release notes 翻譯 / 摩茲工寮 2020 營運報告 / CC0 語料庫 isabel Hou|Isabel|g0v宣言台語版、英語版、多國語言版 憲餅互動小鋪 憲餅廚房 Slack 歡迎訊息與 Channel 完補計畫 🙋 g0v 首頁社群治理頁面 九週年：g0v 時間軸以及 10 週年相關 jinwen|JinWen|疫情解封指引 Joy|Joyhsu|國會調查兵團開放公督盟數據API ivod下載器UI改寫|無法判斷是不是同一人 kirby|Kirby|選區視覺化 kirstenliu|Kirsten|小蜜蜂戰鬥隊覆蓋率地圖視覺化 Ly|LY|summer of ? 立法院 ivod下載網 mglee|Mg Lee|十週年生日趴 liz|Liz|n/a| lulu|Lulu|珊瑚體檢十年數據怎麼看 Macpaul/Mindos|Macpaul,Mindos|逆滲透 - 開放資料研究社 Michael_LI|Michael LI|全民除黴計畫 APP4AM（新聞啄木鳥APP）＆其他專案 八仙塵爆　新聞分析（80天） 假新聞的主題：籌辦演講會／大松來玩桌遊《抓誑新聞》 影片逐字稿自動化 & 整理系統 文本分析器（用魚骨圖討論事情） 新聞後面．觀眾留言的存檔（爬蟲機器人） 服貿專題網 沒有人在乎的「假新聞受害者」　－　X 媒體計劃 這個社會的新聞樣貌：以八仙塵爆意外為起點 連續錄影數十台新聞頻道，監督選舉假資訊傳播／紅色媒體，資訊戰，假新聞 Michael_LI（新聞松 x 媒觀）|Michael LI|「新聞分析指標」以及「轉檔工具」 Michael_LI（VT System 開發團隊）|Michael LI|影片聲音文字圖片整理系統－－政府與民眾社會對話還原裝置 mindos|Mindos|國土管理局報告 `Muyueh `|Muyueh| muyueh|Muyueh|展覽松 菜價 食用油測試 AI 製圖坑 peggy|Peggy|「假的！」-- 護病比資料查詢 ronny|Ronny|立委 say it g0v 十週年參與者徽章 線上揪松 & 2D 揪松 發文附上判決書運動 ronnywang|Ronny Wang|Dev-Env 斧頭幫大挑戰 台灣法院判決書可分享網址產生器 台灣內閣變化 地址轉經緯度 ?|unknow|Child Not Found ttcat|Ttcat|g0v-shadow 影子政府網站 廢核連署平台 Y.D. Lin|Y.D Lin| yurenju|Yuren Ju|勞基法函式庫：勞基法相關應用的基石 Yuren|Yuren Ju|勞基法計算機 - 變形工時實作 `[FtO] pm5`|pm5| bess|Bess `chewei `|chewei| 救松團 chewei|chewei|來救松 chihao（代）|chihao|鄉民看電視 jslee|jsleetw|寵物需要我 Pet Need Me viola|Viola|全台公立動物收容所資訊統整劉李(night17x)|劉李揪松|揪松團|elixus 到 g0v 之 ilya 紀念共筆理查|理查 (monaludao)|開放都市-委員會會議記錄資料庫 開放都市計畫 - API + 前端設計 開放都市計畫:委員會會議紀錄 開放都市計畫 蓮霧+胖胖|蓮霧,胖胖蕭a|蕭A|國家寶藏易樓網 - 鄭淑麗|鄭淑麗|實價登錄 2.0 & 臺灣公寓大廈資料庫 seangau|SeanGau|陳東甫老師教學系統開源計畫 藝文活水向哪流 Claire/ Weichen|Claire,Weichen|開放國會 Fly|fly|生命、宇宙以及萬事萬物的終極答案？ 分心衝動好動者聯盟 醬即興 jothon(ichieh)|ichieh|g0v Podcast |cheintai|chientai|南庄桐花松．賞花、農業、做專案 (活動籌備中) Ted (同上)|Ted|零時樂團 peter|Peter|疫情紓困資訊彙整 運動爭議時間軸 一起來辦趴：十週年零宇宙大爆炸 一起來擺攤 ` Vic`|Vic xing|Xing|學習鏈宥伯=工友=unknow|宥伯|資料治理與公私協力的可能性 paul|Paul|韌性松、數位韌性、戰時韌性 RS Chiang|RSChiang|N/A tofus|Tofus|g0v Design yellowsoar & Dong|yellowsoar,Dong 進良|進良Thomas|LLM我的家鄉 ` 任翔 Sean`|任翔 Sean|Collage NIna&Alex|NIna,Alex|WizardAmigos CodeCamps 世界和平（Huanry）|Huanry|S-E-E 永續所得指標 wancat（宏信）|宏信|indieveloper 獨立開發者 Denken|denkeni|立法院大小聲 peii / yukai|peii,yukai Ziv/Peling/Dennis|Ziv,Peling,Dennis|The good, bad and ugly of Emergency Data

Syntax	Example	Reference
# Header	Header	基本排版
- Unordered List	Unordered List
1. Ordered List	Ordered List
- [ ] Todo List	Todo List
> Blockquote	Blockquote
Bold font	Bold font
Italics font	Italics font
~~Strikethrough~~	~~Strikethrough~~
19^th^	19^th
H~2~O	H₂O
++Inserted text++	Inserted text
==Marked text==	Marked text
[link text](https:// "title")	Link
![image alt](https:// "title")	Image
`Code`	`Code`	在筆記中貼入程式碼
```javascript var i = 0; ```	`var i = 0;`
:smile:		Emoji list
{%youtube youtube_id %}	Externals
$L^aT_eX$	L^aT_eX
:::info This is a alert area. :::	This is a alert area.