AriWeb-Suite/portal/mail/REUSE.md

# AriMail 기능 도입 기록(§0.3·§0.4·§0.5) — 원본 AriMail `a07f69f1ffb6667de6e66b3d1ec43c1c66fab924` (1.0.11)

| 기능 | 결과 | Ariweb Suite 에서 접근하는 위치 | 회귀 테스트 |
|---|---|---|---|
| Multi-domain Mail Service(도메인별 테넌트) | 그대로 도입 + 최소 연결 변경(등록부 `ariweb`·`operating` 필드) | 포털 메일 서비스 생성 → 어댑터 `addDomain` | modules/arimail test/domains·ariweb 3) |
| Webmail 수신함·발신함·작성·회신·전달·검색 | 그대로 도입 | 메일 서비스/메일함 화면 "웹메일 열기"(SSO 티켓 또는 로그인 안내) | test/gateway(기존) |
| SMTP 발신·Mail 수신 | 그대로 도입 + 오류 수정(Haraka/SMTP 중계 때 Resend 키 요구) + 정책 개선(제출·전달 속도, 대기열) | AriMail 서버 그대로(포털은 상태만) | test/ariweb 2)·6) |
| IMAP·POP3 접속 | 그대로 도입 | 메일함 화면 "메일 프로그램 설정"(호스트·포트·암호화·사용자, 비밀번호 비표시) | test/imap·gateway(기존) |
| Resend·Haraka·External SMTP 발송 방식 | 그대로 도입 | 운영자 콘솔(전체 설정 화면 링크) | test/provision(기존) |
| Mail Domain·Mail Account 관리 | 그대로 도입(관리자 API) + 최소 연결(포털 메일함 표와 대응) | 메일함 목록·생성·설정 | test/mail.test(포털) |
| Mailbox 용량 관리 | 그대로 도입 + 정책 개선(저장 공간에 대용량 첨부 포함) | 메일함 설정 "저장 공간" | test/ariweb 4) |
| 자동 응답·Mail 전달 | 그대로 도입(웹메일 설정) | 메일함 화면에서 웹메일 설정으로 이동(포털은 상태 표시만) | test/gateway(기존) |
| 일반 첨부·링크 방식 대용량 첨부 | 그대로 도입 + 정책 표시(허용 크기·횟수·기한은 상품정책) | 메일 서비스 설정 › 대용량 첨부 | test/gateway 0.9.3(기존) |
| POP3·IMAP 사용 설정 | 그대로 도입 + 최소 연결(서비스 단위 스위치 + 적용 뒤 접속 확인) | 메일 서비스 설정 | test/mail.test |
| DNS 설정과 Mail Domain 확인 | 그대로 도입(dnsRecords·plan) + 최소 연결(포털에서 공용 DNS 조회·복사값) | 메일 서비스 개요·도메인 보안 탭 | test/mail.test |
| Mail 사용량·Account 별 사용량(usage API) | 그대로 도입 + 정책 개선(수신자 기준 통수·경고 구간·제한 사유·운영 상태) | 사용량 탭·사용량 영역 | test/usage·ariweb 3)·4)·5) |
| Webmaker 연동(webmaker 로그인 모드) | 그대로 도입(변경 없음) | 운영자 설정 | test/webmaker(기존) |
| 초기 설정·관리자 설정·진단 | 그대로 도입 | 운영자 콘솔 링크(전용 포트 설정 화면) | test/config·setup(기존) |
| `usage.test.mjs` KST·UTC 월 경계 | 오류 수정(고정 시각 기준) | — | test/usage(수정)·ariweb 1) |
| 사이트 대표 메일/독립 MailService 구분 | 정책 개선(등록부 `ariweb.kind`) | 메일 목록·상세 | test/ariweb 3) |
| Site 별 보장량(Storage·월간 통수·Account 수) | 정책 개선(테넌트 설정 LIMIT_*) | 사용량 탭(배정 변경은 사용량 영역) | test/ariweb 4) |
| 100% 제한 동작·70/80/90/95 경고 | 정책 개선 | 사용량 탭·알림 | test/ariweb 5) |
| Domain·Server 별 발송 Queue·안전 발송 속도·제출 제한 | 정책 개선(sendqueue.mjs, 0009 마이그레이션) | 운영자 › 메일 운영(발송 제한) | test/ariweb 6) |
| Mail Domain 이전 중 운영 상태 | 정책 개선(`operating`) | 운영자 › 이전 요청, 고객 상세 상태 | test/ariweb 7) |
| Site-bound → 독립 전환 | 정책 개선(포털 전환 작업 + AriMail `ariweb.kind` 변경) | 메일 상세 › 독립 전환 | test/mail.test |
| 고객용 Mail Backup·복원 미제공 표시 | 정책 개선(포털 문구) | 메일 모든 화면·생명주기 | test/mail.test |
| 해지 뒤 30일 읽기·Export·삭제 예정일 | 정책 개선(포털 생명주기 + AriMail `frozen`) | 메일 상세 › 생명주기 | test/mail.test |
| 포털 SSO 진입 | 정책 개선(`GET /api/auth/sso`) | 웹메일 열기 | test/ariweb 8) |
| 별칭·전달 전용 주소 생성 | 미사용(이번 버전에서 지원하지 않음 — AriMail 에 별칭 기능이 없고 정책 미확정) | 메일함 설정에 정책 안내만 | test/mail.test |
| 일괄 .eml 내보내기 | 미사용(AriMail 에 일괄 API 없음 — 보존 기간 중 IMAP/POP3·메일별 원본 다운로드 안내) | 생명주기 탭 | test/mail.test |

회귀 테스트 결과(2026-10-26, 도입 후): modules/arimail 9개 파일 모두 통과(gateway 48 · imap 7 · smtp 7 · config 4 · provision 8 · domains 8 · webmaker 10 · usage 5 · ariweb 8).
변경 파일(원본 대비): server/config.mjs · limits.mjs · domains.mjs · smtp.mjs · providers/index.mjs · api.mjs · usage.mjs · main.mjs · sendqueue.mjs(신규) · migrations/0009_ariweb_queue.sql(신규) · haraka/plugins/arimail.js · web/setup.js · test/*(gateway·smtp·usage 기대값, ariweb 신규) · package.json · deploy/deploy.sh.