docs: dịch 22 file Markdown còn lại sang tiếng Việt có dấu (TEC-2881)
Some checks failed
CI / Lint → Typecheck → Test → Build (22) (push) Failing after 18s
CI / E2E Tests (push) Has been skipped
CodeQL Analysis / CodeQL (javascript-typescript) (push) Failing after 2m15s
Deploy / Build API Image (push) Failing after 28s
Deploy / Build Web Image (push) Failing after 16s
Deploy / Build AI Services Image (push) Failing after 17s
E2E Tests / Playwright E2E (push) Failing after 31s
Security Scanning / Dependency Audit (pnpm) (push) Failing after 3s
Security Scanning / Trivy Scan — API Image (push) Failing after 1m46s
Security Scanning / Trivy Scan — Web Image (push) Failing after 1m7s
Security Scanning / Trivy Scan — AI Services Image (push) Failing after 53s
Security Scanning / Trivy Filesystem Scan (push) Failing after 35s
Deploy / Deploy to Staging (push) Has been skipped
Deploy / Smoke Test Staging (push) Has been skipped
Deploy / Deploy to Production (push) Has been skipped
Deploy / Smoke Test Production (push) Has been skipped
Security Scanning / Security Gate (push) Failing after 0s
Deploy / Rollback Staging (push) Has been skipped
Deploy / Rollback Production (push) Has been skipped
Some checks failed
CI / Lint → Typecheck → Test → Build (22) (push) Failing after 18s
CI / E2E Tests (push) Has been skipped
CodeQL Analysis / CodeQL (javascript-typescript) (push) Failing after 2m15s
Deploy / Build API Image (push) Failing after 28s
Deploy / Build Web Image (push) Failing after 16s
Deploy / Build AI Services Image (push) Failing after 17s
E2E Tests / Playwright E2E (push) Failing after 31s
Security Scanning / Dependency Audit (pnpm) (push) Failing after 3s
Security Scanning / Trivy Scan — API Image (push) Failing after 1m46s
Security Scanning / Trivy Scan — Web Image (push) Failing after 1m7s
Security Scanning / Trivy Scan — AI Services Image (push) Failing after 53s
Security Scanning / Trivy Filesystem Scan (push) Failing after 35s
Deploy / Deploy to Staging (push) Has been skipped
Deploy / Smoke Test Staging (push) Has been skipped
Deploy / Deploy to Production (push) Has been skipped
Deploy / Smoke Test Production (push) Has been skipped
Security Scanning / Security Gate (push) Failing after 0s
Deploy / Rollback Staging (push) Has been skipped
Deploy / Rollback Production (push) Has been skipped
Hoàn tất đợt cuối của nhiệm vụ chuyển toàn bộ tài liệu sang tiếng Việt. Đã dịch 22 file `.md` còn sót (~9.7k dòng) — gồm RUNBOOK, audits, docs/architecture, docs/load-testing, libs READMEs và các quick references. Giữ nguyên code blocks, đường dẫn, identifier kỹ thuật, URL và biến môi trường. Co-Authored-By: Paperclip <noreply@paperclip.ing>
This commit is contained in:
@@ -1,22 +1,22 @@
|
||||
# @goodgo/ai-services
|
||||
|
||||
Python FastAPI AI/ML microservice for the GoodGo Platform.
|
||||
Microservice AI/ML viết bằng Python FastAPI cho GoodGo Platform.
|
||||
|
||||
## Services
|
||||
## Các dịch vụ
|
||||
|
||||
| Service | Router | Description |
|
||||
| Dịch vụ | Router | Mô tả |
|
||||
|---------|--------|-------------|
|
||||
| **AVM** | `/avm` | Automated Valuation Model — XGBoost-based property price predictions |
|
||||
| **Moderation** | `/moderation` | Content moderation for listings (text + image analysis) |
|
||||
| **NLP** | `/nlp` | Vietnamese NLP — feature extraction, search query understanding |
|
||||
| **AVM** | `/avm` | Mô hình định giá tự động — dự đoán giá bất động sản dựa trên XGBoost |
|
||||
| **Moderation** | `/moderation` | Kiểm duyệt nội dung tin đăng (phân tích văn bản + hình ảnh) |
|
||||
| **NLP** | `/nlp` | NLP tiếng Việt — trích xuất đặc trưng, hiểu truy vấn tìm kiếm |
|
||||
|
||||
## Tech Stack
|
||||
|
||||
- **Python** 3.12+
|
||||
- **FastAPI** 0.115 + Uvicorn
|
||||
- **XGBoost** 2.1 (property valuation model)
|
||||
- **Underthesea** 6.8 (Vietnamese NLP tokenizer)
|
||||
- **Pydantic** 2.9 (request/response schemas)
|
||||
- **XGBoost** 2.1 (mô hình định giá bất động sản)
|
||||
- **Underthesea** 6.8 (tokenizer NLP tiếng Việt)
|
||||
- **Pydantic** 2.9 (schema request/response)
|
||||
|
||||
## Quick Start
|
||||
|
||||
@@ -30,7 +30,7 @@ pip install -e ".[dev]"
|
||||
uvicorn app.main:app --reload --port 8000
|
||||
```
|
||||
|
||||
## Project Structure
|
||||
## Cấu trúc dự án
|
||||
|
||||
```
|
||||
libs/ai-services/
|
||||
@@ -55,7 +55,7 @@ libs/ai-services/
|
||||
└── pyproject.toml # Dependencies and config
|
||||
```
|
||||
|
||||
## Testing
|
||||
## Test
|
||||
|
||||
```bash
|
||||
cd libs/ai-services
|
||||
|
||||
@@ -1,23 +1,23 @@
|
||||
# @goodgo/mcp-servers
|
||||
|
||||
MCP (Model Context Protocol) tool server library for the GoodGo Platform. Provides structured tools that AI assistants can use to query property data, run analytics, and perform valuations.
|
||||
Thư viện tool server MCP (Model Context Protocol) cho GoodGo Platform. Cung cấp các công cụ có cấu trúc để trợ lý AI có thể truy vấn dữ liệu bất động sản, chạy phân tích và thực hiện định giá.
|
||||
|
||||
## Tool Servers
|
||||
|
||||
| Server | Path | Description |
|
||||
| Server | Đường dẫn | Mô tả |
|
||||
|--------|------|-------------|
|
||||
| **Property Search** | `property-search/` | Geo search, full-text search, filter by type/price/area |
|
||||
| **Market Analytics** | `market-analytics/` | Price trends, heatmaps, district comparisons |
|
||||
| **Valuation** | `valuation/` | AVM property valuation requests |
|
||||
| **Property Search** | `property-search/` | Tìm kiếm theo vị trí địa lý, full-text search, lọc theo loại/giá/diện tích |
|
||||
| **Market Analytics** | `market-analytics/` | Xu hướng giá, heatmap, so sánh giữa các quận |
|
||||
| **Valuation** | `valuation/` | Yêu cầu định giá bất động sản qua AVM |
|
||||
|
||||
## Tech Stack
|
||||
|
||||
- **TypeScript** 6+
|
||||
- **@modelcontextprotocol/sdk** 1.12 (MCP protocol implementation)
|
||||
- **Zod** 3.24 (schema validation)
|
||||
- **NestJS** integration module (optional peer dependency)
|
||||
- **@modelcontextprotocol/sdk** 1.12 (triển khai giao thức MCP)
|
||||
- **Zod** 3.24 (kiểm tra schema)
|
||||
- **NestJS** module tích hợp (peer dependency tuỳ chọn)
|
||||
|
||||
## Project Structure
|
||||
## Cấu trúc dự án
|
||||
|
||||
```
|
||||
libs/mcp-servers/
|
||||
@@ -33,21 +33,21 @@ libs/mcp-servers/
|
||||
└── tsconfig.json
|
||||
```
|
||||
|
||||
## Usage
|
||||
## Cách dùng
|
||||
|
||||
```typescript
|
||||
import { PropertySearchServer, MarketAnalyticsServer } from '@goodgo/mcp-servers';
|
||||
```
|
||||
|
||||
The MCP endpoints are exposed via the API's `apps/api/src/modules/mcp/` module.
|
||||
Các endpoint MCP được expose qua module `apps/api/src/modules/mcp/` của API.
|
||||
|
||||
## Building
|
||||
## Build
|
||||
|
||||
```bash
|
||||
pnpm --filter @goodgo/mcp-servers build
|
||||
```
|
||||
|
||||
## Testing
|
||||
## Test
|
||||
|
||||
```bash
|
||||
pnpm --filter @goodgo/mcp-servers test
|
||||
|
||||
Reference in New Issue
Block a user