# Mobile App - Worker (EuroTile & Vasta Stone)

## 📱 Giới thiệu Dự Án

**Mobile App - Worker** là một ứng dụng mobile-first được thiết kế dành cho thầu thợ, đại lý phân phối, kiến trúc sư và môi giới trong ngành gạch men, nội thất và xây dựng. Ứng dụng kết hợp chương trình khách hàng thân thiết (Loyalty) với công cụ đặt hàng và quản lý công việc tiện lợi.

### 🎯 Mục tiêu chính:
- Nền tảng Loyalty mạnh mẽ với hệ thống điểm thưởng và hạng thành viên
- Công cụ đặt hàng nhanh chóng và hiệu quả
- Quản lý công trình, hợp đồng và báo cáo
- Tích hợp chương trình khuyến mãi và ưu đãi

### 👥 Đối tượng người dùng:
- Thầu thợ
- Kiến trúc sư  
- Đại lý phân phối
- Môi giới bất động sản

## 🚀 Tính năng đã hoàn thành

### ✅ Luồng Đăng nhập & Đăng ký
- `login.html` - Màn hình đăng nhập với số điện thoại
- `otp.html` - Xác thực OTP 6 số
- `register.html` - Đăng ký tài khoản mới với đầy đủ thông tin

### ✅ Trang chủ với 3 hạng thẻ thành viên
- `index.html` - Trang chủ mặc định (thẻ Diamond)
- Hiển thị thông tin thành viên, QR code và các chức năng chính
- Các mục sản phẩm, loyalty, đơn hàng được tổ chức rõ ràng

### ✅ Hệ thống Loyalty đầy đủ
- `loyalty.html` - Trang hội viên thân thiết với progress bar
- `loyalty-rewards.html` - Danh sách quà tặng có thể đổi
- `points-history.html` - **MỚI** - Lịch sử tích điểm chi tiết với khiếu nại
- `referral.html` - **MỚI** - Giới thiệu bạn bè với link và mã giới thiệu
- `my-gifts.html` - **MỚI** - Quà đã đổi với bộ lọc trạng thái

### ✅ Quản lý Sản phẩm & Đơn hàng
- `products.html` - Danh sách sản phẩm với tìm kiếm và bộ lọc
- `cart.html` - Giỏ hàng với tính năng chỉnh sửa
- `checkout.html` - Thanh toán với thông tin giao hàng
- `order-success.html` - Xác nhận đặt hàng thành công
- `orders.html` - **MỚI** - Danh sách đơn hàng với tabs lọc trạng thái
- `payments.html` - **MỚI** - Danh sách thanh toán với trạng thái xử lý

### ✅ Quản lý Công việc & Dự án
- `projects.html` - **MỚI** - Danh sách công trình với tiến độ
- `project-create.html` - **MỚI** - Form tạo công trình mới
- `quotes.html` - **MỚI** - Danh sách báo giá với trạng thái
- `chat.html` - **MỚI** - Hệ thống chat hỗ trợ khách hàng

### ✅ Quản lý Tài khoản
- `account.html` - Trang tài khoản với menu điều hướng (đã cập nhật links)
- `profile-edit.html` - **MỚI** - Chỉnh sửa thông tin cá nhân với avatar
- `addresses.html` - **MỚI** - Quản lý địa chỉ giao hàng
- `password-change.html` - **MỚI** - Đổi mật khẩu với bảo mật

### ✅ Khuyến mãi & Thông báo
- `promotions.html` - Danh sách chương trình khuyến mãi
- `notifications.html` - Thông báo với tabs chung/đơn hàng

## 🎨 Design System & UI/UX

### Bảng màu chính:
- **Primary Blue**: #005B9A (Màu chủ đạo)
- **Light Blue**: #38B6FF (Màu nhấn)
- **Accent Cyan**: #35C6F4 (FAB & highlights)
- **Success**: #28a745 | **Warning**: #ffc107 | **Danger**: #dc3545

### Thành phần UI:
- **Mobile-first responsive design** với Tailwind CSS
- **Card-based layout** với đổ bóng tinh tế
- **Bottom navigation** cố định 5 tabs
- **Floating Action Button** (FAB) cho chat
- **Status indicators** màu sắc trực quan
- **Form validation** và UX thân thiện

## 📁 Cấu trúc File Hoàn chỉnh

```
/
├── index.html                  # Trang chủ (Diamond member)
├── login.html                  # Đăng nhập
├── otp.html                    # Xác thực OTP
├── register.html               # Đăng ký
│
├── loyalty.html                # Hội viên thân thiết (đã cập nhật)
├── loyalty-rewards.html        # Đổi quà tặng
├── points-history.html         # ⭐ MỚI: Lịch sử điểm
├── referral.html               # ⭐ MỚI: Giới thiệu bạn bè
├── my-gifts.html               # ⭐ MỚI: Quà của tôi
│
├── products.html               # Danh sách sản phẩm
├── cart.html                   # Giỏ hàng
├── checkout.html               # Thanh toán
├── order-success.html          # Đặt hàng thành công
├── orders.html                 # ⭐ MỚI: Quản lý đơn hàng
├── payments.html               # ⭐ MỚI: Danh sách thanh toán
│
├── projects.html               # ⭐ MỚI: Quản lý công trình
├── project-create.html         # ⭐ MỚI: Tạo công trình mới
├── quotes.html                 # ⭐ MỚI: Danh sách báo giá
├── chat.html                   # ⭐ MỚI: Chat hỗ trợ
│
├── account.html                # Tài khoản (đã cập nhật links)
├── profile-edit.html           # ⭐ MỚI: Sửa thông tin cá nhân
├── addresses.html              # ⭐ MỚI: Địa chỉ đã lưu
├── password-change.html        # ⭐ MỚI: Đổi mật khẩu
│
├── promotions.html             # Khuyến mãi
├── notifications.html          # Thông báo
│
└── assets/
    └── css/
        └── style.css           # CSS đầy đủ với tất cả components
```

## 🔧 Công nghệ sử dụng

- **HTML5 & CSS3**: Semantic markup và modern styling
- **Tailwind CSS**: Utility-first CSS framework via CDN
- **JavaScript ES6+**: Interactive functionality và form validation
- **Font Awesome 6**: Icon system đồng nhất
- **Google Fonts**: Roboto font family
- **Responsive Images**: Placeholder và optimized assets

## 📱 Tính năng mới đã hoàn thành

### 🎯 Lịch sử điểm (points-history.html)
- Danh sách chi tiết các giao dịch điểm
- Nút "Khiếu nại" cho từng giao dịch
- Hiển thị thay đổi điểm (+/-) và điểm mới
- Bộ lọc theo thời gian

### 🤝 Giới thiệu bạn bè (referral.html)
- Thông tin người giới thiệu với avatar
- Link và mã giới thiệu có thể copy/share
- Danh sách quyền lợi và hướng dẫn sử dụng
- Tích hợp Web Share API

### 💰 Quản lý thanh toán (payments.html)
- Cards hiển thị thông tin thanh toán chi tiết
- Trạng thái với màu sắc: Đang xử lý (blue), Hoàn thành (green)
- Tìm kiếm theo mã phiếu thanh toán
- Bộ lọc nâng cao

### 📦 Quản lý đơn hàng (orders.html)
- Tabs lọc theo trạng thái đơn hàng
- Hiển thị thông tin khách hàng và sản phẩm
- Trạng thái trực quan: Chờ xác nhận, Đang xử lý, Đang giao, Hoàn thành, Đã hủy
- Tìm kiếm theo mã đơn hàng

### 🏗️ Quản lý công trình (projects.html & project-create.html)
- Danh sách công trình với tiến độ %
- Thông tin chi tiết: Chủ đầu tư, địa chỉ, thời gian
- Form tạo mới với validation đầy đủ
- Trạng thái: Đang thi công, Hoàn thành, Lên kế hoạch

### 💬 Chat hỗ trợ (chat.html)
- Interface chat thời gian thực
- Bubble messages với timestamp
- Typing indicator animation
- Nút đính kèm file và gửi tin nhắn
- Auto-scroll và responsive design

### 🎁 Quà của tôi (my-gifts.html)
- Tabs lọc: Còn hạn, Đã sử dụng, Hết hạn
- Thông tin chi tiết voucher/quà tặng
- Trạng thái trực quan với màu sắc
- Nút sử dụng/xem chi tiết

### 👤 Quản lý tài khoản nâng cao
- **Profile Edit**: Upload avatar, form validation, các trường thông tin đầy đủ
- **Addresses**: CRUD địa chỉ, đặt mặc định, validation
- **Password Change**: Form đổi mật khẩu an toàn với toggle show/hide, validation match

## 🎨 CSS Components mới

- `.payment-card`, `.order-card`, `.quote-card`, `.project-card` - Card components
- `.gift-item` - Gift/voucher display với status styling
- `.chat-*` - Complete chat interface styling
- `.referral-*` - Referral page components
- `.form-*` - Enhanced form styling với validation states
- `.address-*` - Address management components
- `.password-*` - Password input với toggle visibility

## 🚀 Các tính năng đã tích hợp

### Interactivity & UX:
- ✅ Form validation với HTML5 và JavaScript
- ✅ Dynamic tab switching và filtering
- ✅ Copy to clipboard functionality
- ✅ Web Share API integration
- ✅ File upload với preview (avatar)
- ✅ Password visibility toggle
- ✅ Real-time chat simulation
- ✅ Responsive navigation với active states

### Performance & Accessibility:
- ✅ Mobile-first responsive design
- ✅ Fast loading với CDN assets
- ✅ Semantic HTML structure
- ✅ ARIA labels và accessibility support
- ✅ Optimized images và placeholders

## 📋 Roadmap & Tính năng tiếp theo

### Phase 2 - Backend Integration:
- [ ] API integration cho tất cả CRUD operations
- [ ] Real-time notifications với WebSocket
- [ ] Push notifications
- [ ] Offline capability với Service Workers

### Phase 3 - Advanced Features:
- [ ] QR code scanner cho sản phẩm
- [ ] Geolocation cho cửa hàng gần nhất
- [ ] Photo gallery cho công trình
- [ ] Export báo cáo PDF
- [ ] Multi-language support

## 📞 Hỗ trợ

**Developed by**: EuroTile Development Team  
**Framework**: Mobile-first HTML/CSS/JS  
**Browser Support**: Modern browsers (Chrome, Safari, Firefox, Edge)  
**Mobile**: iOS Safari, Android Chrome  

---

**Trạng thái dự án**: ✅ **HOÀN THÀNH PHASE 1**  
**Tổng số màn hình**: 25+ screens  
**Tính năng chính**: 100% functional prototypes  
**UI/UX**: Full mobile-optimized design system