---

status: living created: 2026-05-06 updated: 2026-05-06

Argo Dev 테스트 계정 Ledger

Argo dev 환경에 미리 만들어둔 테스트 계정과 그 계정이 잡고 있는 vendor / workplace / sales_channel 의 1:1 매핑 장부.

왜 이 문서가 필요한가: 테스트 계정·vendor 는 매번 새로 만들면 dev DB 가 누적되어 정리 비용이 커지므로, 시나리오별로 암묵적 1:1 ownership 을 만들어 사용한다. 누군가 password 를 바꾸거나 vendor 를 재설정할 때 다른 시나리오를 망가뜨리지 않으려면 어떤 계정이 누구의 것인지가 합의돼 있어야 한다.

범위: dev 만 (argoport.co). prod 계정은 다루지 않는다.

관련 도구:

• /argo-test (claude command / codex skill) — 새 셀러/SKU/재고/주문 시뮬 자동화
• /argo-dev-db — Argo PostgreSQL 직접 조회용

---

사용 정책 (재설정 혼선 방지)

1. shipper 계정은 vendor 와 1:1. loginId ↔ vendor_id 가 lifelong 짝. vendor 를 다른 셀러에게 재할당하지 말 것.
2. password 통일 — Xpzmxkzk2021! 로 신규 계정에 통일. 기존 baseline 계정 (makitt_test_shipper_01, makitt_test_worker_*, makitt_test_manager_01) 은 spec 박힌 Makitt1234! 유지.
3. 신규 셀러가 필요하면 새 loginId — 기존 계정 password reset 으로 가로채지 말 것. /argo-test create-shipper <new-loginId> 가 자동으로 새 vendor (SHIPPER-N+1) 를 발급한다.
4. helper 계정 (*_helper) 은 본 계정의 verification 백도어 — 직접 사용 금지. 본 계정만 사용.
5. 워커/매니저는 cross-vendor 공용 — 같은 workplace(376) 에 있는 모든 vendor 의 입출고를 처리. 비번 reset 영향 큼, 절대 변경 금지.

---

1. 어드민 / cross-vendor 운영 계정

Worker 의 working_space_mapping (SC0000000123607 SECTION + Z0000000161396,Z0000000155841 ZONE) 은 baseline 셋업. picking/stowing 시나리오에서 이 매핑이 필수 — 건드리지 말 것.

---

2. Shipper ↔ Vendor 1:1 매핑 (셀러 시나리오 ledger)

각 행은 "이 loginId 는 이 vendor 전용" 이라는 약속.

1:1 ownership 의 의미

• vendorId 는 한 번 발급되면 그 셀러 전용. 새 시나리오에서 같은 vendor 를 재사용하지 않는다 (재고/주문 이력이 섞여 디버그 어려워짐).
• vendorCode (SHIPPER-NNN) 은 sequence 발급. 새 셀러는 SHIPPER-{max+1}.
• 테스트가 망가졌다고 vendor 를 삭제하지 말 것 — 14개 테이블 cascading. 새 loginId 로 신규 발급 권장.
• vendor 를 폐기하고 싶으면 vms.vendor.enabled=false 만 토글 (소프트 삭제).

---

2.5. MAKITT seller user ↔ Argo shipper 매핑 (PartnerConnection)

makitt-dev-table 의 ORGANIZATION#{orgId} / SK=PARTNER_CONNECTION#ARGO 가 SSOT. 각 makitt 측 user 가 어떤 argo shipper credential 로 풀필먼트 호출하는지.

기타 ARGO 매핑 (test-* user 와 무관, 시나리오 전용)

PartnerConnection 등록 패턴 (DDB 직접 PUT)

aws dynamodb put-item --profile makitt-dev --region ap-northeast-2 --table-name makitt-dev-table \
  --item '{
    "PK":{"S":"ORGANIZATION#<orgId>"},
    "SK":{"S":"PARTNER_CONNECTION#ARGO"},
    "partnerId":{"S":"ARGO"},
    "credentials":{"M":{"loginId":{"S":"<argoLoginId>"},"password":{"S":"<password>"}}},
    "status":{"S":"ACTIVE"}
  }'

PRE-ALLOCATED 상태의 user 가 makitt 에서 처음 onboarding 진행하면 org 가 생성됨 → 그 시점 위 패턴으로 PartnerConnection 한 줄 추가하면 본 ledger 의 mkt_<name> 과 자동 연결됨.

---

3. Helper 계정 (1:1 짝)

각 본 셀러에 _helper suffix 짝 — verification 백도어 (Argo 내부 진단용 계정). 본 계정 verification 과 별도. 직접 로그인하지 말고 본 계정 사용.

helper 계정의 verification_status (IDENTITY/FORCE_VERIFIED) 는 Argo 의 addVerifiedIdentity(helper(...)) factory 로 자동 등록. 본 계정 verification 은 /argo-test create-shipper 가 별도로 force-verify 호출.

---

4. 워크플레이스 / Agency 상수

/argo-test 가 디폴트로 사용:

---

5. 비번 정책

SHA-256: Xpzmxkzk2021! → 5f191ecd97f311021001647520fd93da697f85bb4c199bb15f02f9402cc3d474. Makitt1234! → 363a2f3e5d8813e2eabfb1ece18349f610e8b170ca0807d1583bc343985cbf20.

---

6. 정리 후보 (legacy)

dev 누적 데이터. /argo-test 시나리오에서 사용 안 함. 만약 정리 작업 한다면 후보:

삭제 전 반드시 사용자 확인. 다른 세션이나 다른 테스트가 묻혀 쓰고 있을 수 있다.

---

7. 검증 SQL (현재 상태 재확인)

-- sugar.argo_users (모든 makitt_* 계정 + 매핑)
SELECT u.argo_user_id, u.login_id, u.user_type, u.company_id, u.workplace_id,
       ARRAY_AGG(r.role_code ORDER BY r.role_code) FILTER (WHERE r.role_code IS NOT NULL) AS roles
  FROM sugar.argo_users u
  LEFT JOIN sugar.user_role ur ON u.argo_user_id=ur.argo_user_id
  LEFT JOIN sugar.roles r ON ur.role_id=r.role_id
 WHERE u.login_id LIKE 'makitt%' OR u.login_id IN ('makitt_admin','makitttest1')
 GROUP BY u.argo_user_id, u.login_id, u.user_type, u.company_id, u.workplace_id
 ORDER BY u.argo_user_id;

-- vms.vendor (매핑된 vendor)
SELECT vendor_id, vendor_code, vendor_type, business_name, business_number,
       owner_login_id, enabled
  FROM vms.vendor
 WHERE owner_login_id LIKE 'makitt%' OR vendor_id IN (900761, 10000)
 ORDER BY vendor_id;

-- cms.sales_channel (셀러별 채널)
SELECT sales_channel_id, vendor_id, sales_channel_name, store_platform_id, collect_group_code
  FROM cms.sales_channel
 WHERE vendor_id IN (900938, 900971, 900972, 900973, 900974, 900975, 900983)
   AND enable=true
 ORDER BY vendor_id, sales_channel_id;

-- wms.metadata.vendor_workplace_mapping (셀러 ↔ 창고)
SELECT vendor_id, ARRAY_AGG(workplace_id ORDER BY workplace_id) AS workplaces
  FROM wms.metadata.vendor_workplace_mapping
 WHERE vendor_id IN (900938, 900971, 900972, 900973, 900974, 900975, 900983)
   AND enabled=true
 GROUP BY vendor_id ORDER BY vendor_id;

---

8. 새 계정 추가 시 절차

1. /argo-test create-shipper <new-loginId> 실행 (자동으로 vendor 발급 + 매핑 + role + verification + cache reindex)
2. 이 문서 §2 표에 row 추가 (loginId, argoUserId, vendorId, vendorCode, business*, workplaces, sales_channels, password, 시나리오)
3. 토큰 캐시 위치 확인: /tmp/argo-test-token-<loginId>
4. helper 계정 자동 생성 → §3 표에도 추가

향후 /argo-test 가 이 문서를 자동 갱신하도록 액션 추가 가능 (TODO).

---

관련 문서

• spec/argo/README.md — Argo 연동 spec 인덱스 (hardcode 상수, dev URL, 핵심 교훈)
• spec/argo/onboarding-flow.md — 셀러 셀프 가입 flow
• spec/argo/argo_makitt/internal-onboarding.md — MAKITT internal endpoint (옵션 C 가 우회한 것)
• E2E_PLAYBOOK.md — 전체 e2e 시나리오 playbook
• /argo-test skill — 본 ledger 의 모든 매핑을 자동화