Skip to content

About

2-2 vacation Planner App

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

65 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Planner

계획한 만큼 실제로 할 수 있는지 확인하기 위해 만든 개인용 Android 플래너다. 재수 시절 종이 플래너를 쓰면서 하루 계획과 실행 가능한 양의 차이를 줄였던 경험에서 시작했다.

계획을 매번 새로 입력하는 부담을 줄이는 데 초점을 두고 있다. 폰 캘린더의 수업이나 약속을 가져오고, 남는 시간에 공부·운동 같은 블록을 배치한다. 실행 후에는 짧은 피드백을 남겨 다음 계획을 조정한다.

현재는 실사용하면서 수정하는 프로토타입 단계다. 서버 없이 폰의 로컬 DB에 저장한다. 행동을 세밀하게 추적하는 HardTracking(app_2-develop)은 별도 앱으로 유지한다.

주요 기능

일간 계획

  • 빈 시간대를 눌러 일정을 추가하거나 보관함의 블록을 끌어 배치
  • 길게 눌러 이동, 위아래 손잡이로 소요 시간 조절
  • 드래그 시 15분 간격으로 정렬, 세부 시각은 시·분 휠로 선택
  • 겹치는 일정은 나란히 표시하고 자정을 넘는 일정도 처리
  • 보관함 높이 조절, 자주 쓰는 블록 저장, 어제 계획 복사
  • 좌우 스와이프로 날짜 이동, 마지막 변경 되돌리기

월간 계획

  • 상단 달력 아이콘으로 월간 화면 전환
  • 날짜별 일정과 선택한 날짜의 상세 목록 확인
  • 길게 눌러 다른 날짜로 이동하며 기존 시각과 소요 시간 유지
  • 여러 날에 걸친 같은 원본 일정은 연속 막대로 표시하고 기간 전체를 함께 이동
  • 좌우 스와이프로 월 이동
  • 토요일은 파랑, 일요일과 공휴일은 빨강으로 구분

캘린더 가져오기

삼성 캘린더가 사용하는 Android 일정 저장소를 읽는다. 읽기 권한을 허용한 뒤 가져올 캘린더를 선택하면 여러 날짜의 일정을 한 번에 가져온다.

가져온 일정은 앱 안에서 제목·날짜·시간을 바꿀 수 있다. 삼성 캘린더의 원본은 수정하지 않는다. 날짜나 시간을 바꿔도 원본 식별자는 유지해 다시 가져올 때 중복을 막는다.

상황 처리
새 원본 일정 계획에 추가
원본만 수정됨 앱에서 수정하지 않은 계획에 반영
앱과 원본이 모두 수정됨 내 계획을 유지하고 충돌 표시
앱에서 삭제함 삭제 이력을 남겨 재생성 방지
원본에서 삭제됨 계획과 피드백을 보존하고 상태 표시

자동 가져오기를 켜면 앱 복귀와 사용 중 변경 알림에 맞춰 확인한다. 필요 없는 캘린더는 선택에서 빼고, 특정 제목은 이후 가져오기에서도 제외할 수 있다. 공휴일·기념일 캘린더는 개인 계획과 분리해 날짜 색상에만 사용한다.

돌아보기

지난 일정에 다 함 / 일부 함 / 못 함을 남기고, 필요하면 이유와 메모를 추가한다. 처음 잡았던 시간과 조정한 시간을 따로 보관한다. 실제 수행 시간을 자동 측정하는 기능은 없다.

저장 구조

SQLiteOpenHelper와 SQL을 사용한다. DB 파일은 planner.db다.

테이블 역할
plans 날짜별 계획, 최초 계획 시간, 피드백
calendar_sources 원본 스냅샷, 수정·삭제·충돌 상태
templates 자주 쓰는 블록
metadata DB 초기화 등 내부 상태

plans.source_key에 UNIQUE 제약과 외래키를 두고, 저장은 하나의 트랜잭션으로 처리한다. 날짜·시각 조회용 인덱스도 둔다.

첫 실행에는 기존 SharedPreferences 기록을 DB로 옮긴다. 이전 원본은 삭제하지 않으며, 이전이 완료된 뒤에는 다시 가져오지 않는다. 구조와 조회 예제는 DB 설계 문서에 정리했다.

실행

개발 환경은 Kotlin, Jetpack Compose, Android SDK 36, JDK 25 기준이다. 앱의 최소 Android 버전은 API 24다.

  1. Android Studio에서 android 폴더를 연다.
  2. Gradle JDK를 25로 설정하고 프로젝트 동기화를 마친다.
  3. USB 디버깅을 허용한 폰을 선택하고 Run app을 실행한다.
  4. 캘린더 기능을 사용할 때 읽기 권한을 허용한다.

Windows 명령줄에서는 android 폴더에서 실행한다.

.\gradlew.bat assembleDebug
.\gradlew.bat testDebugUnitTest

일반적인 업데이트 설치는 앱 데이터를 유지한다. 앱을 삭제하거나 저장공간을 초기화하면 기록도 지워지므로 주의한다. Google 계정이나 서버를 통한 계획 데이터 동기화는 지원하지 않는다.

확인된 범위와 제한

  • 2026-11-05 기준 단위 테스트 39개, 실제 폰 테스트 13개 통과. DB 이전·롤백, 중복·충돌 처리, 스와이프, 드래그 등을 확인했다.
  • 앱을 완전히 종료한 상태에서의 즉시 백그라운드 동기화는 지원하지 않는다.
  • 끝없이 반복되는 일정은 과거 1년부터 앞으로 2년까지 가져온다.
  • 원본 계정 재등록으로 이벤트 ID가 바뀌거나 반복 규칙 변경으로 회차 식별자가 달라지면 새 일정으로 인식할 수 있다.
  • 공휴일은 2025~2027년 기본 자료와 폰의 한국 휴일 캘린더를 사용한다. 새 임시공휴일은 폰에 정보가 반영된 뒤 갱신된다. 정부 발표를 직접 수집하는 구조는 아니다.
  • 사용자가 파일로 내보내고 복원하는 백업 기능, 온라인 동기화, 실제 시간 측정, 월별 분석 화면은 아직 없다.

작업 문서

초기 범위·로드맵 문서는 당시 설계를 남긴 자료다. 현재 동작은 이 README와 이번 개편 문서를 기준으로 한다.

1105 커밋 확인.

About

2-2 vacation Planner App

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages