# MKT X/Twitter Service - Documentation
## Tài Liệu Dịch Vụ Twitter Marketing

---

## English Documentation

| Document | Description | Link |
|----------|-------------|------|
| **README** | Service overview, quick start, features | [../README.md](../README.md) |
| **Architecture** | System architecture, domain model, components | [en/ARCHITECTURE.md](en/ARCHITECTURE.md) |
| **API Reference** | Complete API documentation with examples | [en/API.md](en/API.md) |
| **Twitter Setup** | Step-by-step Twitter API integration guide | [en/TWITTER_SETUP.md](en/TWITTER_SETUP.md) |

---

## Tài Liệu Tiếng Việt

| Tài Liệu | Mô Tả | Link |
|----------|-------|------|
| **README** | Tổng quan dịch vụ, hướng dẫn nhanh | [../README.md](../README.md) |
| **Kiến Trúc** | Kiến trúc hệ thống, mô hình domain | [vi/KIEN-TRUC.md](vi/KIEN-TRUC.md) |
| **Thiết Lập Twitter** | Hướng dẫn tích hợp Twitter API | [vi/CAI-DAT-TWITTER.md](vi/CAI-DAT-TWITTER.md) |

---

## Quick Links / Liên Kết Nhanh

### Getting Started / Bắt Đầu
- [Quick Start Guide](../README.md#quick-start) / [Hướng Dẫn Nhanh](../README.md#bắt-đầu-nhanh)
- [Prerequisites](../README.md#prerequisites) / [Yêu Cầu](../README.md#yêu-cầu)

### Architecture / Kiến Trúc
- [System Overview](en/ARCHITECTURE.md#system-architecture) / [Tổng Quan Hệ Thống](vi/KIEN-TRUC.md#kiến-trúc-hệ-thống)
- [Domain Model](en/ARCHITECTURE.md#domain-model) / [Mô Hình Domain](vi/KIEN-TRUC.md#mô-hình-domain)
- [Integration](en/ARCHITECTURE.md#integration-architecture) / [Tích Hợp](vi/KIEN-TRUC.md#kiến-trúc-tích-hợp)

### API / API
- [API Overview](en/API.md#api-overview)
- [Account Management](en/API.md#account-management) / [Quản Lý Tài Khoản](en/API.md#account-management)
- [Contacts](en/API.md#contact-management) / [Liên Hệ](en/API.md#contact-management)
- [Campaigns](en/API.md#campaign-management) / [Chiến Dịch](en/API.md#campaign-management)

### Setup / Thiết Lập
- [Twitter API Setup](en/TWITTER_SETUP.md) / [Thiết Lập Twitter API](vi/CAI-DAT-TWITTER.md)
- [Configuration](../README.md#configuration) / [Cấu Hình](../README.md#cấu-hình)
- [Deployment](../README.md#development) / [Triển Khai](../README.md#phát-triển)

---

## Service Features / Tính Năng Dịch Vụ

### 1. CHATBOT Automation Messenger

**EN**: Template-based messaging with workflows and scheduling
- Message template library
- Visual workflow designer
- Event-triggered messaging
- Campaign scheduling
- A/B testing

**VI**: Gửi tin nhắn dựa trên mẫu với workflows và lịch trình
- Thư viện mẫu tin nhắn
- Thiết kế workflow trực quan
- Tin nhắn kích hoạt sự kiện
- Lịch chiến dịch
- Kiểm thử A/B

### 2. CHATBOT AI Messenger

**EN**: AI-powered conversationsusing OpenAI
- Natural language understanding
- Intent detection
- Context-aware responses
- Auto escalation to human

**VI**: Trò chuyện được hỗ trợ AI dùng OpenAI
- Hiểu ngôn ngữ tự nhiên
- Phát hiện ý định
- Phản hồi theo ngữ cảnh
- Tự động chuyển cho người

### 3. Customer Management

**EN**: Complete CRM for Twitter contacts
- Contact profiles
- Segmentation
- Engagement analytics
- GDPR compliance

**VI**: CRM hoàn chỉnh cho liên hệ Twitter
- Hồ sơ liên hệ
- Phân khúc
- Phân tích tương tác
- Tuân thủ GDPR

---

## API Endpoints Overview

```
Base URL: /api/v1/mkt-x

# Accounts / Tài Khoản
POST   /accounts              # Connect Twitter / Kết nối Twitter
GET    /accounts              # List / Danh sách
DELETE /accounts/{id}         # Disconnect / Ngắt kết nối

# Contacts / Liên Hệ  
GET    /contacts              # List / Danh sách
POST   /contacts/{id}/tags    # Add tags / Thêm nhãn

# Conversations / Hội Thoại
GET    /conversations         # List / Danh sách
POST   /conversations/{id}/messages # Send / Gửi tin nhắn

# Campaigns / Chiến Dịch
POST   /campaigns             # Create / Tạo
POST   /campaigns/{id}/start  # Start / Bắt đầu

# Automation / Tự Động Hóa
POST   /automation/flows      # Create flow / Tạo workflow

# AI Chatbot
POST   /ai/conversations/{id}/message # AI chat

# Analytics / Phân Tích
GET    /analytics/overview    # Dashboard / Bảng điều khiển
```

**Full documentation** / **Tài liệu đầy đủ**: [en/API.md](en/API.md)

---

## Technology Stack / Công Nghệ

| Component | Technology | Version |
|-----------|-----------|---------|
| **Runtime** | .NET | 8.0+ |
| **Framework** | ASP.NET Core | 8.0+ |
| **Database** | PostgreSQL | 15+ |
| **Cache** | Redis | 7+ |
| **Message Broker** | RabbitMQ | 3.12+ |
| **Mediator** | MediatR | 12+ |

---

## External Dependencies / Dependencies Bên Ngoài

### Required / Bắt Buộc
- **Twitter API v2** - Direct Messages, Account Activity API
- **PostgreSQL** - Primary database
- **Redis** - Caching
- **RabbitMQ** - Message broker

### Optional / Tùy Chọn
- **OpenAI API** - AI chatbot features / Tính năng chatbot AI
- **Prometheus + Grafana** - Monitoring / Giám sát
- **Loki** - Logging / Ghi log

---

## Development Workflow / Quy Trình Phát Triển

### 1. Setup / Thiết Lập

```bash
# Restore dependencies / Cài dependencies
dotnet restore

# Setup database / Thiết lập database
dotnet ef database update --project src/MktXService.Infrastructure
```

### 2. Development / Phát Triển

```bash
# Run locally / Chạy local
dotnet run --project src/MktXService.API

# Run tests / Chạy tests
dotnet test
```

### 3. Deployment / Triển Khai

```bash
# Docker build
docker-compose build mkt-x-service-net

# Deploy / Triển khai
docker-compose up -d mkt-x-service-net
```

---

## Support / Hỗ Trợ

### For Developers / Dành Cho Lập Trình Viên

- **Quick Start**: [README.md#quick-start](../README.md#quick-start)
- **API Questions**: [en/API.md](en/API.md)
- **Architecture**: [en/ARCHITECTURE.md](en/ARCHITECTURE.md)

### Issues / Vấn Đề

1. Check documentation / Kiểm tra tài liệu
2. Check logs / Kiểm tra logs: `docker-compose logs -f mkt-x-service-net`
3. Health check: `curl http://localhost:5000/health`
4. Contact support / Liên hệ hỗ trợ: api-support@goodgo.com

---

## Related Services / Dịch Vụ Liên Quan

- [MKT Facebook Service](../../mkt-facebook-service-net/docs)
- [MKT Zalo Service](../../mkt-zalo-service-net/docs)
- [MKT WhatsApp Service](../../mkt-whatsapp-service-net/docs)

---

**Last Updated**: 2026-01-18  
**Maintained by**: GoodGo Platform Team
