Skip to content

Nhóm 1 — Quy trình (Process)

SSoT quy trình vận hành fleet. 4 giai đoạn tuần tự, lặp lại per-site.

1.1 Đăng ký site (register)

  1. Tạo factory/sites/<slug>/blueprint.yaml (copy factory/blueprint.yaml template, điền).
  2. python3 factory/sitectl.py register factory/sites/<slug>/blueprint.yaml → thêm vào config/fleet/registry.json + scaffold folder.
  3. Tạo factory/sites/<slug>/entity.json (xem MESH.md).
  4. sitectl sync → aggregate entity_mesh.json.
  5. sitectl validate → 0 issue mới.

1.2 Onboarding site mới (onboard)

  1. Áp dụng NEW_SITE_ADAPTATION_GUIDE.md (adapt author/persona/cluster).
  2. Điền credential theo prefix SITE_<SLUG>__* trong .env (xem ROLES.md §credential).
  3. Verify GSC property + add SA siteOwner (xem AGENTS.md GSC gotcha).
  4. Đăng ký vào Telegram bot nếu cần daily report (SDA profile).

1.3 Vận hành hằng ngày (operate)

  • Giữ tier framework (ROLES.md): Tier1 auto, Tier2 approve.
  • Per-site pipeline giữ nguyên: WP site → 4-gate p8ctl.py; Hono site → CMS API + nampham_auto_optimizer.py.
  • Cron + bot đã có (SDA profile) — không tạo cron mới trừ khi registry.json thêm site.

1.4 Audit định kỳ (audit)

  • Weekly: sitectl validate (mesh integrity) + GSC pull all-site.
  • Monthly: docs consistency check (REFERENCES.md §consistency) + KPI review vs artifacts/analytics/fleet_kpi-latest.json.
  • On entity change: re-verify live JSON-LD parse (Rich Results Test) + update entity.json verified_at.

1.5 Escalation

  • Worker bí → orchestrator. Orchestrator thấy rủi ro phá dữ liệu → hỏi anh Nam 1 lần (AGENTS.md Orchestrator Credential Rule).