본문으로 건너뛰기

실행되는 앱을 다른 사람에게 건넬 수 있는 시연 묶음으로 만들었습니다

강진태

2026.10.19

실행되는 앱을 다른 사람에게 건넬 수 있는 시연 묶음으로 만들었습니다 본문 이미지

소개

이 글은 2026년 10월 13일의 후속 개발·시연 전달 기록을 기준으로 정리했습니다.

저는 앱이 제 개발 환경에서 실행되는 것과 다른 사람에게 전달할 수 있는 상태가 다르다는 점을 이번 후속 작업에서 확인했습니다. 화면을 열어 기능을 보여줄 수는 있었지만, 최신 화면이 압축파일에도 들어 있는지, 받는 사람이 무엇을 설치해야 하는지, 종료할 때 다른 프로그램을 건드리지 않는지까지 정리되어야 전달이 끝났다고 말할 수 있었습니다. 이번 글은 앞선 기능 개발 자체보다, 실행되는 결과물을 시연용 전달본으로 마무리한 과정에 관한 기록입니다.

당시 제가 요청한 방향은 기존 앱과 발표 자료를 보존하면서 가능한 개발과 검증을 먼저 진행하고, 사람이 직접 확인해야 하는 항목은 마지막에 모으는 것이었습니다. 그렇다고 실회원 자료를 가져오거나 실제 사진을 전송해도 된다는 뜻은 아니었습니다. 저는 시연에 필요한 합성 자료로 동작을 확인하되, 원본 자료와 실제 운영의 경계를 지키는 전달을 원했습니다.

제가 실제로 보낸 짧은 요청은 다음과 같았습니다.

계속 진행해

아래는 당시 작업 기록에서 확인한 요청의 요약입니다. 대화 원문을 그대로 인용한 문장은 아닙니다.

[실제 요청 요약]
기존 앱과 발표 자료는 보존해 주세요.
가능한 잔여 개발과 검증을 진행하고, 제가 직접 확인할 일은 마지막에 모아 주세요.
시연 결과를 전달할 수 있게 정리하되 실제 운영 완료와는 구분해 주세요.

여기서 가장 먼저 풀어야 할 문제는 파일을 압축하는 기술보다 전달 대상의 구분이었습니다. 공개 화면에서 입력한 내용은 방문자의 브라우저에 남고, PC용 발표 묶음의 입력은 그 묶음의 합성 저장소에 남았습니다. 두 결과가 서로 동기화되는 앱처럼 설명하면 받는 사람의 기대부터 어긋날 수 있었습니다.

설명용 일러스트, 실제 앱 화면 아님: 내 컴퓨터에서 실행되는 앱과 전달할 묶음 사이에는 확인할 간격이 있다.

진행 방법

전달 문서부터 실행 조건을 분리했습니다

Aside는 최종 전달 안내와 검증 기록을 정리하면서 공개 시연, PC용 시연 묶음, 역사적 중간본을 구분했습니다. 저는 이름이 비슷한 압축파일을 모두 최종본처럼 다루지 않는 것이 중요하다고 보았습니다. 수정 과정에서 남은 파일은 지우지 않되, 실제 전달에 사용할 묶음은 따로 지정했습니다. 과거 기록을 보존하는 일과 최신 전달 대상을 명확하게 만드는 일을 함께 한 셈입니다.

PC용 묶음에는 Windows x64와 Node 24 이상이라는 조건이 있었습니다. 실행 파일 자체가 모두 포함된 무설치 프로그램은 아니었고, Node 실행 파일도 들어 있지 않았습니다. 따라서 단순히 압축을 풀면 누구에게나 바로 실행된다고 설명하지 않았습니다. 압축을 푼 뒤 시작 안내와 실행 명령을 사용하고, 끝날 때는 전용 종료 명령으로 해당 시연만 종료하도록 전달 조건을 정리했습니다.

이 과정에서 저는 전달 문서를 기능 소개의 부록이 아니라 결과물의 일부로 보게 되었습니다. 화면에 어떤 기능이 있는지보다 먼저, 어떤 환경에서 열 수 있고 어떤 자료가 남는지 알아야 받는 사람이 실수하지 않기 때문입니다. 다른 PC 실행 여부는 따로 남겨 두었고, 현재 PC에서 확인한 결과로 그 조건까지 덮지 않았습니다.

저장 실패처럼 보인 현상을 먼저 나누었습니다

시연 흐름을 검사하는 과정에서는 기록을 저장한 뒤 다시 여는 동작이 문제가 되었습니다. 초기 브라우저 시도에는 화면이 비동기로 그려지는 시간과, 같은 날 같은 종류로 표시된 카드 중 무엇을 선택했는지가 섞여 있었습니다. 결과가 기대와 다르다고 해서 곧바로 저장 기능이 실패했다고 결론내릴 수 없는 상황이었습니다.

Aside는 생성한 기록의 정확한 식별값으로 같은 기록을 다시 열고, 화면이 그려지는 시점을 기다리는 방식으로 검사를 보완했습니다. 저는 여기서 화면에 비슷한 카드가 보인다는 것과 방금 저장한 동일 기록을 확인했다는 것이 다르다는 점을 배웠습니다. 확인 대상을 좁힌 뒤 최종 브라우저 흐름을 다시 검수했으며, 초기 시도 기록도 지우지 않았습니다.

공개 시연의 원정 참가에서는 별개의 실제 불일치가 발견되었습니다. 화면이 보내는 요청의 표기와 서버가 받는 계약이 맞지 않았고, 취소한 신청의 응답 표현 때문에 재신청 화면도 복구되지 않았습니다. Aside는 요청 표기를 맞추고 취소 상태의 응답을 수정한 뒤 관련 시험을 추가했습니다. 이후 다시 게시한 공개 시연에서 참가, 취소, 재신청의 연결을 확인한 것으로 전달 기록에 남겼습니다.

모든 오류를 기다림 문제로 처리한 것은 아니었습니다. 첫 문제는 검사 대상과 시점의 보완이 필요했고, 두 번째 문제는 앱 계약 자체의 수정이 필요했습니다. 저는 실패 화면 하나만 보고 원인을 같은 종류로 묶지 않는 것이 시연 검수에서도 중요하다고 보았습니다.

최신 화면과 안전 경계를 묶음에 반영했습니다

Aside는 최종 화면 파일을 전달용 사본에 맞추고, 기록 저장 뒤 도감으로 이동해도 시연 모드가 유지되도록 수정했습니다. 실제 사진 입력은 사용하지 못하게 했으며 서버에서도 사진 요청을 저장 전에 차단했습니다. 사진이 없는 합성 기록은 저장할 수 있게 하되, 실제 사진 처리나 사진 AI가 연결된 것처럼 보이지 않도록 했습니다.

저는 시연의 편의를 위해 안전 경계를 없애지 않았다는 점을 중요하게 보았습니다. 누군가 발표 화면에서 사진을 선택해 보더라도 그 행동이 실제 전송으로 이어져서는 안 되었습니다. 좋아요나 댓글처럼 시연에 필요한 상호작용을 허용하는 것과, 실제 인증·관리자·결제 권한을 여는 것은 다른 작업으로 남겼습니다.

최종 압축본은 만든 자리에서 끝내지 않고 새로 압축을 푼 사본으로 검사했습니다. 기록에는 실제 설치된 Node 24 환경에서 필요한 모듈을 불러오고, HTTP 응답과 사진 차단, 시작·상태 확인·종료를 점검한 결과가 남아 있습니다. 묶음의 파일 해시를 대조하고 원본 개발 경로 없이 실행할 수 있는지도 확인했습니다.

압축 묶음과 분리된 실행 공간을 확대경으로 점검하는 장면

설명용 일러스트, 실제 앱 화면 아님: 압축과 독립 실행을 각각 확인한다.

검증 숫자보다 검증 범위를 함께 전달했습니다

전체 후속 기록에는 합성 회귀시험 471건 중 470건 통과, 실패 없음, 제외 1건이 정리되어 있었습니다. 제외한 시험은 비공개 원본 자료가 필요했기 때문에 원본을 읽지 않고 남긴 항목이었습니다. 저는 이 결과를 모든 기능이 실사용까지 검증되었다는 의미로 쓰지 않았습니다. 어떤 자료를 쓰지 않기로 했는지까지 포함해야 숫자의 의미가 정확해졌습니다.

전달용 압축 해제 검사에는 HTTP 관련 확인 39건과 필요한 모듈 로딩, 파일 일치 여부가 기록되어 있었습니다. 반면 실제 휴대폰, 물리 키보드, 카메라와 위치 권한은 사람 확인 대상으로 분리했습니다. 브라우저 자동화로 키를 보냈거나 좁은 화면을 표시한 사실만으로 실제 단말 검수가 끝났다고 하지는 않았습니다.

기존 결과물을 보존했다는 설명도 범위를 좁혔습니다. 확인한 파일 지문과 압축본의 해시가 유지된다는 근거가 있었지만, 그것을 모든 과거 파일과 현재 공개 사이트의 상태를 새로 전수 검사했다는 말로 넓히지 않았습니다. 이 구분은 뒤이어 클라우드 준비 작업으로 넘어갈 때도 기준이 되었습니다.

결과와 배운 점

이 단계에서 저는 전달 대상을 지정한 PC용 시연 묶음과 최종 전달 안내, 별도의 사람 확인표를 갖추었습니다. 압축 해제 사본의 실행 검사 결과가 남았고, 최신 화면 반영과 기존 산출물 보존의 근거도 정리되었습니다. 앱이 실행된다는 설명에서 한 걸음 더 나아가, 무엇을 건네고 어떻게 확인했는지를 말할 수 있게 된 결과였습니다.

다만 실서비스를 완성한 것은 아니었습니다. 다른 PC에서의 직접 실행과 발표 리허설, 실제 기기와 물리 입력, 계정·메일·보관 정책, 실제 제공자와 권리 확인이 남아 있었습니다. 공개 입력과 PC 시연 입력이 서로 동기화되지 않는다는 조건도 그대로였습니다. 이번 글 역시 당시 문서와 검증 산출물을 바탕으로 정리한 것이며, 현재 사이트나 실행 환경을 새로 점검했다는 뜻은 아닙니다.

저는 이번 작업에서 완료 기준을 기능 목록만으로 잡지 않는 법을 배웠습니다. 기능이 보이는가, 전달본에도 같은 내용이 들어 있는가, 받는 사람이 실행 조건을 이해할 수 있는가, 실제 자료가 잘못 들어갈 경로는 막혀 있는가를 따로 물어야 했습니다. 그 질문을 분리하니 사람이 판단해야 할 일도 더 구체적으로 남길 수 있었습니다.

앞으로 비슷한 작업을 한다면 저는 실행 화면만 요청하지 않고 전달 대상, 자료의 저장 위치, 시작과 종료 방법, 다른 환경에서 남은 확인을 함께 요청하겠습니다. 자동으로 진행할 수 있는 검수는 끝까지 하되 사람이 직접 확인해야 하는 조건을 완료라는 말 뒤에 숨기지 않는 것이 이번 사례의 핵심입니다.

봉인된 전달물과 별도 보호막 아래 보존된 원본 종이

설명용 일러스트, 실제 앱 화면 아님: 전달물의 완성과 원본 보존을 함께 지킨다.

도움 받은 글 (옵션)

이번 글은 외부 사례글을 따라 만든 후기가 아니라 후속 작업 기록, 최종 전달 안내, 압축 해제 검증 결과와 사람 확인표를 바탕으로 정리했습니다. 이전 기능 개발은 배경으로만 두고, 전달 가능한 시연 묶음으로 마무리하며 새로 확인한 변화에 집중했습니다.

1

함께 이야기해요 1

로그인하고 댓글을 남겨 주세요

Giacomo 프로필 이미지
Giacomo2026.10.20

진태님, 새로 압축을 푼 사본에서 원본 개발 경로 없이 실행을 확인한 대목이 반가웠어요. 앞서 사람이 직접 시험할 서버를 유지하셨던 작업에 이어, 이번에는 건넬 파일 자체를 검사 대상으로 삼으셨네요. 공개 화면의 입력과 PC 시연의 입력이 따로 남는다는 설명도 받는 사람에게 필요한 안내입니다. 화면이 비슷해도 자료가 서로 동기화되는 앱은 아니라는 점을 먼저 알려주셨으니까요.

Windows x64와 Node 24 이상이 필요하고 Node 실행 파일은 포함되지 않는다는 조건, 시작과 상태 확인뿐 아니라 해당 시연만 종료하는 방법까지 전달물에 넣으셨네요. 현재 PC에서 압축 해제본을 검사한 결과와 다른 PC에서의 직접 실행은 구분해두셨고요. 설치가 필요 없는 프로그램으로 오해하지 않도록 설명한 부분에서 전달 안내가 왜 결과물의 일부인지 잘 드러납니다.

저장 후 다시 열기가 어긋났던 두 사례를 다르게 다룬 과정도 짚고 싶어요. 비슷한 카드 대신 생성한 기록의 식별값을 사용하고 화면이 그려질 때까지 기다린 검수 보완이 있었고, 원정 참가 쪽은 요청 표기와 취소 응답을 실제로 수정한 뒤 재신청까지 확인하셨죠. 기다림을 늘리는 일과 앱을 고치는 일을 한 가지 처방으로 뭉개지 않은 기록이라, 오류 화면만 보고 결론을 서두르지 않게 됩니다.

실제 사진은 화면에서만 막는 데 그치지 않고 서버에서도 저장 전에 차단하면서, 사진 없는 합성 기록은 시연할 수 있게 남기신 마무리가 든든합니다. 최신 화면을 묶음에 반영하고 실행 조건과 사람이 직접 확인할 항목까지 함께 건네신 덕분에, 받는 사람이 무엇을 실행하고 어디까지 믿어도 되는지 읽을 수 있는 전달본이 되었어요.

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요