# 1. Clone repository

git clone https://github.com/d0ngle8k/NLP-Processing.git- **Real-time Notifications**: Background service with custom sounds- 📍 Trích xuất địa điểm từ câu (NER + regex).

cd NLP-Processing

- 🔔 Nhắc nhở linh hoạt: phút / giờ / ngày ("nhắc trước 2 tiếng", "15 phút").

# 2. Create virtual environment

python -m venv .venv### 📊 **Data Management**- 📤 Export: Google Calendar / Outlook / Apple (ICS + JSON).

.\.venv\Scripts\Activate.ps1

- **SQLite Database**: Efficient local storage with full CRUD operations- 📥 Import: Đọc file export & test case format.

# 3. Install dependencies

pip install -r requirements.txt- **Import/Export**: JSON and ICS format support- 📊 Dashboard thống kê: phân bố thời gian, xu hướng 4 tuần, top địa điểm.



# 4. Run application- **Statistics Dashboard**: Event analytics and insights- 🛡️ Bảo vệ dữ liệu: xác nhận 2 lớp khi xóa toàn bộ.

python main_ctk.py

```- **Backup & Restore**: Easy data migration- 🎛️ Settings riêng + chế độ im lặng (tắt debug với `VERBOSE_LOG=False`).



---



## 📖 Usage Examples------



### **Natural Language Input**## 🧱 Kiến trúc tổng quan

### **Complex Time Patterns**1. Download the latest release from [Releases](https://github.com/d0ngle8k/NLP-Processing/releases)├─────────────────────────────────────────┤

### **Reminder Patterns****System Requirements:**                ▼                     ▼

- 1.5 GB disk space                  Chuẩn hoá kết quả cuối

---

┌─────────────────────────────────────────────────────────────┐Thành phần chính:

│                     User Interface (CTk)                     │

│  ┌──────────────┬──────────────┬──────────────────────────┐ │```powershell- `core_nlp/pipeline.py`: Rule-based phân tích thời gian / ngày.

│  │ Event Input  │   Calendar   │   Statistics Dashboard   │ │

│  └──────────────┴──────────────┴──────────────────────────┘ │# 1. Clone repository- `core_nlp/hybrid_pipeline.py`: Kết hợp PhoBERT + Rule-based.

└────────────────────────┬────────────────────────────────────┘

                         │git clone https://github.com/d0ngle8k/NLP-Processing.git- `database/db_manager.py`: SQLite + schema + kết nối.

         ┌───────────────┴───────────────┐

         │     NLP Pipeline (Hybrid)     │cd NLP-Processing- `services/*`: Export/Import/Notification/Statistics.

         │  ┌──────────┬──────────────┐  │

         │  │ PhoBERT  │  Rule-based  │  │- `widgets/`: Thành phần giao diện CustomTkinter.

         │  │   NER    │   Patterns   │  │

         │  └──────────┴──────────────┘  │# 2. Create virtual environment (Python 3.13+ recommended)

         └───────────────┬───────────────┘

                         │python -m venv .venv---

         ┌───────────────┴───────────────┐

         │      Services Layer           │.\.venv\Scripts\Activate.ps1## 📦 Cài đặt

         │  • Time Parser               │

         │  • Location Extractor        │

         │  • Notification Service      │

         │  • Import/Export Service     │# 3. Install dependencies### Yêu cầu

         └───────────────┬───────────────┘

                         │pip install -r requirements.txt- Python 3.9+ (khuyên dùng 3.12)

         ┌───────────────┴───────────────┐

         │     Database (SQLite)         │- Windows 10+ 64-bit

         │  • Events, Reminders, Sounds │

         └───────────────────────────────┘# 4. Run application- RAM 2GB+, Disk trống ≥1GB (bundle exe lớn do model + PyTorch)

| Component | Purpose | Accuracy |

|-----------|---------|----------|```powershell

| **Hybrid Pipeline** | Combines AI + rules for best results | 99.7% |

| **Time Parser** | Vietnamese time expression parsing | 96.4% |---git clone https://github.com/d0ngle8k/NLP-Processing.git

| **Location Extractor** | Smart location detection | 25.3% |

| **Notification Service** | Background reminders | 100% |cd NLP-Processing



---## 📖 Usage Examplespython -m venv .venv



## 📊 Performance Metrics.\.venv\Scripts\Activate.ps1



### **NLP Accuracy (1000 test prompts)**### **Basic Event Creation**pip install -r requirements.txt

| Metric | Before (v0.5) | After (v0.6.1) | Improvement |

|--------|----------------|----------------|-------------|```

| **Time Extraction** | 15.7% | **96.4%** | +80.7% |

| **Location Detection** | 24.8% | 25.3% | +0.5% |```

| **Event Extraction** | 87.5% | **99.7%** | +12.2% |

| **PhoBERT Errors** | 2 errors | **0 errors** | Fixed |Input: "Họp nhóm ngày mai lúc 2 giờ chiều tại phòng A301"---



### **Processing Performance**Output:## 🚀 Chạy ứng dụng

- **Speed**: 202.4 prompts/second

- **Memory**: ~4GB RAM during operation  - Event: Họp nhóm

- **Startup**: ~3 seconds (PhoBERT model loading)

- **Reliability**: 0 crashes on 1000+ test cases  - Time: Tomorrow 14:00### GUI (CustomTkinter)



---  - Location: phòng A301```powershell



## 📁 Project Structure```python main_ctk.py

└── generate_report.py        # Report generation```Nếu lỗi Permission Denied khi update checksum: đóng mọi phiên bản đang chạy rồi build lại.

---

------

## 🧪 Testing

## 🧪 Kiểm thử

### **Run Tests**

```powershell## 🏗️ Architecture

# Unit tests

python -m unittest tests/test_nlp_pipeline.py -v| Suite | Số test | Trạng thái |



# Extended test suite (1000 prompts)```|-------|---------|------------|

python tests/run_extended_tests.py

┌─────────────────────────────────────────────────────────────┐| NLP Pipeline | 42 | ✅ |

# Performance benchmark

python -c "│                     User Interface (CTk)                     │| Hybrid Voting | 10 | ✅ |

from core_nlp.hybrid_pipeline import HybridNLPPipeline

import time│  ┌──────────────┬──────────────┬──────────────────────────┐ │| New Patterns | 8 | ✅ |



pipeline = HybridNLPPipeline()│  │ Event Input  │   Calendar   │   Statistics Dashboard   │ │| Extended Edge Cases | 1065 | ✅ |

start = time.time()

results = [pipeline.process('Họp nhóm 10h mai') for _ in range(100)]│  └──────────────┴──────────────┴──────────────────────────┘ │

elapsed = time.time() - start

print(f'100 prompts: {elapsed:.2f}s ({100/elapsed:.1f} prompts/sec)')└────────────────────────┬────────────────────────────────────┘Chạy nhanh:

"

```                         │```powershell



### **Test Results**         ┌───────────────┴───────────────┐python tests/test_nlp_pipeline.py

         │  │   NER    │   Patterns   │  │---

---

         │  └──────────┴──────────────┘  │## 📂 Cấu trúc dự án (rút gọn)

## 📦 Build Standalone EXE

         └───────────────┬───────────────┘```

### **Using PyInstaller**

```powershell                         │NLP-Processing/

# Install PyInstaller

pip install pyinstaller         ┌───────────────┴───────────────┐├── main_ctk.py                # Entry GUI



# Build executable (includes all models & dependencies)         │      Services Layer           │├── build_main_ctk.spec        # PyInstaller spec chuẩn

pyinstaller --clean trolylichtrinhV2.spec

         │  • Time Parser               │├── core_nlp/                  # NLP logic & hybrid

# Result: dist/trolylichtrinhV2.exe (3.6GB)

```         │  • Location Extractor        │├── services/                  # Export / Import / Notification / Stats



### **EXE Features**         │  • Notification Service      │├── widgets/                   # CustomTkinter components

- ✅ **Self-contained**: No Python installation required

- ✅ **All dependencies**: PyTorch, transformers, underthesea included         │  • Import/Export Service     │├── database/                  # SQLite schema & manager

- ✅ **PhoBERT models**: Fine-tuned Vietnamese NLP models

- ✅ **Database**: SQLite with schema         └───────────────┬───────────────┘├── models/                    # PhoBERT (fine-tuned)

- ✅ **Sounds**: Notification audio files

- ✅ **Cross-platform**: Windows 10/11 compatible                         │├── training_data/             # Dữ liệu huấn luyện/validation



### **Distribution**         ┌───────────────┴───────────────┐├── tests/                     # Bộ test tự động

```powershell

# The exe is completely standalone         │     Database (SQLite)         │└── version_document/          # Tài liệu archive (changelog, design, guides)

# Just share trolylichtrinhV2.exe - users can run it immediately

.\trolylichtrinhV2.exe         │  • Events, Reminders, Sounds │```

     └───────────────────────────────┘

## 🔧 Configuration

## 📥📤 Import / Export

### **Model Selection**

Edit `main_ctk.py` to choose NLP pipeline:---- JSON: Backup & restore sự kiện.



```python- ICS: Đồng bộ Google / Outlook / Apple.

# Option 1: Hybrid (Recommended)

from core_nlp.hybrid_pipeline import HybridNLPPipeline## 📂 Project Structure- Export báo cáo: scripts/generate_report.py (PDF/Excel).

nlp = HybridNLPPipeline()



# Option 2: Rule-based only (Fast, 100% accurate)

from core_nlp.pipeline import NLPPipeline```---

nlp = NLPPipeline()

NLP-Processing/## 🔔 Nhắc nhở

# Option 3: PhoBERT only (Experimental)

from core_nlp.phobert_model import PhoBERTNLPPipeline├── main_ctk.py                    # Main application (CustomTkinter GUI)- Thread nền kiểm tra mỗi 60s (`notification_service.py`).

nlp = PhoBERTNLPPipeline()

```├── main.py                        # Legacy Tkinter version- Tránh spam: đánh dấu đã thông báo.



### **Debug Mode**├── requirements.txt               # Python dependencies- Hỗ trợ trước X phút/giờ/ngày.

```python

# Enable verbose logging├── build_main_ctk.spec           # PyInstaller build configuration

VERBOSE_LOG = True  # Shows model loading, processing steps

```├── .gitignore                    # Git ignore patterns---



---│## 🧠 NLP Highlights



## 🐛 Troubleshooting├── core_nlp/                      # NLP Processing Engine- Xử lý lỗi gõ phổ biến: "támh", "mườih".



### **Common Issues**│   ├── pipeline.py               # Hybrid PhoBERT + Rule-based pipeline- Chuẩn hoá buổi: sáng / chiều / tối / trưa.



| Issue | Solution |│   └── time_parser.py            # Vietnamese time expression parser- Tương đối: "trong 2 ngày", "tuần sau", "tháng sau".

|-------|----------|

| **Module not found** | `pip install -r requirements.txt` |│- Múi giờ: hỗ trợ chuẩn hoá + nội suy nếu thiếu năm.

| **EXE won't start** | Check antivirus, run as administrator |

| **Slow startup** | Normal - PhoBERT model loading (~3s) |├── database/                      # Data Layer

| **Time parsing errors** | Use explicit formats: "10h sáng mai" |

| **Database locked** | Close all app instances, restart |│   ├── db_manager.py             # SQLite operations---

| **Sound not working** | Check Windows audio settings |

│   └── schema.sql                # Database schema## 🛡️ Bảo trì & đóng góp

### **Performance Tips**

- **For speed**: Use rule-based pipeline│Pull Request được chào đón. Vui lòng kèm test cho logic NLP mới.

- **For accuracy**: Use hybrid pipeline

- **For large datasets**: Enable database indexes├── services/                      # Business Logic

- **For low memory**: Reduce batch processing size

│   ├── notification_service.py   # Background reminders---

---

│   ├── import_service.py         # JSON/ICS import## 📝 Tài liệu mở rộng

## 📝 Changelog

│   ├── export_service.py         # JSON/ICS exportXem thư mục `version_document/` (được ignore trong Git để giảm noise) chứa: 

### **v0.6.1 (2025-11-09)** 🔥 LATEST

- ✅ **Massive improvement**: Time extraction 15.7% → 96.4% (+80.7%)│   └── statistics_service.py     # Analytics & reporting- Changelog & Hotfix (`V0.*.md`)

- ✅ **Fixed PhoBERT errors**: 0 errors on 1000 test prompts

- ✅ **Enhanced location detection**: 50+ new Vietnamese patterns│- UI redesign (`BA_GOOGLE_CALENDAR_UI_REDESIGN.md`)

- ✅ **Standalone EXE**: trolylichtrinhV2.exe (3.6GB) with all dependencies

- ✅ **Production ready**: 202.4 prompts/sec processing speed├── widgets/                       # UI Components- Training guides (Colab, GPU)



### **v0.6.0 (2025-11-05)**│   ├── calendar_widget.py        # Monthly calendar view- Sound system & Theme updates

- ✅ Statistics dashboard with charts

- ✅ PDF/Excel export capabilities│   ├── event_list_widget.py      # Event list with animations

- ✅ Enhanced UI with CustomTkinter

- ✅ Background notification service│   └── settings_widget.py        # Settings dialog---



### **v0.5.0 (2025-11-04)**│## ⚠️ Troubleshooting

- ✅ Initial hybrid NLP pipeline

- ✅ Basic Vietnamese time parsing├── models/                        # AI Models (~1 GB)| Vấn đề | Nguyên nhân | Cách xử lý |

- ✅ SQLite database integration

- ✅ JSON/ICS import/export│   ├── phobert_base/             # Pre-trained PhoBERT|--------|-------------|------------|



---│   └── phobert_finetuned/        # Fine-tuned for calendar tasks| PhoBERT load chậm | Kích thước model | Kiên nhẫn (~vài giây) / preload |



## 📄 License│| EXE >900MB | PyTorch + model | Dùng zip phân phối / build lại khi tối ưu |



**MIT License** - Free for personal and commercial use├── sounds/                        # Notification Sounds| Lỗi checksum khi build | File exe đang mở | Tắt ứng dụng rồi build lại |



```│   └── sound1-4.wav              # Default notification tones| Không hiện âm thanh | Thiếu preset | Tạo file .wav trong `sounds/` |

Copyright (c) 2025 d0ngle8k

│

Permission is hereby granted, free of charge, to any person obtaining a copy

of this software and associated documentation files (the "Software"), to deal├── training_data/                 # Training Datasets---

in the Software without restriction, including without limitation the rights

to use, copy, modify, merge, publish, distribute, sublicense, and/or sell│   └── ...                       # Labeled training examples## 📄 License

copies of the Software...

```│Chưa khai báo – bổ sung sau (MIT khuyến nghị).



---├── tests/                         # Test Suite



## 👨‍💻 Author│   ├── test_nlp_pipeline.py      # NLP unit tests---



**Trường Gia Thành (d0ngle8k)**│   ├── test_cases.json           # Baseline test dataset## ✅ Trạng thái hiện tại

- **GitHub**: [@d0ngle8k](https://github.com/d0ngle8k)

- **Repository**: [NLP-Processing](https://github.com/d0ngle8k/NLP-Processing)│   ├── extended_test_cases*.json # Extended test suites- Production GUI ✅

- **Email**: Contact via GitHub

│   └── test_date_parsing_results.json- Silent startup ✅

---

│- EXE build verified ✅

## 🙏 Acknowledgments

├── scripts/                       # Utility Scripts- NLP >1000 edge cases ✅

- **PhoBERT** - Vietnamese BERT model by VinAI Research

- **underthesea** - Vietnamese NLP toolkit│   └── generate_report.py        # Report generation

- **CustomTkinter** - Modern tkinter UI library

- **PyTorch** - Deep learning framework│---

- **Transformers** - Hugging Face library

├── version_document/              # Version History & Documentation*README được viết lại gọn gàng từ bản cũ bị trộn nội dung. Nếu cần thêm English section, thông báo để bổ sung.*

---

│   ├── INDEX.md                  # Documentation index```

## 📞 Support

│   ├── RELEASE_v1.0.3.md        # Release notes

**Need help?**

1. Check [Troubleshooting](#-troubleshooting) section│   └── ...                       # 30+ technical documents

2. Review [CHANGELOG.md](CHANGELOG.md) for updates

3. Create an issue on GitHub│

4. Check the [Wiki](https://github.com/d0ngle8k/NLP-Processing/wiki) for guides

├── build/                         # Build artifacts (gitignored)## 🔧 Configuration

---

│   └── build_main_ctk/           # Latest build cache

## 🎯 Roadmap

│#### 3. Sửa Sự Kiện- [Troubleshooting](#-troubleshooting)

### **✅ Completed**

- [x] Hybrid NLP pipeline with 96.4% accuracy└── dist/                          # Distribution folder

- [x] Modern CustomTkinter UI

- [x] Standalone EXE distribution    └── TroLyLichTrinh_v1.0.4_Improved.exe  # Standalone executable### Model Selection

- [x] Vietnamese time parsing

- [x] Statistics and reporting```

- [x] Import/export functionality

- Double-click vào sự kiện trong danh sách

### **🚧 In Progress**

- [ ] Google Calendar sync---

- [ ] Mobile app (Flutter)

- [ ] Voice input integrationEdit `main.py` to change model:

- [ ] Multi-language support

## 🧠 NLP Pipeline Details

### **💡 Planned**

- [ ] Recurring events- Chỉnh sửa thông tin trong form- [Changelog](#-changelog)- Phân tích thời gian: `core_nlp/time_parser.py`

- [ ] Team collaboration

- [ ] Smart suggestions### **Event Extraction Accuracy**

- [ ] Advanced analytics

```python

---

| Metric | Test Cases | Baseline | Extended | Real-World |

<p align="center">

  <strong>⭐ Star this repo if you find it useful!</strong>|--------|-----------|----------|----------|------------|# Option 1: Hybrid (Recommended)- Bấm **"Sửa"** để lưu

  <br>

  Made with ❤️ for Vietnamese NLP processing| **Event Name** | 1,107 | 100% | 80.67% | **99.1%** |

  <br>

  <em>Version 0.6.1 - Production Ready</em>| **Time Parsing** | 1,107 | 98.5% | 95.2% | 97.8% |from core_nlp.hybrid_pipeline import HybridNLPPipeline

</p>
| **Location** | 543 | 96.7% | 92.3% | 95.1% |

nlp = HybridNLPPipeline()- [License](#-license)    - Quy tắc thủ công cho ngày/giờ tường minh và tương đối; mặc định giờ nếu thiếu (ví dụ 09:00 hoặc theo buổi).

*Real-world accuracy excludes 210 meta-test artifacts*



### **Supported Time Patterns**

# Option 2: Rule-based only (Faster, 100% accurate)#### 4. Xóa Sự Kiện

```python

# Specific timesfrom core_nlp.pipeline import NLPPipeline

"14h30", "2 giờ chiều", "1h50p", "9h15 sáng"

nlp = NLPPipeline()- Chọn sự kiện → Bấm **"Xóa"** (xóa 1 sự kiện)    - Timezone chỉ áp dụng khi người dùng nêu rõ (UTC/GMT hoặc “múi giờ +..”).

# Relative dates

"hôm nay", "ngày mai", "tuần sau", "tháng tới"



# Complex expressions# Option 3: PhoBERT only (Experimental)- Hoặc bấm **"Xóa tất cả"** → Xác nhận 2 lần

"thứ 3 tuần sau", "ngày 15/12", "cuối tháng này"

from core_nlp.phobert_model import PhoBERTModel

# Reminders

"nhắc trước 1 ngày", "nhắc trước 2 giờ", "nhắc 30 phút trước"nlp = PhoBERTModel(model_path='./models/phobert_finetuned')---

### **Location Patterns**

#### 5. Import/Export

```python

# Explicit locations## 📝 Pattern Support

"tại phòng A301", "ở Hà Nội", "tại công ty"

- Bấm **"⚙️ Cài đặt"** (góc dưới bên trái)- CSDL: `database/db_manager.py` + `database/schema.sql`

# Smart extraction

"họp công ty"        → Location: "công ty"### Thời gian (Time)

"đi siêu thị"        → Location: "siêu thị"

"cafe quán góc phố"  → Location: "quán góc phố"- ✅ "6h sáng", "3h chiều", "9h tối"- **Xuất JSON/ICS**: Lưu toàn bộ dữ liệu

# Activate virtual environment

.\.venv\Scripts\Activate.ps1- ✅ "nhắc trước 2 giờ"### Cấu Trúc Thư Mục- **OS**: Windows 10+ (64-bit)- Dịch vụ: `services/`



# Build with PyInstaller- ✅ **NEW:** "nhắc trước 2 tieng"

python -m PyInstaller --clean build_main_ctk.spec

- ✅ **NEW:** "nhắc trước 1 tiếng"```

# Output: dist/TroLyLichTrinh_v1.0.4_Improved.exe (~987 MB)

   - Before: "nhắc trước 2 tieng" → 0 mins ❌

---

   - After: "nhắc trước 2 tieng" → 120 mins ✅│

## 📊 Performance Metrics



### **v1.0.4 Optimizations**

2. **DD/MM Date Format** - Hỗ trợ định dạng ngày DD/MM├── core_nlp/                    # Module xử lý NLP

| Component | Before | After | Improvement |

|-----------|--------|-------|-------------|   - Before: "ngày 20/10" → None ❌

| Event Extraction | 76.96% | 80.67% | +3.71% |

| Complex Events (4-15 words) | 65% | 95% | +30% |   - After: "ngày 20/10" → 2025-10-20 ✅│   ├── pipeline.py              # Pipeline chính (NER + Time + Location)

| Priority Matching | Random | Optimized | Smart 3→2→1 word |

| Time Parsing (1h50p) | ❌ | ✅ | New pattern |



### **Real-world Performance**### Files Changed│   └── time_parser.py           # Parser thời gian tiếng Việt### Dependencies- Kiểm thử: `tests/`



```- `core_nlp/pipeline.py` - Added "tieng|tiếng" to reminder patterns

Total Tests: 1,107

├── Real Events: 897 (81%)- `core_nlp/time_parser.py` - Fixed DD/MM parsing with "ngày" prefix│

│   ├── Passed: ~889 (99.1%)

│   └── Failed: ~8 (0.9%)

└── Meta Tests: 210 (19%) - excluded from metrics

```### Test Results├── database/                    # Lớp database```plaintext    - `tests/test_cases.json`: bộ dữ liệu kỳ vọng.



---- ✅ All 1065 extended tests passed



## 🎯 Features Roadmap- ✅ 8/8 new pattern tests passed│   ├── db_manager.py            # SQLite CRUD operations



### **✅ Completed**- ✅ No regressions detected

- [x] CustomTkinter modern UI

- [x] PhoBERT hybrid NLP pipeline│   ├── schema.sql               # Database schema# Core NLP    - `tests/test_nlp_pipeline.py`: unittest tính macro-F1 cho 4 nhánh (event, time, location, reminder).

- [x] Fade animations (300ms)

- [x] Sound persistence to database## 📊 Performance

- [x] Time pattern 1h50p support

- [x] Calendar widget integration│   └── events.db                # SQLite database (auto-created)

- [x] Import/Export JSON/ICS

| Metric | Value |

### **🚧 In Progress**

- [ ] Google Calendar sync|--------|-------|│underthesea>=6.7.0        # Vietnamese NLP (NER, word segmentation)

- [ ] Mobile app (Flutter)

- [ ] Multi-language support| Accuracy (Rule-based) | 100% |



### **💡 Planned**| Accuracy (PhoBERT) | 95% |├── services/                    # Business logic services

- [ ] Voice input integration

- [ ] Smart suggestions| Accuracy (Hybrid) | ~100% |

- [ ] Recurring events

- [ ] Team collaboration| Avg Processing Time | <100ms |│   ├── import_service.py        # Import JSON/ICS → DBpython-dateutil>=2.8.2    # Date parsing utilities## Cấu trúc thư mục và tệp chính



---| Agreement Score | 84.3% avg |



## 🐛 Troubleshooting│   ├── export_service.py        # Export DB → JSON/ICS



### **Common Issues**## 🐛 Known Issues



#### **1. Exe file won't start**│   └── notification_service.py  # Background reminder thread

#### **2. NLP extraction errors**- First run loads PhoBERT model (~3s startup time)

#### **3. Database locked**│   ├── generate_edge_case_tests.py  # Tạo test cases

#### **4. Models not found**```bash

---└── tests/                       # Testing suitetkinter                    # Standard library (included with Python)├── main.py                     # Tkinter GUI, nhập NLP, lịch, chỉnh sửa, import/export, nhắc nhở



## 📚 Documentation# Run tests before commit



### **Core Documentation**python tests/run_extended_tests.py    ├── test_nlp_pipeline.py     # Unit tests

- [Version Index](version_document/INDEX.md) - All version documents

- [Release v1.0.3](version_document/RELEASE_v1.0.3.md) - Latest release notespython tests/test_hybrid_pipeline.py

- [Build Guide](version_document/BUILD_SUCCESS_v1.0.3.md) - Build instructions

- [Deployment](version_document/DEPLOYMENT_v1.0.3.md) - Deployment checklist```    ├── run_edge_case_tests.py   # Edge case test runner├── core_nlp/



### **Technical Docs**

- [UI Redesign](version_document/BA_GOOGLE_CALENDAR_UI_REDESIGN.md)

- [Sound System](version_document/SOUND_SYSTEM_V2.md)### Adding New Patterns    ├── test_cases.json          # Test dataset

- [NLP Training](version_document/GPU_TRAINING_GUIDE.md)

- [Testing Guide](version_document/TEST_GUIDE_v0.8.1.md)



---1. Update regex patterns in `core_nlp/pipeline.py`    └── edge_case_tests_1000.json  # 1050 edge cases# Data Processing│   ├── pipeline.py             # NLPPipeline: NER (underthesea) + regex trích event/time/location/reminder



## 🤝 Contributing2. Update parsing logic in `core_nlp/time_parser.py`



We welcome contributions! Please follow these guidelines:3. Add test cases in `tests/test_cases.json````



1. **Fork** the repository4. Run full test suite

2. **Create** a feature branch (`git checkout -b feature/AmazingFeature`)

3. **Commit** your changes (`git commit -m 'Add some AmazingFeature'`)5. Update documentationbabel>=2.13.1             # Locale and timezone support│   └── time_parser.py          # parse_vietnamese_time: quy tắc thời gian tiếng Việt

4. **Push** to the branch (`git push origin feature/AmazingFeature`)

5. **Open** a Pull Request



### **Development Standards**## 📄 License### Luồng Xử Lý NLP

- Follow PEP 8 style guide

- Write unit tests for new features

- Update documentation

- Add examples to READMEThis project is licensed under the MIT License.├── database/



---



## 📄 License## 👨‍💻 Author```



This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.



---**d0ngle8k**Input: "thứ 3 mười giờ tôi có lịch phỏng vấn ở tầng 5, nhắc trước 30 phút"# Import/Export│   ├── db_manager.py           # SQLite CRUD và các truy vấn tiện ích



## 🙏 Acknowledgments- Repository: [NLP-Processing](https://github.com/d0ngle8k/NLP-Processing)



- **PhoBERT** - Vietnamese BERT model by VinAI Research   │

- **CustomTkinter** - Modern tkinter UI library

- **underthesea** - Vietnamese NLP toolkit## 🙏 Acknowledgments

- **PyInstaller** - Executable packaging

   ▼ics>=0.7.2                # iCalendar format support│   └── schema.sql              # DDL tạo bảng events

---

- **PhoBERT** - Pre-trained Vietnamese BERT model

## 📞 Contact

- **VNCoreNLP** - Vietnamese NLP toolkit┌─────────────────────────────────────────┐

**Author:** d0ngle8k  

**GitHub:** [@d0ngle8k](https://github.com/d0ngle8k)  - Test data contributors

**Repository:** [NLP-Processing](https://github.com/d0ngle8k/NLP-Processing)

│ 1. Normalize & Extract Time Patterns   │├── services/

---

---

## 📈 Statistics

│    → "thứ 3 mười giờ"                  │

---┌─────────────────────────────────────────┐



<div align="center">│ 3. Extract Location (NER + Regex)      │```│   └── test_cases.json         # dữ liệu kiểm thử



**⭐ Star this repo if you find it useful!**│    → "tầng 5"                           │



Made with ❤️ by d0ngle8k└─────────────────────────────────────────┘├── requirements.txt



</div>   │


   ▼---└── README.md

┌─────────────────────────────────────────┐

│ 4. Extract Reminder                     │```

│    → reminder_minutes: 30               │

└─────────────────────────────────────────┘## 🚀 Cài Đặt Nhanh

   │

   ▼## Yêu cầu hệ thống

┌─────────────────────────────────────────┐

│ 5. Extract Event Name (Remaining Text) │### 1. Clone Repository

│    → "phỏng vấn"                        │

└─────────────────────────────────────────┘```powershell- Python 3.9+ (đã kiểm thử trên Windows)

   │

   ▼git clone https://github.com/d0ngle8k/NLP-Processing.git- Tkinter (đi kèm CPython chuẩn trên Windows)

Result: {

  "event": "phỏng vấn",cd NLP-Processing- Thư viện trong `requirements.txt`: underthesea, tkcalendar, ics, babel, (dateparser hiện không dùng trong mã, có thể giữ lại nếu muốn thử nghiệm)

  "start_time": "2025-11-11T10:00:00",

  "location": "tầng 5",```

  "reminder_minutes": 30

}## Cài đặt và chạy (Windows PowerShell)

```sql

CREATE TABLE IF NOT EXISTS events (python -m venv venv

    id INTEGER PRIMARY KEY AUTOINCREMENT,

    event_name TEXT NOT NULL,.\venv\Scripts\Activate.ps1```powershell

    start_time TEXT NOT NULL,      -- ISO 8601 format

    end_time TEXT,                  -- ISO 8601 (optional)```python -m venv venv

    location TEXT,

    reminder_minutes INTEGER DEFAULT 0,.\n+venv\Scripts\Activate.ps1  # thông thường trên Windows

    status TEXT DEFAULT 'pending'   -- 'pending' or 'notified'

);### 3. Cài Đặt Dependencies# Nếu venv của bạn có cấu trúc dạng bin/ (như repo này), dùng:

---

pip install -r requirements.txt```

## 🧪 Kiểm Thử

# Compact weekday format với typos

"t5 támh phỏng vấn"           → Thứ 5, 8:00, "phỏng vấn"### Thêm Sự Kiện- Chọn ngày trên lịch để xem danh sách. Chọn một dòng → “Sửa” để chỉnh nhanh.

"t2 bah họp"                  → Thứ 2, 3:00, "họp"

"chu nhat mườih đi chơi"      → Chủ nhật, 10:00, "đi chơi"Nhập câu lệnh tự nhiên vào ô text, ví dụ:- “Xuất JSON/ICS” và “Nhập JSON/ICS” ở thanh nút dưới cùng.



# Date formats```

"họp 20.10"                   → 20/10/2025, "họp"

"khám bệnh 15/12"             → 15/12/2025, "khám bệnh"Họp nhóm lúc 10h sáng mai ở phòng 302, nhắc trước 15 phút## Kiểm thử (F1 macro)



# Period markers  ```

"6h chiều họp"                → 18:00 (không phải 6:00)

"10h tối"                     → 22:00Bấm **"Thêm sự kiện"** → Hệ thống tự động:Chạy unittest đo macro-F1 cho pipeline NLP:



# Relative dates- Trích xuất tên sự kiện: "Họp nhóm"

"tuần sau thứ 3"              → Thứ 3 tuần sau

"tháng sau ngày 15"           → Ngày 15 tháng sau- Parse thời gian: 10:00 AM ngày mai```powershell

underthesea>=6.7.0          # Vietnamese NLP (NER)

python-dateutil>=2.8.2      # Date parsing1. Click vào ngày trên **Calendar**

tkcalendar>=1.6.1           # Calendar widget

babel>=2.13.1               # Timezone support2. Danh sách sự kiện hiển thị bên dưới## Cơ sở dữ liệu (SQLite)

ics>=0.7.2                  # iCalendar format

```3. Double-click vào sự kiện → Chỉnh sửa inline



### Optional (Statistics - chưa dùng)4. Bấm **"Sửa"** để lưu thay đổi- File DB: `database/events.db` tự tạo nếu chưa có.

- **Xóa 1 sự kiện**: Chọn sự kiện → Bấm **"Xóa"**- Reset DB (xóa dữ liệu): xoá file `database/events.db` khi ứng dụng đang tắt.

---

- **Xóa tất cả**: Bấm **"Xóa tất cả"** → Xác nhận 2 lần

## 🔧 Troubleshooting

## Nhập/Xuất JSON & ICS

### Lỗi Thường Gặp

### Xem Thống Kê

#### 1. `ModuleNotFoundError: No module named 'tkcalendar'`

```powershell1. Bấm **"📊 Xem thống kê"**- Xuất mặc định ra gốc dự án: `schedule_export.json`, `schedule_export.ics`.

# Kích hoạt venv và cài đặt lại

.\venv\Scripts\Activate.ps12. Chọn tab phân tích:- Nhập từ tệp do bạn chọn qua hộp thoại.

pip install -r requirements.txt

```   - 📊 Tổng quan- **Nhập JSON hỗ trợ 2 định dạng**:



#### 2. Database không tạo được   - ⏰ Thời gian    1. **Export format** (truyền thống): `{"event_name": "...", "start_time": "2025-11-10T18:00:00", ...}`

```powershell

# Kiểm tra quyền ghi trong thư mục database/   - 📍 Địa điểm    2. **Test case format** (MỚI): `{"input": "Họp nhóm 10h mai...", "expected": {...}}` - tự động parse qua NLP

# Xóa file events.db cũ nếu bị corrupt

Remove-Item database\events.db -Force   - 🏷️ Phân loại- Mapping chính:

python main.py  # Sẽ tạo lại tự động

```   - 📉 Xu hướng    - JSON export: `event_name`/`event` → `event_name`, `start_time` ISO bắt buộc, `location`, `reminder_minutes`.



#### 3. Underthesea NER không hoạt động3. Bấm **"📄 Xuất PDF"** hoặc **"📊 Xuất Excel"**    - JSON test case: `input` → parse qua NLP → event + start_time + location + reminder.

→ Không ảnh hưởng chức năng, app vẫn chạy với regex location detection### Import/Export- **Lưu ý**: Có thể nhập file test từ `./tests/` (như `test_cases.json`, `extended_test_cases_10000.json`).



#### 4. Venv có cấu trúc `bin/` thay vì `Scripts/`- **Export JSON**: Bấm **"Xuất JSON"** → `schedule_export.json`

```powershell

# Sử dụng đường dẫn bin/- **Export ICS**: Bấm **"Xuất ICS"** → `schedule_export.ics` (Google Calendar compatible)## Đóng gói (.exe) bằng PyInstaller

.\venv\bin\Activate.ps1

.\venv\bin\python.exe main.py- **Import**: Bấm **"Nhập JSON/ICS"** → Chọn file

 │

 ▼

 │
 ▼

### Database Operations

### Notification Service

---

## 📁 Cấu Trúc Dự Án

### Key Files Explained

| File | Purpose | Lines of Code |
|------|---------|---------------|
| `main.py` | GUI application with Tkinter | ~800 |
| `core_nlp/pipeline.py` | NLP processing logic | ~300 |
| `core_nlp/time_parser.py` | Vietnamese time parsing | ~400 |
| `database/db_manager.py` | Database operations | ~200 |
| `services/statistics_service.py` | Statistics & reporting | ~650 |
| `services/notification_service.py` | Reminder notifications | ~100 |
| `services/import_service.py` | Import JSON/ICS | ~150 |
| `services/export_service.py` | Export JSON/ICS | ~100 |

---

## 🗄️ Database Schema

### Table: `events`

```sql
CREATE TABLE IF NOT EXISTS events (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    event_name TEXT NOT NULL,
    start_time TEXT NOT NULL,        -- ISO 8601 format
    end_time TEXT,                    -- ISO 8601 format (optional)
    location TEXT,
    reminder_minutes INTEGER DEFAULT 0,
    status TEXT DEFAULT 'pending'     -- 'pending' or 'notified'
);

Macro-F1 Score: 0.9961
Precision: 0.9965
Recall: 0.9957

Component Breakdown:
- Event Name: 0.9980
- Time Parsing: 0.9970
- Location: 0.9945
- Reminder: 0.9950

dist/
└── TroLyLichTrinh0.6.1.exe    # 111.91 MB

WARNING: lib not found: torch.dll
WARNING: lib not found: api-ms-win-core-path-l1-1-0.dll
WARNING: Hidden import "scipy._distributor_init" not found

"Họp 10h UTC+7"        → Applies UTC+7
"Họp 10h sáng mai"     → No timezone (naive datetime)
"Họp múi giờ +07:00"   → Applies +07:00

dist/
   TroLyLichTrinhHybrid/
      TroLyLichTrinhHybrid.exe
      database/schema.sql
      models/phobert_finetuned/... (weights, tokenizer, config)
      lib/... (Python stdlib + deps)