Spaces:

Catalna
/

ginchiee-bot

Running on Zero

App Files Files Community

ginchiee-bot / docs /PRD.md

Catalna

first commit

8031356 2 months ago

preview code

Raw History Blame Contribute Delete

7.71 kB

# PRD — AI Diet Companion

**Version:** 0.1.0
**Status:** MVP
**Last Updated:** 2026-08-30

---

## 1. Product Overview

**AI Diet Companion** adalah bot personal yang membantu pengguna menjaga pola makan dan kebiasaan diet melalui reminder, food logging, estimasi nutrisi, serta percakapan natural menggunakan LLM.

Produk tidak dirancang sebagai sekadar alarm makan.

Tujuan utamanya adalah membuat pengguna merasa memiliki **personal diet companion** yang:

* mengingatkan waktu makan,
* membantu mencatat makanan,
* memperkirakan kalori dan makronutrisi,
* memberikan saran sederhana,
* memahami konteks pengguna,
* dapat diajak bercanda dan berbicara secara natural,
* serta membantu pengguna tetap konsisten.

### MVP Channel

MVP menggunakan:

> **Telegram Bot**

WhatsApp belum menjadi bagian dari MVP dan akan ditambahkan setelah core system stabil.

---

# 2. Problem Statement

Aplikasi diet pada umumnya berfokus pada tracking atau reminder yang bersifat statis.

Contoh:

> "It's time to eat."

Pendekatan tersebut kurang engaging karena pengguna hanya menerima notifikasi tanpa adanya interaksi atau konteks.

AI Diet Companion mencoba menyelesaikan masalah tersebut dengan menggabungkan:

```text
Reminder
+
Nutrition Tracking
+
LLM Conversation
+
Personalization
```

Contoh:

> 🍱 Lunch time!

berubah menjadi:

> 🍱 Bro, lunch time 😂
> Jangan sampai tugasmu selesai tapi makan siangmu masih pending.
>
> Hari ini protein kamu baru 42g dari target 130g.
> Kalau makan sekarang, coba pilih makanan yang punya protein cukup ya 💪

---

# 3. Goals

## Primary Goals

1. Membuat bot diet yang dapat berjalan secara otomatis.
2. Memberikan reminder berdasarkan jadwal pengguna.
3. Menyimpan profil dan data diet pengguna.
4. Mencatat makanan yang dikonsumsi.
5. Mengestimasi kalori dan makronutrisi.
6. Menggunakan LLM untuk conversational interaction.
7. Memberikan personalized suggestions.
8. Membuat fondasi yang mudah dikembangkan menjadi AI Agent.

## Secondary Goals

1. Integrasi Google Calendar.
2. Integrasi Google Tasks.
3. Integrasi WhatsApp.
4. Memory yang lebih kompleks.
5. Food recognition dari gambar.
6. Deployment 24/7.

---

# 4. Non-Goals for MVP

Fitur berikut tidak wajib pada MVP:

* Medical diagnosis.
* Prescription.
* Medical treatment.
* Real-time professional nutritionist.
* Advanced computer vision.
* Google Calendar integration.
* WhatsApp integration.
* Multi-agent LangGraph architecture.
* Web dashboard.
* Mobile application.

---

# 5. Target User

Target awal:

* mahasiswa,
* pekerja,
* pengguna yang sedang diet,
* pengguna yang ingin menjaga pola makan,
* pengguna yang membutuhkan reminder,
* pengguna yang menyukai conversational AI.

---

# 6. Core Features

## 6.1 User Registration

Command:

```text
/start
```

Bot membuat profile baru.

Data minimal:

```text
user_id
name
age
gender
height
weight
goal
activity_level
timezone
```

---

# 7. User Profile

User dapat memasukkan:

```text
Age
Gender
Height
Weight
Activity Level
Diet Goal
```

Diet goal:

```text
LOSE_WEIGHT
MAINTAIN_WEIGHT
GAIN_WEIGHT
```

Activity level:

```text
SEDENTARY
LIGHT
MODERATE
ACTIVE
VERY_ACTIVE
```

Profile digunakan untuk menghitung estimasi kebutuhan energi dan target makronutrisi.

---

# 8. Nutrition Target

System menghitung estimasi:

```text
Daily Calories
Protein
Carbohydrates
Fat
Water
```

Contoh:

```text
Daily Target
Calories     2,100 kcal
Protein        130 g
Carbs          230 g
Fat             70 g
Water          2.5 L
```

Nilai tersebut adalah **estimasi**, bukan diagnosis atau rekomendasi medis.

---

# 9. Meal Schedule

User dapat menentukan jadwal:

```text
Breakfast
Lunch
Snack
Dinner
```

Contoh:

```text
Breakfast → 07:00
Lunch     → 12:00
Snack     → 15:30
Dinner    → 19:00
```

Scheduler akan mengirim reminder.

---

# 10. Intelligent Reminder

Reminder tidak selalu berupa teks statis.

System memberikan context kepada LLM.

Input:

```text
meal = lunch
current_time = 12:00
user_name = ...
protein_consumed = 42
protein_target = 130
personality = funny
```

LLM menghasilkan pesan.

Contoh:

> 🍱 Lunch time!
>
> Protein kamu baru 42g hari ini.
> Jangan cuma makan kerupuk terus bilang sudah makan 😂

---

# 11. Food Logging

User dapat mencatat makanan menggunakan natural language.

Contoh:

> Aku makan nasi 200 gram, ayam 150 gram dan telur satu.

System mengekstrak:

```text
rice = 200g
chicken = 150g
egg = 1
```

Nutrition engine kemudian menghitung:

```text
Calories
Protein
Carbs
Fat
```

---

# 12. Daily Nutrition Tracking

System menyimpan konsumsi harian.

Contoh:

```text
TARGET
Calories   2100 kcal
Protein     130 g
Carbs       230 g
Fat          70 g
CONSUMED
Calories   1450 kcal
Protein      92 g
Carbs       160 g
Fat          48 g
```

System dapat menghitung progress:

```text
Calories: 69%
Protein: 71%
Carbs: 70%
Fat: 69%
```

---

# 13. AI Conversation

User dapat berbicara secara bebas.

Contoh:

> Aku lapar banget.

LLM mendapatkan context:

```text
User profile
+
Today's nutrition
+
Meal schedule
+
Recent food logs
+
Current time
```

Kemudian memberikan response.

Contoh:

> Waduh 😭
> Baru beberapa jam sejak lunch, tapi kalau memang lapar jangan dipaksa tahan.
>
> Coba snack yang ada protein seperti telur, yogurt, atau susu.
>
> Kita masih punya ruang sekitar 500 kcal hari ini.

---

# 14. Personality

Bot memiliki personality.

MVP default:

```text
PLAYFUL + SUPPORTIVE
```

Karakter:

* casual,
* friendly,
* sedikit bercanda,
* tidak menghakimi,
* tetap informatif,
* tidak berlebihan.

Contoh:

> Jangan khawatir kalau hari ini agak melenceng 😭
> Satu kali makan tidak menghancurkan progress kamu. Yang penting balik ke rutinitas.

---

# 15. AI Safety

LLM tidak boleh:

* mendiagnosis penyakit,
* memberikan prescription,
* mengklaim sebagai dokter,
* memberikan instruksi medis berisiko,
* menjamin hasil penurunan berat badan.

Jika user memberikan pertanyaan medis berisiko, bot harus memberikan batasan dan menyarankan konsultasi profesional.

---

# 16. Commands

MVP commands:

```text
/start
/profile
/setprofile
/today
/log
/food
/schedule
/reminders
/help
```

Natural language tetap menjadi interface utama.

---

# 17. Example User Journey

```text
/start
   ↓
Create Profile
   ↓
Set Goal
   ↓
Calculate Nutrition Target
   ↓
Set Meal Schedule
   ↓
Enable Reminder
   ↓
Daily Reminder
   ↓
User Logs Food
   ↓
Nutrition Calculation
   ↓
Daily Progress
   ↓
AI Suggestion
```

---

# 18. MVP Success Criteria

MVP dianggap berhasil apabila:

### Bot

* dapat menerima message Telegram,
* dapat membalas message,
* dapat menerima command,
* dapat menyimpan user.

### Reminder

* dapat membuat jadwal,
* dapat mengirim reminder otomatis,
* dapat menggunakan timezone user.

### Nutrition

* dapat menyimpan food log,
* dapat menghitung estimasi nutrisi,
* dapat menghitung daily progress.

### AI

* dapat memahami natural language,
* dapat menggunakan user context,
* dapat memberikan suggestion,
* dapat mempertahankan personality.

---

# 19. Future Roadmap

## Phase 1 — MVP

```text
Telegram
Python
SQLite
Scheduler
LLM
Nutrition Engine
```

## Phase 2 — Better AI

```text
Memory
Conversation Context
Better Nutrition Database
Personalization
```

## Phase 3 — Google Ecosystem

```text
Google OAuth
Google Calendar
Google Tasks
```

## Phase 4 — AI Agent

```text
LangGraph
Tool Calling
Multiple Specialized Agents
```

## Phase 5 — Multichannel

```text
Telegram
WhatsApp
Web
```

## Phase 6 — Vision

```text
Food Photo
   ↓
Vision Model
   ↓
Food Detection
   ↓
Nutrition Estimation
```

## Phase 7 — Production

```text
Docker
VPS / Cloud
PostgreSQL
Redis
Monitoring
HTTPS
```

	# PRD — AI Diet Companion

	Version: 0.1.0
	Status: MVP
	Last Updated: 2026-08-30

	---

	## 1. Product Overview

	AI Diet Companion adalah bot personal yang membantu pengguna menjaga pola makan dan kebiasaan diet melalui reminder, food logging, estimasi nutrisi, serta percakapan natural menggunakan LLM.

	Produk tidak dirancang sebagai sekadar alarm makan.

	Tujuan utamanya adalah membuat pengguna merasa memiliki personal diet companion yang:

	* mengingatkan waktu makan,
	* membantu mencatat makanan,
	* memperkirakan kalori dan makronutrisi,
	* memberikan saran sederhana,
	* memahami konteks pengguna,
	* dapat diajak bercanda dan berbicara secara natural,
	* serta membantu pengguna tetap konsisten.

	### MVP Channel

	MVP menggunakan:

	> Telegram Bot

	WhatsApp belum menjadi bagian dari MVP dan akan ditambahkan setelah core system stabil.

	---

	# 2. Problem Statement

	Aplikasi diet pada umumnya berfokus pada tracking atau reminder yang bersifat statis.

	Contoh:

	> "It's time to eat."

	Pendekatan tersebut kurang engaging karena pengguna hanya menerima notifikasi tanpa adanya interaksi atau konteks.

	AI Diet Companion mencoba menyelesaikan masalah tersebut dengan menggabungkan:

	```text
	Reminder
	+
	Nutrition Tracking
	+
	LLM Conversation
	+
	Personalization
	```

	Contoh:

	> 🍱 Lunch time!

	berubah menjadi:

	> 🍱 Bro, lunch time 😂
	> Jangan sampai tugasmu selesai tapi makan siangmu masih pending.
	>
	> Hari ini protein kamu baru 42g dari target 130g.
	> Kalau makan sekarang, coba pilih makanan yang punya protein cukup ya 💪

	---

	# 3. Goals

	## Primary Goals

	1. Membuat bot diet yang dapat berjalan secara otomatis.
	2. Memberikan reminder berdasarkan jadwal pengguna.
	3. Menyimpan profil dan data diet pengguna.
	4. Mencatat makanan yang dikonsumsi.
	5. Mengestimasi kalori dan makronutrisi.
	6. Menggunakan LLM untuk conversational interaction.
	7. Memberikan personalized suggestions.
	8. Membuat fondasi yang mudah dikembangkan menjadi AI Agent.

	## Secondary Goals

	1. Integrasi Google Calendar.
	2. Integrasi Google Tasks.
	3. Integrasi WhatsApp.
	4. Memory yang lebih kompleks.
	5. Food recognition dari gambar.
	6. Deployment 24/7.

	---

	# 4. Non-Goals for MVP

	Fitur berikut tidak wajib pada MVP:

	* Medical diagnosis.
	* Prescription.
	* Medical treatment.
	* Real-time professional nutritionist.
	* Advanced computer vision.
	* Google Calendar integration.
	* WhatsApp integration.
	* Multi-agent LangGraph architecture.
	* Web dashboard.
	* Mobile application.

	---

	# 5. Target User

	Target awal:

	* mahasiswa,
	* pekerja,
	* pengguna yang sedang diet,
	* pengguna yang ingin menjaga pola makan,
	* pengguna yang membutuhkan reminder,
	* pengguna yang menyukai conversational AI.

	---

	# 6. Core Features

	## 6.1 User Registration

	Command:

	```text
	/start
	```

	Bot membuat profile baru.

	Data minimal:

	```text
	user_id
	name
	age
	gender
	height
	weight
	goal
	activity_level
	timezone
	```

	---

	# 7. User Profile

	User dapat memasukkan:

	```text
	Age
	Gender
	Height
	Weight
	Activity Level
	Diet Goal
	```

	Diet goal:

	```text
	LOSE_WEIGHT
	MAINTAIN_WEIGHT
	GAIN_WEIGHT
	```

	Activity level:

	```text
	SEDENTARY
	LIGHT
	MODERATE
	ACTIVE
	VERY_ACTIVE
	```

	Profile digunakan untuk menghitung estimasi kebutuhan energi dan target makronutrisi.

	---

	# 8. Nutrition Target

	System menghitung estimasi:

	```text
	Daily Calories
	Protein
	Carbohydrates
	Fat
	Water
	```

	Contoh:

	```text
	Daily Target

	Calories 2,100 kcal
	Protein 130 g
	Carbs 230 g
	Fat 70 g
	Water 2.5 L
	```

	Nilai tersebut adalah estimasi, bukan diagnosis atau rekomendasi medis.

	---

	# 9. Meal Schedule

	User dapat menentukan jadwal:

	```text
	Breakfast
	Lunch
	Snack
	Dinner
	```

	Contoh:

	```text
	Breakfast → 07:00
	Lunch → 12:00
	Snack → 15:30
	Dinner → 19:00
	```

	Scheduler akan mengirim reminder.

	---

	# 10. Intelligent Reminder

	Reminder tidak selalu berupa teks statis.

	System memberikan context kepada LLM.

	Input:

	```text
	meal = lunch
	current_time = 12:00
	user_name = ...
	protein_consumed = 42
	protein_target = 130
	personality = funny
	```

	LLM menghasilkan pesan.

	Contoh:

	> 🍱 Lunch time!
	>
	> Protein kamu baru 42g hari ini.
	> Jangan cuma makan kerupuk terus bilang sudah makan 😂

	---

	# 11. Food Logging

	User dapat mencatat makanan menggunakan natural language.

	Contoh:

	> Aku makan nasi 200 gram, ayam 150 gram dan telur satu.

	System mengekstrak:

	```text
	rice = 200g
	chicken = 150g
	egg = 1
	```

	Nutrition engine kemudian menghitung:

	```text
	Calories
	Protein
	Carbs
	Fat
	```

	---

	# 12. Daily Nutrition Tracking

	System menyimpan konsumsi harian.

	Contoh:

	```text
	TARGET

	Calories 2100 kcal
	Protein 130 g
	Carbs 230 g
	Fat 70 g


	CONSUMED

	Calories 1450 kcal
	Protein 92 g
	Carbs 160 g
	Fat 48 g
	```

	System dapat menghitung progress:

	```text
	Calories: 69%
	Protein: 71%
	Carbs: 70%
	Fat: 69%
	```

	---

	# 13. AI Conversation

	User dapat berbicara secara bebas.

	Contoh:

	> Aku lapar banget.

	LLM mendapatkan context:

	```text
	User profile
	+
	Today's nutrition
	+
	Meal schedule
	+
	Recent food logs
	+
	Current time
	```

	Kemudian memberikan response.

	Contoh:

	> Waduh 😭
	> Baru beberapa jam sejak lunch, tapi kalau memang lapar jangan dipaksa tahan.
	>
	> Coba snack yang ada protein seperti telur, yogurt, atau susu.
	>
	> Kita masih punya ruang sekitar 500 kcal hari ini.

	---

	# 14. Personality

	Bot memiliki personality.

	MVP default:

	```text
	PLAYFUL + SUPPORTIVE
	```

	Karakter:

	* casual,
	* friendly,
	* sedikit bercanda,
	* tidak menghakimi,
	* tetap informatif,
	* tidak berlebihan.

	Contoh:

	> Jangan khawatir kalau hari ini agak melenceng 😭
	> Satu kali makan tidak menghancurkan progress kamu. Yang penting balik ke rutinitas.

	---

	# 15. AI Safety

	LLM tidak boleh:

	* mendiagnosis penyakit,
	* memberikan prescription,
	* mengklaim sebagai dokter,
	* memberikan instruksi medis berisiko,
	* menjamin hasil penurunan berat badan.

	Jika user memberikan pertanyaan medis berisiko, bot harus memberikan batasan dan menyarankan konsultasi profesional.

	---

	# 16. Commands

	MVP commands:

	```text
	/start
	/profile
	/setprofile
	/today
	/log
	/food
	/schedule
	/reminders
	/help
	```

	Natural language tetap menjadi interface utama.

	---

	# 17. Example User Journey

	```text
	/start
	↓
	Create Profile
	↓
	Set Goal
	↓
	Calculate Nutrition Target
	↓
	Set Meal Schedule
	↓
	Enable Reminder
	↓
	Daily Reminder
	↓
	User Logs Food
	↓
	Nutrition Calculation
	↓
	Daily Progress
	↓
	AI Suggestion
	```

	---

	# 18. MVP Success Criteria

	MVP dianggap berhasil apabila:

	### Bot

	* dapat menerima message Telegram,
	* dapat membalas message,
	* dapat menerima command,
	* dapat menyimpan user.

	### Reminder

	* dapat membuat jadwal,
	* dapat mengirim reminder otomatis,
	* dapat menggunakan timezone user.

	### Nutrition

	* dapat menyimpan food log,
	* dapat menghitung estimasi nutrisi,
	* dapat menghitung daily progress.

	### AI

	* dapat memahami natural language,
	* dapat menggunakan user context,
	* dapat memberikan suggestion,
	* dapat mempertahankan personality.

	---

	# 19. Future Roadmap

	## Phase 1 — MVP

	```text
	Telegram
	Python
	SQLite
	Scheduler
	LLM
	Nutrition Engine
	```

	## Phase 2 — Better AI

	```text
	Memory
	Conversation Context
	Better Nutrition Database
	Personalization
	```

	## Phase 3 — Google Ecosystem

	```text
	Google OAuth
	Google Calendar
	Google Tasks
	```

	## Phase 4 — AI Agent

	```text
	LangGraph
	Tool Calling
	Multiple Specialized Agents
	```

	## Phase 5 — Multichannel

	```text
	Telegram
	WhatsApp
	Web
	```

	## Phase 6 — Vision

	```text
	Food Photo
	↓
	Vision Model
	↓
	Food Detection
	↓
	Nutrition Estimation
	```

	## Phase 7 — Production

	```text
	Docker
	VPS / Cloud
	PostgreSQL
	Redis
	Monitoring
	HTTPS
	```