Revert to spec's free web plan + PWA install (iPhone/Android, $0)

명세서 준수: 네이티브(Flutter/Kotlin) 경로 폐기 — 유료 iOS 개발자 등록·맥이 필요해 비용 0 원칙과 명세서에 어긋남.
- app/(Flutter) 전부 제거, 원래 웹 클라이언트 복원.
- PWA 추가: manifest.webmanifest + sw.js(오프라인 캐시) + 앱 아이콘(192/512/apple-touch).
  → iPhone Safari·Android Chrome에서 '홈화면에 추가'로 전체화면 앱처럼 실행, 스토어/맥/등록비 불필요.
- Cloudflare Pages 무료 배포 대상. 서버(Workers) 계획 불변.
This commit is contained in:
tkrmagid
2026-08-22 15:08:51 +09:00
parent cbb8dea2eb
commit a8ff780248
76 changed files with 70 additions and 2520 deletions

View File

@@ -6,9 +6,7 @@ TETR.IO 스타일의 **모바일 실시간 대전 블록 스태커** 웹 게임.
이 문서는 앱 제작을 위한 **최종 빌드 진입점(entry point)** 이다. 모든 설계 결정·수치·에셋의 **정본(source of truth)은 [`TETRIG-최종명세서.md`](./TETRIG-최종명세서.md)** 이며, 구현 시 반드시 명세서와 UX 목업을 함께 열어 작업한다.
> **클라이언트 변경 (2026-08-22 사용자 결정)**: 플레이스토어 + 앱스토어(아이폰) 동시 출시를 위해 클라이언트를 **크로스플랫폼 Flutter (Dart, Android + iOS)** 로 제작한다. 소스는 [`app/`](./app). 코어 게임 로직은 UI와 분리된 순수 Dart 모듈 [`app/lib/engine.dart`](./app/lib/engine.dart) 에 있고 `flutter test` 로 검증한다(SRS 킥테이블·7-bag·T-spin 판정·점수·좌표 등 §4·§13 데이터는 그대로 이식됨). 서버 계획(Cloudflare Workers + D1 + WebSocket)은 변경 없이 유지된다. 초기 웹(HTML) 프로토타입(`src/`, `index.html`)은 검증된 **동작 레퍼런스**로 남겨둔다.
>
> **iOS 빌드 제약**: Android(APK/AAB)는 리눅스에서 빌드 가능하나, iOS(.ipa)·앱스토어 제출은 **macOS + Xcode** 가 필수다. 맥 한 대 또는 클라우드 맥 CI(Codemagic 등) + **Apple Developer Program($99/년)** 이 필요하다. 이 저장소는 iOS 코드베이스와 CI 설정까지 포함하되 실제 iOS 바이너리는 맥 환경에서 빌드한다.
> **비용 0 · 아이폰/안드로이드 모두 지원 (2026-08-22 정)**: 명세서대로 **웹 게임 + PWA(홈화면 설치)** 로 간다. Cloudflare Pages(무료)에 배포하면 iPhone Safari·Android Chrome에서 그대로 돌아가고, "홈 화면에 추가"로 전체화면 앱처럼 실행된다(`manifest.webmanifest` + `sw.js` 오프라인 캐시 + 앱 아이콘). **맥·Xcode·앱스토어/구글플레이 등록비·Apple Developer 멤버십이 전혀 필요 없다.** (네이티브 iOS 앱만 유료·맥 필수라 웹/PWA 경로가 무료로 크로스플랫폼을 달성하는 유일한 방법이다.) 클라이언트 진입점은 [`index.html`](./index.html)(빌드 산출물), 소스는 [`src/`](./src), 서버 계획(Cloudflare Workers + D1 + WebSocket)은 명세서 그대로.
---