변경내역

Semantic Versioning을 따릅니다 — MAJOR.MINOR.PATCH.

최신 버전 안내와 설치파일은 운영팀(hanalabs@hanapf.kr 또는 안내받은 카카오톡 채널)으로 문의해 주세요.

[0.3.1] — 2026-09-20

0.3.0 사용 중 드러난 문제를 고칩니다. 아래 수정은 0.3.1을 받으셔야 적용됩니다.

Fixed

• 자동 업데이트 화면이 “내려받는 중 N%”에서 멈추던 문제 — 진행률이 뒤늦게 도착해 “준비됨” 표시를 덮어쓰는 경우가 있었습니다. 그러면 [지금 다시 시작] 버튼이 보이지 않아, 다 받아 놓고도 적용할 수 없었습니다.
• 받지 못한 업데이트를 “준비됨”으로 알리던 문제 — 내려받기가 실패해도 화면에는 준비됐다고 나왔습니다. 이제 실패하면 실패로 알리고, 지금 버전을 그대로 쓰실 수 있으며 다음 확인 때 자동으로 다시 받습니다.
• 마켓 응답이 깨졌을 때 “0건”으로 조용히 넘어가던 문제 — 스마트스토어·카페24 응답이 주문 목록 형태가 아닌데도 주문 0건을 받은 것처럼 처리해, 그 구간 주문이 빠진 채 수집이 정상 완료된 것처럼 보일 수 있었습니다. 이제 수집 실패로 드러내고 다음 동기화에서 다시 받습니다.

Security

• 오류 기록에 주문 응답 본문이 섞이던 것을 차단 — 마켓 연동이 실패하면 오류 진단을 위해 응답 내용 일부를 기록해 왔는데, 여기에 받는 분 성함·주소가 섞일 수 있었습니다. 이제 서버가 준 오류 코드와 메시지, 응답 길이만 남깁니다. 오류 보고에 실리는 내용도 같은 기준으로 한 번 더 걸러집니다.

[0.3.0] — 2026-09-18 · 무료 Core 공개 출시

첫 공개 릴리스입니다. 비공개 베타(0.1.0-beta · 0.2.0-beta)에서 검증한 기능이 모두 포함됩니다.

Changed

• 하나로 Core 무료화 — 요금제(Lite/Pro/Business)와 14일 체험을 없앴습니다. 주문 수집·송장 발행·전송·배송 추적·매출 집계를 기간 제한·결제 없이 사용합니다. 설정의 “라이선스” 탭은 “계정” 탭으로 바뀌고 라이선스 코드 입력이 사라졌습니다.
• 지원 정책 시행 — 담당자 1:1 상담은 AI 직원 고용 이용자에게 제공합니다. 무료 이용자는 앱 안 AI 도우미(Ctrl+/)·사용설명서·커뮤니티로 지원합니다. 지원 정책
• 체험 만료·라이선스 만료로 주문 수집과 송장 기능이 잠기던 동작을 제거했습니다.
• 주문 화면의 [마켓에서 새 주문 받기]가 [마켓 동기화]로 바뀌었고, 순번 컬럼은 상품주문번호로 바뀌었습니다.
• 주문 목록의 마켓 칸이 마켓 이름 대신 마켓 색 원 안의 약자(스마트스토어 N · 쿠팡 C · 카페24 24)로 바뀌었습니다. 약자에 마우스를 올리면 마켓 이름이 보입니다.
• 🔴 카페24 연동 방식 변경 — 기존 연동 셀러는 재연결이 필요합니다 (δ.agency-1.0-A). 이제 개발자센터 가입도, Client ID/Secret 발급도 필요 없습니다. 하나로 공용 앱을 쓰므로 셀러는 몰 ID만 입력하고 [카페24 연결하기] → 카페24에서 [허용]을 누르면 끝입니다. 가이드
  • 이전 방식으로 연동해 두신 분은 한 번 다시 연결해 주세요. 기존 연결은 셀러 개인 앱으로 발급된 것이라 새 방식에서는 갱신되지 않고, 주문 수집이 “다시 연결해 주세요” 안내와 함께 멈춥니다. 설정 → 마켓 계정에서 몰 ID로 다시 연결하면 복구됩니다.
  • 계정을 삭제하고 다시 등록하지 마세요. 같은 몰을 새로 등록하면 주문 이력이 두 계정으로 나뉩니다. 기존 계정의 [재인증] → [카페24 연결하기]로 다시 연결하면 됩니다.
  • 기존 주문·송장 데이터는 그대로 유지됩니다. 지워지는 것은 없습니다.
  • 이미 입력해 두신 Client ID/Secret은 더 이상 쓰이지 않습니다. 다시 입력하실 필요 없습니다.
• 카페24: 셀러 본인 앱(Client ID/Secret)으로도 연결할 수 있습니다 (δ.agency-1.7). 새로 카페24를 연결할 때는 카페24 개발자센터에서 만든 앱의 Client ID와 Client Secret을 입력합니다. 하나로 화면에 표시된 Redirect URI를 앱에 그대로 등록해 주세요. 가이드
  • 기존 연결은 그대로 동작합니다. 다시 연결할 필요가 없습니다. 다시 연결할 때도 Client ID/Secret을 비운 채 [카페24 연결하기]를 누르면 위 하나로 공용 앱 방식이 유지됩니다.
  • 공용 앱 연결을 본인 앱으로 바꾸려면 [재인증]에서 Client ID/Secret을 입력해 한 번 다시 연결하면 됩니다. 한 번 바꾸면 공용 앱 방식으로는 되돌릴 수 없습니다.
  • 연결 직후 주문 조회를 한 번 확인하고, 카페24 앱의 API 버전이 맞지 않으면 그 사유를 화면에 한국어로 알려 줍니다.

Added

• 마켓 동기화 진행 표시 — 수동·자동 수집 모두 진행률과 완료 문구를 같은 자리에 보여 주고, 자동 수집은 어느 화면에 있든 표시됩니다.
• 송장번호 직접 입력/수정 — 주문 행을 우클릭해 [송장번호 입력/수정…]에서 송장번호와 택배사를 직접 넣습니다. 자동 접수가 실패했을 때의 비상구이자 잘못 들어간 번호를 고치는 수단입니다. 가이드
• 마켓 송장번호 불일치 감지 — 마켓에 등록된 송장번호와 앱의 송장번호가 다르면 배지로 알리고 전송을 막습니다. 배지를 눌러 앱 안에서 바로 해결합니다.
• 도움말 FAQ 143건 + “해결됐나요?” 피드백 — AI 도우미 답변에 피드백 버튼이 붙고, 답변은 FAQ 근거에 고정됩니다.
• 알림센터·토스트 알림, 배송 이상 큐(“처리할 일”에 배송 지연·이상 건 표시), 주기 수집(간격 설정 + 마지막 수집 시각), 삭제 되돌리기.
• 주문 목록 — 헤더 전체선택 체크박스, “신규 주문” 상태 필터, 받는분·송장번호 검색, Enter로 검색.
• Pretendard 글꼴을 앱에 번들해 어느 PC에서나 같은 화면을 그립니다. 본문 글자 크기·굵기 바닥을 올렸습니다.
• 릴리스 채널 분리(stable / beta) — 설치할 때 쓴 Setup 파일의 채널을 따라갑니다. 시작하기

Fixed

• 테마를 한 번 바꾼 뒤 앱이 다음 실행부터 뜨지 않던 문제, 자동업데이트가 조용히 꺼지던 문제, 처음 사용 안내가 한 번도 뜨지 않던 문제.
• 배송조회가 로젠에서만 되던 문제 — CJ대한통운·한진·롯데·우체국 전부 동작합니다.
• 마켓 동기화 때 같은 주문 2건이 계속 갱신되던 문제.
• 스마트스토어 롯데 택배사 코드 오류.
• 카페24 주문을 발송처리할 때 발주확인 동의 창이 뜨고 “발주확인에 동의해야 발송처리할 수 있습니다”라고 잘못 안내하던 문제 — 카페24는 발주확인 단계가 없어 이제 묻지 않습니다. 입금 전 주문은 전과 같이 발송처리되지 않습니다.
• 로젠 접수 중 하나로 창이 뒤로 밀리거나 뷰어 창이 남던 문제, 접수 인쇄가 설정한 프린터로 나가지 않던 문제.
• 대시보드 마켓 카드가 셀을 넘치던 문제, 매출 화면 건수 표기, 인쇄 설정 라벨 잘림.

Notes

• 이번 빌드는 코드서명 전이라 설치 시 SmartScreen 경고가 뜹니다. 추가 정보 → 실행. 10월 서명 빌드(0.3.1)부터 사라집니다. 시작하기
• 카페24 연동이 새 방식으로 포함됩니다. 이미 연결해 쓰시던 분은 위 “카페24 연동 방식 변경”대로 [재인증]으로 한 번만 다시 연결해 주세요(계정 삭제 금지). 정산·수수료 집계는 다음 업데이트에 포함됩니다.
• AI 직원(첫 직원은 구매자 문의 응대)은 2026년 12월에 월정액으로 열립니다. 고용하지 않아도 Core는 계속 무료입니다.

[0.1.0-beta · 0.2.0-beta] — 2026-08-13 · 2026-08-24 (비공개 베타)

Added

• 매출관리 화면 (β.lite-10) — 기간별·마켓별·상품별 매출 집계 + 엑셀(.xlsx) 리포트 내보내기. 가이드
• 송장 라벨 인쇄 (β.lite-11) — 감열 프린터(XPrinter XP-DT108B 등)로 100×150mm 택배 라벨 인쇄. 미리보기·일괄 인쇄·”인쇄됨” 배지. 가이드
• 대시보드 개편 (β.lite-14) — 오늘 매출 스트립(전일 대비 증감), “처리할 일” 큐(송장 미등록·발송 지연·라벨 미인쇄), 마켓별 진행 현황 일감순 정렬. 가이드
• 처리할 일 바로가기 (β.lite-14.1) — 큐 항목 클릭 시 주문 화면에서 해당 건만 필터 표시.
• 사용설명서 사이트 (docs/) — 셀러용 GitHub Pages.
• Onboarding 마법사 4단계 (Wave β.2-E).
• 운영 게이트: Velopack 자동업데이트, Sentry 에러 추적 (Wave β.1-C). 코드서명은 파이프라인만 준비된 상태(인증서 발급 진행 중) — 현재 설치파일은 서명되지 않아 SmartScreen 경고가 나올 수 있습니다 (시작하기 참조).

Changed

• 화면 문구 명확화 (β.lite-12) — 혼동을 주던 안내 문구 정비 + 용어 통일 + 오류 리포트의 개인정보 자동 제거 강화.
• 디자인 정비 (β.lite-13) — 색 대비 접근성(WCAG AA) 교정 + 화면 간 색·글꼴 일관성 통일.
• 단위테스트 확장 + CI 커버리지 게이트 강제 (평균 라인·브랜치 ~49%).
• 한국어 도메인 식별자 일관성 정리.

Fixed

• 스마트스토어 송장번호 전송 실패 수정 (β.lite-14.2) — 마켓 전송 규격 불일치로 전량 실패하던 문제 해소.
• 송장번호 충돌 다이얼로그 — “다음 충돌에도 같은 선택 적용” 옵션.
• 그리드 클립보드 붙여넣기 행 단위 처리.

[β.1.0] — 2026-04-XX (Wave β.1)

Added

• 마켓 어댑터 — 스마트스토어, 쿠팡, 카페24.
• 택배사 추적 — 5대 택배사 (로젠, CJ대한통운, 한진, 롯데, 우체국).
• 화면: 대시보드 / 주문(주문수집·송장관리 통합) / 배송조회 / 설정.
• DPAPI 암호화 마켓 자격증명 저장.
• CI/CD 파이프라인 (GitHub Actions) — 빌드 경고 0 + 테스트 + 커버리지 게이트 (0%제외 평균 라인·브랜치 30% + 프로젝트별 floor 라인 20%·브랜치 15%).

Architecture

• Clean Architecture: Domain → Contracts → Application → Infrastructure → UI.
• .NET 8 + Avalonia 11 + EF Core 8 + CommunityToolkit MVVM.
• 한국어 도메인 식별자 — 클래스·메서드·열거형 이름에 한글 사용(예: 주문, 송장, 자격증명검증서비스). 네임스페이스는 영어(Hanaro.Domain / Hanaro.Application 등).

[α.0.1] — 2026-03-XX (Wave α 프로토타입)

Added

• 도메인 모델 초안 (Aggregate / Entity / Value Object).
• spec-panel 평가 8/10 (Reliability ✓, Security ✓, Maintainability ✓).
• 기술 스택 결정: .NET 8 / Avalonia 11 / EF Core / SQLite.

형식 안내

각 릴리스는 다음 항목으로 구성됩니다:

문의

• 설치파일 · 릴리스 노트 · 다음 버전 계획 — 운영팀(hanalabs@hanapf.kr 또는 안내받은 카카오톡 채널)