PROJECT SUMMARY
<aside>
๐
์๊ณ ๋ฆฌ์ฆ ๋ฌธ์ ์ฌ์ดํธ(ํ๋ก๊ทธ๋๋จธ์ค ยท Codeforces ยท ์ ์ฌ)์์ ํต๊ณผํ ์์ค ์ฝ๋๋ฅผ ๋ฒํผ ํ ๋ฒ์ผ๋ก GitHub ยท Notion์ ์
๋ก๋ํ๋ Chrome Extension โ 1์ธ ๊ฐ๋ฐ, ์๋ฒ ์์ด Extension๋ง์ผ๋ก ๋์ํ๊ณ Chrome ์น ์คํ ์ด์ ๋ฐฐํฌ ยท ์ด์ ์ค
</aside>
<aside>
๐งญ
์ด ์์ฝ์ ์ต์ ๋ฒ์ (v3.5.0) ๊ธฐ์ค์ด์์. ์ด์ ๋ฒ์ (Python ์คํฌ๋ฆฝํธ ยท Django ์๋ฒ ยท ๋ฐฑ์ค ์ง์)์ ๊ตฌ์กฐ์ ๊ธฐ๋ก์ ๋ฒ์ ํ์คํ ๋ฆฌ์ ๋ชจ์ ๋์์ด์.
</aside>
| ๊ธฐ๊ฐ |
2021.12 ~ ํ์ฌ (๋ง์ง๋ง ์ปค๋ฐ 2026.10, ์ต์ ๋ฆด๋ฆฌ์ค v3.5.0, Chrome ์น ์คํ ์ด) |
| ๊ตฌ๋ถ |
๊ฐ์ธ ํ๋ก์ ํธ (1์ธ) |
| ๋ด ์ญํ |
๊ธฐํ ยท Chrome Extension ๊ฐ๋ฐ ยท OAuth ๋ก๊ทธ์ธ ยท client secret ์ ๊ฑฐ(GitHub device flow, Cloudflare Workers ํ๋ก์) ยท Chrome ์น ์คํ ์ด ๋ฐฐํฌ ยท ์ ํ ์ฌ์ดํธ(Codeforces ยท ์ ์ฌ) ์ถ๊ฐ |
| ๊ธฐ์ |
JavaScript, Chrome Extension (Manifest V3), GitHub ยท Notion API, OAuth 2.0 (GitHub App device flow ยท chrome.identity), ์ ํ ํธ์คํธ ๊ถํ ยท chrome.scripting, chrome.i18n(์์ด ยท ํ๊ตญ์ด), Cloudflare Workers, GitHub Actions, node:test ยท jsdom |
| ๊ธฐ์ฌ |
์ปค๋ฐ 291๊ฐ ยท PR 185๊ฐ ๋จธ์ง ยท ์ด์ 112๊ฐ ยท ํ
์คํธ 464๊ฐ (์ ๋ถ ๋ณธ์ธ, 2026.10.26 ๊ธฐ์ค) |
| ์ ์ฅ์ |
Seojeonguk/sourceCodeUploader |
๐งฉ ๋ฌธ์ ์ ์
- ์๊ณ ๋ฆฌ์ฆ ๋ฌธ์ ๋ฅผ ํ ๋๋ง๋ค ํต๊ณผํ ์ฝ๋๋ฅผ GitHub๋ Notion์ ์ ๋ฆฌํ๋ ค๋ฉด, ์ฝ๋๋ฅผ ๋ณต์ฌํ๊ณ ๋ฌธ์ ์ ๋ณด(์ ๋ชฉ ยท ๋์ด๋ ยท ํ๊ทธ)๋ฅผ ์ฐพ์ ๋ถ์ฌ ๋ฃ๋ ๋ฐ๋ณต ์์
์ด ํ์ํ๋ค.
- โ ๋ฌธ์ ์ฌ์ดํธ ํ๋ฉด์ ์
๋ก๋ ๋ฒํผ์ ๋ถ์ฌ, ํด๋ฆญ ํ ๋ฒ์ผ๋ก ์์ค ์ฝ๋์ ๋ฌธ์ ์ ๋ณด๋ฅผ ์ํ๋ ๊ณณ์ ์ฌ๋ฆฌ๋๋ก ๋ง๋ค์๋ค.
๐ ์ฃผ์ ๊ธฐ๋ฅ
- ์
๋ก๋ ๋ฒํผ : ํ๋ก๊ทธ๋๋จธ์ค ๋ฌธ์ ํ์ด์ง(2026.04~), Codeforces์ ๋ด ์ ๋ต ์ ์ถ(2026.10~), ์ ๋ต ์ฑ์ ์งํ์ ์ ์ฌ ๋ฌธ์ ํ์ด์ง(2026.10~)์ GitHub / Notion ์
๋ก๋ ๋ฒํผ ํ์
- ์ ํ ์ฌ์ดํธ : Codeforces ยท ์ ์ฌ์ ํ์
์์ ์ผค ๋๋ง ๊ทธ ์ฌ์ดํธ ๊ถํ์ ์์ฒญํ๊ณ content script๋ฅผ ๋ฑ๋ก โ ์ฌ์ดํธ๋ฅผ ๋๋ ค๋ ๊ธฐ์กด ์ฌ์ฉ์์๊ฒ ๊ถํ ๊ฒฝ๊ณ ๊ฐ ๋จ์ง ์์ (๊ธฐ์ ์ ๊ณ ๋ฏผ 7)
- ํ์
: GitHub / Notion ํญ๋ง๋ค ๊ณ์ โ ์ ์ฅ์ ยท DB โ ์๋ ์
๋ก๋ ๋จ๊ณ, ์ค๋น๋์ง ์์ ํญ๋ถํฐ ์ด๋ฆผ, ๋คํฌ ยท ๋ผ์ดํธ ํ
๋ง, ์์ด ยท ํ๊ตญ์ด
- GitHub ์
๋ก๋ : GitHub App์ ๊ธฐ๊ธฐ ์ฝ๋(device flow)๋ก ๋ก๊ทธ์ธํ๊ณ App์ ์ค์นํ ์ ์ฅ์ ์ค ํ๋๋ฅผ ๊ณ ๋ฅด๋ฉด ๋ฌธ์ ๋ฒํธ ยท ์ธ์ด์ ๋ง๋ ํ์ผ๋ก ์ปค๋ฐ, ๊ฐ์ ๋ด์ฉ์ด๋ฉด ์ค๋ณต ์ปค๋ฐ ๋ฐฉ์ง
- Notion ์
๋ก๋ : OAuth ๋ก๊ทธ์ธ(ํ ํฐ ๊ตํ์ Cloudflare Worker ํ๋ก์) ํ ๋ฐ์ดํฐ๋ฒ ์ด์ค๋ฅผ ๊ณ ๋ฅด๋ฉด ๋ฌธ์ ์ ๋ชฉ ยท ๋์ด๋ ยท ํ๊ทธ ์์ฑ๊ณผ ์ฝ๋ ๋ธ๋ก์ ๋ด์ ํ์ด์ง ์์ฑ, ํ์ํ ์์ฑ์ด ์์ผ๋ฉด ์๋์ผ๋ก ์ถ๊ฐ(์๋ฌด DB๋ ์ฌ์ฉ)
- ๋ฌธ์ ์ ๋ณด ์์ง : ํ๋ก๊ทธ๋๋จธ์ค๋ ํ์ด์ง์์ ์ ๋ชฉ ยท ๋์ด๋ ยท ์ธ์ด๋ฅผ ์ฝ๊ณ ์๋ํฐ ๊ฐ์ฒด์์ ์ฝ๋๋ฅผ ๊ฐ์ ธ์ด, Codeforces๋ ์ ์ถ ํ์ด์ง์ ์ฝ๋์ ๋ฌธ์ ํ์ด์ง์ ๋ ์ดํ
ยท ํ๊ทธ, ์ ์ฌ์ ํ์ด์ง๊ฐ ๋ณด๋ด๋ ์ฑ์ ์์ฒญ์ ์ฝ๋์ ๊ณต๊ฐ ๋ฌธ์ ๋ฐ์ดํฐ์ ์ ๋ชฉ ยท ํฐ์ด ยท ํ๊ทธ (๋ฌธ์ ์ง๋ฌธ์ ์ฌ๋ฆฌ์ง ์์)
- ์๋ ์
๋ก๋ (ํ๋ก๊ทธ๋๋จธ์ค ยท Codeforces ยท ์ ์ฌ) : ์ต์
์ ๋ฐ๋ผ ํต๊ณผ ์ ์๋ ์
๋ก๋
๐ ๊ตฌ์กฐ
flowchart LR
U["์ฌ์ฉ์"] -->|OAuth ๋ก๊ทธ์ธ ยท ๋ชฉ๋ก์์ ์ ํ| P["Popup"]
B["ํ๋ก๊ทธ๋๋จธ์ค ยท Codeforces ยท ์ ์ฌ<br/>content script"] -->|sendMessage| BG["background<br/>service worker"]
P --> BG
BG --> ST[("chrome.storage<br/>access token")]
BG -->|host_permissions| GH["GitHub API"]
BG -->|host_permissions| N["Notion API"]
BG -->|ํ ํฐ ๊ตํ ยท ์ทจ์| PX["Notion OAuth ํ๋ก์<br/>Cloudflare Worker"]
PX --> N
- ์๋ฒ๊ฐ ์๋ค.
host_permissions๋ฅผ ๊ฐ์ง background service worker๊ฐ GitHub ยท Notion API๋ฅผ ์ง์ ํธ์ถํ๊ณ , ๋ฌธ์ ํ์ด์ง์ content script์ ํ์
์ ๋ฉ์์ง๋ก ์
๋ก๋๋ฅผ ์์ฒญํ๋ค. ์ฌ์ฉ์๋ OAuth๋ก ๋ก๊ทธ์ธํ๊ณ ์ ์ฅ์ ยท DB๋ฅผ ๋ชฉ๋ก์์ ๊ณ ๋ฅด๋ฉด ๋๋ค.
- Notion ํ ํฐ ๊ตํ์ ํ์ํ client secret๋ง์ ํ์ฅ ํ๋ก๊ทธ๋จ์ ๋ ์ ์์ด์, ์์ฒญ ๋ ๊ฐ๋ง ์ฒ๋ฆฌํ๋ Cloudflare Worker๊ฐ ๋งก๋๋ค. (๊ธฐ์ ์ ๊ณ ๋ฏผ 5)
๐ ๊ธฐ์ ์ ๊ณ ๋ฏผ