Skip to content

izzuddinmohsin/pricekita

Repository files navigation

PriceKita

"Jimat belanja, hidup senang"

Aplikasi perbandingan harga barangan runcit Malaysia yang menggunakan data rasmi kerajaan daripada data.gov.my untuk membantu rakyat Malaysia mencari harga termurah di kawasan mereka.

Dibina untuk Krackathon Q1 2026 oleh KrackedDevs.


Masalah

Jutaan rakyat Malaysia berhadapan dengan kos sara hidup yang semakin meningkat. Harga ayam, telur, minyak masak, beras — semuanya naik. Tetapi tiada cara mudah untuk mengetahui kedai mana yang menjual paling murah berhampiran anda.

Kerajaan mengumpul 2 juta+ rekod harga setiap bulan melalui program PriceCatcher, tetapi data ini tersimpan dalam format teknikal yang sukar digunakan oleh rakyat biasa.

Penyelesaian

PriceKita mengubah data pengawasan harga kerajaan menjadi aplikasi intuitif yang membantu rakyat Malaysia:

  • Mencari harga barangan runcit paling murah di kawasan mereka
  • Membandingkan harga antara kedai dalam daerah/negeri
  • Melihat trend harga (naik ke turun?)
  • Mendapatkan cadangan bajet AI berdasarkan harga sebenar tempatan

Ciri-Ciri Utama

Cari Harga Murah

Bandingkan harga barangan di 3,837 kedai merentasi 16 negeri dengan 732,000+ rekod harga terkini.

Dashboard Analitik

Lihat trend harga, perbandingan negeri, dan barangan paling banyak naik harga melalui carta interaktif.

Penasihat Bajet AI

Dapatkan cadangan menu mingguan yang jimat berdasarkan harga sebenar di kawasan anda — dikuasakan oleh AI.

Harga Minyak

Pantau harga terkini RON95, RON97, dan Diesel.


Sumber Data

Semua data dalam PriceKita bersumber 100% daripada data.gov.my — Portal Data Terbuka Malaysia.

Data Sumber Rekod
Harga Barangan PriceCatcher (KPDN) 732,000+
Senarai Kedai PriceCatcher (KPDN) 3,837
Senarai Barangan PriceCatcher (KPDN) 756
Harga Minyak data.gov.my Mingguan

Data dimuat turun dan disimpan secara tempatan dalam SQLite — tiada API luaran dipanggil semasa penggunaan aplikasi.


Tech Stack

Layer Teknologi
Framework Next.js 16 (App Router)
Bahasa TypeScript
UI shadcn/ui + Tailwind CSS v4
Animasi Framer Motion
Carta Recharts
Pangkalan Data SQLite (better-sqlite3)
AI Gemini Flash 2.0 via OpenRouter

Mula Guna

# Clone repo
git clone https://github.com/izzuddinmohsin/pricekita.git
cd pricekita

# Install dependencies
npm install

# Setup environment variable
cp .env.example .env.local
# Tambah OPENROUTER_API_KEY dalam .env.local

# Run development server
npm run dev

Buka http://localhost:3000 di browser anda.

Struktur Projek

pricekita/
├── src/
│   ├── app/
│   │   ├── page.tsx              # Landing page
│   │   ├── cari/page.tsx         # Cari harga
│   │   ├── dashboard/page.tsx    # Dashboard analitik
│   │   ├── penasihat/page.tsx    # Penasihat bajet AI
│   │   ├── tentang/page.tsx      # Tentang
│   │   └── api/                  # API routes
│   ├── components/               # Komponen React
│   └── lib/                      # Utiliti (db, ai, utils)
├── data/
│   ├── pricekita.db              # SQLite database
│   └── fuelprice.json            # Data harga minyak
└── public/                       # Aset statik

Penggunaan AI

Projek ini menggunakan alatan AI berikut:

  • Claude Code (Anthropic) — Pembangunan kod dengan bantuan AI
  • Gemini Flash 2.0 (via OpenRouter) — Penasihat bajet AI dalam aplikasi
  • Claude (Anthropic) — Perancangan dan persediaan pra-hackathon

Developer

Dibina oleh Izzuddin Mohsin untuk Krackathon Q1 2026.

Data 100% daripada data.gov.my — Portal Data Terbuka Malaysia.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages