# Webmaker 기존 기능 적용 기록 (Ariweb Suite 0.1.1 → 0.2.0, 개발 지시 §0.1·§0.2·§0.5 · v0.2.0 직접 편집)

- 원본: https://source.ibit.kr/OZ-Group/WebHosting_AI_agent — 고정 revision `4b8c4d0de0f69025001a9e0a28a58a94e1a1f088` (Webmaker 1.8.0, 브랜치 `feature/visual-editor-v1.8.0`·main 원격 ref 검증됨; 0.1.1 의 불변 기준 revision `3b10859884ef2fd0f2af11934ab6c16370fd64b8`(v1.7.3) 위의 변경). 개발 중에는 커밋 전 작업 트리에서 나란히 도입했고(`IMPORTED_SOURCES.md` 의 upstream 칸, workingTreeDirty:true), 커밋 뒤 `scripts/import-sources.mjs` 의 pin 을 `4b8c4d0` 으로 올렸다 — 그 pin 으로 다시 만든 도입 기록은 workingTreeDirty:false, 184 파일(수정 8 = Suite 블록 파일). 도입 경로 `modules/webmaker/`
- 접근 위치: 포털 사이트 상세 › 제작 탭 › "제작 화면 열기" (`/sso/webmaker?site=<siteId>`) → Webmaker `/api/auth/sso` → 기존 빌더 화면. 포털 사용자당 Webmaker 계정 `aw-<그룹>-<사용자>` 가 자동으로 생기며 별도 로그인은 없다.
- 회귀 테스트: `cd modules/webmaker && CLAUDE_BIN=<즉시 실패하는 가짜 실행 파일> node --test test/*.test.js` (원본 6개 파일 + 신규 `test/ariweb.test.js` + 0.2.0 `test/visual-editor.test.js`·`test/visual-editor-server.test.js`). Suite 쪽 회귀는 `test/webmaker-visual-editor.test.mjs`. 실제 화면 확인 결과는 출시 검증 기록(VERSION_HISTORY.md 검증 절)에 적는다.
- 0.2.0 추가 기능 — **직접 편집(시각 편집기)**: 제작 화면(Webmaker 빌더)의 미리보기 도구 줄 "직접 편집". 그대로 도입(Webmaker 1.8.0 기능) + Suite 최소 연결 변경 1건(직접 편집 저장 `PUT /api/sites/<id>/visual/<페이지>` 에도 저장본 `rev` 충돌 검사(§9.3) 적용 — 소스 편집기와 같은 409 + 양쪽 요약). 직접 편집은 AI Wallet(캐시)을 쓰지 않으므로 포털 AI Wallet 표시에 영향이 없고, 저장본(버전 `visual-edit`)은 포털 배포 화면의 저장본 선택에 그대로 보인다.

| §0.1 기능 | 적용 구분 | 접근 위치 / 비고 |
|---|---|---|
| `AI에게 맡기기`·`내가 고르기` Site 제작 | 그대로 도입 | 제작 탭 → Webmaker 빌더. 포털에서 사이트를 만들 때 제작 방식(ai·manual·quick)을 골라 프로젝트를 만든다(내부 API `POST /api/internal/ariweb/projects`) |
| Site Brief 작성과 확인 | 그대로 도입 | Webmaker 기획 단계 그대로 |
| Template과 기존 제작 Module | 그대로 도입 | Webmaker 생성 탭 "템플릿에서 시작"·모듈 관리 그대로 |
| Page 생성·편집·미리보기·저장 | 최소 연결 변경 | 저장(PATCH 기본 사항·PUT 소스 편집·0.2.0 PUT 직접 편집)에 `rev` 기반 동시 편집 충돌 감지(409 + 두 버전 요약)를 더함(§9.3). rev 를 보내지 않는 기존 화면은 그대로 동작 |
| 직접 편집(시각 편집기, Webmaker 1.8.0) | 그대로 도입 + 최소 연결 변경(rev 충돌) | 제작 화면 미리보기 도구 줄 "직접 편집" — 글 바로 고치기·블록 끌어 옮기기·구성 요소 7종 끌어다 놓기·속성 창·실행 취소/다시 실행·Ctrl+S 저장·저장하지 않은 변경 보호. 페이지 스크립트 비실행 캔버스(sandbox+CSP nonce), 서버 저장 검증(새 스크립트·핸들러·위험 주소·iframe 등 거절). AI 캐시 미사용 |
| AI 생성·수정과 Wallet/Cache 차감 | 그대로 도입 | Webmaker 캐시(credits) 그대로. 포털은 `/api/internal/ariweb/credits/<login>` 으로 잔액을 읽어 AI Wallet 으로 표시(호스팅 사용량과 분리 §0.2) |
| 이전 저장본과 배포할 저장본 선택 | 최소 연결 변경 | 저장본 목록은 Webmaker 버전 기록(git.changes) 그대로. 배포할 저장본 선택은 포털 배포 탭(`/api/internal/ariweb/projects/<id>/export?version=N`)에서 한다 |
| Domain·DNS·TLS 관리 기능 | 그대로 도입 | 등록기관(Openprovider·Porkbun·Route 53)·DNS 공급자·네임서버 이전·레코드 관리는 Webmaker 도메인 탭 그대로(포털 도메인 화면의 "도메인 구매·DNS 자동화(Webmaker)" 링크). 포털은 연결 상태·소유 확인·HTTPS 검증만 가진다 |
| Gitea Source 연결과 변경 이력 | 그대로 도입 | gitstore·connectors/gitea 그대로. 포털 Source 탭은 `/api/internal/ariweb/projects/<id>/source` 로 읽어 표시 |
| 관리형 또는 외부 대상 배포에 이미 사용할 수 있는 기능 | 미사용(이번 버전) | Webmaker 의 배포 서버(deploy.js: local/ssh tar-over-ssh)는 포털 연결 프로젝트에서는 쓰지 않는다. 운영 배포는 HAL/Node Agent 가 맡는다(§32). 포털에 연결되지 않은 Webmaker 단독 프로젝트는 기존 기능 그대로 동작 |
| 배포 결과 확인과 이전 Version 복구 기능 | 미사용(이번 버전) | 위와 같은 이유로 포털 배포 탭(되돌리기 = HAL site.rollback)이 담당. Webmaker 발행(plan/publish)은 포털 연결 프로젝트에서 409 로 막고 포털 배포 화면으로 안내 |
| AriMail Server 연결과 Mail 사용량 표시 | 그대로 도입 | Webmaker 관리자 콘솔 메일 서버 등록부·사용량 연동 그대로. 포털 메일 화면은 별도(메일 영역) |
| 사용자·관리자 화면의 설정·상태·통계 기능 | 그대로 도입 | Webmaker 관리자 콘솔·설정 페이지(8795) 그대로 |

## §0.2 수정·개선 항목

| 항목 | 구분 | 구현 |
|---|---|---|
| 별도 로그인 없이 현재 사용자·그룹으로 이용 | 정책 개선 | `GET /api/auth/sso?ticket=`(server.js) + `lib/auth.ensureSsoUser` + `lib/ariweb.verifyTicket`(60초·1회용·HMAC). 상단 배너(`public/index.html #ariwebBanner`, app.js)에 그룹·사이트 표시 |
| Project 와 운영 Site 구분 | 정책 개선 | `lib/ariweb.js` 연결 등록부(data/ariweb-links.json), 배너 문구, 사이트 조회 응답 `ariweb` 필드 |
| Draft Site 가 운영 사이트 수를 쓰지 않음 | 정책 개선(포털) | portal/sites: 초안 생성은 예약 없음, 최초 공개 배포 때 예약 |
| 관리형/외부 배포의 비용·책임·상태 구분 | 정책 개선(포털) | portal/sites 배포 방식 화면·동의 기록 |
| 상품 권리·Site 별 보장량 배포 전 확인 | 정책 개선(포털) | portal/sites precheck |
| AI Wallet 과 Hosting·Mail 사용량 분리 | 정책 개선(포털) | 제작 탭 AI Wallet 카드 / 사용량 탭 별도 |
| 운영 Version 을 바로 덮어쓰지 않고 Preview 후 배포 | 정책 개선 | Webmaker 발행 차단(연결 프로젝트) + 포털 배포 탭 저장본 선택 |
| 진행 상태를 공통 상태·알림에 표시 | 정책 개선(포털) | lib/jobs + lib/notify |
| Project 삭제가 운영 Site·Domain·Source 를 자동 삭제하지 않음 | 정책 개선 | `DELETE /api/sites/<id>` 가 포털 `/internal/webmaker/project-impact` 를 서명 호출해 영향을 보이고, 운영 중이면 거부·확인(acknowledgeImpact) 후에만 폐기. 포털 데이터는 건드리지 않음 |
| 동시 편집 충돌 표시 | 오류 수정 | `lib/store.js` rev + `server.js revConflict` |
| 기존 기능 오류 수정 | — | 이번 도입에서 Webmaker 1.7.3 회귀 테스트 전부 통과, 별도 오류 발견 없음 |