Phase 8 Complete: Sync Audit Log + Frontend Integration

- Thêm audit/sync_audit.py: Ghi lịch sử sync vào audit/sync_log.json
- Thêm API endpoints: /sync/history, /sync/history/{run_id}
- Frontend: Nút 'Lịch sử đồng bộ' + panel expand chi tiết từng file
- Sửa frontend served từ backend (http://localhost:8000)
- Cập nhật DEPLOYMENT_GUIDE với hướng dẫn chạy localhost
- Cập nhật ARCHITECTURE_MAP: Phase 8 hoàn thành

doc/00.AGENT_ARCHITECTURE_MAP.md

@@ -38,8 +38,9 @@ SharePoint → Ingestion → DCE → [OCR/Extract/Skip] → Chunking → OpenSea
 - **LLM Factory:** `chat/llm_factory.py` → Hỗ trợ Gemini, Groq, Local (config trong `.env`).
 
 ### E. Tầng API & Frontend
-- **Backend:** `api/main.py` → FastAPI tại port 8000. Endpoint: `/health`, `/auth/login` (SSO), `/auth/callback`, `/auth/login-email`, `/chat`, `/sync`, `/sync/status`.
-- **Frontend:** `frontend/` → Glassmorphism UI với SSO login + email fallback + sync button. Gọi `http://localhost:8000`.
+- **Backend:** `api/main.py` → FastAPI tại port 8000. Endpoint: `/health`, `/auth/login` (SSO), `/auth/callback`, `/auth/login-email`, `/chat`, `/sync`, `/sync/status`, `/sync/history`, `/sync/history/{run_id}`.
+- **Frontend:** `frontend/` → Glassmorphism UI với SSO login + email fallback + sync button + sync history panel. Gọi `http://localhost:8000`.
+- **Audit:** `audit/sync_audit.py` → Lưu lịch sử sync vào `audit/sync_log.json`.
 
 ### F. Tầng Cấu hình (Decoupled Configuration)
 - Toàn bộ thông số trong `.env`. Load qua `core/config.py`.
@@ -83,6 +84,9 @@ SharePoint → Ingestion → DCE → [OCR/Extract/Skip] → Chunking → OpenSea
 │       └── local_llm.py
 ├── 📁 api/
 │   └── main.py                # 🚀 FastAPI Backend (port 8000)
+├── 📁 audit/
+│   ├── sync_audit.py          # 📋 Sync audit logging (ghi lịch sử sync)
+│   └── sync_log.json          # 📄 Audit log data
 ├── 📁 frontend/
 │   ├── index.html             # 🎨 Glassmorphism UI (Login + Chat + Sync)
 │   ├── app.js                 # 💬 Chat, Auth, Sync logic
@@ -175,12 +179,10 @@ SharePoint → Ingestion → DCE → [OCR/Extract/Skip] → Chunking → OpenSea
 - [x] Auth UI: Simple email login + SSO Azure AD + user context cho API calls
 - [x] DOCX Text Extraction: python-docx (paragraphs + tables)
 - [x] XLSX Text Extraction: openpyxl (sheets + cells)
+- [x] Sync Audit: Lịch sử sync persist vào file + API + Frontend panel
 
 ### Chưa triển khai (Phase 9 - Production Ready)
 
-#### Ưu tiên trung bình
-- [ ] **Cấu hình Azure AD cho SSO:** Thêm Redirect URI `http://localhost:8000/auth/callback` và bật "ID tokens" trong App Registration.
-
 #### Ưu tiên thấp
 - [ ] **Monitoring Dashboard:** Health metrics, ingestion status, OCR success rate.
 - [ ] **Multi-tenant:** Hỗ trợ nhiều SharePoint site/tenant.

doc/DEPLOYMENT_GUIDE.md

@@ -4,6 +4,42 @@
 
 ---
 
+## 0. Chạy hệ thống trên Localhost
+
+### Yêu cầu
+- Python 3.10+ với venv đã cài dependencies
+- Docker (cho OpenSearch)
+- Azure AD App Registration đã cấu hình
+
+### Các bước khởi động
+
+```bash
+# 1. Khởi động OpenSearch
+docker-compose up -d opensearch
+
+# 2. Khởi động Backend (serves cả API + Frontend)
+source venv/bin/activate
+python3 api/main.py
+
+# 3. Mở trình duyệt
+# http://localhost:8000
+```
+
+### Truy cập
+
+| URL | Mô tả |
+|-----|-------|
+| `http://localhost:8000` | Frontend (Login + Chat) |
+| `http://localhost:8000/docs` | Swagger API Documentation |
+| `http://localhost:8000/health` | Health check |
+| `http://localhost:8000/auth/login` | SSO Azure AD redirect |
+
+### Đăng nhập
+- **SSO:** Bấm "Đăng nhập Microsoft SSO" → đăng nhập bằng tài khoản Microsoft 365
+- **Email:** Nhập email bất kỳ (fallback, không cần password)
+
+---
+
 ## 1. Cấu hình Azure AD App Registration (MANUAL)
 
 ### 1.1 Tạo App Registration (nếu chưa có)
@@ -36,13 +72,13 @@
 4. Bấm **Add permissions**
 5. **Quan trọng:** Bấm **Grant admin consent for [tenant]** → Confirm
 
-### 1.4 Cấu hình Redirect URI cho SSO (khi cần login)
+### 1.4 Cấu hình Redirect URI cho SSO ✅ ĐÃ CẤU HÌNH
 
 1. App Registration → **Authentication** → **Add a platform** → **Web**
 2. Nhập Redirect URI:
-   - **PoC (localhost):** `http://localhost:8000/auth/callback`
-   - **Production:** `https://your-domain.com/auth/callback`
-3. Tích chọn: ✅ **ID tokens** (implicit grant)
+   - **PoC (localhost):** `http://localhost:8000/auth/callback` ✅
+   - **Production:** `https://your-domain.com/auth/callback` (thêm khi có domain)
+3. Tích chọn: ✅ **ID tokens** (implicit grant) ✅
 4. Bấm **Save**
 
 ### 1.5 Kiểm tra Token Claims
@@ -350,9 +386,11 @@ curl -X POST http://localhost:8000/chat \
 
 ## 7. Checklist trước khi Production
 
-- [ ] Azure AD App Registration đã cấu hình đúng permissions
-- [ ] Client Secret còn hạn sử dụng
-- [ ] Redirect URI đã thêm cho production domain
+- [x] Azure AD App Registration đã cấu hình đúng permissions
+- [x] Client Secret còn hạn sử dụng
+- [x] Redirect URI đã thêm cho localhost (`http://localhost:8000/auth/callback`)
+- [x] ID tokens đã bật (implicit grant)
+- [ ] Redirect URI cho production domain (khi có domain thật)
 - [ ] OpenSearch đã đổi password mặc định
 - [ ] SSL certificate đã cài đặt
 - [ ] CORS đã giới hạn origins