Schema.org Structured Data Validator (schema-test)

[khoipro]

Mô tả

schema-test là Schema.org structured data validator — accuracy-matched tới validator.schema.org của Google. Fork từ schemacraft-validator.

Kiến trúc

• Node.js/TypeScript — Express server, CORS, CLI
• Docker — Multi-stage build, Node 20 Alpine

API Endpoints

Method	Path	Description
GET	/health	Health check
POST	/validate	Validate URL, raw HTML, or raw JSON-LD
POST	/validate/batch	Batch validate (max 100 URLs)

Test Coverage

• ✅ 203 tests (20 test files)
• ✅ 22 accuracy fixtures (100% match vs validator.schema.org)
• ✅ Docker build + healthcheck verified

Action Items

• Push Docker image lên registry (cần token write:packages)
• Setup deployment
• Tích hợp với Laravel app (qua HTTP API)
• Viết document cho team Engineer
• Setup CI/CD

References

• Repo: https://github.com/codetot-web/schema-test
• README: https://github.com/codetot-web/schema-test#readme

[khoipro]

✅ Hoàn thành

Tính năng đã implement

• Bearer token auth — Authorization: Bearer <token> cho API access
• CORS — configurable via --allowed-origins
• Docker — multi-stage build, healthcheck, docker-compose.yml
• CLI — check, check-json, serve commands

Deploy lên RunCloud (Node.js App)

# 1. SSH vào server RunCloud
# 2. Clone repo
cd ~/webapps/
git clone git@github.com:codetot-web/schema-test.git
cd schema-test

# 3. Install deps + build
npm ci
npm run build

# 4. Tạo .env (không commit)
echo "BEARER_TOKEN=<your-secret-token>" > .env

# 5. Chạy (RunCloud quản lý process)
node dist/cli.js serve --port 3001

# 6. Trên RunCloud UI: tạo Node.js App → domain + port 3001
#    Auto Nginx reverse proxy + SSL

Local dev

# Copy env, start
cp .env.example .env
# Sửa BEARER_TOKEN trong .env
docker compose up -d --build

# Test
curl -H "Authorization: Bearer <token>" http://localhost:3001/health

[khoipro]

📄 Internal docs updated

• Knowledgebase: ~/Workspaces/Knowledgebase/schema-test-internal.md
• Local token: dev-schema-token-123
• Local container: http://localhost:3001
• Covers: local dev, API reference, error codes, deploy to RunCloud, troubleshooting

Team Engineer có thể đọc và dùng ngay.