Spaces:
Running
Running
|
Download docs/LOCAL_ART_ROUTE_CATALOG.md from tkadkghdlf/CD: direct link, hf CLI and curl.
- Browser
- Download file 4.34 kB
-
https://huggingface.co/spaces/tkadkghdlf/CD/resolve/main/docs/LOCAL_ART_ROUTE_CATALOG.md
- Command line
-
hf download hf://spaces/tkadkghdlf/CD/docs/LOCAL_ART_ROUTE_CATALOG.md
-
curl -L -o LOCAL_ART_ROUTE_CATALOG.md https://huggingface.co/spaces/tkadkghdlf/CD/resolve/main/docs/LOCAL_ART_ROUTE_CATALOG.md
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์ ์ปค๋ฐํ์ง ์๋๋ค. | |