SMART HC Chatbot 🤖📚

SMART HC (Smart Human Capital) adalah chatbot internal berbasis AI yang dirancang untuk menjawab pertanyaan karyawan terkait HR, seperti perjalanan dinas, benefit, cuti, payroll, dan kebijakan perusahaan lainnya.

Proyek ini menggunakan pendekatan Retrieval-Augmented Generation (RAG) dengan model LLM terbaru yang terhubung ke dokumen internal perusahaan.

---

🚀 Fitur Utama

• ✅ Jawaban berbasis dokumen kebijakan resmi
• 🧠 Integrasi LLM (Meta Llama 3 via Together.ai)
• 📄 Parsing otomatis PDF/DOCX kebijakan
• 🔍 Pencarian semantik dengan Chroma vectorstore
• 💬 Riwayat chat untuk pertanyaan lanjutan
• ⚡ Parser cepat untuk uang harian (tanpa LLM)

---

🧱 Teknologi yang Digunakan

Komponen	Teknologi
Backend	Python + Flask
AI Framework	LangChain
Embedding	HuggingFace (all-MiniLM-L6-v2)
Vector DB	Chroma
LLM API	Together.ai (Meta Llama 3)
Parsing Dokumen	PyMuPDF (PDF), python-docx (DOCX)

---

🧭 Alur Kerja Chatbot

1. Pengguna mengirim pertanyaan via antarmuka web
2. Sistem mencoba mengenali pola (parser uang harian)
3. Jika tidak ditemukan, sistem lakukan embedding pertanyaan
4. Retriever mencari potongan dokumen terkait
5. Prompt + dokumen dikirim ke LLM untuk menjawab

---

📁 Struktur Folder

smart-hc-chatbot/
│
├── app.py                 # Entry point Flask app
├── rag_chatbot/
│   ├── __init__.py
│   ├── chatbot.py         # Class utama HRChatbot
│   ├── parser.py          # Logic uang harian & akomodasi
│   ├── rag_engine.py      # RAG pipeline (retriever + LLM)
│   ├── document_loader.py # Loader & chunking dokumen
│
├── config/
│   ├── config.py          # API keys & path konfigurasi
│   ├── rules.json         # JSON rules uang harian, dll
│
├── templates/             # Frontend HTML
├── static/                # CSS, logo, JS
├── .gitignore
└── README.md

---

🛠️ Instalasi (local)

git clone https://github.com/jie3116/smart-hc-chatbot.git
cd smart-hc-chatbot
python -m venv .venv
source .venv/bin/activate  # atau .venv\Scripts\activate di Windows
pip install -r requirements.txt
python app.py

---

🧠 Contoh Pertanyaan

• "Berapa uang harian perjalanan dinas grade 4?"
• "Apa syarat pengajuan perjalanan dinas luar kota?"
• "Jelaskan peraturan cuti tahunan"
• "Kalau saya pergi 3 hari termasuk sabtu minggu, dapat tambahan?"

---

🔐 Catatan

Pastikan config.py berisi:

• API key dari Together.ai
• Path ke dokumen PDF/DOCX
• Path ke folder vectorstore

File ini sudah diabaikan oleh .gitignore.

---

✨ License

Proyek ini bersifat internal dan digunakan untuk pengembangan sistem Human Capital secara cerdas.