# FONUMA Language 0.2.0-dev.4 — 웹 연동 개발 프리뷰

2026-10-06 공개 · 구현24f566c. dev.3의 공유 데이터·고급 UI·타입 SDK·여섯 템플릿에 opt-in 웹 연동과 integrations 템플릿을 더했습니다.

- 개인 파일함: 업로드·목록·다운로드·삭제, 파일당256 KiB·사용자당128개/8 MiB·앱 파일 전체32 MiB.
- 변경 알림: 기본1초 주기 조회·변경 감지 버튼. WebSocket/SSE 푸시는 아닙니다.
- 외부 API: 관리자가 지정한 고정 HTTPS GET JSON, TLS·주소 필터·타임아웃·응답 한도.
- 서명 웹훅: HMAC·시간·Actor·재전송 검증. integrations 예제는 저장된 청구 금액·통화·영수증과 대조해 상태를 반영합니다.
- 실제 결제 생성·승인·환불이나 결제사 원본 웹훅의 직접 연결은 없습니다. 공급자별 서버 어댑터는 별도입니다.

## 시작

```sh
./bin/fonuma-app new ~/fonuma-demo --template integrations
./bin/fonuma-app check ~/fonuma-demo
./bin/fonuma-app test ~/fonuma-demo
./bin/fonuma-app serve ~/fonuma-demo --data-dir ~/fonuma-demo/.fonuma/data --port 3441
```

브라우저에서 http://127.0.0.1:3441을 열어 가입·로그인합니다. 파일함은 즉시 사용할 수 있습니다. 비밀키는 서버 환경 변수로만 설정하며 소스·문서·채팅에 넣지 않습니다. Rust·Node.js 설치는 필요하지 않고 선택적 install.py는 Python 3이 필요합니다.

## 업데이트 경계

기존 프로젝트는 extensions를 생략하면 확장이 꺼집니다. 확장을 켜기 전에 DB를 backup 하세요. 확장 테이블이 추가된 DB는 dev.3에서 열 수 없습니다. rollback만으로 데이터가 되돌아가지 않으므로 이전 버전으로 돌아갈 때는 서버를 멈추고 확장 전 백업을 복구해야 합니다. 기존 프로젝트나 DB를 자동으로 공유 모드로 바꾸지 않습니다.

## 검증 상태

코어1000 PASS/0 FAIL/10 ignored, Mac·Linux 호스트 각각30 PASS, SDK/DOM/생성 SDK 각각12 PASS, 설치 후 각각12 PASS, 설치기3 PASS. 실제 외부 HTTPS JSON 조회를 공식 manifest로 확인했습니다. 이 수치는 겹치는 기능 시험이며 독립 보안 평가 표본 수가 아닙니다.

Required87은14 PASS/1 FAIL/72 NOT RUN으로 과거 STATUS 역할 경계에 실패합니다. 기존 Hub55 PASS/10 FAIL 기록도 남아 있습니다. 실제 브라우저 시각 검증·새 macOS·독립 재현·Windows 새 프로필·정식 베타 판정은 미완료입니다. Mac은 ad hoc 서명이며 Developer ID/Apple 공증은 없습니다. npm에는 게시하지 않았습니다.

사용법과 정확한 제한은 web-extensions.md 및 다른 포함 가이드를 확인하세요. 실사용 비공개 정보·실제 결제는 사용하지 않았고 API 비용은 지출하지 않았습니다. 라이선스는 포함된 LICENSE-POLICY.md와 의존성 고지를 따릅니다.