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์— ์ปค๋ฐ‹ํ•˜์ง€ ์•Š๋Š”๋‹ค.