CD / docs /running-environment.md
tkadkghdlf's picture
Sync DemoService b83f7fc9411699cd75f1b063a83de6e53bf7ab9f
9bd155f verified
|
Raw History Blame Contribute Delete
6.95 kB

๋Ÿฌ๋‹ ํ™˜๊ฒฝ ์ ์ˆ˜

์ถ”์ฒœ ๊ฒฐ๊ณผ์™€ AI ์ƒ˜ํ”Œ์€ ์ ์ˆ˜๊ฐ€ ๋†’์€ ์ˆœ์œผ๋กœ ์ •๋ ฌํ•œ๋‹ค. ์›๋ž˜ ์ˆœ์„œ๋Š” ์ถ”์ฒœ ์ ์ˆ˜ ๋™๋ฅ ์—, ์ง€๋„ ์ค‘์‹ฌ๊นŒ์ง€์˜ ๊ฑฐ๋ฆฌ๋Š” ์ƒ˜ํ”Œ ์ ์ˆ˜ ๋™๋ฅ ์— ์‚ฌ์šฉํ•œ๋‹ค. ์ ์ˆ˜์™€ ์ถ”์ฒœ ์ˆœ์œ„๋Š” ๊ฒฝ๋กœ ID๋ฅผ ๋ฐ”๊พธ์ง€ ์•Š๋Š”๋‹ค.

  • ๋ณดํ–‰๋กœ ๊ตฌ์กฐ 25%, ์ง€์—ญ ์ธ๊ตฌ ํ˜ผ์žก๋„ 45%, ์•ฑ ํ™œ๋™ 30%. ๊ฒฝ๋กœ๋ฅผ ๊ฑฐ๋ฆฌ ๊ธฐ์ค€์œผ๋กœ ์ƒ˜ํ”Œ๋งํ•œ๋‹ค.
  • ๋น„์–ด ์žˆ๋Š” ์‹ ํ˜ธ๋Š” ์ค‘๋ฆฝ๊ฐ’์ด๋ฉฐ ํ•œ์‚ฐํ•˜๋‹ค๋Š” ์ฆ๊ฑฐ๊ฐ€ ์•„๋‹ˆ๋‹ค. ์ „๋ถ€ ๋น„์–ด ์žˆ์œผ๋ฉด ์ž๋ฃŒ ๋ถ€์กฑ.
  • ํ™œ๋™ ์ง‘๊ณ„๊ฐ€ ์ •์ƒ ์‘๋‹ตํ–ˆ์„ ๋•Œ์˜ 0๋ช…์€ ์„œ๋น„์Šค ์ด์šฉ์ž ํ™œ๋™์—๋งŒ ๋ฐ˜์˜ํ•˜๋ฉฐ ์ผ๋ฐ˜ ๋ณดํ–‰ ์ธ๊ตฌ์—๋Š” ๋ฐ˜์˜ํ•˜์ง€ ์•Š๋Š”๋‹ค.
  • ์‹ค์‹œ๊ฐ„ ์ธ๊ตฌ๋Š” ๊ณต์‹ POI ์˜์—ญ๊ณผ ๊ต์ฐจํ•˜๋Š” ๋ถ€๋ถ„๋งŒ ์‚ฌ์šฉํ•œ๋‹ค. ์„œ์šธ์‹œ API๊ฐ€ 20๋ถ„ ๋„˜๊ฒŒ ์˜ค๋ž˜๋๊ฑฐ๋‚˜, ๋Œ€์ฒด๊ฐ’์ด๊ฑฐ๋‚˜, ์‹คํŒจํ•˜๋ฉด ๋ฐ˜์˜ํ•˜์ง€ ์•Š๋Š”๋‹ค. ์‹œ๊ฐ„๋Œ€๋ณ„ ์ž๋ฃŒ๊ฐ€ ์žˆ๋Š” ๊ตฌ๊ฐ„์€ ๋ณ„๋„๋กœ ์ถ”์ •ํ•œ๋‹ค.
  • ์•ฑ ํ™œ๋™์€ ์ตœ๊ทผ 2๋ถ„ ์ด๋‚ด์— ์ €์žฅ๋˜๊ณ  GPS ๊ฒฝ๋กœ๊ฐ€ ์žˆ๋Š” ์ง„ํ–‰ ์ค‘ ์‹ค์ œ ๋Ÿฌ๋‹๋งŒ ํฌํ•จํ•œ๋‹ค. ์‹œ๋ฎฌ๋ ˆ์ด์…˜, ์ผ์‹œ์ •์ง€, ์ข…๋ฃŒ๋Š” ์ œ์™ธํ•œ๋‹ค. ์ฃผ๋ณ€ ๊ตฌ์—ญ์— ์†Œ์ˆ˜ ์ธ์›์ด ์žˆ์œผ๋ฉด ์กด์žฌ ์—ฌ๋ถ€๋งŒ ํ‘œ์‹œํ•˜๊ณ , ์ธ์›์ˆ˜๋Š” ๊ตฌ์—ญ๋‹น 3๋ช… ์ด์ƒ์ธ ์ง‘๊ณ„๋งŒ ํ•ฉ์‚ฐํ•œ๋‹ค. ๋ธŒ๋ผ์šฐ์ €์—๋Š” ์œ„์น˜๋‚˜ ๊ตฌ์—ญ ๋ชฉ๋ก์„ ๋ฐ˜ํ™˜ํ•˜์ง€ ์•Š๋Š”๋‹ค.
  • ์ด ์ ์ˆ˜๋Š” ์ถ”์ฒœ ์ˆœ์œ„์šฉ์ด๋ฉฐ ํ†ตํ–‰ ๊ฐ€๋Šฅ ์—ฌ๋ถ€๋‚˜ ์•ˆ์ „์„ ์ธ์ฆํ•˜์ง€ ์•Š๋Š”๋‹ค.

Hugging Face ๋ฐฐํฌ

GitHub์˜ DemoService ๋ธŒ๋žœ์น˜ ํ‘ธ์‹œ๋Š” Space ๋™๊ธฐํ™”๋ฅผ ์‹œ์ž‘ํ•œ๋‹ค. Docker ๋นŒ๋“œ๋Š” Geofabrik์˜ ๋Œ€ํ•œ๋ฏผ๊ตญ OSM์—์„œ ๋„๋กœ ์ธ๋ฑ์Šค๋ฅผ ๋งŒ๋“ ๋‹ค. ๊ธฐ๋ณธ๊ฐ’์€ /app/running-environment์ด๋ฉฐ RUN_ENV_DATA_DIR๋กœ ๋‹ค๋ฅธ ์ธ๋ฑ์Šค๋ฅผ ์ง€์ •ํ•  ์ˆ˜ ์žˆ๋‹ค. ํ˜ผ์žก๋„ ํ”„๋กœํ•„์€ ์•”ํ˜ธํ™”๋œ ๋ฌถ์Œ์œผ๋กœ๋งŒ ๋ฐฐํฌํ•˜๋ฉฐ GitHub Secrets์˜ RUN_ENV_PROFILE_KEY, RUN_ENV_SEOUL_API_KEY๋Š” Space Secret์œผ๋กœ ์ „๋‹ฌ๋œ๋‹ค. ๋‚ด๋ถ€ ํ™œ๋™ ์ง‘๊ณ„ ํ‚ค๋Š” ์ปจํ…Œ์ด๋„ˆ ์‹œ์ž‘ ์‹œ ์ƒ์„ฑํ•˜๋ฉฐ ์ธ์ฆ ์„œ๋ฒ„์™€ Next๊ฐ€ ๊ณต์œ ํ•œ๋‹ค. ์ธ๋ฑ์Šค๋‚˜ ํ‚ค๊ฐ€ ์—†์œผ๋ฉด ํ•ด๋‹น ์‹ ํ˜ธ๋งŒ ์ž๋ฃŒ ๋ถ€์กฑ์œผ๋กœ ์ฒ˜๋ฆฌํ•œ๋‹ค.

๊ฐ€์ ธ์˜ค๊ธฐ

  1. ๋Œ€ํ•œ๋ฏผ๊ตญ OSM PBF๋ฅผ ๋‹ค์šด๋กœ๋“œํ•œ๋‹ค.
  2. ๊ตญํ† ์ •๋ณดํ”Œ๋žซํผ์—์„œ ์ˆ˜์น˜์ง€ํ˜•๋„ ๋„์—ฝ์„ ๋ฐ›์•„ ํ•„์š”ํ•œ ๋ ˆ์ด์–ด๋ฅผ SHP ๋˜๋Š” WGS84 GeoJSON์œผ๋กœ ์ค€๋น„ํ•œ๋‹ค. sidewalk-1000, sidewalk-5000, road-width, carriageway์— ๊ฐ๊ฐ ๋Œ€์‘ํ•œ๋‹ค. ์•„๋ž˜ ํ•„๋“œ๋ช…์€ ์˜ˆ์‹œ๋‹ค. ๋„์—ฝ์˜ ์กฐ์‚ฌ์—ฐ๋„์™€ ์ด์šฉ์กฐ๊ฑด์„ ํ™•์ธํ•œ ํ›„ ๋„ฃ๊ณ , ๊ฐ™์€ ์ง€์—ญ์˜ ๊ตฌ๋ฒ„์ „๊ณผ ์‹ ๋ฒ„์ „์€ ์ค‘๋ณต ํˆฌ์ž…ํ•˜์ง€ ์•Š๋Š”๋‹ค.
  3. ์„œ์šธ ์‹ค์‹œ๊ฐ„ ๋„์‹œ๋ฐ์ดํ„ฐ์˜ ์ฃผ์š” 121์žฅ์†Œ ์˜์—ญ ZIP์„ ํ’€๊ณ  SHP์˜ AREA_CD ํ•„๋“œ๋ฅผ ์‚ฌ์šฉํ•œ๋‹ค.
python -m pip install osmium geopandas
python tools/import_running_environment.py --out D:/data/run-env-v1 --osm D:/data/south-korea.osm.pbf --roads sidewalk-1000 D:/data/sidewalk.shp WIDTH SURFACE --seoul-areas D:/data/seoul-areas.shp AREA_CD

--roads๋Š” ์—ฌ๋Ÿฌ ๋ฒˆ ์ง€์ •ํ•  ์ˆ˜ ์žˆ๊ณ  --seoul-areas๋„ ์„ ํƒ ์‚ฌํ•ญ์ด๋‹ค. OSM๋งŒ ๋จผ์ € ๊ฐ€์ ธ์˜ฌ ์ˆ˜ ์žˆ๋‹ค. ์ฐจ๋„๋‚˜ ๋„๋กœ ์ „์ฒด์˜ ํญ์„ ๋ณด๋„ ํญ์œผ๋กœ ์ฝ์ง€ ์•Š๋Š”๋‹ค. ์ƒˆ ๋ฒ„์ „์„ ๋นˆ ํด๋”์— ์ƒ์„ฑํ•œ ๋’ค ๊ฒฝ๋กœ๋ฅผ ๋ฐ”๊ฟ” Next ์„œ๋ฒ„๋ฅผ ์žฌ์‹œ์ž‘ํ•œ๋‹ค.

๋กœ์ปฌ ์‹คํ–‰

Next ํ”„๋กœ์„ธ์Šค์— ๋‹ค์Œ ๋ณ€์ˆ˜๋ฅผ ์„ค์ •ํ•œ ํ›„ main์—์„œ npm run dev๋ฅผ ์‹คํ–‰ํ•œ๋‹ค.

  • RUN_ENV_DATA_DIR: ์ƒ์„ฑ๋œ ์ธ๋ฑ์Šค์˜ ์ ˆ๋Œ€ ๊ฒฝ๋กœ.
  • RUN_ENV_SEOUL_API_KEY: ๋ฐœ๊ธ‰๋ฐ›์€ ์„œ๋ฒ„์šฉ ์„œ์šธ์‹œ API ํ‚ค. sample์€ ๊ด‘ํ™”๋ฌธยท๋•์ˆ˜๊ถ ํ•œ ๊ณณ๋งŒ ๊ฒ€์ฆ ๊ฐ€๋Šฅ.
  • RUN_ENV_INTERNAL_KEY: Next์™€ ๋กœ์ปฌ auth-service์— ๊ฐ™์€ ์ž„์˜์˜ ๊ธด ๋น„๋ฐ€๊ฐ’์„ ์„ค์ •ํ•œ๋‹ค. Docker Compose๋กœ auth-service๋ฅผ ๋„์šฐ๋Š” ๊ฒฝ์šฐ Compose ์‹คํ–‰ ํ™˜๊ฒฝ์—๋„ ๊ฐ™์€ ๊ฐ’์„ ์ œ๊ณตํ•œ๋‹ค.
  • NEXT_INTERNAL_API_PROXY_TARGET: ๋กœ์ปฌ API Gateway ์ฃผ์†Œ (๊ธฐ๋ณธ http://localhost:8000).

๋น„๋ฐ€๊ฐ’๊ณผ ์›๋ณธ ์ธ๋ฑ์Šค๋Š” ์ €์žฅ์†Œ์— ์ปค๋ฐ‹ํ•˜์ง€ ์•Š๋Š”๋‹ค. ์„œ์šธ์‹œ API๋Š” ๊ณต์‹ ์˜ˆ์ œ์™€ ๊ฐ™์€ HTTP ํฌํŠธ 8088์„ ์‚ฌ์šฉํ•œ๋‹ค. ํ‚ค๋Š” ์„œ๋ฒ„์—์„œ๋งŒ ์‚ฌ์šฉํ•˜๋ฉฐ, ์ด ์™ธ๋ถ€ ์—ฐ๊ฒฐ์—๋Š” TLS๊ฐ€ ์ ์šฉ๋˜์ง€ ์•Š๋Š”๋‹ค. ์ „๊ตญ OSM์„ ์“ด๋‹ค๋Š” ๊ฒƒ์€ ์ „๊ตญ์— ๋™์ผํ•œ ํญ/๋ณด๋„ ๋ฐ์ดํ„ฐ๊ฐ€ ์žˆ๋‹ค๋Š” ๋œป์ด ์•„๋‹ˆ๋‹ค. OpenStreetMap ยฉ OpenStreetMap contributors (ODbL).

์ง€์—ญ๋ณ„ ๊ณผ๊ฑฐ ํ˜ผ์žก๋„

์‹ค์‹œ๊ฐ„ ๊ฐ’์ด ์—†๋Š” ๊ฒฝ๋กœ ์ง€์ ์€ ํ•œ๊ตญ ์‹œ๊ฐ„ ๊ธฐ์ค€ ํ‰์ผ/์ฃผ๋ง ์‹œ๊ฐ„๋Œ€ ํŒจํ„ด์„ ์‚ฌ์šฉํ•œ๋‹ค. ๊ฐ ์žฅ์†Œ์˜ ์ž์ฒด ์ผํ‰๊ท  ๋Œ€๋น„ ๋น„์œจ์ด๋ฉฐ, ๋‹ค๋ฅธ ๋„์‹œ์™€ ์ธ๊ตฌ์ˆ˜๋ฅผ ์ง์ ‘ ๋น„๊ตํ•˜์ง€ ์•Š๋Š”๋‹ค. ์‹ค์‹œ๊ฐ„๊ณผ ๊ณผ๊ฑฐ ๊ฐ’์„ ๊ฐ™์€ ์ง€์ ์— ์ค‘๋ณต ๋ฐ˜์˜ํ•˜์ง€ ์•Š๊ณ , ๊ณผ๊ฑฐ ์ž๋ฃŒ์˜ ๋ฐ˜์˜ ๊ฐ•๋„๋Š” ์‹ค์‹œ๊ฐ„์˜ 65%๋‹ค.

python tools/import_regional_crowd.py --seoul ์„œ์šธ์ƒํ™œ์ธ๊ตฌ.zip ๊ฒฉ์ž.shp --bupyeong ๋ถ€ํ‰๊ตฌ.csv --out D:/data/run-env-v1/regional-crowd.json

์ธ๋ฑ์Šค ์ƒ์„ฑ ํ›„ Next ์„œ๋ฒ„๋ฅผ ๋‹ค์‹œ ์‹œ์ž‘ํ•œ๋‹ค. ๋ถ€์‚ฐ API๋Š” ํ‚ค์™€ ์›๋ณธ ์‘๋‹ต ํ™•์ธ, ๊ฒฝ๊ธฐ ๋ฐ์ดํ„ฐ๋Š” ์›๋ณธ ๋ฐ ๊ฒฝ๊ณ„ยท์ด์šฉ ์กฐ๊ฑด ํ™•์ธ, ์ œ์ฃผ ์‹ค์‹œ๊ฐ„์€ ๊ณต์‹ ์—ฐ๋™ ๊ฒฝ๋กœ ํ™•์ธ ํ›„ ์ถ”๊ฐ€ํ•œ๋‹ค.

๋ณดํ–‰์ž ์„ผ์„œ ๋ฐ ๊ฒฝ๊ธฐ ๊ฒฉ์ž

  • ์„œ์šธ ์—ด๋ฆฐ๋ฐ์ดํ„ฐ๊ด‘์žฅ S-DoT์˜ ์นด๋ฉ”๋ผ ์‹๋ณ„ ๋ฒ”์œ„ 4001~4050๋งŒ ์‚ฌ์šฉํ•œ๋‹ค. ๋ถ„๋ฅ˜ ๊ทผ๊ฑฐ. 45m๋Š” ์ถ”์ฒœ ์ ์šฉ ๋ฐ˜๊ฒฝ์ด๋ฉฐ ๊ด€์ธก ์‹œ์•ผ๊ฐ€ ์•„๋‹ˆ๋‹ค. ์‹ค์‹œ๊ฐ„ ์žฅ์†Œ ๊ด€์ธก์ด ์—†์„ ๋•Œ ์„ผ์„œ์˜ ๊ณผ๊ฑฐ ์‹œ๊ฐ„๋Œ€ ํŒจํ„ด์„ ๊ธฐ์กด ๊ด‘์—ญ ์ถ”์ •๋ณด๋‹ค ์šฐ์„ ํ•œ๋‹ค. ์ตœ์‹  ๊ด€์ธก์ผ์ด 90์ผ์„ ๋„˜์œผ๋ฉด ๋ฐ˜์˜ํ•˜์ง€ ์•Š๋Š”๋‹ค.
  • --gyeonggi-verified-grid HOURLY_CSV GRID_FILE๋กœ ๊ฒฝ๊ธฐ๋„ 50m ๊ฒฉ์ž ์ž๋ฃŒ๋ฅผ ์ถ”๊ฐ€ํ•  ์ˆ˜ ์žˆ๋‹ค. CSV๋Š” grid_id,date,hour,count (๋‚ ์งœ YYYY-MM-DD), ๊ฒฝ๊ณ„ ํŒŒ์ผ์€ ๊ฐ™์€ grid_id๋ฅผ ๊ฐ€์ง„ ์ขŒํ‘œ๊ณ„๊ฐ€ ๋ช…์‹œ๋œ ๊ฒฉ์ž์—ฌ์•ผ ํ•œ๋‹ค. ๋ฌด๋ฃŒ ์„œ๋น„์Šค ์ด์šฉ์ด ํ™•์ธ๋œ ์‹œ๊ฐ„๋ณ„ ์›๋ณธ๋งŒ ์‚ฌ์šฉํ•œ๋‹ค. 8์›” ํ–‰์ •๋™ ์œ ์ž… ZIP๊ณผ ํ‰์ผ/์ฃผ๋ง ์ฃผ๊ฐ„ ํ‰๊ท ๋งŒ ์žˆ๋Š” ๋ฐ์ดํ„ฐ๋Š” ์ด ์ž…๋ ฅ์œผ๋กœ ์“ฐ์ง€ ์•Š๋Š”๋‹ค.
python -m pip install openpyxl
python tools/import_regional_crowd.py --sdot ์œ„์น˜.xlsx ์ฒซ์ฃผ.csv ๋‘˜์งธ์ฃผ.csv --out D:/data/run-env-v1/pedestrian-crowd.json
python tools/import_regional_crowd.py --gyeonggi-verified-grid ์‹œ๊ฐ„๋ณ„.csv ๊ฒฉ์ž.shp --out D:/data/run-env-v1/gyeonggi-crowd.json