Create README.md
This commit is contained in:
HagaDalpintoGinting
GitHub
parent
bc63ed83bb
commit
ead3f3daba
191
README.md
Normal file
191
README.md
Normal file
@ -0,0 +1,191 @@
|
|||||||
|
Step & Drink
|
||||||
|
Aplikasi Android untuk tracking langkah harian dan kebutuhan air minum menggunakan Kotlin dan Jetpack Compose.
|
||||||
|
|
||||||
|
📋 Deskripsi
|
||||||
|
Step & Drink adalah aplikasi mobile yang membantu pengguna untuk:
|
||||||
|
|
||||||
|
Melacak langkah harian menggunakan sensor step counter bawaan smartphone
|
||||||
|
Mencatat asupan air minum untuk memenuhi kebutuhan hidrasi harian
|
||||||
|
Menetapkan dan memantau target langkah dan air minum yang dapat disesuaikan
|
||||||
|
Melihat riwayat aktivitas untuk evaluasi kebiasaan sehat
|
||||||
|
|
||||||
|
Aplikasi ini dibuat sebagai tugas akhir mata kuliah Pemrograman Bergerak dengan fokus pada penggunaan sensor hardware, database lokal, dan multi-halaman navigation.
|
||||||
|
|
||||||
|
✨ Fitur
|
||||||
|
1. Home Screen
|
||||||
|
|
||||||
|
Dashboard dengan ringkasan aktivitas hari ini
|
||||||
|
Card interaktif untuk langkah dan air minum
|
||||||
|
Progress bar visual untuk tracking target
|
||||||
|
Greeting dengan nama pengguna
|
||||||
|
|
||||||
|
2. Step Tracker
|
||||||
|
|
||||||
|
Real-time tracking langkah menggunakan sensor TYPE_STEP_COUNTER
|
||||||
|
Start/Stop tracking dengan tombol floating action button
|
||||||
|
Riwayat langkah 7 hari terakhir
|
||||||
|
Target langkah yang dapat disesuaikan
|
||||||
|
|
||||||
|
3. Water Tracker
|
||||||
|
|
||||||
|
Quick add buttons (250ml, 500ml, 1000ml)
|
||||||
|
Input custom untuk jumlah air
|
||||||
|
Riwayat minum harian dengan timestamp
|
||||||
|
Hapus record jika salah input
|
||||||
|
Target air minum yang dapat disesuaikan
|
||||||
|
|
||||||
|
4. Profile & Settings
|
||||||
|
|
||||||
|
Edit nama pengguna
|
||||||
|
Ubah target langkah harian
|
||||||
|
Ubah target air minum harian
|
||||||
|
Informasi aplikasi
|
||||||
|
|
||||||
|
|
||||||
|
🛠️ Teknologi
|
||||||
|
Bahasa & Framework
|
||||||
|
|
||||||
|
Kotlin - Bahasa pemrograman
|
||||||
|
Jetpack Compose - UI Framework
|
||||||
|
Material Design 3 - Design system
|
||||||
|
|
||||||
|
Architecture
|
||||||
|
|
||||||
|
MVVM (Model-View-ViewModel)
|
||||||
|
Repository Pattern
|
||||||
|
Clean Architecture
|
||||||
|
|
||||||
|
Database & Storage
|
||||||
|
|
||||||
|
Room Database - Local database (SQLite)
|
||||||
|
DataStore Preferences - Settings storage
|
||||||
|
|
||||||
|
Components
|
||||||
|
|
||||||
|
Navigation Compose - Multi-halaman navigation
|
||||||
|
Sensor Manager - Akses hardware sensor (Step Counter)
|
||||||
|
ViewModel - State management
|
||||||
|
Kotlin Flow - Reactive data stream
|
||||||
|
Coroutines - Asynchronous operations
|
||||||
|
|
||||||
|
|
||||||
|
📦 Struktur Project
|
||||||
|
stepdrink/
|
||||||
|
├── data/
|
||||||
|
│ ├── local/
|
||||||
|
│ │ ├── entity/ # StepRecord, WaterRecord
|
||||||
|
│ │ ├── dao/ # StepDao, WaterDao
|
||||||
|
│ │ ├── database/ # AppDatabase
|
||||||
|
│ │ └── PreferencesManager.kt
|
||||||
|
│ └── repository/ # StepRepository, WaterRepository
|
||||||
|
├── ui/
|
||||||
|
│ ├── screen/ # HomeScreen, StepsScreen, WaterScreen, ProfileScreen
|
||||||
|
│ ├── navigation/ # Navigation setup
|
||||||
|
│ ├── components/ # Reusable UI components
|
||||||
|
│ └── theme/ # App theming
|
||||||
|
├── viewmodel/ # StepViewModel, WaterViewModel, ProfileViewModel
|
||||||
|
├── sensor/ # StepCounterManager
|
||||||
|
├── util/ # DateUtils
|
||||||
|
└── MainActivity.kt
|
||||||
|
|
||||||
|
🗄️ Database
|
||||||
|
step_records
|
||||||
|
Menyimpan data langkah harian
|
||||||
|
|
||||||
|
id - Primary key
|
||||||
|
date - Tanggal (yyyy-MM-dd)
|
||||||
|
steps - Jumlah langkah
|
||||||
|
timestamp - Waktu pencatatan
|
||||||
|
|
||||||
|
water_records
|
||||||
|
Menyimpan data minum air
|
||||||
|
|
||||||
|
id - Primary key
|
||||||
|
date - Tanggal (yyyy-MM-dd)
|
||||||
|
amount - Jumlah air (ml)
|
||||||
|
timestamp - Waktu pencatatan
|
||||||
|
|
||||||
|
Preferences (DataStore)
|
||||||
|
Menyimpan pengaturan pengguna
|
||||||
|
|
||||||
|
user_name - Nama pengguna
|
||||||
|
step_goal - Target langkah harian
|
||||||
|
water_goal - Target air minum harian (ml)
|
||||||
|
|
||||||
|
|
||||||
|
🚀 Instalasi
|
||||||
|
Requirements
|
||||||
|
|
||||||
|
Android Studio (versi terbaru)
|
||||||
|
Minimum SDK: API 26 (Android 8.0)
|
||||||
|
Kotlin 1.9.22
|
||||||
|
|
||||||
|
Cara Menjalankan
|
||||||
|
|
||||||
|
Clone atau download project
|
||||||
|
Buka di Android Studio
|
||||||
|
Sync Gradle (File → Sync Project with Gradle Files)
|
||||||
|
Build project (Build → Make Project)
|
||||||
|
Run di device atau emulator
|
||||||
|
Izinkan permission ACTIVITY_RECOGNITION saat diminta
|
||||||
|
|
||||||
|
|
||||||
|
📱 Cara Penggunaan
|
||||||
|
|
||||||
|
Tracking Langkah
|
||||||
|
|
||||||
|
Buka Step Tracker
|
||||||
|
Klik tombol Play
|
||||||
|
Izinkan permission
|
||||||
|
Mulai berjalan
|
||||||
|
Data otomatis tersimpan
|
||||||
|
|
||||||
|
|
||||||
|
Catat Air Minum
|
||||||
|
|
||||||
|
Buka Water Tracker
|
||||||
|
Klik quick add atau tombol +
|
||||||
|
Input jumlah air
|
||||||
|
Data tersimpan dengan timestamp
|
||||||
|
|
||||||
|
|
||||||
|
Ubah Target
|
||||||
|
|
||||||
|
Buka Profile
|
||||||
|
Klik card yang ingin diubah
|
||||||
|
Input nilai baru
|
||||||
|
Simpan
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
🎯 Tujuan Project
|
||||||
|
Project ini dibuat untuk memenuhi tugas akhir mata kuliah Pemrograman Bergerak dengan requirements:
|
||||||
|
|
||||||
|
✅ Multi-halaman (4 screens)
|
||||||
|
✅ Penggunaan sensor (Step Counter)
|
||||||
|
✅ Database lokal (Room)
|
||||||
|
✅ IDE Android Studio
|
||||||
|
✅ Bahasa Kotlin
|
||||||
|
✅ UI Framework Jetpack Compose
|
||||||
|
|
||||||
|
|
||||||
|
👨💻 Developer
|
||||||
|
Nama: [Nama Kamu]
|
||||||
|
NIM: [NIM Kamu]
|
||||||
|
Mata Kuliah: Pemrograman Bergerak
|
||||||
|
Institusi: [Nama Universitas]
|
||||||
|
Tahun: 2025
|
||||||
|
|
||||||
|
📝 Catatan
|
||||||
|
|
||||||
|
Aplikasi memerlukan device dengan sensor step counter untuk fitur tracking langkah
|
||||||
|
Emulator Android biasanya tidak memiliki sensor step counter
|
||||||
|
Data disimpan secara lokal di device
|
||||||
|
Aplikasi masih dalam tahap pengembangan dan dapat dikembangkan lebih lanjut
|
||||||
|
|
||||||
|
|
||||||
|
📄 License
|
||||||
|
MIT License - Copyright (c) 2025
|
||||||
|
|
||||||
|
Made with Kotlin & Jetpack Compose
|
||||||
Loading…
x
Reference in New Issue
Block a user