# 마이페이지 기능 정리

Oct 7, 2026 · @master

## 개요

마이페이지는 고객이 계약한 서비스(웹호스팅·도메인·메일·서버·DBMS·SSL 등)를 직접 관리하고, 결제·계정·고객지원까지 처리하는 셀프서비스 콘솔입니다. 화면은 모두 한국어 기본이며 16개 언어를 지원합니다.

| 항목 | 내용 |
| --- | --- |
| 소스 | `/home/dev/apps/mypage` |
| 빌드 산출물 | `/home/dev/public/new/mypage` |
| 접속 URL | 개발 `http://b57.nskorea.com/new/mypage/`, 운영 `https://jungbo.net/mypage/` |
| 프론트엔드 | React 18 + TypeScript + Vite, shadcn-ui + Tailwind, React Router v6, Framer Motion, Recharts, TipTap |
| 백엔드 | PHP 엔드포인트 `php/<영역>/*.php` (약 280개) + Python 데몬 `mypage_daemon.py` + Go 터미널 서버 |
| 외부 연동 | 토스페이먼츠(결제), NICE 본인인증, 채널톡(상담), SSH(서버 관리) |
| 다국어 | react-i18next, 번역 파일 16개 언어(언어 선택 메뉴에는 10개), 기본값 ko |

## 메뉴·화면 구성

마이페이지는 공통 화면 4개와 서비스별 관리 영역 11개로 나뉩니다. 서비스 영역은 대부분 ‘도메인(계약) 목록 → 선택 → 상세 관리 화면’ 순서로 동작합니다. 경로는 모두 `/mypage` 기준입니다.

| 영역 | 경로 | 하위 화면 |
| --- | --- | --- |
| 홈(서비스 현황) | `/` | — |
| 내 계정 | `/account` | — |
| 결제 | `/payment` | `success`, `fail` |
| 고객지원 | `/support` | — |
| 리눅스 웹호스팅 | `/web/linux` | 목록, `dashboard`, `security/overview`, `security/firewall`, `security/ssl`, `accounts`, `backups`, `weblog` |
| 윈도우 웹호스팅 | `/web/windows` | 목록, `security/firewall`, `accounts` |
| 이미지 호스팅 | `/web/image` | 목록 |
| 미디어 호스팅 | `/web/media` | 목록, `accounts`, `logs` |
| 도메인 | `/domain` | 목록, `dashboard`, `owner-info`, `manager-info`, `nameserver`, `records`, `transfer`, `ownership-transfer`, `privacy`, `parking-forwarding` |
| 메일 | `/mail` | 목록, `dashboard`, `client-guide`, `email-accounts`, `email-accounts/settings`, `spam`, `tracking`, `access-control`, `settings` |
| 서버 | `/server` | 목록, `dashboard`, `tickets`, `server-manager`, `network-firewall`, `subdomain`, `traffic`, `transfer` |
| DBMS | `/dbms` | 목록, `password`, `backups` |
| SSL 인증서 | `/ssl` | 목록, `order` |
| 보안 서비스 | `/waf`, `/vpn`, `/nms` | 각 목록 |

그 외 `/session-expired`(세션 만료 안내)와 404 화면이 있습니다.

## 기능별 상세

서비스 영역의 목록 화면은 공통 컴포넌트(`DomainListUnified`)를 써서 검색, 상태 필터(전체·정상·만료 임박·만료), 정렬, 페이지 이동을 똑같이 제공합니다. 아래는 목록 이후 화면의 기능입니다.

### 홈 (`/`)

- **보유 서비스 카드** — 도메인·웹호스팅·서버호스팅·DBMS·메일·보안·솔루션별 개수와 바로가기, ‘도메인 등록’ 바로가기.
- **결제 및 연장 / 만료 일정** — 남은 일수 순 정렬, ‘N건 확인 필요’ 배지, 연장하기·재등록 → `/payment` (`get_domain_expiration_status.php`, `get_hosting_expiration_status.php`).
- **공지사항** — 보안·공지·작업 태그, 상단 고정, 상세 모달 (`get_notices.php`, `get_notice_detail.php`).
- **서버 보안 점검** — NMS·WAF 적용 여부 표시, 적용하기·채팅 상담(채널톡, 없으면 1522-8761 전화)·닫기.
- **AI 리뉴얼 미리보기 배너** — `/ai-styler` 링크, 닫기 가능.

### 내 계정 (`/account`)

| 탭 | 사용자가 할 수 있는 일 | 주요 엔드포인트 |
| --- | --- | --- |
| 회원정보 | 국문·영문 이름, 이메일(NICE 또는 SMS 인증 후), 주소(다음 우편번호) 수정. NICE 본인인증으로 휴대폰 변경, 네이버·카카오 소셜 로그인 연동, 법인전환 신청(서류 첨부), 비밀번호 변경 | `get_user_profile.php`, `update_user_profile.php`, `get_nice_token.php`, `update_mobile_from_nice.php`, `send_sms_auth.php`, `request_corp_conversion.php`, `change_password.php` |
| 보안설정 | OTP 2단계 인증 켜기·QR 등록, 해외 IP 로그인 차단 | `get_security_settings.php`, `update_security_settings.php` |
| 관리자 | 도메인별 관리자(이름·이메일·전화·휴대폰) 조회·수정 | `get_admin_domain_list.php`, `update_admin_info.php` |
| 예치금 | 잔액·입출금 내역 검색, 카드로 충전(최소 1,000원) | `get_deposit_info.php`, 토스 `chargeBalance` |
| 활동 로그 | 최근 1년 활동(일시·동작·결과·IP) 검색 | `get_activity_log.php` |

### 결제 (`/payment`)

| 탭 | 사용자가 할 수 있는 일 | 주요 엔드포인트 |
| --- | --- | --- |
| 호스팅 | 단건·일괄 연장(월·반기·연), 청구서 보기, 사양 변경 신청, 해지 신청 | `get_hosting_list.php`, `view_estimate.php`, `submit_service_change.php` |
| 도메인 | 일괄 연장, 청구서, 만료 도메인 재등록 | `get_domain_list.php`, `get_domain_reorder_info.php` |
| 결제 내역 | 기간(1·3·6·12개월)·수단별 조회, 카드 영수증·거래명세서, 세금계산서 요청 바로가기 | `get_payment_history.php`, `view_statement.php` |
| 세금계산서 | 발행 신청(대상 선택 → 사업자 정보)·수정, 최근 6개월 발급 내역·출력 | `create_tax_invoice_request.php`, `update_tax_invoice.php`, `get_tax_report_list.php`, `get_tax_print.php` |
| 현금영수증 | 개인(소득공제)·법인(증빙) 발행 신청·수정 | `create_cash_receipt.php`, `update_cash_receipt.php` |
| CMS 자동이체 | 도메인 선택 → 출금 계좌 → 약관 동의 신청, 수정·재신청·해지 | `create_cms_request.php`, `delete_cms_request.php` |

결제 수단은 세 가지입니다. 카드(토스페이먼츠, 가상계좌는 ‘입금 대기’), 무통장 입금 통보(`set_inform.php`, 담당자 확인), 예치금(`pay_balance.php`). 결과는 `/payment/success`·`/payment/fail`을 거쳐 결제 성공·입금 대기·미완료 모달로 표시됩니다.

### 고객지원 (`/support`)

- **1:1 문의 등록** — 분류(고객지원·기술지원·해지신청·법인전환서류), 첨부 5개×20MB (`support/create_inquiry.php`).
- **문의 내역·상세** — 검색·상태 필터, 관리자 답변 확인, 문의 수정 (`get_inquiries.php`, `get_inquiry_details.php`, `update_inquiry.php`).
- **FAQ** — 고정 질문 4개(도메인 등록·호스팅 업그레이드·백업·SSL).

### 공통 레이아웃

- **헤더** — 사용자 이름, 경로 표시, 프로필 드로어(접속 IP·투어 시작·로그아웃).
- **설정** — 언어 전환(메뉴 10개 언어), 다크 모드(라이트·다크·시스템), 저사양 모드(기본 켜짐).
- **사이드바** — 서비스별 메뉴와 호버 하위 메뉴, 첫 방문 시 프로필 설정 가이드.
- **가이드 투어** — 메일, 리눅스 웹호스팅, 서버매니저 화면에만 있음.
- **채널톡** — 상담 위젯.

### 리눅스 웹호스팅 (`/web/linux`)

| 화면 | 사용자가 할 수 있는 일 | 주요 엔드포인트 |
| --- | --- | --- |
| 대시보드 | 저장공간·월 트래픽·보안 상태·최근 백업 카드, 방문자 국가 지도. 허용된 도메인은 ‘내 사이트 고치기’(라이브 사이트 텍스트 편집, 저장당 300건, 동시 수정 감지) | `get_dashboard.php`, `get_site_edit.php`, `page_edit.php` |
| 보안 개요 | HTTPS 리다이렉트·WAF·해외 IP 차단 토글, IP·CIDR(/16 이하) 웹 접근 차단 목록(일괄 추가·삭제), 크롤러별 허용·차단(검색·소셜·AI·SEO·아카이브, robots.txt 반영) | `get_settings.php`, `update_settings.php`, `update_ip_blocklist.php`, `bot_policy.php` |
| 방화벽 | FTP(21)·SSH(22) 접속 허용 IP 등록(1\~60일, 기본 6개월), 연장(최대 6개월), 영구 등록, 일괄 삭제 | `get_firewall_rules.php`, `add_firewall_rule.php`, `extend_firewall_rule.php`, `delete_firewall_rule.php` |
| 무료 SSL | Let’s Encrypt 인증서 상태(90일, 자동 갱신), 발급·폐기. 스탠다드형 이상 | `get_ssl_status.php`, `issue_new_ssl_certificate.php`, `revoke_ssl_certificate.php` |
| 계정 | FTP 호스트·포트·ID 확인, 비밀번호 변경 | `change_password.php` |
| 백업 | 백업 목록(날짜·크기·종류·상태), 수동 백업(하루 1회), 파일(.tar)·DB(.sql) 다운로드 | `get_backup_list.php`, `create_ftp_backup.php`, `check_referer.php` |
| 웹로그 | 일·주·월 방문자 추이와 국가 분포. 요약·대역폭·상태코드/보안 이벤트·유입 경로·상세 표 탭, CSV 내보내기 | `get_weblog_overview.php`, `get_weblog_visitors.php`, `get_weblog_search.php`, `get_weblog_tables.php` |

### 윈도우·이미지·미디어 호스팅

- **윈도우 (`/web/windows`)** — 대시보드 없이 방화벽(리눅스와 동일한 허용 IP 관리)과 계정(FTP 정보·비밀번호 변경)만 제공.
- **이미지 (`/web/image`)** — 도메인 선택 시 FTP 토큰을 발급해 외부 콘솔(`console.hardfree.net`)을 새 탭으로 엽니다 (`web-image/storage.php`).
- **미디어 (`/web/media`)** — 계정(FTP ID·비밀번호 변경)과 FTP 로그(기간·검색, 로그인·업로드·다운로드 집계) (`get_ftp_logs.php`).

### 도메인 (`/domain`)

타사 등록 도메인과 2차 도메인은 DNS 레코드·소유권 이전 메뉴만 보입니다 (`get_domain_type.php`).

| 화면 | 사용자가 할 수 있는 일 | 주요 엔드포인트 |
| --- | --- | --- |
| 목록 | 도메인별 등록확인서 출력 | `get_registration_confirmation.php` |
| 대시보드 | 등록·만료일, 상태, 정보보호, 네임서버, 등록기관, 소유자·관리자 이메일, 기관 이전 진행 시 경고 | `get_domain_details.php` |
| 소유자 정보 | 이메일 인증(2분) 후 개인·법인, 국문·영문 이름, 연락처, 주소 수정 | `get_owner_info.php`, `update_owner_info.php`, `send_auth_email.php`, `verify_code.php` |
| 관리자 정보 | 관리자 연락처·주소·SMS 수신 동의 수정 | `get_manager_info.php`, `update_manager_info.php` |
| 네임서버 | 네임서버 2\~4개 변경, 자체 네임서버는 IP(글루) 입력 | `get_nameservers.php`, `update_nameservers.php` |
| DNS 레코드 | A·MX·TXT·CNAME·DNAME·SRV 추가·수정·삭제, 변경 모아 저장·복구, CNAME 충돌 검사. 자사 네임서버일 때만 편집 | `get_dns_records.php`, `manage_dns_record.php` |
| 기관 이전 | 이전 잠금 토글(소유자 변경 후 60일 해제 불가), 이전 코드 발급, 타사 이전 요청 거부 | `update_transfer_lock_status.php`, `issue_transfer_code.php`, `outbound_transfer.php` |
| 소유권 이전 | 받는 사람 ID 확인 → 양쪽 이메일 인증 → WHOIS 변경 여부 선택 → 결제(22,000원). or.kr은 비영리 서류 첨부 | `get_ownership_transfer_info.php`, `check_transferee_id.php`, `ownership_pay_balance.php` |
| 정보보호 | WHOIS 정보보호(유료) 켜기·끄기 | `get_privacy_status.php`, `update_privacy_status.php` |
| 파킹·포워딩 | 파킹 페이지(제목·메모·문의 폼), 포워딩(주소 고정 옵션), A 레코드 불일치 경고, 유료 SSL 추가 | `get_parking_forwarding_data.php`, `update_parking_forwarding_data.php`, `check_a_record.php` |

### 메일 (`/mail`)

일부 화면은 요금제에 따라 잠기며 잠긴 화면은 안내 오버레이를 보여 줍니다. 월간 보고서는 고급형(30GB) 이상입니다.

| 화면 | 사용자가 할 수 있는 일 | 주요 엔드포인트 |
| --- | --- | --- |
| 대시보드 | 저장공간 게이지, 최근 활동, 7일 수신·스팸 차트, 계정별 사용량 분석 | `get_dashboard.php`, `get_detailed_usage.php`, `get_traffic.php` |
| 메일 프로그램 설정 안내 | Outlook·Thunderbird·iPhone 설정 방법과 서버 정보 | `get_mail_server.php` |
| 이메일 계정 | 계정 목록·검색·트래픽 정렬, 계정 추가·삭제, 읽은 메일 정리 | `active_emails.php`, `add_account.php`, `delete_account.php`, `cleanup_read_mails.php` |
| 계정 설정 | 전달 규칙(기본 10개) 추가·삭제·켜기, 비밀번호 변경·마지막 변경일 | `forwarding_rules_batch_update.php`, `update_password.php` |
| 스팸 관리 | 격리함(복원·삭제·허용/차단 등록), 스팸 강도 3\~10, 처리 방식(격리/\[SPAM\] 표시), 필터 우회, 반송 메일(백스캐터) 차단 | `get_quarantine.php`, `update_spamlevel.php`, `update_spam_action.php`, `update_bypass_status.php`, `update_backscatter_status.php` |
| 메일 추적 | 기간(최대 약 30일, 1회 48시간)·발신자·결과별 수발신 추적, 거부 사유·스팸 점수 확인 | `get_mail_tracking.php`, `get_mail_tracking_detail.php` |
| 접근 제어 | 허용·차단 목록(이메일·도메인·IPv4) 추가·삭제 | `get_access_list.php`, `add_access_list_entry.php`, `delete_access_list_entry.php` |
| 설정 | 용량 알림(임계치·수신 주소·테스트 발송), 월간 보안 보고서 구독·즉시 발송 | `get_mail_settings.php`, `save_mail_settings.php`, `send_monthly_report.php` |

백그라운드 작업으로 용량 알림 점검(6시간마다, `check_storage_alert.php`)과 월간 보고서 발송(`cron_monthly_report.php`, LLM 코멘트 포함)이 동작합니다.

### 서버 (`/server`)

모든 하위 화면은 `?domain=&ip=`로 대상 서버를 지정합니다.

| 화면 | 사용자가 할 수 있는 일 | 주요 엔드포인트 |
| --- | --- | --- |
| 목록 | 도메인·서비스명·만료일·서버 IP 확인, IP 있는 서버 상단 정렬 | `server/get_domain_list.php` |
| 대시보드 | CPU·메모리·디스크·I/O 지표(날짜 선택, 1분 자동 갱신). 모니터링 미설정 시 설정 요청 티켓 생성 | `dashboard.php`, `create_ticket.php` |
| 작업 요청서 | 티켓 목록·검색, 작성(서비스 문의·재부팅·설정·방화벽, 첨부 5개×20MB), 접수 상태일 때만 수정, 관리자 답변 확인 | `get_tickets.php`, `create_ticket.php`, `update_ticket.php`, `get_ticket_detail.php` |
| 서버매니저 | 관리형 서버 상품 전용. 아래 탭 참고 | `check_managed_access.php`, `get_server_overview.php` |
| 네트워크 방화벽 | 관리 포트(TCP, 최대 5개)별 허용 IP 추가·삭제·메모·활성 토글·일괄 편집. 최초 활성화는 방화벽 티켓으로 요청 | `network_firewall_manage.php` |
| 하위도메인 신청 | 호스트명 + IP 입력 → 하위도메인·DNS 레코드 등록 | `request_subdomain.php` |
| 트래픽 | 일·주·월 차트, 기간 지정, In/Out 전환, 최대·평균·현재값 | `get_traffic.php` |
| 전송량 | 월 선택 → 총 전송량과 일별 차트 | `get_traffic.php` |

서버매니저 탭:

- **운영** — 서비스 시작·중지·재시작(10분에 3회), 서버 재부팅·취소(1시간에 1회), CPU·메모리 순 프로세스 목록, 최근 명령 이력 20건.
- **보안** — hosts.allow로 SSH·FTP 허용 IP 관리, iptables 규칙 편집·검증·적용과 IPv4 차단·해제, fail2ban 차단 해제, 서버 SSL 만료일 확인.
- **네트워크 방화벽** — 위 독립 화면과 동일.
- **DB** — DB·DB 사용자·DB 프로세스 조회, DB·사용자 생성.
- **로그** — Apache Error, MySQL Slow, Syslog, Auth, PHP Error(설치된 것만 표시).
- **디스크** — 디스크 사용량.
- **계정** — 리눅스(FTP/SSH) 계정 목록·생성(문서 루트 자동 감지, Apache VirtualHost·Nginx server 블록 작성)·비밀번호 변경.
- **웹 터미널** — NICE 본인인증 + 이메일 코드(5분 유효, 5회) 통과 후 사용. 다중 탭, 테마 5종, 글꼴 크기, 전체화면. 유휴 30분 종료, 세션은 asciicast로 녹화.

### DBMS (`/dbms`)

- **목록** — 도메인·DB 서버·DB명 확인, 개설 중이면 ‘설정 중’ 표시 (`dbms/get_domain_list.php`).
- **접속 정보** — 호스트·포트·사용자·비밀번호 확인(표시/숨김) (`get_user_info.php`).
- **백업** — 최근 5건 백업 상태(다운로드 가능·진행 중·만료), 수동 백업 요청, 다운로드 (`get_backup_list.php`, `create_db_backup.php`).

### SSL 인증서 (`/ssl`)

- **목록** — 도메인 검증(DCV) 대기 건 상단 고정, 만료 30일 이내 ‘연장’·만료 후 ‘재발급’ 버튼, 유효한 인증서 다운로드 (`ssl/get_domain_list.php`, `download_cert.php`).
- **도메인 검증(DCV)** — 3단계: 방법 선택(이메일·DNS TXT·HTTP 파일) → 방법별 안내(승인 메일 12개 언어 재발송, TXT 값·네임서버 표시) → 발급 확인.
- **주문 (`/ssl/order`)** — 3단계: 주문 내역(공급가·VAT) → 신청서(영문 CSR 정보, 이전 주문에서 자동 채움) → 결제(토스 카드, 무통장 입금 통보, 예치금).

### WAF·VPN·NMS (`/waf`, `/vpn`, `/nms`)

조회 전용 목록이며 상세 화면은 없습니다. WAF·NMS는 도메인·신청일·종료일을, VPN은 장비·상품·그룹·공인 IP·상태를 보여 줍니다.

## 인증·권한

로그인은 메인 사이트 세션(`$_SESSION['userid']`)을 그대로 쓰고, 모든 PHP 엔드포인트가 `auth_check.php`로 로그인·CSRF·도메인 소유를 다시 확인합니다.

1. **로그인 확인** — 앱 로드 시 `AuthGate`가 `auth_check.php`를 호출합니다. 401이면 `/member/login/?required=1&nextPage=...`로 보냅니다.
2. **CSRF** — `get_csrf_token.php`가 32바이트 토큰을 발급하고, `main.tsx`의 전역 fetch 가로채기가 `/php/`로 가는 POST·PUT·PATCH·DELETE에 `X-CSRF-Token`을 붙입니다.
3. **도메인 소유 확인** — 서비스별 레이아웃이 `?domain=`을 `check_domain_ownership.php`로 확인합니다. 본인 소유가 아니면 오류 화면, 아직 개설 중이면 ‘준비 중’ 화면을 보여 주며, `ip`가 있으면 해당 도메인의 IP인지도 확인합니다.
4. **세션 만료** — 어느 `/php/` 호출이든 401을 받으면 `/session-expired`로 이동해 로그인 버튼을 보여 줍니다.

추가 인증이 필요한 기능:

| 기능 | 추가 인증 |
| --- | --- |
| 서버 웹 터미널 | NICE 본인인증 + 이메일 코드(5분, 5회), 1회용 토큰 |
| 도메인 소유자 정보 수정·소유권 이전 | 이메일 인증 코드 |
| 계정 이메일·휴대폰 변경, 소셜 연동 | NICE 본인인증 또는 SMS 인증 |
| 로그인 자체 | 선택적 OTP 2단계 인증, 해외 IP 차단 |

서버 명령·메일 작업·터미널 세션은 각각 `command_audit_log`, `ACTION_LOG`, `terminal_session_log`에 기록됩니다.

## API·데이터 연동

프론트엔드는 전역 상태 라이브러리 없이 `fetch()`로 `php/<영역>/*.php`를 직접 호출합니다. PHP는 DB를 읽고, 서버 설정 변경이 필요하면 아래 백엔드 구성 요소를 호출합니다.

| 구성 요소 | 역할 | 호출하는 곳 |
| --- | --- | --- |
| PHP 엔드포인트 (`php/`) | 영역별 API. DB `jungbo`, `mail`, `firewall`, `cert`, `servermgr` 등 사용 | 프론트엔드 |
| `mypage_daemon.py` (FastAPI, HTTPS 9090, 호스팅 노드 19대) | Apache 설정 변경: HTTPS 리다이렉트, WAF, 해외 IP·IP 차단, 봇 정책, 디스크·트래픽 조회, FTP 비밀번호, 페이지 편집. IP 화이트리스트 + API 키 | `php/web-linux`, 윈도우·미디어 `change_password.php` |
| SSH 실행기 (`ssh_executor.php`) | CA가 서명한 5분짜리 인증서로 고객 서버에 접속, 허용 목록 명령만 실행 | `php/server` (서버매니저) |
| 터미널 서버 (Go, WebSocket 3002) | 웹 터미널 SSH 중계, 세션 녹화 | 웹 터미널 탭 |
| CA 서버 (Go) | SSH 인증서 서명(RSA-4096, 5분), 키 교체 | SSH 실행기, 터미널 서버 |
| 토스페이먼츠 | 카드·가상계좌 결제. 호스팅·도메인 연장, SSL·WAF·VPN·NMS 주문, 예치금 충전 | `before_payment.php` → `confirm_payment.php` |
| DigiCert | SSL 주문·DCV·인증서 발급 | `php/ssl` |
| OPNsense·라우터 API | 네트워크 방화벽 허용 IP | `network_firewall_manage.php` |
| PMG(메일 필터) | 스팸·격리함·메일 추적 | `php/mail` |
| NICE·채널톡 | 본인인증, 상담 위젯 | 계정·터미널 / 전체 |

프론트엔드에서 호출되지 않는 엔드포인트는 `account/verify_password.php`, `payment/save_tax_invoice.php` 두 개입니다. 정리 대상인지 확인이 필요합니다.

## 빌드·배포 및 참고 사항

`npm run build`는 테스트 모드로 Vite 빌드한 뒤 `scripts/publish-dist.mjs`가 결과물을 공개 트리에 복사합니다. 배포 위치 기본값은 `/home/dev/public/mypage`입니다(`PUBLIC_DEPLOY_DIR`로 변경).

| 명령 | 동작 |
| --- | --- |
| `npm run dev` | Vite 개발 서버, mock 데이터(`src/mocks/`) |
| `npm run build` | `build:test` — 테스트 모드 빌드 + 배포 복사 |
| `npm run build:live` | 운영 모드 빌드 + 배포 복사 |
| `npm run build:dist` | 빌드만(복사 없음) |
| `npm run i18n:check` / `i18n:audit` | 번역 키 검증·점검 |
| `npm run lint` / `typecheck` | ESLint / tsc 검사 |

배포 시 참고:

- `dist/`, `index.php`, `.htaccess`, `php/`, `vendor/`가 함께 복사됩니다. `php/` 안의 `.md` 문서와 `*.php.bak`·`*.php.ori` 백업본은 공개·실행되지 않도록 제외됩니다.
- `.htaccess`는 `.env*`·`vendor/` 접근을 막고, `php/` 외 경로는 SPA용 `index.php`로 보냅니다.
- Python 데몬(`mypage_daemon.service`)과 Go 터미널 서버(`terminal-server.service`)는 systemd로 별도 운영되며 데몬은 `deploy_daemon.sh`로 각 노드에 배포합니다.
- `AGENTS.md`는 출력 위치를 `/home/dev/public/new/mypage`로 적고 있지만 2026-10-07 기준 그 디렉터리는 없고 실제 배포본은 `/home/dev/public/mypage`에 있습니다. 문서 정정이 필요합니다.
- `mypage_daemon.service`와 `terminal-server.service` 파일에 API 키·토큰이 평문으로 들어 있습니다. 저장소에서 빼내고 환경 파일로 옮기는 것을 권합니다.