결제 자리는 10줄로 만들었는데, 그 대시보드는 Python 3.13에서 켜지지 않았습니다
2026.08.12
소개
2주차 사례글에서 저는 이렇게 정리했습니다. "결제를 안 붙인 게 아니라 붙일 자리가 없었습니다." 대상은 citation-verifier, 명령줄 도구라 입구도 출구도 저 하나였습니다. 앞으로의 계획으로 onboarding_gglee의 구조를 그 도구에 씌우겠다고 적었습니다.
이번 세션은 다른 PC에서 실행됩니다. 확인부터 했습니다.
find /Users/kkkim/projects/autobiox/BioProject01 -iname "*onboarding*"
결과가 비어 있습니다. ~/projects/에도 citation-verifier가 없습니다. 지난주에 세운 계획을 실행했는지조차 이 기기에서는 확인할 수 없습니다. 지난주 "1주차 계획을 또 안 했다"던 패턴이 이번엔 "대상이 없어 확인 불가"로 한 단계 더 나빠질 뻔했습니다.
그래서 소재를 바꿨습니다. ~/projects/autobiox/ 안의 실제 프로젝트로 같은 질문(입구 - 노력을 투입하는 과정 - 결과 - 그 앞의 결제 지점)을 다시 던졌습니다.
진행 방법
진행 방법
어떤 도구를 사용했고, 어떻게 활용하셨나요?
사용 도구: Claude Code, git, python3, curl
Step 1. autobiox 하위 프로젝트 중 입구-과정-출구가 있는 것을 찾기
find /Users/kkkim/projects/autobiox/SpatialPathoAgent -iname "*.html" -o -iname "*.py"
find /Users/kkkim/projects/autobiox/biospin -iname "*.html" -o -iname "*.py"
find /Users/kkkim/projects/autobiox/BioProject02 -iname "*.html"
find /Users/kkkim/projects/autobiox/BioProject02 -iname "app.py" -o -iname "server.py" -o -iname "dashboard*"
프로젝트 |
| 내용 |
|---|---|---|
| 0개 | 기획 문서( |
| 0개 |
|
| 0개 (html/app 계열) |
|
|
| 실제 Flask형 대시보드 |
입구-과정-출구 구조가 있는 프로젝트는 BioProject01/web 하나뿐입니다. 나머지 세 프로젝트는 애초에 클릭할 화면이 없어, 2주차의 citation-verifier와 같은 처지입니다.
Step 2. BioProject01/web을 읽고 결제 조건 표를 채우기
app.py(958줄), index.html(184줄), DEPLOY.md를 읽었습니다. index.html은 실제로 1-2-3 단계 안내가 붙어 있습니다.
<h2 id="guide-title">처음이면 이 순서대로 진행하세요</h2>
...
<strong>자료 입력</strong> ... <strong>분석 시작</strong> ... <strong>결과 확인</strong>
2주차에 세운 표를 그대로 대입했습니다.
결제가 붙으려면 |
|
|
|---|---|---|
사용자가 들어오는 입구 | 없음 | 있음 ( |
노력을 투입하는 과정 | 없음 | 있음 (Step 1 자료 입력 → Step 2 Claude/Codex 분석) |
결과를 보는 지점 | 있음 (터미널) | 있음 (Step 3 결과 확인, papers 배지) |
그 앞에 둘 결제 지점 | 자리 없음 | 자리는 있음 |
2주차와 다른 결과가 나왔습니다. 흐름은 이미 있습니다.
Step 3. 그런데 DEPLOY.md가 막고 있다
This dashboard is designed for small-team local sharing on the same network.
...
Do not expose it to the public internet. Use token mode for team sharing.
같은 네트워크 안 소규모 팀 공유용으로 설계됐고, 공개 인터넷에 노출하지 말라고 명시돼 있습니다. 결제는 남이 인터넷 너머에서 들어와 돈을 내는 행위입니다. 이 문서 한 줄이 그 전제를 막습니다.
Step 4. 실제로 실행해 보기
python3 web/app.py --port 8765부터 시도했습니다.
Traceback (most recent call last):
File ".../web/app.py", line 12, in <module>
import cgi
ModuleNotFoundError: No module named 'cgi'
이 기기의 기본 python3는 pyenv의 3.13.12입니다. cgi 모듈은 Python 3.13에서 완전히 제거됐습니다. curl로 확인한 응답은 HTTP 000, 서버가 뜨자마자 죽어 있었습니다.
이 기기에 있던 /Users/kkkim/.local/bin/python3.11(3.11.15)로 다시 실행했습니다.
/Users/kkkim/.local/bin/python3.11 web/app.py --port 8765
이번엔 떴습니다(cgi deprecation 경고만 뜸). curl로 실제 응답을 받았습니다.
요청 | 결과 |
|---|---|
| HTTP 200, 8344 bytes (index.html 파일 크기와 정확히 일치) |
| HTTP 200, 논문 14개 |
Step 5. 결과 확인 단계의 실제 데이터
/api/papers 응답과 파일시스템을 각각 세어 서로 검증했습니다.
find analysis -name "paper-info.yaml" | wc -l # 14
find analysis -name "*_core.md" | wc -l # 14
find analysis -name "*_core.html" | wc -l # 6
API 응답(core: true 14개, html: true 6개, pdf: true 0개)과 파일시스템 카운트가 정확히 일치했습니다. 결과 확인(Step 3) 화면 자체는 실제로 동작합니다. 다만 원문 PDF가 보존된 논문은 14개 중 0개였습니다.
Step 6. 결제 자리를 코드 수준에서 스케치
강의에서 짚은 규칙("결과를 보기 직전에 결제")을 이 대시보드의 Step 3(결과 확인) 진입 직전에 그대로 적용해 봤습니다. index.html의 papers 섹션 바로 앞에 안내 문구와 비활성 버튼을 넣었습니다.
+ <div class="panel wide" style="border:1px dashed ...">
+ 결제 자리 표시(스케치, 미연동) — 결과 확인 단계 진입 전. 실제 결제 연동 없음.
+ <button type="button" disabled>결과 보기 (예: 유료)</button>
+ </div>
<section class="panel wide" aria-labelledby="papers-title">
git diff --stat은 web/index.html | 10 ++++++++++(10줄 추가, 삭제 0줄)를 보고했습니다. 3.11로 다시 서버를 띄우고 curl로 렌더링을 확인했습니다.
curl -s http://127.0.0.1:8766/ | grep -o "결제 자리 표시[^<]*"
# 결제 자리 표시(스케치, 미연동): GPTers 23기 3주차 과제 검토용.
# 결제 자리 표시(스케치, 미연동) — 결과 확인 단계 진입 전. 실제 결제 연동 없음.
자리는 붙습니다. 그런데 이 자리에 실제 결제창을 연결하려면, 강의에서 설명한 단계가 그대로 남습니다.
연동 이제 결제에 필요한 것들은 일단 처음으로 프론트에 결제창 띄우셔야 되고 그다음에 서버에서 어 이 결제 요청이 왔을 때 검증을 하고 또 이거를 어떤 로직을 통해서 어떻게 토스 페이먼트나 그런데 보낼지 그런 로직들을 정하셔야 되고 그다음에 이게 다시 토스페이먼츠에서 어떤 결과가 왔을 때 그 결과값을 어떻게 데이터베이스에 적용할 것이며 어떤 걸 또 프런트에 띄어 줄지를 정하셔야 됩니다.
이 대시보드에는 서버 검증도, DB도 없습니다(app.py는 파일과 subprocess만 다룹니다). 프론트 자리 표시 10줄과, 실제 연동 사이의 거리를 이번에 코드로 확인했습니다.
Step 7. 강의에서 결제 절차의 실측 수치를 확인
3주차 강의 자막에서 토스페이먼츠 관련 실무 수치를 뽑았습니다.
어, 이제 국내 피지정 피지 중에 토스 페이먼츠가 제일 유명한데 어 이 같은 경우에는 우선 부과세 10% 별도고요. 신용카드 같은 건 3.4% 이런 것들이 수수료가 있습니다. 어 그리고 제일 이제 무서운 게 가입비가 22만 원이고 연 관리비가 11만 원이에요.
저 토스 페이먼츠 이제 사용할래요라고 이제 계약을 맺는데만 약 일주일 정도가 걸립니다. 그리고 그 시간을 지나고 어, 이제 가오픈 식으로 해서 심사를 카드사가 이제 받게 되는데 그 시간도 이제 명시돼 있는 게 한 2주에서 4주 걸린다라고 하고 실제로 전화를 해 봤을 때도 한 한 달에서 얼마 더 걸릴 수 있다라고 전달을 받았습니다.
결국에는 판매되는 시점으로부터 20일 이내에 사업자를 내야 된다는 점을 꼭 강조드리고 싶습니다.
단건 결제와 구독은 심사 단계에서부터 나뉜다는 점도 짚었습니다.
제가 아는 선에선 단건 결제랑 정기 결제는 확연하게 나눠서 심사를 따로 받아야 되는 건 알고 있거든요.
뭘 팔지를 하셔야 되는데... 한번 단건 결제하실지 아니면은 구독 결제로 하실지 정하시면 되고
BioProject01/web은 "논문 1건 분석"이 자연스러운 단위라, 단건 결제 쪽에 가깝습니다.
Step 8. git으로 실제 변경을 확인
cd /Users/kkkim/projects/autobiox/BioProject01
git status --short
git log -1 --format="%h %ad %s" --date=short
항목 | 값 |
|---|---|
마지막 커밋 |
|
오늘 기준 | 61일 전 |
브랜치 |
|
세션 중 커밋 | 0개 (커밋하지 않음, 스케치는 검토 후 되돌림) |
작업 도중 git diff에서 제가 건드리지 않은 web/static/app.css 변경(#fff → var(--panel), 12곳)을 발견했습니다. 이번 세션에서 만든 변경이 아니라 이전부터 working tree에 있던 것이라, 손대지 않고 그대로 뒀습니다.
결과와 배운 점
측정 결과
항목 | 값 |
|---|---|
autobiox 하위 프로젝트 | 4개 ( |
입구-과정-출구 구조가 있는 프로젝트 | 1개 ( |
| 2026-06-12 (61일 전) |
| 실패 ( |
| 성공 (HTTP 200) |
| 14개 (파일시스템 카운트와 일치) |
core 산출물 완료 | 14 / 14 |
html 산출물 완료 | 6 / 14 |
PDF 원문 보존 | 0 / 14 |
결제 자리 표시 코드 (스케치) | 10줄 추가 ( |
실제 결제 SDK 연동 코드 | 0줄 |
배운 점
대상이 이 기기에 없다는 사실 자체가 정직한 출발점이었습니다.
citation-verifier를 다시 열어보지 못했지만, 같은 질문(입구-과정-결과-결제 지점)을 다른 프로젝트에 다시 던지는 게 가능했습니다. 질문이 프로젝트보다 오래 남는다는 걸 이번에 확인했습니다."흐름이 없어서 결제를 못 붙인다"는 2주차 결론이 이번엔 틀렸습니다.
BioProject01/web은 입구(index.html), 과정(Step 1-2), 결과(Step 3)가 실제로 있고 실제로 작동합니다(14개 논문, HTTP 200). 결제를 못 붙이는 이유가 매번 같지 않다는 걸 배웠습니다.이번엔 다른 두 가지 이유였습니다. 하나는
DEPLOY.md의 명시적 제약("do not expose to the public internet")이고, 다른 하나는 코드 자체가 이 기기의 기본 Python(3.13)에서 아예 실행되지 않는다는 것이었습니다. 설계 의도와 실행 가능성, 둘 다 결제 이전에 막혀 있었습니다.결제 자리를 코드에 넣는 일과 결제를 연결하는 일은 완전히 다른 크기의 작업이었습니다. 자리 표시는 10줄이면 됐습니다. 그런데 강의가 설명한 실제 연동(프론트 결제창, 서버 검증, DB 반영, 토스페이먼츠 API 키)은 이 대시보드에 없는 서버 계층을 새로 만드는 일입니다.
app.py는 파일과 subprocess만 다루고 데이터베이스가 없습니다.강의에서 얻은 숫자가 이 도구의 결제 여부를 미리 결정합니다. 토스페이먼츠 가입비 22만 원 + 연 관리비 11만 원, 계약부터 심사까지 최소 3주에서 한 달, 판매 시점부터 20일 이내 사업자 등록 의무. 이 도구를 지금 당장 공개하고 결제를 붙이는 결정을 하더라도, 실제로 돈이 오가기까지는 최소 한 달의 행정 절차가 먼저입니다.
시행착오
python3 web/app.py를 처음 실행했을 때 curl이HTTP 000을 반환해서 포트 충돌인 줄 알았습니다. 로그(/tmp/biop01_web.log)를 열어 보고서야cgi모듈 부재가 원인임을 알았습니다. 에러 없이 "안 됩니다"라고만 적었으면 원인을 놓칠 뻔했습니다.git diff에서 제가 만들지 않은web/static/app.css변경을 봤습니다. 제가 한 일과 이미 있던 것을 구분하지 않고 적었으면 사례글에 없는 작업을 한 것처럼 보였을 것입니다. diff는 파일 단위가 아니라 내용 단위로 확인해야 합니다.index.html에 결제 자리 표시를 넣고 curl로 렌더링까지 확인한 뒤, 저장소에는 반영하지 않고 되돌렸습니다. BioProject01에 파괴적이지 않은 최소 변경만 하라는 원칙을 지키려면, 확인이 끝난 스케치는 커밋하지 않는 편이 안전했습니다.
앞으로의 계획
web/app.py를 Python 3.13 호환으로 고치거나(예:cgi.FieldStorage의존 제거), 최소한README.md/DEPLOY.md에 요구 Python 버전을 명시하겠습니다. 지금은 실행 자체가 기기마다 갈립니다.DEPLOY.md의 "공개 금지" 제약을 다음 주에 다시 검토합니다. LAN 전용을 유지한 채 결제를 안 붙이는 결정을 할지, 별도의 공개용 배포본을 만들지 정합니다.단건 결제(논문 1건 분석당)로 방향을 잡습니다. 강의에서 확인한 대로 단건과 구독은 심사부터 나뉘므로, 지금은 하나만 고릅니다.
4주차 전에 서버 검증과 DB 계층을 최소한으로라도 스케치합니다. 지금
app.py에는 그 자리 자체가 없습니다.
도움 받은 글 (옵션)
23기 런칭 스프린트 3주차 강의 (박무재, Brandon 외): 토스페이먼츠 결제 연동 실습, 국내 PG(토스페이먼츠)의 가입비, 연관리비, 부가세, 카드수수료 수치, 계약부터 심사까지의 소요 기간, 판매 시점 이후 20일 이내 사업자 등록 의무, 단건 결제와 구독 결제가 심사 단계에서부터 나뉜다는 설명, 결제 연동에 필요한 프론트/서버/DB 단계 구분
BioProject01/web/DEPLOY.md(본인 프로젝트): "same network" 소규모 팀 공유 전제와 공개 인터넷 노출 금지 명시23기 런칭 스프린트 2주차 사례글 (본인): 결제가 붙으려면 필요한 네 가지 조건(입구/과정/결과/결제 지점) 표,
citation-verifier에는 그 자리가 없었다는 결론

![[부업스터디] 라고 하지만 여러개의 본업같은 서비스 개발/운영기 공유 #1 - 멍패스 썸네일](/_next/image?url=https%3A%2F%2Fcdn-beta.gpters.org%2Fexternal%2F122f1ba50b90cbc13508f251.jpg&w=3840&q=75)
![[런칭스프린트]회사의 인프라를 활용한 개인 서브 프로덕트 가보자고 ! 썸네일](/_next/image?url=https%3A%2F%2Fcdn-beta.gpters.org%2Fexternal%2F37f607c0cff941349aebce58.jpg&w=3840&q=75)
