location marker
주소를 여러 개 붙여넣으면 지도에 마커로 찍어 주는 웹 앱.
엑셀에서 주소 열을 통째로 복사해 넣으면, 한 줄씩 좌표를 찾아 지도에 번호 붙은 마커로
표시한다. 못 찾은 주소는 버리지 않고 원래 자리에 남겨 고쳐서 다시 시도할 수 있게 한다.
결과는 링크로 공유하거나 CSV 로 내려받는다.
현재 상태: M1 진행 중. 앱 껍데기와 테스트·배포 파이프라인까지 있고, 지도는 아직 없다.
개발
pnpm install
pnpm dev # 개발 서버
pnpm test # Vitest (node · jsdom 두 프로젝트)
pnpm type-check # tsc --noEmit
pnpm build # dist/ 생성
키가 없어도 전부 동작한다. 지도 자리에 안내 문구가 뜰 뿐이다.
다만 pnpm install 은 비공개 저장소 Doosies/common_agent_system 에서
@cas/spec-sync 를 받아온다. 그 저장소를 읽을 수 있는 git 인증이 없으면 설치가 실패한다.
기술 선택
| 항목 | 선택 |
|---|
| 지도 · 지오코딩 | Kakao Maps JS SDK (+ services) |
| 언어 · 프레임워크 | TypeScript (strict) + React |
| 번들러 · 테스트 | Vite · Vitest · Playwright |
| 백엔드 | 없음 |
| 배포 | GitHub Pages + GitHub Actions |
백엔드가 없는 것은 Kakao JS SDK 의 지오코딩이 브라우저에서 그대로 동작하기 때문이다.
근거는 설계 문서 에 있다.
문서
설계
계획
키 취급 규칙
- 키 값은 코드·커밋·문서·PR·이슈 어디에도 적지 않는다. 저장소에 들어가는 것은 변수
이름뿐이다 (
.env.example 의 VITE_KAKAO_JS_KEY=).
- 값이 필요해지면 그 자리에서 멈추고 요청한다. 지어내지 않는다.
- 주입은 두 곳뿐이다 — 로컬
.env.local (커밋 금지) 와 GitHub Actions Secrets.
- Kakao REST API 키와 Admin 키는 이 앱에 넣지 않는다.
- JavaScript 앱키가 빌드된 JS 에 평문으로 보이는 것은 정상이다. 이 키의 보호 장치는 비밀
유지가 아니라 Kakao 콘솔의 도메인 등록이다.
테스트 규약
common_agent_system 의 UC ID 규약을 그대로 쓴다. __test_specs__/ 에 Given-When-Then
스펙을 두고, @cas/spec-sync 가 테스트와 1:1 대응을 강제한다. 스펙 문서 없이 테스트를
추가하면 그 자리에서 실패하므로, "스펙 먼저" 가 관습이 아니라 게이트가 된다.
자세한 내용은 02-architecture.md §9.
