Kira-MoneyApp

Kira — personal money app

내가 실제로 쓴 돈만 보여주는 개인 가계부. 보통 가계부와 달리 모든 걸 기록하는 게 아니라, 내 다른 계좌로 보낸 이체·지인에게 빌려준 돈처럼 “소비가 아닌 것”을 빼고 진짜 소비를 보여준다.

[CODEF] → [PC 수집기] → [AES-256 암호화] → [GitHub(공개레포)] → [폰 PWA]
  은행      money.db       data.enc          git push          복호화해 표시

CODEF가 은행 스크래핑을 대신 → 은행별 연동 직접 안 짬
PC 수집기가 하루 1번 거래를 긁어 암호화 후 push
폰 PWA가 data.enc를 받아 내 암호로 복호화해서 표시 → 공개 레포라도 데이터는 암호화돼 안전 (AES-256-GCM, 암호 없으면 못 봄)

경로	설명
`app/index.html`	Kira PWA (전체화면, 설치형). GitHub Pages로 호스팅
`app/data.enc`	암호화된 거래 데이터 (수집기가 생성·push)
`app/icons/`, `app/manifest.webmanifest`	앱 아이콘·PWA 매니페스트
`collector/codef_collector.py`	CODEF → money.db
`collector/publish.py`	money.db → 암호화 → data.enc → git push
`collector/kira_crypto.py`	AES-256-GCM 암호화 (브라우저 Web Crypto와 호환)
`docs/money-app-mockup.html`	디자인 목업 (= app/index.html 소스)
`docs/codef-setup-checklist.md`	CODEF 가입·무료티어·인증 체크리스트

앱: https://develu0825.github.io/Kira-MoneyApp/app/ (아이폰 Safari → 공유 → 홈 화면에 추가)
데이터 연결 전에는 샘플(데모) 데이터로 동작

docs/codef-setup-checklist.md 참고. CLIENT_ID / CLIENT_SECRET / PUBLIC_KEY 발급.

pip install -r collector/requirements.txt
cd collector
cp .env.example .env     # .env 에 키·암호·본인정보 입력

KIRA_PASSPHRASE 는 폰 앱에서 입력할 암호와 동일해야 함. .env 는 커밋 금지.

python codef_collector.py   # CODEF → money.db (폰에서 간편인증 승인)
python publish.py           # money.db → data.enc → git push

몇 초 뒤 폰 앱을 완전 종료 후 재실행 → 암호 입력 → 실데이터 표시.

codef_collector.py → publish.py 를 하루 1회 실행하도록 등록. 단, 카카오뱅크는 간편인증이라 ConnectedId 만료 시 폰에서 재승인 필요 (앱 홈의 동기화 버튼 빨간 점으로 안내).

절대 커밋 금지: CODEF 키·RSA키·ConnectedId·은행 로그인·money.db·.env (모두 .gitignore)
데이터는 AES-256-GCM 암호화 후에만 push. 암호(KIRA_PASSPHRASE)는 PC .env와 폰에만 존재
공개 레포지만 암호 없이는 데이터 복호화 불가. 강한 암호 사용 권장