테스트 환경과 계정 설정

검증엔 "어디를, 누구로"가 필요해요

검증은 실제 브라우저가 진짜 주소를 열고 눌러 보는 일이에요. 그래서 돌리기 전에 두 가지가 정해져 있어야 합니다.

• 어디를 — 테스트할 사이트 주소 (테스트 환경)
• 누구로 — 로그인이 필요한 흐름이라면, 어떤 계정으로 들어갈지 (테스트 계정)

이 두 가지를 정하는 곳이 작업실 보드의 테스트 환경 탭이에요. 한 번 갖춰 두면 이후 모든 검증이 이 설정을 따라갑니다.

테스트 환경 등록하기

테스트 환경은 "검증이 열 사이트 주소"예요. 테스트 환경 탭에서 이름과 주소만 적으면 등록됩니다.

• 이름 — 구분용 이름 (예: "스테이징", "운영")
• 사이트 주소 — 검증이 여는 프론트 주소 (예: https://staging.example.com)

환경은 여러 개 둘 수 있어요. 예를 들어 배포 전 확인용 "스테이징"과 실제 서비스 "운영"을 나란히 두고, 검증할 때 골라 쓰는 식이죠. 그중 하나를 기본 환경으로 정해 두면, 따로 고르지 않은 검증은 늘 기본 환경에서 돌아갑니다.

검증 묶음(회차)이 만들어질 때는 그때 고른 환경과 계정이 그 묶음에 고정돼요. 그래서 같은 묶음 안에서 다시 검증할 때는 늘 같은 환경·같은 계정으로 돌아가, 결과가 서로 어긋나지 않아요.

주소는 Specnote 서버가 접속할 수 있는 곳이어야 해요. 내 PC에서만 도는 localhost 주소라면 아래 "내 컴퓨터에서만 도는 앱이라면"을 봐 주세요.

테스트 계정 연결하기

"로그인한 회원만 볼 수 있는 화면"을 검증하려면, Specnote가 로그인할 테스트 계정이 필요해요. 테스트 환경 탭의 로그인 계정에서 아이디(이메일)와 비밀번호를 등록하면 됩니다.

계정은 환경마다 따로 둘 수 있어요. 스테이징 계정과 운영 계정이 다른 경우가 많으니까요. 환경을 정하지 않고 등록한 계정은 특정 환경에 묶이지 않고 어느 환경에서든 쓸 수 있어요. 환경마다 계정이 달라야 한다면 그때 환경을 지정해서 따로 등록하면 됩니다.

여기서도 원칙은 하나예요. 운영 비밀번호가 아니라 테스트 전용 계정을 등록해 주세요. 새어 나가도 실제 손해가 없는 계정이면 가장 안심이에요.

테스트마다 "회원으로 볼지, 방문자(로그인 안 함)로 볼지"를 정할 수 있어서, 같은 화면도 두 입장에서 각각 검증할 수 있어요. 예를 들어 "로그인 안 한 사람이 결제 화면에 들어가지지 않는지" 같은 확인이죠.

시크릿 — 안전하게 보관돼요

등록한 계정과 키 값은 등록 즉시 암호화되어 보관됩니다(KMS라는 전용 보관 장치를 써요). 본인만 열어 볼 수 있고, 화면에서 "값 보기"를 눌러도 5초만 보인 뒤 다시 가려져요.

테스트 계정 말고도, 검증에 필요한 값이 있다면 시크릿으로 함께 보관할 수 있어요. 샌드박스(연습용 가짜 결제 환경) 키 같은 것들이요. 운영 비밀과는 완전히 분리되어 있으니, 테스트에 필요한 최소한의 값만 넣으시면 됩니다.

혹시 코드를 연결할 때 코드 안에서 발견된 값이 있으면, Specnote가 "이 값을 시크릿으로 보관할까요?" 하고 물어봐요. 확인 후 보관 여부를 고르면 됩니다.

내 컴퓨터에서만 도는 앱이라면 (LOCAL)

아직 배포 전이라 앱이 내 PC(localhost)에서만 돌고 있어도 검증할 수 있어요. 환경을 등록할 때 내 컴퓨터(LOCAL) 방식을 고르면 됩니다.

로그인이 필요한 검증이라면 흐름이 조금 달라요. Specnote 서버가 내 PC의 로그인 화면에 직접 들어갈 수 없기 때문에, 내가 한 번 로그인해 주는 방식을 씁니다.

1. 테스트 환경 탭에서 내 컴퓨터에서 로그인을 눌러요.
2. 내 컴퓨터에 로그인용 브라우저 창이 곧 열려요.
3. 그 창에서 평소처럼 로그인해요.
4. 화면으로 돌아와 로그인 완료를 누르면 끝이에요.

이렇게 한 번 로그인해 두면, Specnote가 그 로그인 상태를 안전하게 이어받아 검증을 진행해요. 브라우저 창이 한참 안 열린다면 화면의 안내에 따라 내 컴퓨터에서 Specnote 도우미를 켜 주면 됩니다.

AI에게 맡겨도 돼요

이 설정들은 화면에서 직접 해도 되고, 연결해 둔 AI에게 말로 부탁해도 돼요.

Specnote에 테스트 환경 등록해 줘. 이름은 "스테이징", 주소는 https://staging.example.com 이야. 그리고 테스트 계정 tester@example.com / 비밀번호 ○○○ 도 넣어 줘.

이렇게 말하면 AI가 환경과 계정을 대신 등록합니다. AI 연결이 아직이라면 내 AI 연결하기 (MCP 설치)를 먼저 봐 주세요.

환경과 계정이 갖춰졌다면, 이제 검증 돌리고 결과 읽기로 넘어가 실제로 돌려 보세요. 로그인 단계에서 자꾸 실패한다면 문제 해결에 짚어 볼 목록이 있어요.