본사가 전체를 관리하고, 가맹점은 자기 가맹점의 회원·결제·주문을 관리하는 구조입니다.
배달의민족·요기요처럼 여러 목적별 플랫폼이 공통 운영 기반을 공유하는 구조를 지향합니다. 현재 데모는 유형별 화면·항목만 구분하며, 독립 브랜드·도메인을 실제 운영하는 단계는 아닙니다.
같은 플랫폼이지만 유형마다 호칭·행위 표현·금액 명칭·기본 항목·색이 다르게 적용됩니다. 새 유형은 설정 한 곳(src/lib/vertical.ts)만 추가하면 모든 화면이 따라옵니다.
| 유형 | 기관 호칭 | 구성원 | 금액 | 버튼 문구 | 기본 항목 |
|---|---|---|---|---|---|
| 사찰 | 사찰 | 신도 | 시주금 | 시주하기 | 초하루 기도 · 연등 접수 · 사십구재 · 천도재 · 일반 시주 |
| 교회 | 교회 | 성도 | 헌금 | 헌금하기 | 주일헌금 · 십일조 · 감사헌금 · 선교헌금 · 건축헌금 |
| 성당 | 성당 | 교우 | 봉헌금 | 봉헌하기 | 교무금 · 주일헌금 · 미사예물 · 연미사 · 건축기금 |
| 원불교 | 교당 | 교도 | 보시금 | 보시하기 | 법은미 · 헌공금 · 교당 유지비 · 일반 보시 |
| 무속신앙 | 신당 | 신도 | 정성금 | 정성 올리기 | 치성 기도 · 재수굿 · 신령 공양 · 일반 정성 |
| 점집 | 상담소 | 손님 | 복채 | 복채 보내기 | 사주 상담 · 작명 · 택일 · 부적 |
| 후원단체 | 단체 | 후원자 | 후원금 | 후원하기 | 정기 후원 · 일시 후원 · 지정 기부 |
| 기타 비영리단체 | 단체 | 후원자 | 기부금 | 기부하기 | 일반 기부 · 지정 기부 |
사찰에 "헌금", 교회에 "시주"라고 표시되면 그 자체로 결례가 됩니다. 유형을 단순 분류값으로 두지 않고 화면 문구까지 따라 바뀌도록 설계한 이유입니다. 다만 기부금영수증 발급 자격은 유형에서 자동으로 정해지지 않으며, 언제나 본사가 개별 승인합니다.
마음사 QR로 가입한 회원의 추천 가맹점은 마음사로 고정됩니다. 이후 함께재단에 후원하면 추천 소속은 마음사로 유지되지만, 기부 내역과 영수증은 실제 후원받은 함께재단 기준으로 집계됩니다.
이 데모를 실제 금융 서비스로 오해하지 않도록 정확히 구분해 표기합니다.
| 항목 | 상태 | 비고 |
|---|---|---|
| 본사/가맹점 어드민 화면 분리 | 구현됨 | 탭 구조로 구현 |
| 가맹점 추가·유형 관리·고유 코드 발급 | 구현됨 | 본사 전용 API |
| 가맹점별 QR·전용 관리자 주소 | 구현됨 | /api/qr, /merchant?code= |
| 최초 추천 가맹점 유지 + 실결제 가맹점 별도 기록 | 구현됨 | 회원가입/후원 로직에 반영 |
| 회원가입·PASS 인증 | 시연만 가능 | 성공/취소 버튼으로 시연, 실제 PASS 미호출 |
| 카드/내통장/간편결제 결제 | 시연만 가능 | 성공/실패 시연 버튼, 실제 승인·출금 없음 |
| CMS 자동이체 약정 등록·일시중지·해지 | 시연만 가능 | 등록만 시연, 실제 출금 스케줄러 없음 |
| 결제 취소 | 구현됨 | 완료 금액·영수증 집계에서 자동 제외 |
| 결제·회원 검색/필터, CSV 다운로드 | 구현됨 | /api/export |
| 가맹점별 결제 항목 설정 | 구현됨 | 가맹점 어드민에서 직접 수정 |
| 회원 마이페이지 | 구현됨 | 휴대폰 조회 방식 (비밀번호 로그인 아님) |
| 가맹점·연도별 영수증 견본·인쇄 | 시연만 가능 | "시연용·증빙 효력 없음" 명시 |
| 영수증 발급 자격 관리 | 구현됨 | 유형과 별도로 본사가 개별 승인 |
| 종교·단체 유형별 용어·기본항목·색 구성 | 구현됨 | 8개 유형, 화면 문구까지 자동 적용 |
| 홈 화면에 추가(PWA) · 기관별 앱 이름·아이콘 | 구현됨 | 앱스토어 없이 아이콘 생성, /api/manifest·/api/icon |
| 태블릿 키오스크 모드 | 구현됨 | 화면 꺼짐 방지 + 전체화면 |
| 관리자 결제 푸시 알림 | 시연만 가능 | 동작하나 서버 재시작 시 재등록 필요(키·구독이 메모리) |
| 앱스토어 등록(.apk/.ipa) | 미구현 | Capacitor 절차는 APP.md에 정리 |
| 유형별 물품 주문·본사 처리 상태 변경 | 구현됨 | 기부 결제와 완전히 분리, 전용 화면 /shop 제공 |
| 관리 내역 자동 갱신 | 구현됨 | 15초 주기 |
| 관리자 로그인(비밀번호 없는 인증번호 방식) | 구현됨 | 세션 쿠키 서명·검증, 권한 구분, 계정 해제 즉시 반영 |
| 조회·CSV까지 권한 검증 | 구현됨 | 로그인 없이는 회원·결제 자료 조회 불가 |
| 인증번호 문자(SMS) 발송 | 시연만 가능 | 문자 미발송, 화면에 표시 - 실서버에서 발송 API로 교체 |
| 회원 마이페이지 본인인증 | 미구현 | 현재는 휴대폰 번호만으로 조회 |
| PG/은행 실연동, 계좌실명조회, 웹훅 정산 | 미구현 | 사용자 서버 이전 후 진행 |
| 선불·직불·자체 PG 사업 | 미구현 | 사업 구조 검토 단계 |
영업 데모 검증부터 투자 유치까지 4단계로 진행합니다.