Docs
On this page

16. Traffic-Flow: Three Lifecycles

16.1 Edit-Lifecycle (User types in Editor)#

DBAPIWeb SPABrowserDBAPIWeb SPABrowserUser types "debounce 800 msPATCH /pages/:id { mdContent }UPDATE pages SET mdContent, mdHash{ page }postMessage(RENDER_DOCS) to Iframe
DBAPIWeb SPABrowserDBAPIWeb SPABrowserUser types "debounce 800 msPATCH /pages/:id { mdContent }UPDATE pages SET mdContent, mdHash{ page }postMessage(RENDER_DOCS) to Iframe

No LLM-Call. No Generate. Only DB-Update + Live-Preview Re-Render with Client-Mermaid.

16.2 Generate-Lifecycle#

DBCacheLLMPipelineAPIWebDBCacheLLMPipelineAPIWebalt[cache miss]POST /pages/:id/generatechoose + run pipelineSELECT WHERE mdHash = ?chatComplete(mapper)ComponentMapping[]INSERTprerender mermaid{ html, sections }UPDATE pages SET generatedJson{ html, sections, validation }
DBCacheLLMPipelineAPIWebDBCacheLLMPipelineAPIWebalt[cache miss]POST /pages/:id/generatechoose + run pipelineSELECT WHERE mdHash = ?chatComplete(mapper)ComponentMapping[]INSERTprerender mermaid{ html, sections }UPDATE pages SET generatedJson{ html, sections, validation }

16.3 Deploy-Lifecycle#

DBCFGeneratorAPIWebDBCFGeneratorAPIWebloop[poll every 2s]POST /deploybuild all pages × all languagesSiteFile[]upload deploymentdeploymentIdINSERT deploymentGET /deployments/:idstatus check{ status }{ status }open deployment.url
DBCFGeneratorAPIWebDBCFGeneratorAPIWebloop[poll every 2s]POST /deploybuild all pages × all languagesSiteFile[]upload deploymentdeploymentIdINSERT deploymentGET /deployments/:idstatus check{ status }{ status }open deployment.url