🌾 마이팜 · My Farm
위에서 내려다본 농장 지도로 작물 · 가축 · 물주기 · 수확 · 재고를 관리하는 Flutter 앱
설치도 가입도 필요 없어요. 예시 농장이 채워진 상태로 열립니다.
🇺🇸 A farm-management app built with Flutter: a top-down animated farm map, livestock, watering, harvests and inventory. The UI is available in Korean and English (follows your device language, or pick one in Profile).
✨ 한눈에 보기
구역 칩이나 지도를 누르면 카메라가 그 구역으로 부드럽게 날아갑니다. 목장에서는 소·양·닭이 거닐고, 길에는 트랙터가 지나가고, 연못에는 물결이 일어요. 지도와 동물은 그림 파일 없이 모두 코드(CustomPainter)로 그렸습니다.
🧑🌾 기능
| 기능 | 설명 |
|---|
| 🗺️ | 살아 있는 농장 지도 | 농가·토마토·채소·옥수수·가축·물탱크·창고·온실·과수원 9개 구역. 고르면 카메라 이동 + 테두리 강조, 물이 필요한 밭엔 파란 점이 깜빡여요. |
| 🐄 | 가축 관리 | 건강·사료·생산 원형 게이지, 하루 세 번 급이 타임라인(눌러서 완료), 소·닭·양·염소 48마리의 건강 점수·체중·검진 기록. |
| 💧 | 물주기 · 스마트 관수 | 밭마다 관수 주기와 1회 사용량이 있고 물탱크에서 차감돼요. 스마트 관수는 2시간 안에 물이 필요한 밭만 골라 탱크가 허락하는 만큼 물을 줍니다. |
| 🧺 | 수확 · 재파종 | 작물별 수확량을 기록하고, 원하면 같은 밭에 바로 다시 심어 생육률을 0%부터 다시 계산해요. 판매 금액을 적으면 장부에도 함께 남아요. |
| 🥚 | 생산 기록 | 하루 달걀·우유 생산량을 목표와 비교합니다. |
| 📦 | 재고 | 사료·종자·비료·자재 입고/사용, 하루 소비량으로 남은 일수 계산, 부족 알림. 급이를 완료하면 사료가 자동으로 빠져요. |
| 🏷️ | 입식 · 출하 · 폐사 | 새 가축을 들이면 번호표가 자동으로 붙고, 출하·폐사 처리해도 이력은 남아요. |
| 💉 | 백신 · 진료 일정 | 종 전체나 개체별 백신·검진·구충 일정과 반복 주기. 완료하면 다음 일정이 자동으로 잡히고, 다가오거나 지난 일정은 홈에 떠요. |
| 💰 | 매출 · 비용 장부 | 작물·가축·우유·달걀 판매와 사료·종자·인건비 같은 비용을 적고, 달별 순이익과 분류별 합계, 최근 6개월 차트로 봐요. 기록을 눌러 고치고, CSV로 내보내 엑셀에서 열 수 있어요. 통화는 프로필에서 골라요. |
| 💾 | 백업 · 복원 | 전체 기록을 JSON 파일로 내보내고 다른 기기나 PC·웹 버전에서 복원할 수 있어요. 오래 백업하지 않으면 홈에서 알려 줘요. |
| ⛅ | 날씨 · 작업 조언 | 농장 위치의 현재 날씨와 5일 예보. 비·폭염·서리·강풍이면 관수와 가축 관리 조언을 띄워요. 연결이 안 되면 마지막으로 받은 날씨(최대 3일)를 보여 줘요. |
| ✅ | 오늘 할 일 · 확인할 것 | 물주기·급이 지연·수확 가능·재고 부족·관리 필요 가축을 홈에 자동으로 모아 줍니다. |
| 🖥️ | PC · 태블릿 가로 배치 | 창이 넓으면 왼쪽 메뉴와 두 열 화면으로 바뀌어요(Windows 앱·웹). 휴대폰은 그대로. |
| 🌐 | 한국어 · English | 기기 언어를 따르고, 프로필에서 직접 고를 수도 있어요. |
| 🔔 | 알림 (Android · Windows) | 켜면 물주기·급이·백신 일정 시각에 앱을 닫아 두어도 알려 줘요. 종류별로 끌 수 있고, 밤에 돌아오는 물주기는 아침 7시에. 기본은 꺼짐. |
| 🔄 | 앱 안 업데이트 (Android) | 프로필에서 켜면 하루 한 번 GitHub 릴리스에서 새 버전을 확인하고, 내려받은 APK를 SHA-256으로 확인한 뒤 Android 설치 화면으로 넘겨요. 기본은 꺼짐. |
| 📊 | 분석 | 7/14/30일 매출·비용, 달걀·우유 추이(목표선), 일별 물 사용량, 작물별 누적 수확. |
💡 인스타그램의 "Flutter로 만든 농장 앱 UI" 영상에서 아이디어(농장을 지도 한 장으로 보는 구성)를 얻어 처음부터 다시 구현했고, 1.7.0부터는 지도 일러스트와 색을 "농지 도면" 스타일로 새로 그렸습니다. 또 영상에 없던 온실·과수원·물탱크 연동·수확·생산·재고·날씨·할 일·분석을 더했습니다. 앞으로 넣을 만한 요소는 BACKLOG.md에 있어요.
📲 실행하기
| 플랫폼 | 방법 |
|---|
| 🌐 웹 | jeiel85.github.io/my-farm-flutter — 데이터는 브라우저(localStorage)에만 저장돼요. |
| 🤖 Android | GitHub 릴리스의 my-farm-vX.Y.Z.apk를 설치하거나 flutter build apk --release로 직접 빌드(서명 설정은 아래 참고) |
| 🪟 Windows | flutter build windows --release → build/windows/x64/runner/Release/ 폴더째 실행(MyFarm.exe). 빌드하려면 Windows 개발자 모드가 켜져 있어야 해요(플러그인 심볼릭 링크). |
git clone https://github.com/jeiel85/my-farm-flutter.git
cd my-farm-flutter
flutter pub get
flutter run
🛠️ 기술 스택
| 영역 | 선택 | 이유 |
|---|
| 프레임워크 | Flutter 3.47 (Dart 3.13) | 원본이 iOS 시뮬레이터에서 시연된 Flutter 앱이라, 같은 코드로 Android·Windows·웹을 모두 그리는 쪽을 택했어요. |
| 렌더링 | CustomPainter + ui.Picture 캐시 | 움직이지 않는 지형·작물은 한 번만 그려 재사용하고, 동물·트랙터·물결만 매 프레임 그립니다. |
| 상태 | ChangeNotifier + InheritedNotifier | 화면 수에 비해 상태가 단순해서 별도 상태관리 패키지 없이 충분해요. |
| 저장 | shared_preferences (JSON + schemaVersion) | 기기 안에만 저장. 읽을 수 없는 저장본은 지우지 않고 따로 보관한 뒤 예시 농장으로 시작합니다. |
| 애니메이션 | flutter_animate, 암시적 애니메이션 | 목록 진입, 카드 전환, 게이지 차오름 |
| 차트 | fl_chart | 생산 추이, 물 사용량 |
| 날씨 | Open-Meteo | 무료, API 키 불필요 (CC BY 4.0, 앱 안에 출처 표기) |
| 앱 업데이트 | GitHub 릴리스 자산 update.json + 플랫폼 채널 | markleaf-android와 같은 방식. api.github.com은 비인증 한도(IP당 시간당 60건)를 같은 통신사 IP 사용자와 나눠 써서 쓰지 않아요. 버전은 versionCode 정수로 비교하고, 설치는 ACTION_INSTALL_PACKAGE(파일 관리자 등이 끼어들지 않게)로 시스템 설치 화면에 맡깁니다. 해시·설치는 Kotlin MessageDigest·FileProvider라 새 패키지 의존성이 없어요. 스토어 배포가 없어 스토어용 빌드 분리는 두지 않았습니다. |
| 알림 | flutter_local_notifications + timezone | 서버 없는 로컬 예약 알림(Android AlarmManager, Windows 예약 토스트). 반복 예약 대신 앞으로 일주일 치를 한 건씩 잡고 기록이 바뀔 때마다 다시 계산해서, 이미 체크한 급이나 끝낸 일정은 알리지 않아요. 시각은 같은 순간의 UTC로 넘겨 시간대 데이터베이스(flutter_timezone)가 필요 없습니다. Android는 정확한 알람 권한 없이(inexact) 예약하고, Windows는 MSIX 없이 HKCU에 앱 ID를 등록하는 방식이에요. |
| CI/CD | GitHub Actions | 포맷·분석·테스트, debug APK·Windows 빌드 확인, 웹 데모를 Pages로 배포. APK 릴리스는 서명 키 때문에 로컬 스크립트로 |
flowchart LR
UI["화면<br/>features/*"] -->|읽기·동작| Store["FarmStore<br/>ChangeNotifier"]
Store -->|JSON| Prefs[("shared_preferences")]
UI --> Map["FarmMapView<br/>카메라 애니메이션"]
Map --> Painter["FarmMapPainter<br/>정적 레이어 캐시 + 동적 요소"]
UI --> Weather["WeatherController"] --> API(("Open-Meteo"))
UI --> Update["UpdateController<br/>(Android)"] --> GH(("GitHub 릴리스<br/>update.json · APK"))
화면 문구는 lib/l10n/app_ko.arb(기준)와 app_en.arb에 있고, flutter pub get 때 gen-l10n이 Dart 코드를 만듭니다(생성물은 커밋하지 않음). 문구를 추가할 때는 두 파일에 같은 키를 넣으세요.
lib/
main.dart, app_shell.dart 앱 시작, 하단 탭, 넓은 화면은 휴대폰 폭으로 가운데 정렬
core/ 테마, 공통 위젯, 가축 아이콘 painter
data/ 모델, 저장(FarmStore), 예시 데이터, 날씨
features/
farm/ 농장 지도(farm_world.dart: 지형·애니메이션, farm_map_view.dart: 카메라)
livestock/ crops/ harvest/ ledger/ analytics/ inventory/ weather/ home/ profile/
site/ GitHub Pages 랜딩 페이지
test/ 상태 로직·날씨 파싱·앱 스모크 테스트
서명 정보가 없으면 디버그 키로 조용히 대체하지 않고 빌드를 멈춥니다. 값은 환경변수가 우선이고, 없으면 저장소 루트의 .keystore/release-signing.properties(커밋 금지, .gitignore 처리)를 읽어요.
| 환경변수 | properties 키 | 기본값 |
|---|
KEYSTORE_PATH | keystorePath | ../.keystore/my-farm-upload.jks (android/ 기준) |
STORE_PASSWORD | storePassword | 없음(필수) |
KEY_ALIAS | keyAlias | my-farm |
KEY_PASSWORD | keyPassword | 없음 |
릴리스: pwsh tool/release_android.ps1이 서명된 APK를 빌드하고, APK에서 aapt2로 읽은 versionCode·versionName·minSdk와 크기·SHA-256으로 build/release/update.json을 만듭니다(pubspec과 다르면 멈춤). -Publish를 붙이면 HEAD가 origin/main일 때만 vX.Y.Z 태그로 GitHub 릴리스를 만들어 두 파일을 올리고, 앱이 읽는 고정 주소(releases/latest/download/update.json)가 새 버전을 가리키는지 확인합니다. 릴리스 노트는 CHANGELOG의 해당 버전 절입니다. 서명 키가 저장소 밖에 있어 CI가 아니라 로컬에서 실행해요.
Windows에서 Pub 캐시(C:)와 프로젝트(D:)의 드라이브가 다르면 Kotlin 증분 컴파일 캐시가 실패해서 android/gradle.properties에 kotlin.incremental=false를 넣어 두었습니다.
🔒 데이터와 개인정보
- 모든 기록은 기기(또는 브라우저) 안에 저장되고 개발자 서버로 보내지 않아요. 계정·분석·광고 SDK가 없습니다. Android 시스템 백업을 켜 두었다면 Android가 앱 데이터를 사용자의 Google 계정 백업에 넣어 새 기기에서 복원할 수 있어요. 프로필 → 백업 내보내기로 파일을 만들어 두면 앱을 지워도 되살릴 수 있어요.
- 저장 형식이 바뀌면 처음 실행할 때 자동으로 옮기고, 옮기기 전 원본은 앱 안에 따로 남겨 둡니다.
- 알림은 기기 안에서만 예약하고 외부로 아무것도 보내지 않아요. 켤 때 Android 13 이상은 알림 권한을 묻고, 재부팅 뒤 예약을 되살리려고 부팅 완료 수신 권한을 씁니다. Windows는 알림 표시를 위해 현재 사용자 레지스트리(
HKCU\Software\Classes\AppUserModelId\Jeiel85.MyFarm)에 앱 이름·아이콘을 등록해요.
- 네트워크는 날씨 조회와 (켰을 때만) 앱 업데이트 확인에 씁니다. 날씨는 프로필에 입력한 위도·경도만 Open-Meteo로 보내고, 업데이트 확인은 GitHub에서
update.json을 받기만 하며 요청에 식별자를 붙이지 않습니다(GitHub는 요청한 IP를 볼 수 있어요).
- 처음 열면 예시 농장 "초록골 농장"이 채워져 있어요. 프로필 → 예시 농장으로 초기화로 언제든 되돌릴 수 있습니다.
🗺️ 로드맵
📄 라이선스
MIT © 2026 jeiel85 · 날씨 데이터 © Open-Meteo.com (CC BY 4.0)
