HabitBridge

Intentional Friction & Micro-Swap · 해빗브릿지

도파민을 무작정 막지 마세요. 가치 있는 마이크로 행동으로 스왑하세요. 로컬 우선 안드로이드 스크린타임 앱 — 설계서(PRD/SDD), 브라우저 폰 시뮬레이터, 그리고 실제 안드로이드 앱(v1.0.0) 이 한 저장소에 있습니다.

《Opal》, 《One Sec》, 《ScreenZen》 같은 디지털 디톡스 앱이 왜 퍼지고 왜 2주 안에 지워지는지를 분석하고, 그 결함을 넘는 제품을 설계·구현한 프로젝트입니다.

세 산출물은 같은 규칙을 공유합니다. 정책 엔진은 웹(src/engine.js)과 안드로이드(android/core/policy)에 함수 단위로 1:1 포팅되어 있고, 같은 12개 테스트 벡터를 통과합니다.

설치: Releases에서 habitbridge-1.0.0.apk를 받아 설치합니다(Android 8.0+, minSdk 26). Play 스토어 등록 전 단계라 사이드로드입니다.

구현된 것

• 감지: UsageStatsManager 1초 폴링 포그라운드 서비스(화면 켜짐 시만, specialUse) + 선택적 접근성 서비스(더 빠른 감지, 홈 복귀)
• 개입: TYPE_APPLICATION_OVERLAY 인터셉터 — 3/5초 HOLD 진행 바, 스왑 4종, 우회 버튼(HARDCORE에서는 잠김), 우회 후 10분 쿨다운, 시간당 6회 초과 시 완화, 일일 할당 소진 시 우회 불가
• 스왑 4종: 1분 자세 리셋(6단계 타이머), 단어 카드(12개 시드 덱, 회전), 퀵 메모(280자), 감정 체크인(5종)
• 데이터: Room 7테이블(대상·허용 목록·개입 로그·메모·일일 사용량·설정·단어), 스키마 내보내기, 자동 백업 포함
• 앱 UI: 온보딩(권한 6단계, 거부 시 이유 설명), 대시보드(Focus Score 링·오늘/7일·최근 기록), 대상 앱 관리(설치 앱 검색·쉴드·할당·허용 목록), 메모(.md 내보내기), 설정(취침·업무 시간·요일·쿨다운·캘린더)
• 공유 카드 1080×1920(개인정보 없음) → 공유 시트, 부팅/업데이트 후 서비스 재시작, 한국어/영어
• 없는 것(의도적): INTERNET 권한, 분석 SDK, 크래시 리포터, 앱 삭제 방어

검증(에뮬레이터 Pixel 7 · API 36): 온보딩 → 대상 추가 → 개입 → 스왑 → 홈 복귀 → 대시보드 반영, NORMAL 5초 후 우회 → 쿨다운 통과, 퀵 메모 → Notes_YYYYMMDD.md 생성까지 확인했습니다. 절차는 RELEASE.md §3 체크리스트에 있습니다. 시스템 설정 앱처럼 오버레이를 숨기는 앱(HIDE_OVERLAY_WINDOWS)은 OS 제약으로 개입할 수 없습니다.

빌드

cd android
./gradlew :core:policy:test        # 정책 엔진 테스트 12건
./gradlew :app:assembleDebug       # app/build/outputs/apk/debug/app-debug.apk

릴리스 서명·태그·Actions 파이프라인은 RELEASE.md.

https://jeiel85.github.io/habitbridge-android/

1. 폰의 Instagram 아이콘을 누르면 터미널풍 인터셉터가 뜹니다. 5초 대기 후 [>] 앱 계속하기가 열립니다.
2. 오른쪽 상황 시뮬레이터에서 시각을 00:40으로 옮기거나 "회의 중"을 켜 보세요. 쉴드가 HARDCORE가 되어 우회 버튼이 잠깁니다.
3. 스왑 4종 중 하나를 완료하면 홈으로 돌아가고 대시보드의 Focus Score·절약 시간이 오릅니다.
4. 우회해서 앱에 들어가면 10분 쿨다운이 걸립니다. +10분을 누르면 다시 개입합니다.
5. 앱별 할당량을 넘기면 모드가 "할당 소진"으로 바뀌며 우회가 막힙니다.
6. 공유 카드 PNG와 Notes_YYYYMMDD.md를 내려받을 수 있습니다. 어디로도 전송되지 않습니다.

index.html, styles.css, src/     웹 폰 시뮬레이터 (GitHub Pages 루트) · tests/ node:test
android/
  core/policy/                   순수 Kotlin 정책 엔진 + PolicyTest (웹 engine.js와 1:1)
  app/                           안드로이드 앱 (data / detect / overlay / ui / util)
  gradle/libs.versions.toml      AGP 9.1 · Kotlin 2.2 · Compose BOM · Room 2.7
docs/                            설계서와 부속 문서
.github/workflows/               web CI · Android CI(APK 아티팩트) · Release(태그 → 서명 APK/AAB)

• P0 (완료): 정책 엔진·UX를 브라우저 시뮬레이터로 검증, 라이브 데모 공개
• 스프린트 1~4 (완료, v1.0.0): 안드로이드 앱 구현 + 에뮬레이터 검증 + 릴리스 파이프라인
• P1 (다음): 실기기 5명 7일 — 감지 지연, OEM 백그라운드 제한, 배터리(하루 ≤ 1%), 접근성 경로
• P2: 클로즈드 테스트 20명 14일 — 2주 유지율 ≥ 60%, 권한 유지 ≥ 80%, 스왑 비율 ≥ 40%, 가격 설문
• P3: Play 정책 체크리스트·결제 → 프로덕션 100명

《Opal》, 《One Sec》, 《ScreenZen》은 각 권리자의 제품이며 이 프로젝트는 이들과 무관한 독립 기획입니다. 웹 데모는 실제 앱을 차단하지 않고 사용 시간만 시뮬레이션합니다. 라이선스: MIT