🔧 공유콜백 상세 설정 및 기술 레퍼런스

시스템 구조
내정보 드롭다운 구조
주요 함수 레퍼런스
공유 시스템 연관 기능
권한 및 접근 제어
모범 사례

시스템 구조

공유콜백 시스템은 웹-앱 하이브리드 구조로 설계되어 있습니다:

계층	구성 요소	역할	위치
웹 프론트엔드	`kiam.kr/m` (HTML + jQuery + Bootstrap)	콜백 메시지 CRUD, 리스트 조회, SNS 공유	웹 브라우저
앱 프론트엔드	온리원문자 앱 (AppScript 인터페이스)	콜백등록관리, 공유콜백 설정, 부재중 전화 감지	Android 앱 (WebView)
앱-웹 브릿지	`callAppBridge()`, `AppScript.*`	웹 ↔ 앱 간 통신 인터페이스	WebView JavaScript
백엔드 API	PHP 스크립트 (/ajax, /admin/ajax)	데이터 저장, 조회, 수정, 삭제	서버 (Apache/PHP)
데이터베이스	MySQL (추정)	콜백 메시지, 회원, 공유 관계 데이터 저장	서버 DB

내정보 드롭다운 상세 구조

mypage-modalwindow 모달의 각 메뉴와 연결된 함수/URL을 상세히 정리합니다:

메뉴명	클릭 핸들러	대상 URL / 함수	앱 필요	비고
통합계정관리	`goOnlyOneApp()`	`AppScript.goOnlyOneApp('')`	✅	앱 미설치 시 플레이스토어 안내
마이페이지	`location.href`	`/iam/mypage.php`	❌	웹에서 직접 접근 가능
결제정보	`location.href`	`/?cur_win=payment`	❌	쿼리스트링 기반 페이지 전환
굿마켓	`gwc_tab()`	쿠키+location.href 조합	❌	굿마켓 상품 목록
콜이야	`callya_tab()`	쿠키+쿼리스트링 조합	❌	콜이야 콘텐츠
위드유	`openShop()`	별도 JavaScript 함수	❌	위드유 샵
콜백등록관리 ★	`goCallbackList()`	`AppScript.callbackList()`	✅	공유콜백 진입점
공지/푸쉬 알림	`location.href`	`/?cur_win=unread_push`	❌	읽지 않은 알림 확인
AI로 자동 카드 만들기	`create_auto_card()`	모달 닫기 → 추가 처리	❌	AI 기반 IAM 생성
AI명함프로필관리	`window.open()`	`/m/ai_card_profile_list.php`	❌	새 창에서 열림

주요 함수 레퍼런스

콜백 / 공유콜백 관련 함수

함수명	정의 위치	파라미터	기능
`goCallbackApp()`	HTML 인라인 (2곳)	없음	[콜백발송] 진입 → AppScript 연동
`goCallbackList()`	HTML 인라인 + index.js	없음	콜백등록관리 진입 → AppScript.callbackList()
`goCallbackCamerapApp()`	HTML 인라인	없음	카메라 앱 연동 (Android 전용)
`callback_list()`	HTML 인라인	없음	AJAX로 콜백 리스트 로드 및 모달 표시
`form_save_call()`	index.js	없음	콜백 메시지 저장 (AJAX multipart)
`share_callback()`	HTML 인라인	없음	콜백 공유 (현재 주석 처리)
`send_msg_applist()`	별도 정의	type ('callback'/'daily')	선택된 회원에게 메시지 전송
`app_set_list()`	별도 정의	mode ('self'/'push'), type	발송 방식 선택 (셀프폰/푸시)
`save_call_edit_ev()`	index.js	없음	콜백 메시지 수정 저장
`goback()`	별도 정의	from_page 문자열	이전 모달/페이지로 이동

SNS 공유 관련 함수

함수명	기능	상태
`showSNSModal()`	SNS 공유 팝업 열기	활성
`daily_send_pop()`	데일리발송 안내 팝업	활성
`sns_sendSMS()`	SMS 문자 공유	활성
`sns_copyContacts()`	주소 복사	활성
`sns_shareKakaoTalk()`	카톡 공유	비활성 (주석)
`sns_shareFaceBook()`	페이스북 공유	비활성 (주석)
`share_callback()`	콜백 공유	비활성 (주석)

공유 시스템 연관 기능

포인트 쉐어하기 (sharepoint_modal)

플랫폼 내에서는 포인트도 회원 간 공유할 수 있습니다. 콜백 메시지 설정 시 비용이 발생하므로, 포인트 공유 시스템과 연계됩니다:

// sharepoint_modal — 포인트 쉐어하기 팝업
// - share_id: 공유받을 회원 아이디
// - share_cash: 공유할 캐시포인트 금액
// - share_point: 공유할 씨드포인트 금액
// - start_sharing(): 실제 공유 실행

// 호출 트리거:
// onclick="sharepoint" data="callback_msg_modal" → 포인트 쉐어하기

카드/콘텐츠 공유 전송

기능	모달	공유 방식	포인트
카드 전송	`card_send_modal`	알림형 / 수신함 / 공유전송	포인트 차감
콘텐츠 전송	`contents_send_modal`	알림형 / 수신함	포인트 차감
공지 전송	`notice_send_modal`	알림형	포인트 차감

모든 전송 기능은 show_share_user_list() 함수를 통해 전송할 친구 선택하기 버튼으로 수신자를 지정합니다.

권한 및 접근 제어

제어 계층	메커니즘	상세
플랫폼 제한	User-Agent 검사	`navigator.userAgent.toLocaleLowerCase().search("android")`
앱 설치 확인	`AppScript` 존재 여부	`typeof AppScript !== 'undefined'`
로그인 확인	세션 기반 `mem_id`	비로그인 시 로그인/회원가입 유도
포인트 확인	보유 포인트 표시	부족 시 충전 유도
메시지 상태	유지/해지 (ON/OFF)	OFF 상태 메시지는 발송 불가

📌 보안 참고사항: 앱(AppScript) 연동 기능은 Android WebView 내에서만 동작합니다. 외부 브라우저(Chrome, Samsung Internet 등)에서는 AppScript 객체가 존재하지 않으므로 callAppBridge() 또는 앱 설치 안내로 대체 처리됩니다.

공유콜백 모범 사례

팀/조직에서 공유콜백 활용 시나리오

1
관리자가 표준 메시지 작성: 팀장이 모든 팀원이 사용할 표준 콜백 메시지를 작성하고 등록합니다.
2
팀원에게 공유: 콜백등록관리(앱)에서 팀원들의 아이디를 선택하여 메시지를 공유합니다.
3
팀원이 승인 및 적용: 각 팀원이 공유된 메시지를 확인하고 기본 콜백 메시지로 설정합니다.
4
메시지 업데이트 시 재공유: 관리자가 메시지를 수정하면, 변경사항을 팀원들에게 다시 공유하거나 알립니다.

주의사항

공유된 메시지는 수신자가 임의로 수정할 수 없습니다. (원본 보호)
메시지를 복사하여 나만의 버전으로 새로 등록하는 것은 가능합니다.
공유 해제 시 수신자의 기본 콜백 메시지가 자동으로 변경되지 않으므로, 수신자에게 사전 통보하는 것이 좋습니다.
동일한 메시지를 여러 번 공유해도 중복 등록되지 않습니다.