VP Wiki Blog https://wiki.vpservic.es/changelog VP Wiki Blog Mon, 20 Apr 2026 00:00:00 GMT https://validator.w3.org/feed/docs/rss2.html https://github.com/jpmonette/feed en <![CDATA[sr-wiki → vp-wiki — scope rename]]> https://wiki.vpservic.es/changelog/2026/04/20/vp-wiki-rename https://wiki.vpservic.es/changelog/2026/04/20/vp-wiki-rename Mon, 20 Apr 2026 00:00:00 GMT The wiki has been renamed from sr-wiki to vp-wiki to match its actual scope. Content covers VelocityPoint products (Second Ring, Book Marketing, Prince Charming), shared platform services (Sphinx, Helios, Dispatcher, Provisioning, Observability), infrastructure, and external tools — not only Second Ring.

What changed​

  • Repo: VelocityPoint/sr-wiki → VelocityPoint/vp-wiki
  • Canonical URL: https://wiki.vpservic.es (the deployed custom domain was already this — the old wiki.sr-services.com planned URL in config was stale and never matched Terraform)
  • Top-level taxonomy: added products/ and tools/; renamed systems/ → platform/
    • products/ — second-ring, book-marketing, prince-charming
    • platform/ — sphinx, helios, dispatcher, provisioning, observability, home-portal
    • tools/ — ghl, google-suite, loom, azure, terraform
  • Brand strings: title, tagline, navbar, footer, "Suggest Edit" issue URL, internal references
  • New: scripts/pr-watcher/ — scheduled PR-watcher agent scaffold (filter rules in config.js). See docs/team/docs-update-process.md for how the update loop works.

What did NOT change​

  • Azure SWA resources — Terraform still names them sr-wiki-<env>. Azure doesn't allow rename-in-place, and rebuilding all 4 environments wasn't worth the downtime given the custom domain is unaffected. Treated as accepted technical debt.
  • Entra app registration — same sr-wiki display name, same client_id, same redirect URIs. Works unchanged because the sr-wiki-<env>.azurestaticapps.net default hostnames still exist post-repo-rename.
  • AZURE_STATIC_WEB_APPS_API_TOKEN GitHub secret — GitHub preserves secrets across repo renames. No rotation needed.

Anyone linking to the old wiki paths needs to update:

Old pathNew path
/docs/systems/sphinx/*/docs/platform/sphinx/*
/docs/systems/helios/*/docs/platform/helios/*
/docs/systems/dispatcher/*/docs/platform/dispatcher/*
/docs/systems/provisioning/*/docs/platform/provisioning/*
/docs/systems/observability/*/docs/platform/observability/*
/docs/systems/sr-sales-dev/*/docs/products/second-ring/sr-sales-dev/*
https://wiki.sr-services.com/*https://wiki.vpservic.es/*
]]> release migration governance <![CDATA[Doc Migration — SecondRing.Server & sr-azure-infra]]> https://wiki.vpservic.es/changelog/2026/03/25/doc-migration https://wiki.vpservic.es/changelog/2026/03/25/doc-migration Wed, 25 Mar 2026 00:00:00 GMT First major content release. Migrated production documentation from SecondRing.Server and sr-azure-infra source repos into the wiki. All pages are now browsable, searchable, and cross-linked.

New Pages​

Systems​

PageDescription
Sphinx — Secrets PortalWhat Sphinx is, deployment architecture, known state
Sphinx: API ReferenceFull HTTP API spec for all Sphinx endpoints
Sphinx: Auth & RolesEntra ID roles (viewer / operator / admin / owner) and endpoint permissions
Sphinx: Key Vault Write PatternTwo-phase commit design — how secrets are staged and confirmed
Sphinx: Magic Link FlowEnd-to-end customer credential intake, token structure, HMAC validation
Sphinx: Status MachineSecretRequest lifecycle (Pending → Partial → Completed → Confirmed → Expired / Cancelled)
Sphinx: Telemetry EventsApplication Insights event catalog for Sphinx
Provisioning PipelineCustomerProvisioningOrchestrator — stages, Durable Functions structure, key dependencies
Provisioning: Auth ModelPIT-based auth, deprecated OAuth shim, current state by endpoint
Provisioning: Pipeline OverviewCondensed reference card — flow diagram, trigger, activities, environment variables
Observability OverviewApp Insights + Log Analytics architecture, instrumentation approach
Observability: AlertsAlert rule definitions, thresholds, Telegram routing via Helios
Observability: EventsCustom telemetry event catalog
Observability: KQL QueriesOperational query library for dashboards and ad-hoc investigation
DispatcherRep assignment and round-robin routing system

Reference​

PageDescription
Key Vault Secret NamingNaming conventions for all secrets across all environments — new in this release
Auth Model (Audit)Auth state across all endpoints — which scheme, which migration status
GHL Interface ContractAll GHL API calls made by Second Ring — credentials, per-sub-account scope
GHL Visibility ContractOperational state publishing to GHL (notes, tags, custom fields)
GHL OfframpsWebhook-based SMS/email relay pattern
Tag ContractGHL contact tag definitions, lifecycle, prerequisites
Tag Dispatch WorkflowsHow tags trigger GHL automation workflows
Webhook SchemaInbound webhook payload schema (GHL → Azure)
Handler ContractHandler implementation requirements for tag-triggered functions

Infrastructure​

PageDescription
Cost Optimization ReportAzure cost breakdown per environment with corrected estimates
Terraform ReferenceModule structure, environment configs, naming conventions

Build Fixes (this release)​

The doc migration PR (#6) shipped with broken Markdown links — ALLCAPS filenames from source repos didn't match the wiki's lowercase-hyphenated naming scheme, and several cross-repo paths weren't resolvable. This release fixes all of them:

  • 15 broken Markdown link paths resolved
  • 2 cross-repo links converted to GitHub URLs (INSTRUMENTATION_GUIDE.md, provisioning-alerts.tf)
  • {requestId} bare JSX expressions in table cells escaped
  • Duplicate route conflict (index.md + README.md) resolved via slug overrides
  • Docusaurus v4 deprecation warning fixed (onBrokenMarkdownLinks config path)
  • <10k MDX parse error fixed in cost-optimization doc

What's Next​

  • Archive section for superseded docs
  • Glossary expansion
  • Home Portal doc page
]]> release migration sphinx provisioning observability infrastructure