Skip to content

Nhóm 3 — Tài nguyên (Resources)

Registry tài nguyên fleet. Machine truth = config/fleet/registry.json.

3.1 Registry (SSoT)

  • File: config/fleet/registry.json — mọi site, machine-readable.
  • Schema fields: xem site_schema_fields trong file.
  • Backend: JSON bây giờ → Cloudflare D1 ở P5 (schema không đổi).
  • Sửa registry: qua sitectl register hoặc edit trực tiếp + sitectl validate.

3.2 Credential vault

  • File: /Users/phuongnam/02.AI/NP_AI_macos/.env (SSoT, không hardcode).
  • Per-site prefix SITE_<SLUG>__* (xem ROLES.md §2.2).
  • Manifest: config/CREDENTIAL_MANIFEST.md (liệt kê key cần cho mỗi site).

3.3 Repo / code path

SiteRepoEntry
phamducphuongnam.com/Users/phuongnam/02.AI/NP_AI_macos/8.P8_SEO_Cleanscripts/p8ctl.py run
phamducphuongnam.com theme8.P8_SEO_Clean_gitops (repo khác)GitHub Actions SSH
nampham.net/Users/phuongnam/02.AI/NP_AI_macos/12.CMS/nampham-cmsnpm run deploy
docs.nampham.net (P2)8.P8_SEO_Clean/docs-fleetVitePress build + CF Pages
oee.nampham.net12.CMS/nampham-cms/webapp-oeeCF Pages
fleet.nampham.net12.CMS/nampham-cms/webappCF Pages

3.4 KPI sources

  • Mỗi public site: kpi_source = GSC property URL trong site.json.
  • Aggregate: artifacts/analytics/fleet_kpi-latest.json (nightly cron P3).
  • Bot: /report đã show cả 2 site (SDA profile).

3.5 Docs surfaces

  • Fleet-level: docs/fleet/* (5 nhóm) + docs/FLEET_GOVERNANCE_ROADMAP.md + docs/ECOSYSTEM_MAP.md.
  • Per-site: giữ SSoT riêng (P8: WORKFLOW.md, ENTITY_SCHEMA_ROADMAP.md; NM: ../docs/SITE_DEV_AGENT_*).
  • Control plane (P2): https://docs.nampham.net render từ registry + mesh + KPI.