CD / docs /LOCAL_ART_ROUTE_CATALOG.md
tkadkghdlf's picture
Sync DemoService e2b09b366a64790f3dd1dc93870f72061e3c1aab
e516bd2 verified
|
Raw History Blame Contribute Delete
4.34 kB

๋กœ์ปฌ ๊ฒ€์ฆ ๊ฒฝ๋กœ ์นดํƒˆ๋กœ๊ทธ์™€ ๋ชจ์–‘ ์ž๋™ ์ถ”์ฒœ

HTTP v2 ์—ฐ๋™ ์ž๋ฃŒ์˜ ์กฐํšŒ

v2 ํ›„๋ณด๋Š” art_route_candidates.active=true, ๊ฒฝ๋กœ ๊ฒ€์ฆ passed, ์—ฐ๊ฒฐ๋œ lab_route_library.active=true, ์–‘์ชฝ์˜ ๋™์ผ ๋‚ด์šฉ ํ•ด์‹œ๋ฅผ ํ™•์ธํ•œ ๋’ค ์ฝ๋Š”๋‹ค. ๋„์•ˆ ์ž์ฒด์˜ AI ํŒ์ •์€ ๊ฒฝ๋กœ ์Šน์ธ๊ณผ ๋ณ„๊ฐœ์ด๋ฉฐ, ๊ฒฝ๋กœ ํ†ต๊ณผ๋ฅผ ๋„์•ˆ ์Šน์ธ ํ‘œ์‹œ๋กœ ์“ฐ์ง€ ์•Š๋Š”๋‹ค. ๊ธฐ์กด ์ถœ์ฒ˜ ๋ฏธ์ƒ ํ›„๋ณด๋Š” ์›๋ž˜ ์กฐํšŒ ์ •์ฑ…์„ ์œ ์ง€ํ•˜๊ณ  ๋„์•ˆ ํŒ์ •์€ unknown์œผ๋กœ ๋ณด์กดํ•œ๋‹ค.

v2 ํ–‰์€ [์œ„๋„, ๊ฒฝ๋„]ยทWGS84๋ฅผ ๋ช…์‹œํ•œ๋‹ค. ๊ธฐ์กด ํ–‰์˜ ์ˆœ์„œ๋Š” ๊ธฐ์กด ํ™˜๊ฒฝ๋ณ€์ˆ˜๋กœ ํ•ด์„ํ•œ๋‹ค. ์œ„์น˜ ์—†๋Š” ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ์™ธ๊ณฝ์„ ์€ ์ด๋ฏธ XY์ด๋ฏ€๋กœ GPS ๋ณ€ํ™˜๊ธฐ์— ๋„ฃ์ง€ ์•Š๋Š”๋‹ค. ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ์™€ ์นดํƒˆ๋กœ๊ทธ์— ๊ฐ™์€ ์™ธ๊ณฝ์„ ์ด ์žˆ์„ ๋•Œ๋Š” ๋™์ผ ์ขŒํ‘œ์—ด์„ ์ค‘๋ณต ์ œ๊ฑฐํ•œ๋‹ค.

์นดํƒˆ๋กœ๊ทธ DB ๊ฒฐ๊ณผ๋Š” ์š”์ฒญ๋งˆ๋‹ค ์ฝ์–ด ๋‹ค๋ฅธ ํ”„๋กœ์„ธ์Šค์˜ ์ทจ์†Œ๋ฅผ ๋ฐ˜์˜ํ•œ๋‹ค. ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ์บ์‹œ๋Š” ๊ณต์œ  catalog_revision์„ ํ™•์ธํ•˜๋ฉฐ DB ์žฅ์•  ์‹œ ์ด์ „ ์™ธ๋ถ€ ์บ์‹œ๋ฅผ ์žฌ์‚ฌ์šฉํ•˜์ง€ ์•Š๋Š”๋‹ค. ์ž๋™ ์ถ”์ฒœ๋„ ํ›„๋ณด ์„ ๋ณ„ ์ „์— ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ๊ธฐ์—ฌ๋ถ„์„ ๊ฐฑ์‹ ํ•œ๋‹ค. ์ƒ์„ฑยท์  ํƒ์ƒ‰ ์ฒ˜๋ฆฌ ์ค‘ ์นดํƒˆ๋กœ๊ทธ ๊ฐœ์ • ๋ฒˆํ˜ธ๊ฐ€ ๋ฐ”๋€Œ๋ฉด ์ด์ „ ์ž๋ฃŒ๋กœ ๋งŒ๋“  ๊ฒฐ๊ณผ๋ฅผ ๋ฐ˜ํ™˜ํ•˜์ง€ ์•Š๊ณ  409 route_library_changed_retry๋ฅผ ๋ฐ˜ํ™˜ํ•œ๋‹ค.

ART_ROUTE_CATALOG_DATABASE_URL์ด ์—†์œผ๋ฉด ๊ธฐ์กด ROUTE_LIBRARY_DATABASE_URL์„ ์‚ฌ์šฉํ•œ๋‹ค. Lab์—๋Š” ์ด ์—ฐ๊ฒฐ ์ •๋ณด๋ฅผ ์ „๋‹ฌํ•˜์ง€ ์•Š๋Š”๋‹ค. ART_ROUTE_CATALOG_JSON์€ ๊ณ„์† ํŒŒ์ผ ์šฐ์„  ์„ค์ •์ด๋ฉฐ, ํŒŒ์ผ ์Šค๋ƒ…์ƒท์˜ ์ทจ์†Œ ๋ฐ˜์˜์€ ๋ณ„๋„ ์žฌ์ƒ์„ฑ์ด ํ•„์š”ํ•˜๋‹ค. ๊ธฐ์กด 200ํ–‰ ์ œํ•œ๊ณผ ํ™”๋ฉด๋ณ„ ๋ผ๋ฒจ ๋ชฉ๋ก์€ ์ด ๋ณ€๊ฒฝ์—์„œ ํ™•๋Œ€ํ•˜์ง€ ์•Š๋Š”๋‹ค.

๊ธฐ์กด ์กฐํšŒ ์„ค์ •

๊ฒฝ๋กœ ์ƒ์„ฑ ํ™”๋ฉด์˜ ๊ธฐ๋ณธ๊ฐ’์ธ ๋ชจ์–‘ ์ƒ๊ด€์—†์Œ ยท ์ž๋™ ์ถ”์ฒœ์€ ๋‚ด์žฅ ์˜ˆ์‹œ์™€ ๊ฒ€์ฆ ๊ฒฝ๋กœ ์นดํƒˆ๋กœ๊ทธ๋ฅผ ๊ฐ™์€ ์ฃผ๋ณ€ ๋ณดํ–‰๋ง์—์„œ ๋น„๊ตํ•œ๋‹ค. ๋„๋กœ ํˆฌ์˜์œผ๋กœ ๋จผ์ € ํ›„๋ณด ๋„์•ˆ์„ ์ถ”๋ฆฌ๊ณ , ๊ฑฐ๋ฆฌ๋ณ„ ์šฐ์„  ๋‘ ๋ชจ์–‘์„ ์‹ค์ œ ๋„๋กœ๋ง์— ์—ฐ๊ฒฐํ•˜๊ณ , ํ†ต๊ณผํ•œ ๊ฒฝ๋กœ๊ฐ€ ๋ถ€์กฑํ•˜๋ฉด ์ตœ๋Œ€ ๋„ค ๋ชจ์–‘๊นŒ์ง€ ํƒ์ƒ‰ํ•œ๋‹ค. ์ตœ์ข… ๊ธฐ์ค€ ์œค๊ณฝ ์œ ์‚ฌ๋„ 0.82 ์ด์ƒ๋งŒ ํ‘œ์‹œํ•œ๋‹ค. ์ด ๊ฐ’์€ ์ดˆ๊ธฐ ์šด์˜ ํ›„๋ณด ๊ธฐ์ค€์ด๋ฉฐ ์‚ฌ๋žŒ ํ‰๊ฐ€๋กœ ๋ณด์ •๋˜์ง€ ์•Š์•˜๋‹ค. ํ†ต๊ณผ ๊ฒฝ๋กœ๊ฐ€ ๋ชจ์ž๋ผ๋„ ์ผ๋ฐ˜ ๋Ÿฌ๋‹ ๊ฒฝ๋กœ๋ฅผ ์•„ํŠธ ์ถ”์ฒœ์— ๋„ฃ์–ด ๊ฐœ์ˆ˜๋ฅผ ์ฑ„์šฐ์ง€ ์•Š๋Š”๋‹ค.

DB ์›๋ณธ GPS๋Š” ์ ˆ๋Œ€ ์ƒˆ ๊ฒฝ๋กœ๋กœ ๋ฐ˜ํ™˜ํ•˜์ง€ ์•Š๋Š”๋‹ค. ๊ฒฝ๋กœ๋ฅผ ํ‰๋ฉด ์œค๊ณฝ์œผ๋กœ ๋ณ€ํ™˜ํ•ด ์œ„์น˜์™€ ์Šค์ผ€์ผ์„ ์ œ๊ฑฐํ•˜๊ณ , ์‚ฌ์šฉ์ž๊ฐ€ ์„ ํƒํ•œ ์ง€์—ญ์˜ ๋ณดํ–‰ ๋„๋กœ์— ๋‹ค์‹œ ๋งž์ถ˜๋‹ค. ์›๋ณธ์˜ ๋ฐฉํ–ฅ์€ ์ €์žฅ๋œ GPS๋ฅผ ๋ถ์ชฝ์ด ์œ„๋กœ ๋ณด์•˜์„ ๋•Œ์˜ ๋ฐฉํ–ฅ์ด๋ฉฐ, ๋ณ„๋„ ์ •๋ฐฉํ–ฅ ๊ธฐ์ค€์ ์ด ์žˆ๋Š” ๊ฒƒ์€ ์•„๋‹ˆ๋‹ค. ํฌ๊ฒŒ ์—ด๋ฆฐ ๊ฒฝ๋กœ์™€ ์œ ํšจํ•˜์ง€ ์•Š์€ ์ขŒํ‘œ๋Š” ํ˜„์žฌ ํ๊ณก์„  ์ƒ์„ฑ์—์„œ ์ œ์™ธํ•œ๋‹ค. ๊ธฐ์กด HGB๋Š” ์ง€์›ํ•˜๋Š” ๋‚ด์žฅ ๋ชจ์–‘์—์„œ๋งŒ ์‚ฌ์šฉํ•˜๊ณ , ์ƒˆ ๋ชจ์–‘์˜ ์ƒ์„ฑยทํ‘œ์‹œ์— ์ƒˆ ๋ชจ๋ธ ํ•™์Šต์€ ํ•„์š”ํ•˜์ง€ ์•Š๋‹ค.

DB ์ฝ๊ธฐ ์—ฐ๊ฒฐ

AI ์„œ๋น„์Šค ์‹คํ–‰ ํ™˜๊ฒฝ์— ART_ROUTE_CATALOG_DATABASE_URL์„ ์„ค์ •ํ•œ๋‹ค. ๊ธฐ์กด ๋‘ ํ…Œ์ด๋ธ” (art_templates, art_route_candidates)์˜ SELECT๋งŒ ํ—ˆ์šฉํ•œ DB ๊ณ„์ •์„ ๊ถŒ์žฅํ•œ๋‹ค. ์ฟผ๋ฆฌ๋„ ์ฝ๊ธฐ ์ „์šฉ ํŠธ๋žœ์žญ์…˜์œผ๋กœ ์‹คํ–‰ํ•˜๋ฉฐ validation_status='passed'๋งŒ ์ฝ๋Š”๋‹ค. ์šด์˜ ๋ฐ์ดํ„ฐ ๋ณต์ œ๊ฐ€ ์ค€๋น„๋ผ ์žˆ๋‹ค๋ฉด ์šด์˜ ๊ณ„์ • ๋Œ€์‹  ๋กœ์ปฌ ๋ณต์ œ๋ณธ์„ ์ง€์ •ํ•œ๋‹ค. ๊ธฐ์กด ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜์ด๋‚˜ ํ…Œ์ด๋ธ”์€ ๋ฐ”๊พธ์ง€ ์•Š๋Š”๋‹ค.

์ขŒํ‘œ ๋ฐฐ์—ด์ด [๊ฒฝ๋„, ์œ„๋„]์ด๋ฉด ART_ROUTE_COORDINATE_ORDER=lonlat๋ฅผ ์„ค์ •ํ•œ๋‹ค. ๊ธฐ๋ณธ๊ฐ’์€ ํ”„๋กœ์ ํŠธ ์ขŒํ‘œ ๋ฐฐ์—ด๊ณผ ๊ฐ™์€ [์œ„๋„, ๊ฒฝ๋„]๋‹ค. ์ ‘์†์— ์‹คํŒจํ•˜๊ฑฐ๋‚˜ ์„ค์ •ํ•˜์ง€ ์•Š์œผ๋ฉด ๋‚ด์žฅ ๋„์•ˆ์œผ๋กœ ๋™์ž‘ํ•œ๋‹ค. ์ ‘์† ์ •๋ณด๋ฅผ ํ”„๋ŸฐํŠธ์—”๋“œ ํ™˜๊ฒฝ๋ณ€์ˆ˜์— ๋„ฃ์ง€ ์•Š๋Š”๋‹ค.

์ง์ ‘ ์‹คํ–‰ํ•˜๋Š” AI ์„œ๋น„์Šค์—์„œ๋Š” ์ฝ๊ธฐ ์ „์šฉ JSON ๋‚ด๋ณด๋‚ด๊ธฐ ํŒŒ์ผ์„ ART_ROUTE_CATALOG_JSON์œผ๋กœ ์ง€์ •ํ•  ์ˆ˜๋„ ์žˆ๋‹ค. JSON์€ [{ "template_key": "...", "name": "...", "validation_status": "passed", "coordinates": [[37.0, 127.0], ...] }] ํ˜•ํƒœ๋‹ค. ์ด ๋ณ€์ˆ˜๊ฐ€ ์žˆ์œผ๋ฉด DB ๋Œ€์‹  ํŒŒ์ผ์„ ์‚ฌ์šฉํ•œ๋‹ค.

Docker Compose๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ๊ฒฝ์šฐ ๊ธฐ์กด ./router ๋งˆ์šดํŠธ๋ฅผ ์ด์šฉํ•  ์ˆ˜ ์žˆ๋‹ค. ๋‚ด๋ณด๋‚ธ ํŒŒ์ผ์„ ๋กœ์ปฌ router ํด๋”์— ๋‘” ๋’ค ART_ROUTE_CATALOG_JSON=/workspace/router/<ํŒŒ์ผ๋ช…>.json์„ ์ง€์ •ํ•œ๋‹ค. ์‹ค๋ฐ์ดํ„ฐ ๋‚ด๋ณด๋‚ด๊ธฐ ํŒŒ์ผ์€ Git์— ์ปค๋ฐ‹ํ•˜์ง€ ์•Š๋Š”๋‹ค.