diff --git a/README.md b/README.md index 51abd25..894884a 100644 --- a/README.md +++ b/README.md @@ -1 +1,146 @@ -# javascript-subway-final \ No newline at end of file +# ๐Ÿš‡ ์ง€ํ•˜์ฒ  ๋…ธ์„ ๋„ ๊ฒฝ๋กœ ์กฐํšŒ ๋ฏธ์…˜ +- ๋“ฑ๋ก๋œ ์ง€ํ•˜์ฒ  ๋…ธ์„ ๋„์—์„œ ๊ฒฝ๋กœ๋ฅผ ์กฐํšŒํ•˜๋Š” ๊ธฐ๋Šฅ์„ ๊ตฌํ˜„ํ•œ๋‹ค. + +## ๐Ÿš€ ๊ธฐ๋Šฅ ์š”๊ตฌ์‚ฌํ•ญ +> ํ”„๋ฆฌ์ฝ”์Šค 3์ฃผ์ฐจ ๋ฏธ์…˜์—์„œ ์‚ฌ์šฉํ•œ ์ฝ”๋“œ๋ฅผ ์ฐธ๊ณ ํ•ด๋„ ๋ฌด๊ด€ํ•˜๋‹ค. + +### ์ดˆ๊ธฐ ์„ค์ • +- ํ”„๋กœ๊ทธ๋žจ ์‹œ์ž‘ ์‹œ ์—ญ, ๋…ธ์„ , ๊ตฌ๊ฐ„ ๋ฐ์ดํ„ฐ๋ฅผ ์ดˆ๊ธฐ ์„ค์ • ํ•ด์•ผ ํ•œ๋‹ค. +- ๊ฑฐ๋ฆฌ์™€ ์†Œ์š” ์‹œ๊ฐ„์€ ์–‘์˜ ์ •์ˆ˜์ด๋ฉฐ ๋‹จ์œ„๋Š” km์™€ ๋ถ„์„ ์˜๋ฏธํ•œ๋‹ค. +- ์•„๋ž˜์˜ ์‚ฌ์ „ ๋“ฑ๋ก ์ •๋ณด๋กœ ๋ฐ˜๋“œ์‹œ ์ดˆ๊ธฐ ์„ค์ •์„ ํ•œ๋‹ค. + +``` +1. ์ง€ํ•˜์ฒ ์—ญ์œผ๋กœ ๊ต๋Œ€, ๊ฐ•๋‚จ, ์—ญ์‚ผ, ๋‚จ๋ถ€ํ„ฐ๋ฏธ๋„, ์–‘์žฌ, ์–‘์žฌ์‹œ๋ฏผ์˜์ˆฒ, ๋งค๋ด‰ ์—ญ ์ •๋ณด๊ฐ€ ๋“ฑ๋ก๋˜์–ด ์žˆ๋‹ค. +2. ์ง€ํ•˜์ฒ  ๋…ธ์„ ์œผ๋กœ 2ํ˜ธ์„ , 3ํ˜ธ์„ , ์‹ ๋ถ„๋‹น์„ ์ด ๋“ฑ๋ก๋˜์–ด ์žˆ๋‹ค. +3. ๋…ธ์„ ์— ์—ญ์ด ์•„๋ž˜์™€ ๊ฐ™์ด ๋“ฑ๋ก๋˜์–ด ์žˆ๋‹ค.(์™ผ์ชฝ ๋์ด ์ƒํ–‰ ์ข…์ ) + - 2ํ˜ธ์„ : ๊ต๋Œ€ - ( 2km / 3๋ถ„ ) - ๊ฐ•๋‚จ - ( 2km / 3๋ถ„ ) - ์—ญ์‚ผ + - 3ํ˜ธ์„ : ๊ต๋Œ€ - ( 3km / 2๋ถ„ ) - ๋‚จ๋ถ€ํ„ฐ๋ฏธ๋„ - ( 6km / 5๋ถ„ ) - ์–‘์žฌ - ( 1km / 1๋ถ„ ) - ๋งค๋ด‰ + - ์‹ ๋ถ„๋‹น์„ : ๊ฐ•๋‚จ - ( 2km / 8๋ถ„ ) - ์–‘์žฌ - ( 10km / 3๋ถ„ ) - ์–‘์žฌ์‹œ๋ฏผ์˜์ˆฒ +``` + +### ๊ฒฝ๋กœ ์กฐํšŒ ๊ธฐ๋Šฅ + + +- ์ถœ๋ฐœ์—ญ๊ณผ ๋„์ฐฉ์—ญ์„ ์ž…๋ ฅ๋ฐ›์•„ ๊ฒฝ๋กœ๋ฅผ ์กฐํšŒํ•œ๋‹ค. +- ๊ฒฝ๋กœ ์กฐํšŒ ์‹œ ์ด ๊ฑฐ๋ฆฌ, ์ด ์†Œ์š” ์‹œ๊ฐ„์„ ํ•จ๊ป˜ ์ถœ๋ ฅํ•œ๋‹ค. +- ๊ฒฝ๋กœ ์กฐํšŒ ์‹œ `์ตœ๋‹จ ๊ฑฐ๋ฆฌ` ๋˜๋Š” `์ตœ์†Œ ์‹œ๊ฐ„` ์˜ต์…˜์„ ์„ ํƒํ•  ์ˆ˜ ์žˆ๋‹ค. + +### ์˜ˆ์™ธ ์ฒ˜๋ฆฌ +- ์ถœ๋ฐœ์—ญ๊ณผ ๋„์ฐฉ์—ญ์€ 2๊ธ€์ž ์ด์ƒ์ด์–ด์•ผ ํ•œ๋‹ค. +- ์กด์žฌํ•˜์ง€ ์•Š๋Š” ์—ญ์„ ์ถœ๋ฐœ์—ญ ๋˜๋Š” ๋„์ฐฉ์—ญ์œผ๋กœ ์ž…๋ ฅํ•  ์ˆ˜ ์—†๋‹ค. +- ๊ฒฝ๋กœ ์กฐํšŒ ์‹œ ์ถœ๋ฐœ์—ญ๊ณผ ๋„์ฐฉ์—ญ์ด ๊ฐ™์„ ์ˆ˜ ์—†๋‹ค. +- ๊ฒฝ๋กœ ์กฐํšŒ ์‹œ ์ถœ๋ฐœ์—ญ๊ณผ ๋„์ฐฉ์—ญ์ด ์—ฐ๊ฒฐ๋˜์ง€ ์•Š์œผ๋ฉด ๊ฒฝ๋กœ๋ฅผ ์กฐํšŒํ•  ์ˆ˜ ์—†๋‹ค. +- ๊ทธ ์™ธ ์ •์ƒ์ ์œผ๋กœ ํ”„๋กœ๊ทธ๋žจ์ด ์ˆ˜ํ–‰๋˜์ง€ ์•Š์€ ๊ฒฝ์šฐ `alert`์œผ๋กœ ์—๋Ÿฌ๋ฅผ ์ถœ๋ ฅํ•œ๋‹ค. + +
+ +## ๐Ÿ’ป ํ”„๋กœ๊ทธ๋ž˜๋ฐ ์‹คํ–‰ ๊ฒฐ๊ณผ +### ๊ฒฝ๋กœ ์กฐํšŒ + + + +## โœ… ํ”„๋กœ๊ทธ๋ž˜๋ฐ ์š”๊ตฌ์‚ฌํ•ญ +### ๊ธธ์ฐพ๊ธฐ ๊ด€๋ จ ๊ธฐ๋Šฅ +- ์ถœ๋ฐœ์—ญ์„ ์ž…๋ ฅํ•˜๋Š” input ํƒœ๊ทธ๋Š” `departure-station-name-input` id ์†์„ฑ๊ฐ’์„ ๊ฐ€์ง„๋‹ค. +- ๋„์ฐฉ์—ญ์„ ์ž…๋ ฅํ•˜๋Š” input ํƒœ๊ทธ๋Š” `arrival-station-name-input` id ์†์„ฑ๊ฐ’์„ ๊ฐ€์ง„๋‹ค. +- ์ตœ๋‹จ๊ฑฐ๋ฆฌ, ์ตœ์†Œ์‹œ๊ฐ„์„ ์„ ํƒํ•˜๋Š” radio๋Š” `search-type` name ์†์„ฑ๊ฐ’์„ ๊ฐ€์ง„๋‹ค. + - **radio option์˜ default ๊ฐ’์€ ์ตœ๋‹จ๊ฑฐ๋ฆฌ์ด๋‹ค.** +- ๊ธธ์ฐพ๊ธฐ ๋ฒ„ํŠผ์€ `search-button` id ์†์„ฑ๊ฐ’์„ ๊ฐ€์ง„๋‹ค. +- ๐Ÿ“ ๊ฒฐ๊ณผ๋Š” `table`์„ ์ด์šฉํ•˜์—ฌ ๋ณด์—ฌ์ค€๋‹ค. + +## โ—๏ธํžŒํŠธ +## ๋ฐ์ดํ„ฐ ์ดˆ๊ธฐํ™” +์ž๋ฐ”์Šคํฌ๋ฆฝํŠธ์—์„œ ๋ฐ์ดํ„ฐ๋ฅผ ์ดˆ๊ธฐํ™”ํ•˜๋Š” ๋ฐฉ๋ฒ• ์ค‘์— ํ•˜๋‚˜๋Š” ์•„๋ž˜์™€ ๊ฐ™์ด data๋ฅผ `export`ํ•˜๊ณ , `import`ํ•˜๋Š” ๊ฒƒ์ด๋‹ค. + +```javascript +export const users = [ + { + name: 'Alt' + }, + { + name: 'Jamie' + }, + { + name: 'Sony' + } +] + +export const courses = [ + { + name: 'frontend', + }, + { + name: 'backend', + }, + { + name: 'iOS', + }, + { + name: 'Android', + } +] + +``` +์œ„์™€ ๊ฐ™์ด ๋ฐ์ดํ„ฐ๋ฅผ `export`ํ•˜๋ฉด ์•„๋ž˜์™€ ๊ฐ™์ด ๋ฐ์ดํ„ฐ๋ฅผ `import` ํ•˜์—ฌ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ๋‹ค. +```javascript +import { users, courses } from './data.js' + +function App() { + this.users = users + this.courses = courses +} +``` + +## ์ตœ๋‹จ ๊ฒฝ๋กœ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ +- `utils/Dijkstra.js` ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋ฅผ ํ™œ์šฉํ•˜๋ฉด ๊ฐ„ํŽธํ•˜๊ฒŒ ์ตœ๋‹จ๊ฑฐ๋ฆฌ๋ฅผ ์กฐํšŒํ•  ์ˆ˜ ์žˆ๋‹ค. +- ์ •์ (Vertex)๊ณผ ๊ฐ„์„ (Edge), ๊ทธ๋ฆฌ๊ณ  ๊ฐ€์ค‘์น˜ ๊ฐœ๋…์„ ์ด์šฉ + - ์ •์ : ์ง€ํ•˜์ฒ ์—ญ + - ๊ฐ„์„ : ์ง€ํ•˜์ฒ ์—ญ ์—ฐ๊ฒฐ์ •๋ณด + - ๊ฐ€์ค‘์น˜: ๊ฑฐ๋ฆฌ or ์†Œ์š” ์‹œ๊ฐ„ +- ์ตœ๋‹จ ๊ฑฐ๋ฆฌ ๊ธฐ์ค€ ์กฐํšŒ ์‹œ ๊ฐ€์ค‘์น˜๋ฅผ ๊ฑฐ๋ฆฌ๋กœ ์„ค์ • +- ์ตœ์†Œ ์‹œ๊ฐ„ ๊ธฐ์ค€ ์กฐํšŒ ์‹œ ๊ฐ€์ค‘์น˜๋ฅผ ์‹œ๊ฐ„์œผ๋กœ ์„ค์ • + +```javascript +import Dijkstra from "./utils/Dijkstra.js"; +const dijkstra = new Dijkstra() + +//dijkstra.addEdge("์ถœ๋ฐœ์—ญ", "๋„์ฐฉ์—ญ", ๊ฑฐ๋ฆฌ ๋˜๋Š” ์‹œ๊ฐ„); +dijkstra.addEdge("V1", "V2", 2); +dijkstra.addEdge("V2", "V3", 2); +dijkstra.addEdge("V1", "V3", 100); + +const result = dijkstra.findShortestPath("V1", "V3"); +// result = ["V1", "V2", "V3"] +``` + +#### ํ…Œ์ŠคํŠธ์„ค๋ช… + + +- ์—ญ ์‚ฌ์ด์˜ ๊ฑฐ๋ฆฌ๋ฅผ ๊ณ ๋ คํ•˜์ง€ ์•Š๋Š” ๊ฒฝ์šฐ V1->V3 ๊ฒฝ๋กœ๊ฐ€ ์ตœ๋‹จ ๊ฒฝ๋กœ +- ์—ญ ์‚ฌ์ด์˜ ๊ฑฐ๋ฆฌ๋ฅผ ๊ณ ๋ คํ•  ๊ฒฝ์šฐ V1->V3 ๊ฒฝ๋กœ์˜ ๊ฑฐ๋ฆฌ๋Š” 100km, V1->V2->V3 ๊ฒฝ๋กœ์˜ ๊ฑฐ๋ฆฌ๋Š” 4km์ด๋ฏ€๋กœ ์ตœ๋‹จ ๊ฒฝ๋กœ๋Š” V1->V2->V3 + +
+ +### ์š”๊ตฌ์‚ฌํ•ญ +- ์‚ฌ์šฉ์ž๊ฐ€ ์ž˜๋ชป๋œ ์ž…๋ ฅ ๊ฐ’์„ ์ž‘์„ฑํ•œ ๊ฒฝ์šฐ `alert`์„ ์ด์šฉํ•ด ๋ฉ”์‹œ์ง€๋ฅผ ๋ณด์—ฌ์ฃผ๊ณ , ์žฌ์ž…๋ ฅํ•  ์ˆ˜ ์žˆ๊ฒŒ ํ•œ๋‹ค. +- ์™ธ๋ถ€ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ(jQuery, Lodash ๋“ฑ)๋ฅผ ์‚ฌ์šฉํ•˜์ง€ ์•Š๊ณ , ์ˆœ์ˆ˜ Vanilla JS๋กœ๋งŒ ๊ตฌํ˜„ํ•œ๋‹ค. +- **์ž๋ฐ”์Šคํฌ๋ฆฝํŠธ ์ฝ”๋“œ ์ปจ๋ฒค์…˜์„ ์ง€ํ‚ค๋ฉด์„œ ํ”„๋กœ๊ทธ๋ž˜๋ฐ** ํ•œ๋‹ค + - [https://google.github.io/styleguide/jsguide.html](https://google.github.io/styleguide/jsguide.html) + - [https://ui.toast.com/fe-guide/ko_CODING-CONVENSION/](https://ui.toast.com/fe-guide/ko_CODING-CONVENTION) +- **indent(์ธ๋ดํŠธ, ๋“ค์—ฌ์“ฐ๊ธฐ) depth๋ฅผ 3์ด ๋„˜์ง€ ์•Š๋„๋ก ๊ตฌํ˜„ํ•œ๋‹ค. 2๊นŒ์ง€๋งŒ ํ—ˆ์šฉ**ํ•œ๋‹ค. + - ์˜ˆ๋ฅผ ๋“ค์–ด while๋ฌธ ์•ˆ์— if๋ฌธ์ด ์žˆ์œผ๋ฉด ๋“ค์—ฌ์“ฐ๊ธฐ๋Š” 2์ด๋‹ค. + - ํžŒํŠธ: indent(์ธ๋ดํŠธ, ๋“ค์—ฌ์“ฐ๊ธฐ) depth๋ฅผ ์ค„์ด๋Š” ์ข‹์€ ๋ฐฉ๋ฒ•์€ ํ•จ์ˆ˜(๋˜๋Š” ๋ฉ”์†Œ๋“œ)๋ฅผ ๋ถ„๋ฆฌํ•˜๋ฉด ๋œ๋‹ค. +- **ํ•จ์ˆ˜(๋˜๋Š” ๋ฉ”์†Œ๋“œ)์˜ ๊ธธ์ด๊ฐ€ 15๋ผ์ธ์„ ๋„˜์–ด๊ฐ€์ง€ ์•Š๋„๋ก ๊ตฌํ˜„ํ•œ๋‹ค.** + - ํ•จ์ˆ˜(๋˜๋Š” ๋ฉ”์†Œ๋“œ)๊ฐ€ ํ•œ ๊ฐ€์ง€ ์ผ๋งŒ ์ž˜ ํ•˜๋„๋ก ๊ตฌํ˜„ํ•œ๋‹ค. +- ๋ณ€์ˆ˜ ์„ ์–ธ์‹œ [var](https://developer.mozilla.org/ko/docs/Web/JavaScript/Reference/Statements/var) ๋ฅผ ์‚ฌ์šฉํ•˜์ง€ ์•Š๋Š”๋‹ค. [const](https://developer.mozilla.org/ko/docs/Web/JavaScript/Reference/Statements/const) ์™€ [let](https://developer.mozilla.org/ko/docs/Web/JavaScript/Reference/Statements/let) ์„ ์‚ฌ์šฉํ•œ๋‹ค. +- [import](https://developer.mozilla.org/ko/docs/Web/JavaScript/Reference/Statements/import) ๋ฌธ์„ ์ด์šฉํ•ด ์Šคํฌ๋ฆฝํŠธ๋ฅผ ๋ชจ๋“ˆํ™”ํ•˜๊ณ  ๋ถˆ๋Ÿฌ์˜ฌ ์ˆ˜ ์žˆ๊ฒŒ ๋งŒ๋“ ๋‹ค. +- [template literal](https://developer.mozilla.org/ko/docs/Web/JavaScript/Reference/Template_literals)์„ ์ด์šฉํ•ด ๋ฐ์ดํ„ฐ์™€ html string์„ ๊ฐ€๋…์„ฑ ์ข‹๊ฒŒ ํ‘œํ˜„ํ•œ๋‹ค. + +
+ +## ๐Ÿ“ ๋ฏธ์…˜ ์ €์žฅ์†Œ ๋ฐ ์ง„ํ–‰ ์š”๊ตฌ์‚ฌํ•ญ + +- ๋ฏธ์…˜์€ [https://github.com/woowacourse/javascript-subway-path-precourse](https://github.com/woowacourse/javascript-subway-path-precourse) ์ €์žฅ์†Œ๋ฅผ fork/cloneํ•ด ์‹œ์ž‘ํ•œ๋‹ค. +- **๊ธฐ๋Šฅ์„ ๊ตฌํ˜„ํ•˜๊ธฐ ์ „์— javascript-subway-path-precourse/docs/README.md ํŒŒ์ผ์— ๊ตฌํ˜„ํ•  ๊ธฐ๋Šฅ ๋ชฉ๋ก**์„ ์ •๋ฆฌํ•ด ์ถ”๊ฐ€ํ•œ๋‹ค. +- **git์˜ commit ๋‹จ์œ„๋Š” ์•ž ๋‹จ๊ณ„์—์„œ README.md ํŒŒ์ผ์— ์ •๋ฆฌํ•œ ๊ธฐ๋Šฅ ๋ชฉ๋ก ๋‹จ์œ„๋กœ ์ถ”๊ฐ€**ํ•œ๋‹ค. +- [ํ”„๋ฆฌ์ฝ”์Šค ๊ณผ์ œ ์ œ์ถœ](https://github.com/woowacourse/woowacourse-docs/tree/master/precourse) ๋ฌธ์„œ ์ ˆ์ฐจ๋ฅผ ๋”ฐ๋ผ ๋ฏธ์…˜์„ ์ œ์ถœํ•œ๋‹ค. diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 0000000..60a4b7d --- /dev/null +++ b/docs/README.md @@ -0,0 +1,39 @@ +# ๐Ÿš‡ ์ง€ํ•˜์ฒ  ๋…ธ์„ ๋„ ๊ฒฝ๋กœ ์กฐํšŒ ๋ฏธ์…˜ + +## ๐Ÿ“‹ ๊ธฐ๋Šฅ ๋ชฉ๋ก + +- ์—ญ, ๋…ธ์„ , ๊ตฌ๊ฐ„ ๋ฐ์ดํ„ฐ๋ฅผ ์ดˆ๊ธฐ ์„ค์ •ํ•œ๋‹ค. +- ์—ญ๊ณผ ๋…ธ์„  ์ •๋ณด๋ฅผ ์ด์šฉํ•˜์—ฌ ๊ฑฐ๋ฆฌ ๋‹ค์ต์ŠคํŠธ๋ผ์™€ ์‹œ๊ฐ„ ๋‹ค์ต์ŠคํŠธ๋ผ๋ฅผ ์ƒ์„ฑํ•œ๋‹ค. + +### ๊ฒฝ๋กœ ์กฐํšŒ ๊ธฐ๋Šฅ + +- ์ถœ๋ฐœ์—ญ๊ณผ ๋„์ฐฉ์—ญ์„ ์ž…๋ ฅ๋ฐ›๋Š”๋‹ค. + - ์˜ˆ์™ธ) ๊ฐ’์ด ๋น„์–ด์žˆ๋Š”์ง€ ๊ฒ€์ฆํ•œ๋‹ค. + - ์˜ˆ์™ธ) 2๊ธ€์ž ์ด์ƒ์ธ์ง€ ๊ฒ€์ฆํ•œ๋‹ค. + - ์˜ˆ์™ธ) ์—ญ ๋ชฉ๋ก์—์„œ ์กด์žฌํ•˜๋Š” ์—ญ์ธ์ง€ ๊ฒ€์ฆํ•œ๋‹ค. + - ์˜ˆ์™ธ) ์ถœ๋ฐœ์—ญ๊ณผ ๋„์ฐฉ์—ญ์ด ๋‹ค๋ฅธ์ง€ ๊ฒ€์ฆํ•œ๋‹ค. + +- ์ตœ๋‹จ๊ฑฐ๋ฆฌ / ์ตœ์†Œ์‹œ๊ฐ„์„ ์ž…๋ ฅ๋ฐ›๋Š”๋‹ค. + + - radio option์˜ default ๊ฐ’์€ ์ตœ๋‹จ๊ฑฐ๋ฆฌ์ด๋‹ค. + +- ๊ธธ์ฐพ๊ธฐ ๋ฒ„ํŠผ. + +- ์ตœ๋‹จ๊ฑฐ๋ฆฌ / ์ตœ์†Œ์‹œ๊ฐ„ ๊ฒฝ๋กœ๋ฅผ ์ฐพ๋Š”๋‹ค. + + - `utils/Dijkstra.js` ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋ฅผ ํ™œ์šฉํ•˜์—ฌ ๊ฒฝ๋กœ๋ฅผ ์กฐํšŒํ•œ๋‹ค. + - `searchType` ์ด ์ตœ๋‹จ๊ฑฐ๋ฆฌ ์ด๋ฉด ์ƒ์„ฑํ•ด ๋‘” ๊ฑฐ๋ฆฌ ๋‹ค์ต์ŠคํŠธ๋ผ๋ฅผ ์ด์šฉํ•ด ๊ฒฝ๋กœ๋ฅผ ๊ตฌํ•œ๋‹ค. + - `searchType` ์ด ์ตœ์†Œ์‹œ๊ฐ„ ์ด๋ฉด ์ƒ์„ฑํ•ด ๋‘” ์‹œ๊ฐ„ ๋‹ค์ต์ŠคํŠธ๋ผ๋ฅผ ์ด์šฉํ•ด ๊ฒฝ๋กœ๋ฅผ ๊ตฌํ•œ๋‹ค. + +- ์ด ๊ฑฐ๋ฆฌ์™€ ์ด ์†Œ์š” ์‹œ๊ฐ„์„ ๊ตฌํ•œ๋‹ค. + + - ๋‹ค์ต์ŠคํŠธ๋ผ๋ฅผ ์ด์šฉํ•ด ๊ตฌํ•œ ๊ฒฝ๋กœ๋ฅผ ๊ตฌ๊ฐ„ ๋ณ„๋กœ ๋‚˜๋ˆˆ๋‹ค. + - ๊ตฌ๊ฐ„์ด ํฌํ•จ ๋œ ๋…ธ์„ ์„ ์ฐพ์•„ ๊ตฌ๊ฐ„ ์‚ฌ์ด์˜ ๊ฑฐ๋ฆฌ์™€ ์‹œ๊ฐ„์„ ๊ตฌํ•œ๋‹ค. + - ๊ฐ ๊ตฌ๊ฐ„ ์‚ฌ์ด์˜ ๊ฑฐ๋ฆฌ์™€ ์‹œ๊ฐ„์„ ๋ชจ๋‘ ํ•ฉํ•˜์—ฌ ์ด ๊ฑฐ๋ฆฌ์™€ ์ด ์†Œ์š” ์‹œ๊ฐ„์„ ๊ตฌํ•œ๋‹ค. + +- ๊ฒฐ๊ณผ๋ฅผ ์ถœ๋ ฅํ•œ๋‹ค. + + - ์กฐํšŒ ํƒ€์ž…์„ ์ถœ๋ ฅํ•œ๋‹ค.(์ตœ๋‹จ ๊ฑฐ๋ฆฌ/ ์ตœ์†Œ ์‹œ๊ฐ„) + - `table` ํƒœ๊ทธ์— ์ด ๊ฑฐ๋ฆฌ, ์ด ์†Œ์š” ์‹œ๊ฐ„, ์ด๋™ ๊ฒฝ๋กœ๋ฅผ ์ถœ๋ ฅํ•œ๋‹ค. + + \ No newline at end of file diff --git a/images/dijkstra_example.png b/images/dijkstra_example.png new file mode 100644 index 0000000..7c75197 Binary files /dev/null and b/images/dijkstra_example.png differ diff --git a/images/path_result.gif b/images/path_result.gif new file mode 100644 index 0000000..ee394bd Binary files /dev/null and b/images/path_result.gif differ diff --git a/images/path_result.jpg b/images/path_result.jpg new file mode 100644 index 0000000..40a4bed Binary files /dev/null and b/images/path_result.jpg differ diff --git a/index.html b/index.html new file mode 100644 index 0000000..24db45f --- /dev/null +++ b/index.html @@ -0,0 +1,47 @@ + + + + + ์ง€ํ•˜์ฒ  ๊ธธ์ฐพ๊ธฐ + + +
+

๐Ÿš‡ ์ง€ํ•˜์ฒ  ๊ธธ์ฐพ๊ธฐ

+
+
+ + + +
+
+ + + +
+
+ ์ตœ๋‹จ๊ฑฐ๋ฆฌ + ์ตœ์†Œ์‹œ๊ฐ„ +
+ +
+
+
+ + + + diff --git a/src/index.js b/src/index.js new file mode 100644 index 0000000..4be6e7f --- /dev/null +++ b/src/index.js @@ -0,0 +1,12 @@ +import { printLayout } from "./path-finder/templates.js"; +import { pathFinder } from "./path-finder/actions.js"; + +const pathFinderInputBtn = document.getElementById("path-finder-input-button"); + +export default function SubwayPath() { + pathFinderInputBtn.addEventListener("click", () => { + printLayout(...pathFinder()); + }); +} + +new SubwayPath(); diff --git a/src/path-finder/actions.js b/src/path-finder/actions.js new file mode 100644 index 0000000..8620af4 --- /dev/null +++ b/src/path-finder/actions.js @@ -0,0 +1,128 @@ +import { lines } from "./datas.js"; +import Dijkstra from "../utils/Dijkstra.js"; +import { isNull, isUnderTwo, isUndefind, isEqual } from "../utils/valid.js"; + +const distanceDijkstra = new Dijkstra(); +const timeDijkstra = new Dijkstra(); + +const setDijkstra = (_line) => { + let nextStation = _line.sections[0]; + let prevStation = null; + let section = { distance: "", time: "" }; + + for (let i = 1; i < _line.sections.length; i++) { + if (typeof _line.sections[i] === "string") { + prevStation = nextStation; + nextStation = _line.sections[i]; + + distanceDijkstra.addEdge(prevStation, nextStation, section.distance); + timeDijkstra.addEdge(prevStation, nextStation, section.time); + } else { + section = _line.sections[i]; + } + } +}; + +const isValid = (_departureStation, _arrivalStation) => { + if (isNull(_departureStation) || isNull(_arrivalStation)) { + alert("์—ญ ์ด๋ฆ„์„ ์ž…๋ ฅํ•ด์ฃผ์„ธ์š”."); + return; + } else if (isUnderTwo(_departureStation) || isUnderTwo(_arrivalStation)) { + alert("์—ญ ์ด๋ฆ„์€ ๋‘ ๊ธ€์ž ์ด์ƒ์ž…๋‹ˆ๋‹ค."); + return; + } else if (isUndefind(_departureStation) || isUndefind(_arrivalStation)) { + alert("์กฐํšŒํ•˜์‹  ์—ญ์€ ์—†๋Š” ์—ญ์ž…๋‹ˆ๋‹ค."); + return; + } else if (isEqual(_departureStation, _arrivalStation)) { + alert("์ถœ๋ฐœ์—ญ๊ณผ ๋„์ฐฉ์—ญ์€ ๊ฐ™์„ ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค."); + return; + } + + return true; +}; + +const getDepartureStation = () => { + return document.getElementById("departure-station-name-input").value; +}; + +const getArrivalStation = () => { + return document.getElementById("arrival-station-name-input").value; +}; + +const getSearchType = () => { + const searchTypes = document.getElementsByClassName("search-type-input"); + + return [...searchTypes].find((x) => x.checked === true).value; +}; + +const getPathFinderInput = () => { + const departureStation = getDepartureStation(); + const arrivalStation = getArrivalStation(); + + if (isValid(departureStation, arrivalStation)) { + return [getDepartureStation(), getArrivalStation(), getSearchType()]; + } +}; + +const findPath = (_departureStation, _arrivalStation, _searchType) => { + if (_searchType === "์ตœ๋‹จ๊ฑฐ๋ฆฌ") { + return distanceDijkstra.findShortestPath( + _departureStation, + _arrivalStation + ); + } else { + return timeDijkstra.findShortestPath(_departureStation, _arrivalStation); + } +}; + +const isInLine = (_line, _prevStation, _nextStation) => { + return ( + _line.sections.indexOf(_prevStation) !== -1 && + _line.sections.indexOf(_nextStation) !== -1 + ); +}; + +const getNowLineSections = (_prevStation, _nextStation) => { + return lines.find((x) => isInLine(x, _prevStation, _nextStation)).sections; +}; + +const getNowSection = (_nowLineSections, _prevStation, _nextStation) => { + return _nowLineSections[ + (_nowLineSections.indexOf(_nextStation) + + _nowLineSections.indexOf(_prevStation)) / + 2 + ]; +}; + +const getDistanceAndTime = (_path) => { + let nextStation = _path[0]; + let prevStation = null; + let section = { distance: 0, time: 0 }; + + for (let i = 1; i < _path.length; i++) { + prevStation = nextStation; + nextStation = _path[i]; + + const nowLineSections = getNowLineSections(prevStation, nextStation); + const nowSection = getNowSection(nowLineSections, prevStation, nextStation); + + section.distance += nowSection.distance; + section.time += nowSection.time; + } + + return section; +}; + +export const pathFinder = () => { + const pathFinderInput = getPathFinderInput(); + + if (pathFinderInput) { + lines.forEach((x) => setDijkstra(x)); + + const path = findPath(...pathFinderInput); + const section = getDistanceAndTime(path); + const searchType = pathFinderInput[2]; + + return [searchType, section.distance, section.time, path]; + } +}; diff --git a/src/path-finder/datas.js b/src/path-finder/datas.js new file mode 100644 index 0000000..ff12f80 --- /dev/null +++ b/src/path-finder/datas.js @@ -0,0 +1,58 @@ +export const stations = [ + { + name: "๊ต๋Œ€", + }, + { + name: "๊ฐ•๋‚จ", + }, + { + name: "์—ญ์‚ผ", + }, + { + name: "๋‚จ๋ถ€ํ„ฐ๋ฏธ๋„", + }, + { + name: "์–‘์žฌ", + }, + { + name: "์–‘์žฌ์‹œ๋ฏผ์˜์ˆฒ", + }, + { + name: "๋งค๋ด‰", + }, +]; + +export const lines = [ + { + name: "2ํ˜ธ์„ ", + sections: [ + "๊ต๋Œ€", + { distance: 2, time: 3 }, + "๊ฐ•๋‚จ", + { distance: 2, time: 3 }, + "์—ญ์‚ผ", + ], + }, + { + name: "3ํ˜ธ์„ ", + sections: [ + "๊ต๋Œ€", + { distance: 3, time: 2 }, + "๋‚จ๋ถ€ํ„ฐ๋ฏธ๋„", + { distance: 6, time: 5 }, + "์–‘์žฌ", + { distance: 1, time: 1 }, + "๋งค๋ด‰", + ], + }, + { + name: "์‹ ๋ถ„๋‹น์„ ", + sections: [ + "๊ฐ•๋‚จ", + { distance: 2, time: 8 }, + "์–‘์žฌ", + { distance: 10, time: 3 }, + "์–‘์žฌ์‹œ๋ฏผ์˜์ˆฒ", + ], + }, +]; diff --git a/src/path-finder/templates.js b/src/path-finder/templates.js new file mode 100644 index 0000000..a6a07da --- /dev/null +++ b/src/path-finder/templates.js @@ -0,0 +1,36 @@ +const RESULT_HEADER = ` +

๐Ÿ“ ๊ฒฐ๊ณผ

+`; + +const RESULT_TABLE = ` + +
+`; +const RESULT_TABLE_HEADER = ` + + ์ด ๊ฑฐ๋ฆฌ + ์ด ์†Œ์š” ์‹œ๊ฐ„ + +`; + +const getResultType = (_type) => { + return `

${_type}

`; +}; + +const getResultTable = (_diatance, _time, _sections) => { + const resultTable = document.getElementById("result-table"); + resultTable.innerHTML += RESULT_TABLE_HEADER; + resultTable.innerHTML += `${_diatance}km${_time}๋ถ„`; + resultTable.innerHTML += `${_sections.join( + "โ†’" + )}`; +}; + +export const printLayout = (_type, _diatance, _time, _sections) => { + const resultContainer = document.getElementById("result-container"); + + resultContainer.innerHTML = + RESULT_HEADER + getResultType(_type) + RESULT_TABLE; + + getResultTable(_diatance, _time, _sections); +}; diff --git a/src/utils/Dijkstra.js b/src/utils/Dijkstra.js new file mode 100644 index 0000000..7c6cfd5 --- /dev/null +++ b/src/utils/Dijkstra.js @@ -0,0 +1,220 @@ +export default function Dijkstra() { + const Node = { + init: function (val, priority) { + this.val = val; + this.priority = priority; + }, + }; + + const PriorityQueue = { + init: function () { + this.values = []; + }, + enqueue: function (val, priority) { + const newNode = Object.create(Node); + newNode.init(val, priority); + + this.values.push(newNode); + + let idxOfNewNode = this.values.length - 1; + + while (idxOfNewNode > 0) { + const idxOfParentNode = Math.floor((idxOfNewNode - 1) / 2); + + const parentNode = this.values[idxOfParentNode]; + + if (priority < parentNode.priority) { + this.values[idxOfParentNode] = newNode; + this.values[idxOfNewNode] = parentNode; + idxOfNewNode = idxOfParentNode; + continue; + } + break; + } + return this.values; + }, + dequeue: function () { + if (this.values.length == 0) { + return; + } + const dequeued = this.values.shift(); + const lastItem = this.values.pop(); + if (!lastItem) { + return dequeued; + } + this.values.unshift(lastItem); + + let idxOfTarget = 0; + + while (true) { + let idxOfLeftChild = idxOfTarget * 2 + 1; + let idxOfRightChild = idxOfTarget * 2 + 2; + let leftChild = this.values[idxOfLeftChild]; + let rightChild = this.values[idxOfRightChild]; + + function swap(direction) { + const idxOfChild = + direction == "left" ? idxOfLeftChild : idxOfRightChild; + const child = direction == "left" ? leftChild : rightChild; + this.values[idxOfChild] = this.values[idxOfTarget]; + this.values[idxOfTarget] = child; + idxOfTarget = idxOfChild; + } + + if (!leftChild) { + return dequeued; + } + + if (!rightChild) { + if (leftChild.priority < lastItem.priority) { + swap.call(this, "left"); + continue; + } + return dequeued; + } + + if (leftChild.priority == rightChild.priority) { + swap.call(this, "left"); + continue; + } + + if ( + leftChild.priority < rightChild.priority && + leftChild.priority < lastItem.priority + ) { + swap.call(this, "left"); + continue; + } + + if ( + rightChild.priority < leftChild.priority && + rightChild.priority < lastItem.priority + ) { + swap.call(this, "right"); + continue; + } + } + }, + }; + + const WeightedGraph = { + init: function () { + this.adjacencyList = {}; + this.length = 0; + }, + addVertex: function (vertex) { + if (!this.adjacencyList.hasOwnProperty(vertex)) { + this.adjacencyList[vertex] = {}; + this.length++; + } + }, + addEdge: function (vertex1, vertex2, weight) { + this.addVertex(vertex1); + this.addVertex(vertex2); + this.adjacencyList[vertex1][vertex2] = weight; + this.adjacencyList[vertex2][vertex1] = weight; + return this.adjacencyList; + }, + removeEdge: function (vertex1, vertex2) { + if (!this.adjacencyList.hasOwnProperty(vertex1)) { + return `There's no ${vertex1}`; + } + if (!this.adjacencyList.hasOwnProperty(vertex2)) { + return `There's no ${vertex2}`; + } + + function removeHelper(v1, v2) { + if (!this.adjacencyList.hasOwnProperty(v1)) { + return `There's no edge between ${v1} and ${v2}`; + } + delete this.adjacencyList[v1][v2]; + if (Object.keys(this.adjacencyList[v1]).length == 0) { + delete this.adjacencyList[v1]; + } + } + + removeHelper.call(this, vertex1, vertex2); + removeHelper.call(this, vertex2, vertex1); + + return this.adjacencyList; + }, + removeVertex: function (vertex) { + if (!this.adjacencyList.hasOwnProperty(vertex)) { + return `There's no ${vertex}`; + } + const edges = this.adjacencyList[vertex]; + for (const key in edges) { + this.removeEdge(key, vertex); + } + return this.adjacencyList; + }, + findShortestRoute: function (start, end) { + if (!start || !end) { + throw Error("์ถœ๋ฐœ์ง€์™€ ๋„์ฐฉ์ง€๋ฅผ ๋ชจ๋‘ ์ž…๋ ฅํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค."); + } + const distance = {}; + const previous = {}; + const pq = Object.create(PriorityQueue); + pq.init(); + pq.enqueue(start, 0); + const visited = {}; + + const hashOfVertex = this.adjacencyList; + for (const vertexName in hashOfVertex) { + const priority = vertexName == start ? 0 : Infinity; + distance[vertexName] = priority; + previous[vertexName] = null; + } + + while (true) { + let current = pq.dequeue(); + if (!current?.val) { + return; + } + current = current.val; + if (current == end) { + break; + } + const neighbors = hashOfVertex[current]; + + for (const vertexName in neighbors) { + if (visited.hasOwnProperty(vertexName)) { + continue; + } + const distFromStart = distance[current] + neighbors[vertexName]; + + if (distFromStart < distance[vertexName]) { + pq.enqueue(vertexName, distFromStart); + distance[vertexName] = distFromStart; + previous[vertexName] = current; + } + } + visited[current] = true; + } + + let node = end; + + const route = []; + while (node) { + route.unshift(node); + node = previous[node]; + } + + return route; + }, + }; + + this.addEdge = (source, target, weight) => { + WeightedGraph.addEdge(source, target, weight); + }; + + this.findShortestPath = (source, target) => { + return WeightedGraph.findShortestRoute(source, target); + }; + + this.addVertex = (vertex) => { + WeightedGraph.addVertex(vertex); + }; + + WeightedGraph.init(); +} diff --git a/src/utils/valid.js b/src/utils/valid.js new file mode 100644 index 0000000..3113f92 --- /dev/null +++ b/src/utils/valid.js @@ -0,0 +1,19 @@ +import { stations } from "../path-finder/datas.js"; + +const isNull = (value) => { + return value === ""; +}; + +const isUnderTwo = (value) => { + return value.length < 2; +}; + +const isUndefind = (value) => { + return stations.map((x) => x.name).indexOf(value) === -1; +}; + +const isEqual = (value1, value2) => { + return value1 === value2; +}; + +export { isNull, isUnderTwo, isUndefind, isEqual };