이 게시물은 GitHub Finish-Up-A-Thon 챌린지에 제출하는 결과물입니다.

내가 만든 것: PayFusion AI는 Alipay, WeChat, USDT, PayPal과 같은 플랫폼을 사용하여 하나의 QR 코드(QR code)로 다채널 결제를 지원하는 풀스택 지능형 결제 통합 시스템(payment aggregation system)입니다. 이 시스템은 자동 이체, 자금 분배, QR 코드 파싱(parsing), 그리고 AI 기반의 실시간 결제 모니터링을 통합합니다. 이 프로젝트는 단순한 Flask QR 코드 생성기로 시작했으나 점차 완전한 결제 자동화 플랫폼으로 진화했습니다. 주요 기능은 다음과 같습니다:

• 하나의 QR 코드로 다채널 결제: 통합된 QR 코드를 동적으로 생성하며, 사용자의 스캔 환경에 따라 해당 결제 채널로 지능적으로 라우팅(routing)합니다.
• AI 자금 모니터링 에이전트 (Agent): 결제 상태를 실시간으로 모니터링하고, 자금 도착을 자동으로 확인하며, 후속 워크플로우(workflow)를 트리거합니다.
• 이중 플랫폼 아키텍처 (Dual-platform architecture): Flask 웹 관리 백엔드 + Telegram Bot 모바일 제어.
• 자동 이체 엔진: TRON 네트워크 상의 USDT 자동 수집 및 자금 분배를 지원합니다.
• 오프라인 서명 및 블라인드 서명 (Offline signature and blind signature): 완전한 블록체인 보안 테스트 모듈.

전체 프로젝트는 Android의 Termux 터미널에서 완전히 개발 및 배포되었으며, 최종적으로 GitHub에 푸시(push)된 후 Railway/Render를 통해 자동화되었습니다.

데모 GitHub 저장소: Bigboss6797976/ailipay
Telegram Bot: @PayFusionBot (데모 환경)
웹 패널: https://ailipay-production.up.railway.app (데모 환경)

스크린샷 미리보기:

• 웹 측 통합 QR 코드 생성 인터페이스
• Telegram Bot 실시간 결제 알림
• 자금 전환 규칙 설정 패널
• Termux 내 개발 환경

전환점: 체계적으로 "엉망인 상태를 정리하기 (cleaning up the mess)"
나는 새로 쓰는 대신 수정하기로 결정했습니다. 이것이 바로 Finish-Up-A-Thon의 핵심입니다. 첫 번째 단계: 환경 정리

Hardhat의 손상된 락 파일(lock files)을 철저히 정리하기

rm -rf node_modules package-lock.json npm cache clean --force npm install

2단계: Termux 호환성 수정

• Pillow를 위한 Termux 전용 컴파일 의존성 설치: pkg install libjpeg-turbo libpng
• 시스템 모니터링 모듈을 재작성하기 위해 psutil을 네이티브 Python의 os 및 subprocess로 교체
• TronWeb을 v4 안정 버전으로 다운그레이드하고 모든 주소 생성 로직을 리팩터링 (refactor)
• zbar 시스템 라이브러리 설치: pkg install zbar 및 LD_LIBRARY_PATH 설정

3단계: 배포 파이프라인 수정

• 16진수 색상 값(hexadecimal color values)으로 전환하여 Flask의 RGBA 색상 파싱 오류 수정
• Termux → GitHub → Railway로 이어지는 CI/CD를 자동화하기 위한 원클릭 배포 스크립트 railway_fix.sh 생성
• 컴파일 충돌이 발생하는 의존성을 제거하여 Render를 위한 간소화된 requirements 파일 생성

4단계: 아키텍처 업그레이드

• 복잡한 스크립트들을 모듈형 구조로 분리: bot.py (Telegram 측), app.py (Web 측), payment/ (핵심), crypto/ (온체인)
• aiogram 3.7+ 비동기 (asynchronous) 프레임워크를 도입하고 모든 Telegram 상호작용 로직을 재작성
• 민감한 정보를 코드로부터 완전히 분리하기 위해 환경 변수 (environment variable) 관리 기능 추가

현재 상태
오늘날, 이 프로젝트는 프로덕션 준비가 된 (production-ready) 시스템이 되었습니다:
✅ 오류 없이 모든 단위 테스트 (unit tests) 통과
✅ Railway 및 Render에서 안정적으로 실행 중
✅ 20개 이상의 명령어와 80개 이상의 기능 모듈을 지원하는 Telegram Bot
✅ 완전한 결제 흐름: 코드 스캔 → 결제 → 확인 → 자동 이체 → 알림
✅ 코드베이스가 "실행 불가능한" 상태에서 "유지보수 가능하고 확장 가능한 (maintainable and scalable)" 상태로 진화

가장 큰 교훈
이 프로젝트가 나에게 가르쳐준 것은 단순히 특정 기술 스택이 아니라, 자원이 제한된 환경에서 어떻게 엔지니어링 솔루션을 제공하는가였습니다. 개발 환경이 고작 안드로이드 폰뿐일 때, 컴파일러가 50번째 오류를 던질 때, 문서에 "이 플랫폼에서는 지원되지 않음"이라고 적혀 있을 때—포기하는 대신 디버깅을 계속하기로 선택하는 것—그것이 바로 "Finishing-Up"의 진정한 의미입니다.

스마트폰이나 태블릿에서 개발 중인 분들 중 Termux 사용에 어려움을 겪고 있다면, 다음 팁들을 기억하세요: 1. 권한 문제를 피하기 위해 $HOME을 빌드 디렉토리 (build directory)로 사용하고, 이를 공유 저장소 (shared storage)로 복사하세요. 2. 컴파일 에러 (compilation errors)가 발생하면 시스템 라이브러리 (system libraries)를 먼저 확인하세요. 보통 pip install을 하기 전에 pkg install이 먼저 작동해야 합니다. 3. Termux는 표준 Linux가 아니므로 의존성 버전 (dependency versions)을 고정하세요. 최신 버전이 곧 호환성 문제 (incompatibility)를 의미하는 경우가 많습니다. 4. 정신적 스트레스를 줄이기 위해 "push → deploy → check" 과정을 하나의 명령어로 통합하는 원클릭 스크립트 (one-click script)를 작성하세요. 이번 챌린지를 주최해 준 GitHub과 DEV에 감사드립니다. 프로젝트 하나를 완성하는 것이 열 개를 시작하는 것보다 더 가치 있습니다. 여러분도 만약 엉망이 된 코드들을 정리하고 있다면, 계속 나아가세요. 출시일이 코앞에 와 있습니다. 이 프로젝트에 관심이 있다면, GitHub에서 Star를 누르거나 Issue를 제출해 주세요!