[{"data":1,"prerenderedAt":3358},["ShallowReactive",2],{"navigation_docs":3,"-docs-guides-creating-go-app":968,"-docs-guides-creating-go-app-surround":3354},[4,27,63,129,287,311,893,902,950,964],{"title":5,"path":6,"stem":7,"children":8,"order":10,"icon":11},"Overview","\u002Fdocs\u002Foverview","docs\u002F1.overview\u002Findex",[9,12,18,24],{"title":5,"path":6,"stem":7,"order":10,"icon":11},1,"i-lucide-info",{"title":13,"path":14,"stem":15,"order":16,"icon":17},"Getting Started","\u002Fdocs\u002Foverview\u002Fgetting-started","docs\u002F1.overview\u002F2.getting-started",2,"i-lucide-rocket",{"title":19,"path":20,"stem":21,"order":22,"icon":23},"Contributing","\u002Fdocs\u002Foverview\u002Fcontributing","docs\u002F1.overview\u002F3.contributing",3,"i-lucide-heart",{"title":5,"path":25,"stem":26,"order":10},"\u002Fdocs\u002Foverview\u002F_dir","docs\u002F1.overview\u002F_dir",{"title":28,"path":29,"stem":30,"children":31,"page":62},"Concepts","\u002Fdocs\u002Fconcepts","docs\u002F2.concepts",[32,37,42,47,53,59],{"title":33,"path":34,"stem":35,"order":10,"icon":36},"Events","\u002Fdocs\u002Fconcepts\u002Fevents","docs\u002F2.concepts\u002F1.events","i-lucide-zap",{"title":38,"path":39,"stem":40,"order":16,"icon":41},"Transports","\u002Fdocs\u002Fconcepts\u002Ftransports","docs\u002F2.concepts\u002F2.transports","i-lucide-network",{"title":43,"path":44,"stem":45,"order":22,"icon":46},"Module System","\u002Fdocs\u002Fconcepts\u002Fmodules","docs\u002F2.concepts\u002F3.modules","i-lucide-puzzle",{"title":48,"path":49,"stem":50,"order":51,"icon":52},"Flows","\u002Fdocs\u002Fconcepts\u002Fflows","docs\u002F2.concepts\u002F4.flows",4,"i-lucide-workflow",{"title":54,"path":55,"stem":56,"order":57,"icon":58},"Scheduler","\u002Fdocs\u002Fconcepts\u002Fscheduler","docs\u002F2.concepts\u002F5.scheduler",5,"i-lucide-clock",{"title":28,"path":60,"stem":61,"order":16},"\u002Fdocs\u002Fconcepts\u002F_dir","docs\u002F2.concepts\u002F_dir",false,{"title":64,"path":65,"stem":66,"children":67,"page":62},"Guides","\u002Fdocs\u002Fguides","docs\u002F3.guides",[68,73,77,81,85,89,93,98,104,110,116,122,126],{"title":69,"path":70,"stem":71,"order":10,"icon":72},"Creating a Go App","\u002Fdocs\u002Fguides\u002Fcreating-go-app","docs\u002F3.guides\u002F1.creating-go-app","i-lucide-terminal",{"title":74,"path":75,"stem":76},"E2E tests & demo videos","\u002Fdocs\u002Fguides\u002Fe2e-and-demo-videos","docs\u002F3.guides\u002F10.e2e-and-demo-videos",{"title":78,"path":79,"stem":80,"icon":17},"Deploying to production","\u002Fdocs\u002Fguides\u002Fdeploying-to-production","docs\u002F3.guides\u002F11.deploying-to-production",{"title":82,"path":83,"stem":84,"order":16,"icon":46},"Creating a Go Module","\u002Fdocs\u002Fguides\u002Fcreating-go-module","docs\u002F3.guides\u002F2.creating-go-module",{"title":86,"path":87,"stem":88,"order":22,"icon":36},"Adding Events","\u002Fdocs\u002Fguides\u002Fadding-events-to-go-module","docs\u002F3.guides\u002F3.adding-events-to-go-module",{"title":90,"path":91,"stem":92,"order":51,"icon":52},"FlowDSL to Service","\u002Fdocs\u002Fguides\u002Fflowdsl-to-redelay","docs\u002F3.guides\u002F4.flowdsl-to-redelay",{"title":94,"path":95,"stem":96,"order":57,"icon":97},"Choosing a Transport","\u002Fdocs\u002Fguides\u002Fchoosing-a-transport","docs\u002F3.guides\u002F5.choosing-a-transport","i-lucide-git-branch",{"title":99,"path":100,"stem":101,"order":102,"icon":103},"Module Browser (\u002Fmodules)","\u002Fdocs\u002Fguides\u002Fmodules-browser","docs\u002F3.guides\u002F6.modules-browser",6,"i-lucide-layout-dashboard",{"title":105,"path":106,"stem":107,"order":108,"icon":109},"Running Flows","\u002Fdocs\u002Fguides\u002Frunning-flows","docs\u002F3.guides\u002F7.running-flows",7,"i-lucide-play-circle",{"title":111,"path":112,"stem":113,"order":114,"icon":115},"Trace + Live Observability","\u002Fdocs\u002Fguides\u002Fobservability","docs\u002F3.guides\u002F8.observability",8,"i-lucide-activity",{"title":117,"path":118,"stem":119,"order":120,"icon":121},"Project AI Assistant","\u002Fdocs\u002Fguides\u002Fai-assistant","docs\u002F3.guides\u002F9.ai-assistant",9,"i-lucide-sparkles",{"title":123,"path":124,"stem":125},"Debug taps — trace live data through any node","\u002Fdocs\u002Fguides\u002Fdebug-taps","docs\u002F3.guides\u002F9.debug-taps",{"title":64,"path":127,"stem":128,"order":22},"\u002Fdocs\u002Fguides\u002F_dir","docs\u002F3.guides\u002F_dir",{"title":130,"path":131,"stem":132,"children":133,"page":62},"Reference","\u002Fdocs\u002Freference","docs\u002F4.reference",[134,139,143,148,153,158,163,168,172,177,182,187,193,199,205,210,215,219,225,230,236,242,247,253,259,263,267,273,278,284],{"title":135,"path":136,"stem":137,"order":10,"icon":138},"Go Framework","\u002Fdocs\u002Freference\u002Fgo-framework","docs\u002F4.reference\u002F01.go-framework","i-simple-icons-go",{"title":140,"path":141,"stem":142,"order":16,"icon":46},"Built-in Modules","\u002Fdocs\u002Freference\u002Fgo-modules","docs\u002F4.reference\u002F02.go-modules",{"title":144,"path":145,"stem":146,"order":22,"icon":147},"Domain Addon Modules","\u002Fdocs\u002Freference\u002Fgo-modules-addons","docs\u002F4.reference\u002F03.go-modules-addons","i-lucide-blocks",{"title":149,"path":150,"stem":151,"order":51,"icon":152},"Go Events","\u002Fdocs\u002Freference\u002Fgo-events","docs\u002F4.reference\u002F04.go-events","i-lucide-radio",{"title":154,"path":155,"stem":156,"order":57,"icon":157},"Email Module","\u002Fdocs\u002Freference\u002Fgo-module-email","docs\u002F4.reference\u002F05.go-module-email","i-lucide-mail",{"title":159,"path":160,"stem":161,"order":102,"icon":162},"Go Core & IR","\u002Fdocs\u002Freference\u002Fgo-core","docs\u002F4.reference\u002F06.go-core","i-lucide-cpu",{"title":164,"path":165,"stem":166,"order":108,"icon":167},"Module Definition Files","\u002Fdocs\u002Freference\u002Fgo-module-files","docs\u002F4.reference\u002F07.go-module-files","i-lucide-file-code",{"title":169,"path":170,"stem":171,"order":114,"icon":72},"CLI Reference","\u002Fdocs\u002Freference\u002Fgo-cli","docs\u002F4.reference\u002F08.go-cli",{"title":173,"path":174,"stem":175,"order":120,"icon":176},"Go Formats","\u002Fdocs\u002Freference\u002Fgo-formats","docs\u002F4.reference\u002F09.go-formats","i-lucide-file-json",{"title":178,"path":179,"stem":180,"order":181,"icon":152},"AsyncAPI Module","\u002Fdocs\u002Freference\u002Fgo-asyncapi","docs\u002F4.reference\u002F10.go-asyncapi",10,{"title":183,"path":184,"stem":185,"order":186,"icon":52},"Go FlowDSL","\u002Fdocs\u002Freference\u002Fgo-flowdsl","docs\u002F4.reference\u002F11.go-flowdsl",11,{"title":188,"path":189,"stem":190,"order":191,"icon":192},"FlowDSL Examples","\u002Fdocs\u002Freference\u002Fflowdsl-examples","docs\u002F4.reference\u002F12.flowdsl-examples",12,"i-lucide-file-code-2",{"title":194,"path":195,"stem":196,"order":197,"icon":198},"FlowDSL Sync","\u002Fdocs\u002Freference\u002Fflowdsl-sync","docs\u002F4.reference\u002F13.flowdsl-sync",13,"i-lucide-refresh-cw",{"title":200,"path":201,"stem":202,"order":203,"icon":204},"Node.js Framework","\u002Fdocs\u002Freference\u002Fjs-framework","docs\u002F4.reference\u002F14.js-framework",14,"i-simple-icons-nodedotjs",{"title":206,"path":207,"stem":208,"order":203,"icon":209},"Python Framework","\u002Fdocs\u002Freference\u002Fpy-framework","docs\u002F4.reference\u002F14.py-framework","i-simple-icons-python",{"title":211,"path":212,"stem":213,"order":214,"icon":204},"Node.js Events","\u002Fdocs\u002Freference\u002Fjs-events","docs\u002F4.reference\u002F15.js-events",15,{"title":216,"path":217,"stem":218,"order":214,"icon":209},"Python Events","\u002Fdocs\u002Freference\u002Fpy-events","docs\u002F4.reference\u002F15.py-events",{"title":220,"path":221,"stem":222,"order":223,"icon":224},"go-ai — LLM Providers, Guard, Ledger","\u002Fdocs\u002Freference\u002Fgo-ai","docs\u002F4.reference\u002F16.go-ai",16,"i-lucide-brain-circuit",{"title":226,"path":227,"stem":228,"order":229,"icon":41},"Infrastructure Modules","\u002Fdocs\u002Freference\u002Fgeneric-infra-modules","docs\u002F4.reference\u002F17.generic-infra-modules",17,{"title":231,"path":232,"stem":233,"order":234,"icon":235},"Flow Templates","\u002Fdocs\u002Freference\u002Fflow-templates","docs\u002F4.reference\u002F18.flow-templates",18,"i-lucide-library-big",{"title":237,"path":238,"stem":239,"order":240,"icon":241},"Assistant (chat + handoff)","\u002Fdocs\u002Freference\u002Fassistant","docs\u002F4.reference\u002F19.assistant",19,"i-lucide-messages-square",{"title":243,"path":244,"stem":245,"order":246,"icon":41},"Coordination","\u002Fdocs\u002Freference\u002Fcoordination","docs\u002F4.reference\u002F20.coordination",20,{"title":248,"path":249,"stem":250,"order":251,"icon":252},"Search (vector)","\u002Fdocs\u002Freference\u002Fsearch","docs\u002F4.reference\u002F21.search",21,"i-lucide-search",{"title":254,"path":255,"stem":256,"order":257,"icon":258},"Profiles","\u002Fdocs\u002Freference\u002Fprofiles","docs\u002F4.reference\u002F22.profiles",22,"i-lucide-bookmark",{"title":260,"path":261,"stem":262},"Flow-driven HTTP endpoints","\u002Fdocs\u002Freference\u002Fflow-driven-endpoints","docs\u002F4.reference\u002F23.flow-driven-endpoints",{"title":264,"path":265,"stem":266},"Deployments","\u002Fdocs\u002Freference\u002Fdeployments","docs\u002F4.reference\u002F24.deployments",{"title":268,"path":269,"stem":270,"order":271,"icon":272},"i18n (translations)","\u002Fdocs\u002Freference\u002Fi18n","docs\u002F4.reference\u002F25.i18n",25,"i-lucide-languages",{"title":274,"path":275,"stem":276,"order":277,"icon":152},"WebSockets","\u002Fdocs\u002Freference\u002Fwebsockets","docs\u002F4.reference\u002F26.websockets",26,{"title":279,"path":280,"stem":281,"order":282,"icon":283},"Localized content","\u002Fdocs\u002Freference\u002Flocalized-content","docs\u002F4.reference\u002F27.localized-content",27,"i-lucide-file-text",{"title":130,"path":285,"stem":286,"order":51},"\u002Fdocs\u002Freference\u002F_dir","docs\u002F4.reference\u002F_dir",{"title":288,"path":289,"stem":290,"children":291,"page":62},"Integrations","\u002Fdocs\u002Fintegrations","docs\u002F5.integrations",[292,296,300,304,308],{"title":293,"path":294,"stem":295,"order":10,"icon":52},"FlowDSL","\u002Fdocs\u002Fintegrations\u002Fflowdsl","docs\u002F5.integrations\u002F1.flowdsl",{"title":297,"path":298,"stem":299,"order":16,"icon":283},"OpenAPI","\u002Fdocs\u002Fintegrations\u002Fopenapi","docs\u002F5.integrations\u002F2.openapi",{"title":301,"path":302,"stem":303,"order":22,"icon":152},"AsyncAPI","\u002Fdocs\u002Fintegrations\u002Fasyncapi","docs\u002F5.integrations\u002F3.asyncapi",{"title":305,"path":306,"stem":307},"MCP Integration","\u002Fdocs\u002Fintegrations\u002Fmcp","docs\u002F5.integrations\u002F4.mcp",{"title":288,"path":309,"stem":310,"order":57},"\u002Fdocs\u002Fintegrations\u002F_dir","docs\u002F5.integrations\u002F_dir",{"title":312,"path":313,"stem":314,"children":315},"FlowDSL Node Catalog","\u002Fdocs\u002Fnodes","docs\u002F5.nodes\u002Findex",[316,317,321,325,329,333,337,341,345,349,353,357,361,365,369,373,377,381,385,389,393,397,401,405,409,413,417,421,425,429,433,437,441,445,449,453,457,461,465,469,473,477,481,485,489,493,497,501,505,509,513,517,521,525,529,533,537,541,545,549,553,557,561,565,569,573,577,581,585,589,593,597,601,605,609,613,617,621,625,629,633,637,641,645,649,653,657,661,665,669,673,677,681,685,689,693,697,701,705,709,713,717,721,725,729,733,737,741,745,749,753,757,761,765,769,773,777,781,785,789,793,797,801,805,809,813,817,821,825,829,833,837,841,845,849,853,857,861,865,869,873,877,881,885,889],{"title":312,"path":313,"stem":314},{"title":318,"path":319,"stem":320,"order":57},"Node Catalog","\u002Fdocs\u002Fnodes\u002F_dir","docs\u002F5.nodes\u002F_dir",{"title":322,"path":323,"stem":324},"Record Alert","\u002Fdocs\u002Fnodes\u002Falerts_record","docs\u002F5.nodes\u002Falerts_record",{"title":326,"path":327,"stem":328},"Log to API Log","\u002Fdocs\u002Fnodes\u002Fapilog_record","docs\u002F5.nodes\u002Fapilog_record",{"title":330,"path":331,"stem":332},"ClickHouse Exec","\u002Fdocs\u002Fnodes\u002Fclickhouse_exec","docs\u002F5.nodes\u002Fclickhouse_exec",{"title":334,"path":335,"stem":336},"ClickHouse Insert","\u002Fdocs\u002Fnodes\u002Fclickhouse_insert","docs\u002F5.nodes\u002Fclickhouse_insert",{"title":338,"path":339,"stem":340},"ClickHouse Query","\u002Fdocs\u002Fnodes\u002Fclickhouse_query","docs\u002F5.nodes\u002Fclickhouse_query",{"title":342,"path":343,"stem":344},"Array Op","\u002Fdocs\u002Fnodes\u002Fcore_array-ops","docs\u002F5.nodes\u002Fcore_array-ops",{"title":346,"path":347,"stem":348},"Assert","\u002Fdocs\u002Fnodes\u002Fcore_assert","docs\u002F5.nodes\u002Fcore_assert",{"title":350,"path":351,"stem":352},"Audit Emit","\u002Fdocs\u002Fnodes\u002Fcore_audit-emit","docs\u002F5.nodes\u002Fcore_audit-emit",{"title":354,"path":355,"stem":356},"Catch","\u002Fdocs\u002Fnodes\u002Fcore_catch","docs\u002F5.nodes\u002Fcore_catch",{"title":358,"path":359,"stem":360},"DateTime","\u002Fdocs\u002Fnodes\u002Fcore_datetime","docs\u002F5.nodes\u002Fcore_datetime",{"title":362,"path":363,"stem":364},"Dead Letter","\u002Fdocs\u002Fnodes\u002Fcore_dead-letter","docs\u002F5.nodes\u002Fcore_dead-letter",{"title":366,"path":367,"stem":368},"Delay","\u002Fdocs\u002Fnodes\u002Fcore_delay","docs\u002F5.nodes\u002Fcore_delay",{"title":370,"path":371,"stem":372},"ForEach","\u002Fdocs\u002Fnodes\u002Fcore_foreach","docs\u002F5.nodes\u002Fcore_foreach",{"title":374,"path":375,"stem":376},"Idempotency Key","\u002Fdocs\u002Fnodes\u002Fcore_idempotency-key","docs\u002F5.nodes\u002Fcore_idempotency-key",{"title":378,"path":379,"stem":380},"If","\u002Fdocs\u002Fnodes\u002Fcore_if","docs\u002F5.nodes\u002Fcore_if",{"title":382,"path":383,"stem":384},"Inspect","\u002Fdocs\u002Fnodes\u002Fcore_inspect","docs\u002F5.nodes\u002Fcore_inspect",{"title":386,"path":387,"stem":388},"JSON Merge","\u002Fdocs\u002Fnodes\u002Fcore_json-merge","docs\u002F5.nodes\u002Fcore_json-merge",{"title":390,"path":391,"stem":392},"JSON Schema Validate","\u002Fdocs\u002Fnodes\u002Fcore_json-schema-validate","docs\u002F5.nodes\u002Fcore_json-schema-validate",{"title":394,"path":395,"stem":396},"JSONPath Extract","\u002Fdocs\u002Fnodes\u002Fcore_jsonpath-extract","docs\u002F5.nodes\u002Fcore_jsonpath-extract",{"title":398,"path":399,"stem":400},"Log","\u002Fdocs\u002Fnodes\u002Fcore_log","docs\u002F5.nodes\u002Fcore_log",{"title":402,"path":403,"stem":404},"Math","\u002Fdocs\u002Fnodes\u002Fcore_math","docs\u002F5.nodes\u002Fcore_math",{"title":406,"path":407,"stem":408},"Merge","\u002Fdocs\u002Fnodes\u002Fcore_merge","docs\u002F5.nodes\u002Fcore_merge",{"title":410,"path":411,"stem":412},"Metric Counter","\u002Fdocs\u002Fnodes\u002Fcore_metric-counter","docs\u002F5.nodes\u002Fcore_metric-counter",{"title":414,"path":415,"stem":416},"Metric Gauge","\u002Fdocs\u002Fnodes\u002Fcore_metric-gauge","docs\u002F5.nodes\u002Fcore_metric-gauge",{"title":418,"path":419,"stem":420},"Mock","\u002Fdocs\u002Fnodes\u002Fcore_mock","docs\u002F5.nodes\u002Fcore_mock",{"title":422,"path":423,"stem":424},"No-op","\u002Fdocs\u002Fnodes\u002Fcore_noop","docs\u002F5.nodes\u002Fcore_noop",{"title":426,"path":427,"stem":428},"Object Omit","\u002Fdocs\u002Fnodes\u002Fcore_object-omit","docs\u002F5.nodes\u002Fcore_object-omit",{"title":430,"path":431,"stem":432},"Object Pick","\u002Fdocs\u002Fnodes\u002Fcore_object-pick","docs\u002F5.nodes\u002Fcore_object-pick",{"title":434,"path":435,"stem":436},"Parallel Fan-Out","\u002Fdocs\u002Fnodes\u002Fcore_parallel","docs\u002F5.nodes\u002Fcore_parallel",{"title":438,"path":439,"stem":440},"Raise","\u002Fdocs\u002Fnodes\u002Fcore_raise","docs\u002F5.nodes\u002Fcore_raise",{"title":442,"path":443,"stem":444},"Rate Limit Check","\u002Fdocs\u002Fnodes\u002Fcore_rate-limit-check","docs\u002F5.nodes\u002Fcore_rate-limit-check",{"title":446,"path":447,"stem":448},"Regex Extract","\u002Fdocs\u002Fnodes\u002Fcore_regex-extract","docs\u002F5.nodes\u002Fcore_regex-extract",{"title":450,"path":451,"stem":452},"Require Fields","\u002Fdocs\u002Fnodes\u002Fcore_require-fields","docs\u002F5.nodes\u002Fcore_require-fields",{"title":454,"path":455,"stem":456},"Rethrow","\u002Fdocs\u002Fnodes\u002Fcore_rethrow","docs\u002F5.nodes\u002Fcore_rethrow",{"title":458,"path":459,"stem":460},"Return","\u002Fdocs\u002Fnodes\u002Fcore_return","docs\u002F5.nodes\u002Fcore_return",{"title":462,"path":463,"stem":464},"HMAC Signature Verify","\u002Fdocs\u002Fnodes\u002Fcore_signature-verify","docs\u002F5.nodes\u002Fcore_signature-verify",{"title":466,"path":467,"stem":468},"String Op","\u002Fdocs\u002Fnodes\u002Fcore_string-ops","docs\u002F5.nodes\u002Fcore_string-ops",{"title":470,"path":471,"stem":472},"Subflow Invoke","\u002Fdocs\u002Fnodes\u002Fcore_subflow-invoke","docs\u002F5.nodes\u002Fcore_subflow-invoke",{"title":474,"path":475,"stem":476},"Switch","\u002Fdocs\u002Fnodes\u002Fcore_switch","docs\u002F5.nodes\u002Fcore_switch",{"title":478,"path":479,"stem":480},"Template Render","\u002Fdocs\u002Fnodes\u002Fcore_template-render","docs\u002F5.nodes\u002Fcore_template-render",{"title":482,"path":483,"stem":484},"Throttle","\u002Fdocs\u002Fnodes\u002Fcore_throttle","docs\u002F5.nodes\u002Fcore_throttle",{"title":486,"path":487,"stem":488},"Timeout","\u002Fdocs\u002Fnodes\u002Fcore_timeout","docs\u002F5.nodes\u002Fcore_timeout",{"title":490,"path":491,"stem":492},"Type Cast","\u002Fdocs\u002Fnodes\u002Fcore_type-cast","docs\u002F5.nodes\u002Fcore_type-cast",{"title":494,"path":495,"stem":496},"Webhook Respond","\u002Fdocs\u002Fnodes\u002Fcore_webhook-respond","docs\u002F5.nodes\u002Fcore_webhook-respond",{"title":498,"path":499,"stem":500},"File Delete","\u002Fdocs\u002Fnodes\u002Ffilesys_delete","docs\u002F5.nodes\u002Ffilesys_delete",{"title":502,"path":503,"stem":504},"Directory List","\u002Fdocs\u002Fnodes\u002Ffilesys_list","docs\u002F5.nodes\u002Ffilesys_list",{"title":506,"path":507,"stem":508},"File Read","\u002Fdocs\u002Fnodes\u002Ffilesys_read","docs\u002F5.nodes\u002Ffilesys_read",{"title":510,"path":511,"stem":512},"File Stat","\u002Fdocs\u002Fnodes\u002Ffilesys_stat","docs\u002F5.nodes\u002Ffilesys_stat",{"title":514,"path":515,"stem":516},"File Write","\u002Fdocs\u002Fnodes\u002Ffilesys_write","docs\u002F5.nodes\u002Ffilesys_write",{"title":518,"path":519,"stem":520},"FTP Delete","\u002Fdocs\u002Fnodes\u002Fftp_delete","docs\u002F5.nodes\u002Fftp_delete",{"title":522,"path":523,"stem":524},"FTP Download","\u002Fdocs\u002Fnodes\u002Fftp_download","docs\u002F5.nodes\u002Fftp_download",{"title":526,"path":527,"stem":528},"FTP List","\u002Fdocs\u002Fnodes\u002Fftp_list","docs\u002F5.nodes\u002Fftp_list",{"title":530,"path":531,"stem":532},"FTP Upload","\u002Fdocs\u002Fnodes\u002Fftp_upload","docs\u002F5.nodes\u002Fftp_upload",{"title":534,"path":535,"stem":536},"HTTP DELETE","\u002Fdocs\u002Fnodes\u002Fhttp_delete","docs\u002F5.nodes\u002Fhttp_delete",{"title":538,"path":539,"stem":540},"HTTP GET","\u002Fdocs\u002Fnodes\u002Fhttp_get","docs\u002F5.nodes\u002Fhttp_get",{"title":542,"path":543,"stem":544},"HTTP POST","\u002Fdocs\u002Fnodes\u002Fhttp_post","docs\u002F5.nodes\u002Fhttp_post",{"title":546,"path":547,"stem":548},"HTTP PUT","\u002Fdocs\u002Fnodes\u002Fhttp_put","docs\u002F5.nodes\u002Fhttp_put",{"title":550,"path":551,"stem":552},"HTTP Request","\u002Fdocs\u002Fnodes\u002Fhttp_request","docs\u002F5.nodes\u002Fhttp_request",{"title":554,"path":555,"stem":556},"Fill Translations","\u002Fdocs\u002Fnodes\u002Fi18n_fill-translations","docs\u002F5.nodes\u002Fi18n_fill-translations",{"title":558,"path":559,"stem":560},"Resolve Locale","\u002Fdocs\u002Fnodes\u002Fi18n_resolve-locale","docs\u002F5.nodes\u002Fi18n_resolve-locale",{"title":562,"path":563,"stem":564},"Translate","\u002Fdocs\u002Fnodes\u002Fi18n_translate","docs\u002F5.nodes\u002Fi18n_translate",{"title":566,"path":567,"stem":568},"Mongo AGGREGATE","\u002Fdocs\u002Fnodes\u002Fmongoops_aggregate","docs\u002F5.nodes\u002Fmongoops_aggregate",{"title":570,"path":571,"stem":572},"Mongo DELETE","\u002Fdocs\u002Fnodes\u002Fmongoops_delete","docs\u002F5.nodes\u002Fmongoops_delete",{"title":574,"path":575,"stem":576},"Mongo FIND","\u002Fdocs\u002Fnodes\u002Fmongoops_find","docs\u002F5.nodes\u002Fmongoops_find",{"title":578,"path":579,"stem":580},"Mongo FIND ONE","\u002Fdocs\u002Fnodes\u002Fmongoops_find-one","docs\u002F5.nodes\u002Fmongoops_find-one",{"title":582,"path":583,"stem":584},"Mongo INSERT","\u002Fdocs\u002Fnodes\u002Fmongoops_insert","docs\u002F5.nodes\u002Fmongoops_insert",{"title":586,"path":587,"stem":588},"Mongo UPDATE","\u002Fdocs\u002Fnodes\u002Fmongoops_update","docs\u002F5.nodes\u002Fmongoops_update",{"title":590,"path":591,"stem":592},"Postgres COPY FROM","\u002Fdocs\u002Fnodes\u002Fpostgres_copy-from","docs\u002F5.nodes\u002Fpostgres_copy-from",{"title":594,"path":595,"stem":596},"Postgres Exec","\u002Fdocs\u002Fnodes\u002Fpostgres_exec","docs\u002F5.nodes\u002Fpostgres_exec",{"title":598,"path":599,"stem":600},"Postgres Query","\u002Fdocs\u002Fnodes\u002Fpostgres_query","docs\u002F5.nodes\u002Fpostgres_query",{"title":602,"path":603,"stem":604},"Postgres Transaction","\u002Fdocs\u002Fnodes\u002Fpostgres_transaction","docs\u002F5.nodes\u002Fpostgres_transaction",{"title":606,"path":607,"stem":608},"RabbitMQ Consume","\u002Fdocs\u002Fnodes\u002Frabbitmq_consume","docs\u002F5.nodes\u002Frabbitmq_consume",{"title":610,"path":611,"stem":612},"RabbitMQ Declare","\u002Fdocs\u002Fnodes\u002Frabbitmq_declare","docs\u002F5.nodes\u002Frabbitmq_declare",{"title":614,"path":615,"stem":616},"RabbitMQ Publish","\u002Fdocs\u002Fnodes\u002Frabbitmq_publish","docs\u002F5.nodes\u002Frabbitmq_publish",{"title":618,"path":619,"stem":620},"Auth Login","\u002Fdocs\u002Fnodes\u002Fredelay_auth-login","docs\u002F5.nodes\u002Fredelay_auth-login",{"title":622,"path":623,"stem":624},"Require Permission","\u002Fdocs\u002Fnodes\u002Fredelay_auth-require-permission","docs\u002F5.nodes\u002Fredelay_auth-require-permission",{"title":626,"path":627,"stem":628},"Validate Token","\u002Fdocs\u002Fnodes\u002Fredelay_auth-validate-token","docs\u002F5.nodes\u002Fredelay_auth-validate-token",{"title":630,"path":631,"stem":632},"Render Email Template","\u002Fdocs\u002Fnodes\u002Fredelay_email-render-template","docs\u002F5.nodes\u002Fredelay_email-render-template",{"title":634,"path":635,"stem":636},"Send Email","\u002Fdocs\u002Fnodes\u002Fredelay_email-send","docs\u002F5.nodes\u002Fredelay_email-send",{"title":638,"path":639,"stem":640},"Send Templated Email","\u002Fdocs\u002Fnodes\u002Fredelay_email-send-templated","docs\u002F5.nodes\u002Fredelay_email-send-templated",{"title":642,"path":643,"stem":644},"Event Source","\u002Fdocs\u002Fnodes\u002Fredelay_event-source","docs\u002F5.nodes\u002Fredelay_event-source",{"title":646,"path":647,"stem":648},"Create Group","\u002Fdocs\u002Fnodes\u002Fredelay_groups-create-group","docs\u002F5.nodes\u002Fredelay_groups-create-group",{"title":650,"path":651,"stem":652},"Delete Group","\u002Fdocs\u002Fnodes\u002Fredelay_groups-delete-group","docs\u002F5.nodes\u002Fredelay_groups-delete-group",{"title":654,"path":655,"stem":656},"Resolve Permissions","\u002Fdocs\u002Fnodes\u002Fredelay_groups-resolve-permissions","docs\u002F5.nodes\u002Fredelay_groups-resolve-permissions",{"title":658,"path":659,"stem":660},"Update Group","\u002Fdocs\u002Fnodes\u002Fredelay_groups-update-group","docs\u002F5.nodes\u002Fredelay_groups-update-group",{"title":662,"path":663,"stem":664},"HTTP Endpoint","\u002Fdocs\u002Fnodes\u002Fredelay_http-endpoint","docs\u002F5.nodes\u002Fredelay_http-endpoint",{"title":666,"path":667,"stem":668},"JSON Stream Source","\u002Fdocs\u002Fnodes\u002Fredelay_json-stream-source","docs\u002F5.nodes\u002Fredelay_json-stream-source",{"title":670,"path":671,"stem":672},"JSON → Event","\u002Fdocs\u002Fnodes\u002Fredelay_json-to-event","docs\u002F5.nodes\u002Fredelay_json-to-event",{"title":674,"path":675,"stem":676},"Kafka Produce","\u002Fdocs\u002Fnodes\u002Fredelay_kafka-produce","docs\u002F5.nodes\u002Fredelay_kafka-produce",{"title":678,"path":679,"stem":680},"Create Short Link","\u002Fdocs\u002Fnodes\u002Fredelay_links-create","docs\u002F5.nodes\u002Fredelay_links-create",{"title":682,"path":683,"stem":684},"Delete Short Link","\u002Fdocs\u002Fnodes\u002Fredelay_links-delete","docs\u002F5.nodes\u002Fredelay_links-delete",{"title":686,"path":687,"stem":688},"Resolve Short Link","\u002Fdocs\u002Fnodes\u002Fredelay_links-resolve","docs\u002F5.nodes\u002Fredelay_links-resolve",{"title":690,"path":691,"stem":692},"LLM Chat","\u002Fdocs\u002Fnodes\u002Fredelay_llm-chat","docs\u002F5.nodes\u002Fredelay_llm-chat",{"title":694,"path":695,"stem":696},"LLM Embed","\u002Fdocs\u002Fnodes\u002Fredelay_llm-embed","docs\u002F5.nodes\u002Fredelay_llm-embed",{"title":698,"path":699,"stem":700},"LLM Guard","\u002Fdocs\u002Fnodes\u002Fredelay_llm-guard","docs\u002F5.nodes\u002Fredelay_llm-guard",{"title":702,"path":703,"stem":704},"LLM Tool Router","\u002Fdocs\u002Fnodes\u002Fredelay_llm-tool-router","docs\u002F5.nodes\u002Fredelay_llm-tool-router",{"title":706,"path":707,"stem":708},"NATS Publish","\u002Fdocs\u002Fnodes\u002Fredelay_nats-publish","docs\u002F5.nodes\u002Fredelay_nats-publish",{"title":710,"path":711,"stem":712},"Mark Notification Read","\u002Fdocs\u002Fnodes\u002Fredelay_notifications-mark-read","docs\u002F5.nodes\u002Fredelay_notifications-mark-read",{"title":714,"path":715,"stem":716},"Send Notification","\u002Fdocs\u002Fnodes\u002Fredelay_notifications-send","docs\u002F5.nodes\u002Fredelay_notifications-send",{"title":718,"path":719,"stem":720},"Redis Stream XADD","\u002Fdocs\u002Fnodes\u002Fredelay_redis-stream-publish","docs\u002F5.nodes\u002Fredelay_redis-stream-publish",{"title":722,"path":723,"stem":724},"S3 Copy Object","\u002Fdocs\u002Fnodes\u002Fredelay_s3-copy-object","docs\u002F5.nodes\u002Fredelay_s3-copy-object",{"title":726,"path":727,"stem":728},"S3 Delete Many","\u002Fdocs\u002Fnodes\u002Fredelay_s3-delete-many","docs\u002F5.nodes\u002Fredelay_s3-delete-many",{"title":730,"path":731,"stem":732},"S3 Head Object","\u002Fdocs\u002Fnodes\u002Fredelay_s3-head-object","docs\u002F5.nodes\u002Fredelay_s3-head-object",{"title":734,"path":735,"stem":736},"S3 List Objects","\u002Fdocs\u002Fnodes\u002Fredelay_s3-list-objects","docs\u002F5.nodes\u002Fredelay_s3-list-objects",{"title":738,"path":739,"stem":740},"Create Schedule","\u002Fdocs\u002Fnodes\u002Fredelay_scheduler-create-schedule","docs\u002F5.nodes\u002Fredelay_scheduler-create-schedule",{"title":742,"path":743,"stem":744},"Cron Trigger","\u002Fdocs\u002Fnodes\u002Fredelay_scheduler-cron-trigger","docs\u002F5.nodes\u002Fredelay_scheduler-cron-trigger",{"title":746,"path":747,"stem":748},"Delete Schedule","\u002Fdocs\u002Fnodes\u002Fredelay_scheduler-delete-schedule","docs\u002F5.nodes\u002Fredelay_scheduler-delete-schedule",{"title":750,"path":751,"stem":752},"Interval Trigger","\u002Fdocs\u002Fnodes\u002Fredelay_scheduler-interval-trigger","docs\u002F5.nodes\u002Fredelay_scheduler-interval-trigger",{"title":754,"path":755,"stem":756},"Search Query","\u002Fdocs\u002Fnodes\u002Fredelay_search-query","docs\u002F5.nodes\u002Fredelay_search-query",{"title":758,"path":759,"stem":760},"Search Upsert","\u002Fdocs\u002Fnodes\u002Fredelay_search-upsert","docs\u002F5.nodes\u002Fredelay_search-upsert",{"title":762,"path":763,"stem":764},"Delete Setting","\u002Fdocs\u002Fnodes\u002Fredelay_settings-delete","docs\u002F5.nodes\u002Fredelay_settings-delete",{"title":766,"path":767,"stem":768},"Get Setting","\u002Fdocs\u002Fnodes\u002Fredelay_settings-get","docs\u002F5.nodes\u002Fredelay_settings-get",{"title":770,"path":771,"stem":772},"Set Setting","\u002Fdocs\u002Fnodes\u002Fredelay_settings-set","docs\u002F5.nodes\u002Fredelay_settings-set",{"title":774,"path":775,"stem":776},"Delete File","\u002Fdocs\u002Fnodes\u002Fredelay_storage-delete","docs\u002F5.nodes\u002Fredelay_storage-delete",{"title":778,"path":779,"stem":780},"Download File","\u002Fdocs\u002Fnodes\u002Fredelay_storage-download","docs\u002F5.nodes\u002Fredelay_storage-download",{"title":782,"path":783,"stem":784},"Generate Presigned URL","\u002Fdocs\u002Fnodes\u002Fredelay_storage-presign-url","docs\u002F5.nodes\u002Fredelay_storage-presign-url",{"title":786,"path":787,"stem":788},"Upload File","\u002Fdocs\u002Fnodes\u002Fredelay_storage-upload","docs\u002F5.nodes\u002Fredelay_storage-upload",{"title":790,"path":791,"stem":792},"Subworkflow","\u002Fdocs\u002Fnodes\u002Fredelay_subworkflow","docs\u002F5.nodes\u002Fredelay_subworkflow",{"title":794,"path":795,"stem":796},"Activate User","\u002Fdocs\u002Fnodes\u002Fredelay_users-activate","docs\u002F5.nodes\u002Fredelay_users-activate",{"title":798,"path":799,"stem":800},"Create Pending User","\u002Fdocs\u002Fnodes\u002Fredelay_users-create-pending","docs\u002F5.nodes\u002Fredelay_users-create-pending",{"title":802,"path":803,"stem":804},"Create User","\u002Fdocs\u002Fnodes\u002Fredelay_users-create-user","docs\u002F5.nodes\u002Fredelay_users-create-user",{"title":806,"path":807,"stem":808},"Delete User","\u002Fdocs\u002Fnodes\u002Fredelay_users-delete-user","docs\u002F5.nodes\u002Fredelay_users-delete-user",{"title":810,"path":811,"stem":812},"Find User By Email","\u002Fdocs\u002Fnodes\u002Fredelay_users-find-by-email","docs\u002F5.nodes\u002Fredelay_users-find-by-email",{"title":814,"path":815,"stem":816},"Get User","\u002Fdocs\u002Fnodes\u002Fredelay_users-get-user","docs\u002F5.nodes\u002Fredelay_users-get-user",{"title":818,"path":819,"stem":820},"List Users","\u002Fdocs\u002Fnodes\u002Fredelay_users-list-users","docs\u002F5.nodes\u002Fredelay_users-list-users",{"title":822,"path":823,"stem":824},"Update User","\u002Fdocs\u002Fnodes\u002Fredelay_users-update-user","docs\u002F5.nodes\u002Fredelay_users-update-user",{"title":826,"path":827,"stem":828},"Request Email Verification (legacy)","\u002Fdocs\u002Fnodes\u002Fredelay_verification-request","docs\u002F5.nodes\u002Fredelay_verification-request",{"title":830,"path":831,"stem":832},"Request Email Verification","\u002Fdocs\u002Fnodes\u002Fredelay_verification-request-email","docs\u002F5.nodes\u002Fredelay_verification-request-email",{"title":834,"path":835,"stem":836},"Request SMS Verification","\u002Fdocs\u002Fnodes\u002Fredelay_verification-request-sms","docs\u002F5.nodes\u002Fredelay_verification-request-sms",{"title":838,"path":839,"stem":840},"Verify Token","\u002Fdocs\u002Fnodes\u002Fredelay_verification-verify","docs\u002F5.nodes\u002Fredelay_verification-verify",{"title":842,"path":843,"stem":844},"Redis DEL","\u002Fdocs\u002Fnodes\u002Fredisops_del","docs\u002F5.nodes\u002Fredisops_del",{"title":846,"path":847,"stem":848},"Redis EXPIRE","\u002Fdocs\u002Fnodes\u002Fredisops_expire","docs\u002F5.nodes\u002Fredisops_expire",{"title":850,"path":851,"stem":852},"Redis GET","\u002Fdocs\u002Fnodes\u002Fredisops_get","docs\u002F5.nodes\u002Fredisops_get",{"title":854,"path":855,"stem":856},"Redis HGET","\u002Fdocs\u002Fnodes\u002Fredisops_hget","docs\u002F5.nodes\u002Fredisops_hget",{"title":858,"path":859,"stem":860},"Redis HSET","\u002Fdocs\u002Fnodes\u002Fredisops_hset","docs\u002F5.nodes\u002Fredisops_hset",{"title":862,"path":863,"stem":864},"Redis INCR","\u002Fdocs\u002Fnodes\u002Fredisops_incr","docs\u002F5.nodes\u002Fredisops_incr",{"title":866,"path":867,"stem":868},"Redis LPOP","\u002Fdocs\u002Fnodes\u002Fredisops_lpop","docs\u002F5.nodes\u002Fredisops_lpop",{"title":870,"path":871,"stem":872},"Redis LPUSH","\u002Fdocs\u002Fnodes\u002Fredisops_lpush","docs\u002F5.nodes\u002Fredisops_lpush",{"title":874,"path":875,"stem":876},"Redis PUBLISH","\u002Fdocs\u002Fnodes\u002Fredisops_publish","docs\u002F5.nodes\u002Fredisops_publish",{"title":878,"path":879,"stem":880},"Redis SET","\u002Fdocs\u002Fnodes\u002Fredisops_set","docs\u002F5.nodes\u002Fredisops_set",{"title":882,"path":883,"stem":884},"SFTP Download","\u002Fdocs\u002Fnodes\u002Fsftp_download","docs\u002F5.nodes\u002Fsftp_download",{"title":886,"path":887,"stem":888},"SFTP Upload","\u002Fdocs\u002Fnodes\u002Fsftp_upload","docs\u002F5.nodes\u002Fsftp_upload",{"title":890,"path":891,"stem":892},"Send SMS","\u002Fdocs\u002Fnodes\u002Fsms_send","docs\u002F5.nodes\u002Fsms_send",{"title":894,"path":895,"stem":896,"children":897,"page":62},"Rfcs","\u002Fdocs\u002Frfcs","docs\u002F6.rfcs",[898],{"title":899,"path":900,"stem":901},"RFC 0001 — Worker Assignment for Flow Deployments","\u002Fdocs\u002Frfcs\u002F0001-worker-assignment","docs\u002F6.rfcs\u002F0001-worker-assignment",{"title":903,"path":904,"stem":905,"children":906,"page":62},"Admin","\u002Fdocs\u002Fadmin","docs\u002F7.admin",[907,912,917,922,927,932,937,941,946],{"title":5,"path":908,"stem":909,"order":910,"icon":911},"\u002Fdocs\u002Fadmin\u002Foverview","docs\u002F7.admin\u002F00.overview",0,"i-lucide-compass",{"title":913,"path":914,"stem":915,"order":10,"icon":916},"Getting started","\u002Fdocs\u002Fadmin\u002Fgetting-started","docs\u002F7.admin\u002F01.getting-started","i-lucide-play",{"title":918,"path":919,"stem":920,"order":16,"icon":921},"Layered architecture","\u002Fdocs\u002Fadmin\u002Flayered-architecture","docs\u002F7.admin\u002F02.layered-architecture","i-lucide-layers",{"title":923,"path":924,"stem":925,"order":22,"icon":926},"Building a custom admin project","\u002Fdocs\u002Fadmin\u002Fbuilding-a-custom-admin-project","docs\u002F7.admin\u002F03.building-a-custom-admin-project","i-lucide-folder-plus",{"title":928,"path":929,"stem":930,"order":51,"icon":931},"Building admin modules","\u002Fdocs\u002Fadmin\u002Fbuilding-admin-modules","docs\u002F7.admin\u002F04.building-admin-modules","i-lucide-package-plus",{"title":933,"path":934,"stem":935,"order":57,"icon":936},"Base module reference","\u002Fdocs\u002Fadmin\u002Freference-base-modules","docs\u002F7.admin\u002F05.reference-base-modules","i-lucide-boxes",{"title":938,"path":939,"stem":940,"order":102,"icon":17},"Deployment","\u002Fdocs\u002Fadmin\u002Fdeployment","docs\u002F7.admin\u002F06.deployment",{"title":942,"path":943,"stem":944,"order":108,"icon":945},"Consuming the base layer (versioned)","\u002Fdocs\u002Fadmin\u002Fconsuming-the-base-layer","docs\u002F7.admin\u002F07.consuming-the-base-layer","i-lucide-package",{"title":947,"path":948,"stem":949,"order":108},"Admin UI","\u002Fdocs\u002Fadmin\u002F_dir","docs\u002F7.admin\u002F_dir",{"title":951,"path":952,"stem":953,"children":954,"page":62},"Services","\u002Fdocs\u002Fservices","docs\u002F8.services",[955,960],{"title":956,"path":957,"stem":958,"order":10,"icon":959},"Custom development & support services","\u002Fdocs\u002Fservices\u002Fcustom-development","docs\u002F8.services\u002F1.custom-development","i-lucide-briefcase",{"title":951,"path":961,"stem":962,"icon":959,"order":963},"\u002Fdocs\u002Fservices\u002F_dir","docs\u002F8.services\u002F_dir",80,{"title":965,"path":966,"stem":967,"order":910},"Dir","\u002Fdocs\u002F_dir","docs\u002F_dir",{"id":969,"title":69,"body":970,"description":3347,"extension":3348,"links":3349,"meta":3350,"navigation":3351,"path":70,"seo":3352,"stem":71,"__hash__":3353},"docs\u002Fdocs\u002F3.guides\u002F1.creating-go-app.md",{"type":971,"value":972,"toc":3316},"minimark",[973,977,982,1007,1011,1018,1028,1035,1039,1083,1088,1107,1168,1171,1189,1200,1278,1309,1315,1327,1343,1413,1438,1444,1454,1458,1464,1609,1620,1623,1676,1680,1741,1745,1748,1755,1773,1784,1816,1823,1879,1886,1900,1904,1909,1959,1963,1970,2032,2036,2039,2229,2233,2238,2245,2271,2278,2322,2336,2340,2347,2444,2448,2451,2488,2492,2496,2600,2604,2676,2680,2754,2758,2817,2821,2849,2853,2862,2974,3023,3042,3046,3294,3312],[974,975,976],"p",{},"This guide walks through building a production-ready Go backend using the redelay go-framework.\nThe framework provides built-in modules for auth (JWT + passwords), users (CRUD + model),\nand groups (permissions), plus a server package that wires everything together automatically.",[978,979,981],"h2",{"id":980},"prerequisites","Prerequisites",[983,984,985,994,997,1000],"ul",{},[986,987,988,989,993],"li",{},"Go 1.25+ (the framework modules declare ",[990,991,992],"code",{},"go 1.25.0",")",[986,995,996],{},"MongoDB 7+",[986,998,999],{},"(Optional) Redis 7+",[986,1001,1002,1003,1006],{},"A GitHub account with access to the ",[990,1004,1005],{},"redelay"," organization, and SSH set up for GitHub —\nthe Redelay repos are currently private (see Step 1)",[978,1008,1010],{"id":1009},"project-structure","Project structure",[974,1012,1013,1014,1017],{},"A minimal redelay app is just a ",[990,1015,1016],{},"main.go",":",[1019,1020,1025],"pre",{"className":1021,"code":1023,"language":1024},[1022],"language-text","myapp\u002F\n├── cmd\u002Fapi\u002Fmain.go      # Entry point (~20 lines)\n├── go.mod\n├── .env.example\n└── Dockerfile\n","text",[990,1026,1023],{"__ignoreMap":1027},"",[974,1029,1030,1031],{},"Key principle: ",[1032,1033,1034],"strong",{},"framework modules own business logic AND HTTP routes; your app just includes them.",[978,1036,1038],{"id":1037},"step-1-initialize-the-module","Step 1 — Initialize the module",[1019,1040,1044],{"className":1041,"code":1042,"language":1043,"meta":1027,"style":1027},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","mkdir myapp && cd myapp\ngo mod init github.com\u002Fyourorg\u002Fmyapp\n","bash",[990,1045,1046,1069],{"__ignoreMap":1027},[1047,1048,1050,1054,1058,1062,1066],"span",{"class":1049,"line":10},"line",[1047,1051,1053],{"class":1052},"sBMFI","mkdir",[1047,1055,1057],{"class":1056},"sfazB"," myapp",[1047,1059,1061],{"class":1060},"sMK4o"," &&",[1047,1063,1065],{"class":1064},"s2Zo4"," cd",[1047,1067,1068],{"class":1056}," myapp\n",[1047,1070,1071,1074,1077,1080],{"class":1049,"line":16},[1047,1072,1073],{"class":1052},"go",[1047,1075,1076],{"class":1056}," mod",[1047,1078,1079],{"class":1056}," init",[1047,1081,1082],{"class":1056}," github.com\u002Fyourorg\u002Fmyapp\n",[1084,1085,1087],"h3",{"id":1086},"depend-on-the-framework-versioned-mode-b-recommended","Depend on the framework — versioned (Mode B, recommended)",[974,1089,1090,1091,1094,1095,1098,1099,1106],{},"Redelay's Go modules live in private GitHub repos and are consumed ",[1032,1092,1093],{},"by\nversion"," — ",[990,1096,1097],{},"go.mod"," pins tags, with ",[1032,1100,1101,1102,1105],{},"no ",[990,1103,1104],{},"replace"," directives",". Configure\naccess once per machine:",[1019,1108,1110],{"className":1041,"code":1109,"language":1043,"meta":1027,"style":1027},"go env -w GOPRIVATE='github.com\u002Fredelay\u002F*,github.com\u002Fflowdsl\u002F*,github.com\u002FFlowDSL\u002F*,github.com\u002Fdreplyai\u002F*'\ngit config --global url.\"git@github.com:\".insteadOf \"https:\u002F\u002Fgithub.com\u002F\"\n",[990,1111,1112,1134],{"__ignoreMap":1027},[1047,1113,1114,1116,1119,1122,1125,1128,1131],{"class":1049,"line":10},[1047,1115,1073],{"class":1052},[1047,1117,1118],{"class":1056}," env",[1047,1120,1121],{"class":1056}," -w",[1047,1123,1124],{"class":1056}," GOPRIVATE=",[1047,1126,1127],{"class":1060},"'",[1047,1129,1130],{"class":1056},"github.com\u002Fredelay\u002F*,github.com\u002Fflowdsl\u002F*,github.com\u002FFlowDSL\u002F*,github.com\u002Fdreplyai\u002F*",[1047,1132,1133],{"class":1060},"'\n",[1047,1135,1136,1139,1142,1145,1148,1151,1154,1156,1159,1162,1165],{"class":1049,"line":16},[1047,1137,1138],{"class":1052},"git",[1047,1140,1141],{"class":1056}," config",[1047,1143,1144],{"class":1056}," --global",[1047,1146,1147],{"class":1056}," url.",[1047,1149,1150],{"class":1060},"\"",[1047,1152,1153],{"class":1056},"git@github.com:",[1047,1155,1150],{"class":1060},[1047,1157,1158],{"class":1056},".insteadOf",[1047,1160,1161],{"class":1060}," \"",[1047,1163,1164],{"class":1056},"https:\u002F\u002Fgithub.com\u002F",[1047,1166,1167],{"class":1060},"\"\n",[974,1169,1170],{},"The repos are private, so this only works with a GitHub account that has been\ngranted access and an SSH key registered with GitHub. Check before going further —\nthis must print a commit hash, not a permission error:",[1019,1172,1174],{"className":1041,"code":1173,"language":1043,"meta":1027,"style":1027},"git ls-remote git@github.com:redelay\u002Fgo-framework.git HEAD\n",[990,1175,1176],{"__ignoreMap":1027},[1047,1177,1178,1180,1183,1186],{"class":1049,"line":10},[1047,1179,1138],{"class":1052},[1047,1181,1182],{"class":1056}," ls-remote",[1047,1184,1185],{"class":1056}," git@github.com:redelay\u002Fgo-framework.git",[1047,1187,1188],{"class":1056}," HEAD\n",[974,1190,1191,1192,1195,1196,1199],{},"Then require the framework and ",[990,1193,1194],{},"go mod tidy",". The versions below are the working\nset the Redelay reference backend currently pins; ",[990,1197,1198],{},"@latest"," works too:",[1019,1201,1203],{"className":1041,"code":1202,"language":1043,"meta":1027,"style":1027},"go get github.com\u002Fredelay\u002Fgo-framework@v0.15.1\ngo get github.com\u002Fredelay\u002Fgo-events@v0.3.0          # event bus + transports\n# add-ons, as you need them:\ngo get github.com\u002Fredelay\u002Fgo-modules@v0.43.1\ngo get github.com\u002Fredelay\u002Fgo-flowdsl@v0.1.16\ngo get github.com\u002Fredelay\u002Fgo-ai@v0.11.0\ngo get github.com\u002Fredelay\u002Fgo-module-email@v0.5.0\ngo mod tidy\n",[990,1204,1205,1215,1228,1233,1242,1251,1260,1269],{"__ignoreMap":1027},[1047,1206,1207,1209,1212],{"class":1049,"line":10},[1047,1208,1073],{"class":1052},[1047,1210,1211],{"class":1056}," get",[1047,1213,1214],{"class":1056}," github.com\u002Fredelay\u002Fgo-framework@v0.15.1\n",[1047,1216,1217,1219,1221,1224],{"class":1049,"line":16},[1047,1218,1073],{"class":1052},[1047,1220,1211],{"class":1056},[1047,1222,1223],{"class":1056}," github.com\u002Fredelay\u002Fgo-events@v0.3.0",[1047,1225,1227],{"class":1226},"sHwdD","          # event bus + transports\n",[1047,1229,1230],{"class":1049,"line":22},[1047,1231,1232],{"class":1226},"# add-ons, as you need them:\n",[1047,1234,1235,1237,1239],{"class":1049,"line":51},[1047,1236,1073],{"class":1052},[1047,1238,1211],{"class":1056},[1047,1240,1241],{"class":1056}," github.com\u002Fredelay\u002Fgo-modules@v0.43.1\n",[1047,1243,1244,1246,1248],{"class":1049,"line":57},[1047,1245,1073],{"class":1052},[1047,1247,1211],{"class":1056},[1047,1249,1250],{"class":1056}," github.com\u002Fredelay\u002Fgo-flowdsl@v0.1.16\n",[1047,1252,1253,1255,1257],{"class":1049,"line":102},[1047,1254,1073],{"class":1052},[1047,1256,1211],{"class":1056},[1047,1258,1259],{"class":1056}," github.com\u002Fredelay\u002Fgo-ai@v0.11.0\n",[1047,1261,1262,1264,1266],{"class":1049,"line":108},[1047,1263,1073],{"class":1052},[1047,1265,1211],{"class":1056},[1047,1267,1268],{"class":1056}," github.com\u002Fredelay\u002Fgo-module-email@v0.5.0\n",[1047,1270,1271,1273,1275],{"class":1049,"line":114},[1047,1272,1073],{"class":1052},[1047,1274,1076],{"class":1056},[1047,1276,1277],{"class":1056}," tidy\n",[974,1279,1280,1287,1288,1290,1291,1293,1294,1299,1300,1303,1304,1308],{},[1032,1281,1282,1283,1286],{},"Local dev against a sibling checkout — the ",[990,1284,1285],{},"go.work"," override."," When you edit\nthe framework and your app together, don't add ",[990,1289,1104],{}," directives to ",[990,1292,1097],{},"\n(that's the legacy \"Mode A\" and it leaks into every clone). Instead use a\n",[1032,1295,1296,1297],{},"gitignored ",[990,1298,1285],{}," — the Go-modules analog of the admin's gitignored\n",[990,1301,1302],{},"pnpm-workspace.yaml"," override (",[1305,1306,1307],"a",{"href":943},"see the admin version","):",[1019,1310,1313],{"className":1311,"code":1312,"language":1024},[1022],"\u002F\u002F go.work  (gitignored; commit a go.work.example template instead)\ngo 1.25.0\nuse (\n    .\n    ..\u002F..\u002Fredelay\u002Fgo-framework\n    ..\u002F..\u002Fredelay\u002Fgo-modules\n    \u002F\u002F … each sibling redelay module you're editing\n)\n",[990,1314,1312],{"__ignoreMap":1027},[974,1316,1317,1319,1320,1326],{},[990,1318,1097],{}," stays authoritative (a fresh clone \u002F CI builds against the pinned\nversions); the workspace overrides those with the local trees for dev. ",[1032,1321,1322,1323],{},"Never\ncommit ",[990,1324,1325],{},"go.work.sum"," — a sum generated by one Go toolchain makes a container on\na different toolchain misresolve a module and attempt a network fetch.",[974,1328,1329,1332,1333,1335,1336,1338,1339,1342],{},[1032,1330,1331],{},"Containers with no GitHub credentials."," Workspace mode still reads each pinned\nmodule's ",[990,1334,1097],{}," to compute the build graph, so a dev container (which can't\nfetch the private repos) needs those ",[990,1337,1097],{},"s available. Mount the ",[1032,1340,1341],{},"host module\ncache read-only"," and let the bind-mounted trees supply the source:",[1019,1344,1348],{"className":1345,"code":1346,"language":1347,"meta":1027,"style":1027},"language-yaml shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","environment:\n  GOFLAGS: -mod=readonly      # workspace mode forbids -mod=mod\n  GOTOOLCHAIN: local          # don't chase a newer toolchain\n  GOMODCACHE: \u002Fgomodcache\nvolumes:\n  - ${HOST_GOMODCACHE}:\u002Fgomodcache:ro   # `go env GOMODCACHE` on the host\n","yaml",[990,1349,1350,1359,1372,1385,1395,1402],{"__ignoreMap":1027},[1047,1351,1352,1356],{"class":1049,"line":10},[1047,1353,1355],{"class":1354},"swJcz","environment",[1047,1357,1358],{"class":1060},":\n",[1047,1360,1361,1364,1366,1369],{"class":1049,"line":16},[1047,1362,1363],{"class":1354},"  GOFLAGS",[1047,1365,1017],{"class":1060},[1047,1367,1368],{"class":1056}," -mod=readonly",[1047,1370,1371],{"class":1226},"      # workspace mode forbids -mod=mod\n",[1047,1373,1374,1377,1379,1382],{"class":1049,"line":22},[1047,1375,1376],{"class":1354},"  GOTOOLCHAIN",[1047,1378,1017],{"class":1060},[1047,1380,1381],{"class":1056}," local",[1047,1383,1384],{"class":1226},"          # don't chase a newer toolchain\n",[1047,1386,1387,1390,1392],{"class":1049,"line":51},[1047,1388,1389],{"class":1354},"  GOMODCACHE",[1047,1391,1017],{"class":1060},[1047,1393,1394],{"class":1056}," \u002Fgomodcache\n",[1047,1396,1397,1400],{"class":1049,"line":57},[1047,1398,1399],{"class":1354},"volumes",[1047,1401,1358],{"class":1060},[1047,1403,1404,1407,1410],{"class":1049,"line":102},[1047,1405,1406],{"class":1060},"  -",[1047,1408,1409],{"class":1056}," ${HOST_GOMODCACHE}:\u002Fgomodcache:ro",[1047,1411,1412],{"class":1226},"   # `go env GOMODCACHE` on the host\n",[974,1414,1415,1416,1419,1420,1423,1424,1426,1427,1430,1431,1437],{},"Full recipe (Makefile ",[990,1417,1418],{},"workspace","\u002F",[990,1421,1422],{},"deps"," targets, the mod-cache mount, the\nnever-commit-",[990,1425,1325],{}," gotcha): the starter kit scaffolds all of it with\n",[990,1428,1429],{},"create-redelay-app.sh"," (Mode B is the default) — see the\n",[1305,1432,1436],{"href":1433,"rel":1434},"https:\u002F\u002Fgithub.com\u002Fredelay\u002Fredelay-starter-kit",[1435],"nofollow","starter kit",".",[974,1439,1440,1441,1443],{},"Shipping a Mode B app — Dockerfile with SSH-forwarded private modules, swarm\nstack, push-to-deploy workflow — is covered in\n",[1305,1442,78],{"href":79},". The Redelay\nreference backend itself runs this way.",[1445,1446,1447,1094,1450,1453],"callout",{"icon":11},[1032,1448,1449],{},"Legacy Mode A",[990,1451,1452],{},"replace github.com\u002Fredelay\u002Fgo-framework => ..\u002Fgo-framework","\n— still works for hacking inside the monorepo, but a fresh clone \u002F CI can't build\nwithout the sibling trees and nothing is version-pinned. Prefer Mode B for any\nreal project.",[978,1455,1457],{"id":1456},"step-2-create-maingo","Step 2 — Create main.go",[974,1459,1460,1461,1017],{},"Create ",[990,1462,1463],{},"cmd\u002Fapi\u002Fmain.go",[1019,1465,1468],{"className":1466,"code":1467,"language":1073,"meta":1027,"style":1027},"language-go shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","package main\n\nimport (\n    \"log\"\n\n    \u002F\u002F Blank imports trigger init() factory registration\n    _ \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\u002Fasyncapi\"\n    _ \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\u002Fauth\"\n    _ \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\u002Fgroups\"\n    _ \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\u002Fhealth\"\n    _ \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\u002Fmcp\"\n    _ \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\u002Fmodspec\"\n    _ \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\u002Fopenapi\"\n    _ \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\u002Fusers\"\n\n    \"github.com\u002Fredelay\u002Fgo-framework\u002Fapp\"\n    \"github.com\u002Fredelay\u002Fgo-framework\u002Fserver\"\n)\n\nfunc main() {\n    inst, srv, err := server.Default()\n    if err != nil {\n        log.Fatal(err)\n    }\n    if err := app.Run(inst, srv); err != nil {\n        log.Fatal(err)\n    }\n}\n",[990,1469,1470,1475,1481,1486,1491,1495,1500,1505,1510,1515,1520,1525,1530,1535,1540,1544,1549,1554,1559,1563,1568,1573,1578,1584,1590,1595,1599,1603],{"__ignoreMap":1027},[1047,1471,1472],{"class":1049,"line":10},[1047,1473,1474],{},"package main\n",[1047,1476,1477],{"class":1049,"line":16},[1047,1478,1480],{"emptyLinePlaceholder":1479},true,"\n",[1047,1482,1483],{"class":1049,"line":22},[1047,1484,1485],{},"import (\n",[1047,1487,1488],{"class":1049,"line":51},[1047,1489,1490],{},"    \"log\"\n",[1047,1492,1493],{"class":1049,"line":57},[1047,1494,1480],{"emptyLinePlaceholder":1479},[1047,1496,1497],{"class":1049,"line":102},[1047,1498,1499],{},"    \u002F\u002F Blank imports trigger init() factory registration\n",[1047,1501,1502],{"class":1049,"line":108},[1047,1503,1504],{},"    _ \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\u002Fasyncapi\"\n",[1047,1506,1507],{"class":1049,"line":114},[1047,1508,1509],{},"    _ \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\u002Fauth\"\n",[1047,1511,1512],{"class":1049,"line":120},[1047,1513,1514],{},"    _ \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\u002Fgroups\"\n",[1047,1516,1517],{"class":1049,"line":181},[1047,1518,1519],{},"    _ \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\u002Fhealth\"\n",[1047,1521,1522],{"class":1049,"line":186},[1047,1523,1524],{},"    _ \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\u002Fmcp\"\n",[1047,1526,1527],{"class":1049,"line":191},[1047,1528,1529],{},"    _ \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\u002Fmodspec\"\n",[1047,1531,1532],{"class":1049,"line":197},[1047,1533,1534],{},"    _ \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\u002Fopenapi\"\n",[1047,1536,1537],{"class":1049,"line":203},[1047,1538,1539],{},"    _ \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\u002Fusers\"\n",[1047,1541,1542],{"class":1049,"line":214},[1047,1543,1480],{"emptyLinePlaceholder":1479},[1047,1545,1546],{"class":1049,"line":223},[1047,1547,1548],{},"    \"github.com\u002Fredelay\u002Fgo-framework\u002Fapp\"\n",[1047,1550,1551],{"class":1049,"line":229},[1047,1552,1553],{},"    \"github.com\u002Fredelay\u002Fgo-framework\u002Fserver\"\n",[1047,1555,1556],{"class":1049,"line":234},[1047,1557,1558],{},")\n",[1047,1560,1561],{"class":1049,"line":240},[1047,1562,1480],{"emptyLinePlaceholder":1479},[1047,1564,1565],{"class":1049,"line":246},[1047,1566,1567],{},"func main() {\n",[1047,1569,1570],{"class":1049,"line":251},[1047,1571,1572],{},"    inst, srv, err := server.Default()\n",[1047,1574,1575],{"class":1049,"line":257},[1047,1576,1577],{},"    if err != nil {\n",[1047,1579,1581],{"class":1049,"line":1580},23,[1047,1582,1583],{},"        log.Fatal(err)\n",[1047,1585,1587],{"class":1049,"line":1586},24,[1047,1588,1589],{},"    }\n",[1047,1591,1592],{"class":1049,"line":271},[1047,1593,1594],{},"    if err := app.Run(inst, srv); err != nil {\n",[1047,1596,1597],{"class":1049,"line":277},[1047,1598,1583],{},[1047,1600,1601],{"class":1049,"line":282},[1047,1602,1589],{},[1047,1604,1606],{"class":1049,"line":1605},28,[1047,1607,1608],{},"}\n",[974,1610,1611,1612,1615,1616,1619],{},"That's it. ",[990,1613,1614],{},"server.Default()"," bootstraps the app (connects MongoDB, discovers and starts\nmodules) and creates an HTTP runner. ",[990,1617,1618],{},"app.Run()"," starts the runner and handles signals.",[974,1621,1622],{},"The HTTP runner sets up:",[983,1624,1625,1628,1631,1637,1640,1650,1660,1670],{},[986,1626,1627],{},"CORS middleware",[986,1629,1630],{},"JWT parsing (OptionalAuth)",[986,1632,1633,1634],{},"Health check at ",[990,1635,1636],{},"{prefix}\u002Fhealth",[986,1638,1639],{},"All module routes (auth, users, etc.)",[986,1641,1642,1643,1646,1647],{},"OpenAPI spec at ",[990,1644,1645],{},"\u002Fopenapi.json"," + API reference UI at ",[990,1648,1649],{},"\u002Freference",[986,1651,1652,1653,1656,1657],{},"AsyncAPI spec at ",[990,1654,1655],{},"\u002Fasyncapi.json"," + event browser at ",[990,1658,1659],{},"\u002Fasyncapi",[986,1661,1662,1663,1666,1667,993],{},"Module spec browser at ",[990,1664,1665],{},"\u002Fmodules"," (+ ",[990,1668,1669],{},"\u002Fmodules.json",[986,1671,1672,1673],{},"MCP server at ",[990,1674,1675],{},"\u002Fmcp",[1084,1677,1679],{"id":1678},"how-auto-discovery-works","How auto-discovery works",[1681,1682,1683,1693,1703,1724,1734],"ol",{},[986,1684,1685,1686,1689,1690,993],{},"Each framework module registers a factory in its ",[990,1687,1688],{},"init()"," function (e.g. ",[990,1691,1692],{},"modules.RegisterFactory(\"auth\", ...)",[986,1694,1695,1696,1699,1700,1702],{},"Blank imports (",[990,1697,1698],{},"_ \"...\u002Fmodules\u002Fauth\"",") cause ",[990,1701,1688],{}," to run",[986,1704,1705,1708,1709,1712,1713,1716,1717,1720,1721,993],{},[990,1706,1707],{},"app.Bootstrap()"," calls ",[990,1710,1711],{},"DiscoverAndRegister()"," → all factories run, ",[990,1714,1715],{},"Configure"," phase resolves\ncross-dependencies (auth discovers users as its ",[990,1718,1719],{},"LookupProvider",", groups as ",[990,1722,1723],{},"PermissionsProvider",[986,1725,1726,1729,1730,1733],{},[990,1727,1728],{},"Start()"," topologically sorts modules by ",[990,1731,1732],{},"DependsOn"," and starts them in order",[986,1735,1736,1737,1740],{},"The HTTP runner iterates all modules implementing ",[990,1738,1739],{},"RoutesProvider",", registering their routes",[1084,1742,1744],{"id":1743},"multiple-transports","Multiple transports",[974,1746,1747],{},"The framework is transport-agnostic. The same modules can power HTTP, Kafka consumers,\nFlowDSL workers, gRPC servers, or WebSocket servers.",[974,1749,1750,1751,1754],{},"Wire an EventBus so all modules can publish and consume events. The recommended way is\nauto-wiring: blank-import the go-events lifecycle module and pick the transport with the\n",[990,1752,1753],{},"TRANSPORT"," env var:",[1019,1756,1758],{"className":1466,"code":1757,"language":1073,"meta":1027,"style":1027},"import (\n    _ \"github.com\u002Fredelay\u002Fgo-events\u002Fmodule\" \u002F\u002F creates the bus from env and injects it into ModuleDeps\n)\n",[990,1759,1760,1764,1769],{"__ignoreMap":1027},[1047,1761,1762],{"class":1049,"line":10},[1047,1763,1485],{},[1047,1765,1766],{"class":1049,"line":16},[1047,1767,1768],{},"    _ \"github.com\u002Fredelay\u002Fgo-events\u002Fmodule\" \u002F\u002F creates the bus from env and injects it into ModuleDeps\n",[1047,1770,1771],{"class":1049,"line":22},[1047,1772,1558],{},[1019,1774,1778],{"className":1775,"code":1776,"language":1777,"meta":1027,"style":1027},"language-env shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","TRANSPORT=memory   # memory | kafka | nats | redis  (default: kafka)\n","env",[990,1779,1780],{"__ignoreMap":1027},[1047,1781,1782],{"class":1049,"line":10},[1047,1783,1776],{},[974,1785,1786,1789,1790,1792,1793,1796,1797,1094,1804,1807,1808,1811,1812,1815],{},[990,1787,1788],{},"memory"," needs no broker — use it for local development and tests. The lifecycle module\nregisters every module's consumers during ",[990,1791,1715],{}," and starts the bus during ",[990,1794,1795],{},"Startup",",\nso ",[1032,1798,1799,1800,1803],{},"do not call ",[990,1801,1802],{},"bus.Start"," yourself",[990,1805,1806],{},"eventbus.EventBus"," ignores consumers registered\nafter ",[990,1809,1810],{},"Start",", and calling it before ",[990,1813,1814],{},"app.Bootstrap"," silently drops every module consumer.",[974,1817,1818,1819,1822],{},"To supply your own transport instead, pass the bus with ",[990,1820,1821],{},"app.WithEventBus"," and keep the\nblank import — the lifecycle module then registers consumers on, and starts, the bus you\npassed:",[1019,1824,1826],{"className":1466,"code":1825,"language":1073,"meta":1027,"style":1027},"import (\n    \"github.com\u002Fredelay\u002Fgo-events\u002Feventbus\"\n    \"github.com\u002Fredelay\u002Fgo-events\u002Ftransport\u002Fkafka\"\n    _ \"github.com\u002Fredelay\u002Fgo-events\u002Fmodule\"\n)\n\nt, err := kafka.NewFromEnv() \u002F\u002F reads KAFKA_BOOTSTRAP_SERVERS etc.\nif err != nil { log.Fatal(err) }\nbus := eventbus.New(t)\n\ninst, err := app.Bootstrap(app.WithEventBus(bus)) \u002F\u002F no bus.Start — Startup does it\n",[990,1827,1828,1832,1837,1842,1847,1851,1855,1860,1865,1870,1874],{"__ignoreMap":1027},[1047,1829,1830],{"class":1049,"line":10},[1047,1831,1485],{},[1047,1833,1834],{"class":1049,"line":16},[1047,1835,1836],{},"    \"github.com\u002Fredelay\u002Fgo-events\u002Feventbus\"\n",[1047,1838,1839],{"class":1049,"line":22},[1047,1840,1841],{},"    \"github.com\u002Fredelay\u002Fgo-events\u002Ftransport\u002Fkafka\"\n",[1047,1843,1844],{"class":1049,"line":51},[1047,1845,1846],{},"    _ \"github.com\u002Fredelay\u002Fgo-events\u002Fmodule\"\n",[1047,1848,1849],{"class":1049,"line":57},[1047,1850,1558],{},[1047,1852,1853],{"class":1049,"line":102},[1047,1854,1480],{"emptyLinePlaceholder":1479},[1047,1856,1857],{"class":1049,"line":108},[1047,1858,1859],{},"t, err := kafka.NewFromEnv() \u002F\u002F reads KAFKA_BOOTSTRAP_SERVERS etc.\n",[1047,1861,1862],{"class":1049,"line":114},[1047,1863,1864],{},"if err != nil { log.Fatal(err) }\n",[1047,1866,1867],{"class":1049,"line":120},[1047,1868,1869],{},"bus := eventbus.New(t)\n",[1047,1871,1872],{"class":1049,"line":181},[1047,1873,1480],{"emptyLinePlaceholder":1479},[1047,1875,1876],{"class":1049,"line":186},[1047,1877,1878],{},"inst, err := app.Bootstrap(app.WithEventBus(bus)) \u002F\u002F no bus.Start — Startup does it\n",[974,1880,1881,1882,1885],{},"See ",[1305,1883,1884],{"href":150},"go-events"," for the transport env vars.",[974,1887,1888,1889,1892,1893,1896,1897,1899],{},"Modules receive ",[990,1890,1891],{},"ModuleDeps.EventBus"," and call ",[990,1894,1895],{},"bus.Publish(ctx, msg)"," — they never\nimport Kafka or Redis directly. See ",[1305,1898,38],{"href":39}," for the full API.",[978,1901,1903],{"id":1902},"step-3-configure-environment","Step 3 — Configure environment",[974,1905,1460,1906,1017],{},[990,1907,1908],{},".env.example",[1019,1910,1912],{"className":1775,"code":1911,"language":1777,"meta":1027,"style":1027},"HOST=0.0.0.0\nPORT=8000\nENV=development\nROUTE_PREFIX=\u002Fapi\u002Fv1\nMONGO_URI=mongodb:\u002F\u002Flocalhost:27017\nMONGO_DATABASE=myapp\nCORS_ORIGINS=http:\u002F\u002Flocalhost:3000\nAUTH_JWT_SECRET=change-me-in-production\nTRANSPORT=memory   # only read when go-events\u002Fmodule is imported\n",[990,1913,1914,1919,1924,1929,1934,1939,1944,1949,1954],{"__ignoreMap":1027},[1047,1915,1916],{"class":1049,"line":10},[1047,1917,1918],{},"HOST=0.0.0.0\n",[1047,1920,1921],{"class":1049,"line":16},[1047,1922,1923],{},"PORT=8000\n",[1047,1925,1926],{"class":1049,"line":22},[1047,1927,1928],{},"ENV=development\n",[1047,1930,1931],{"class":1049,"line":51},[1047,1932,1933],{},"ROUTE_PREFIX=\u002Fapi\u002Fv1\n",[1047,1935,1936],{"class":1049,"line":57},[1047,1937,1938],{},"MONGO_URI=mongodb:\u002F\u002Flocalhost:27017\n",[1047,1940,1941],{"class":1049,"line":102},[1047,1942,1943],{},"MONGO_DATABASE=myapp\n",[1047,1945,1946],{"class":1049,"line":108},[1047,1947,1948],{},"CORS_ORIGINS=http:\u002F\u002Flocalhost:3000\n",[1047,1950,1951],{"class":1049,"line":114},[1047,1952,1953],{},"AUTH_JWT_SECRET=change-me-in-production\n",[1047,1955,1956],{"class":1049,"line":120},[1047,1957,1958],{},"TRANSPORT=memory   # only read when go-events\u002Fmodule is imported\n",[978,1960,1962],{"id":1961},"step-4-adding-custom-routes","Step 4 — Adding custom routes",[974,1964,1965,1966,1969],{},"Use ",[990,1967,1968],{},"srv.Router()"," to access the underlying chi router and add custom endpoints:",[1019,1971,1973],{"className":1466,"code":1972,"language":1073,"meta":1027,"style":1027},"func main() {\n    inst, srv, err := server.Default()\n    if err != nil {\n        log.Fatal(err)\n    }\n\n    \u002F\u002F Add a custom route\n    srv.Router().Get(\"\u002Fapi\u002Fv1\u002Fping\", func(w http.ResponseWriter, r *http.Request) {\n        httputil.WriteJSON(w, http.StatusOK, map[string]string{\"pong\": \"ok\"})\n    })\n\n    log.Fatal(app.Run(inst, srv))\n}\n",[990,1974,1975,1979,1983,1987,1991,1995,1999,2004,2009,2014,2019,2023,2028],{"__ignoreMap":1027},[1047,1976,1977],{"class":1049,"line":10},[1047,1978,1567],{},[1047,1980,1981],{"class":1049,"line":16},[1047,1982,1572],{},[1047,1984,1985],{"class":1049,"line":22},[1047,1986,1577],{},[1047,1988,1989],{"class":1049,"line":51},[1047,1990,1583],{},[1047,1992,1993],{"class":1049,"line":57},[1047,1994,1589],{},[1047,1996,1997],{"class":1049,"line":102},[1047,1998,1480],{"emptyLinePlaceholder":1479},[1047,2000,2001],{"class":1049,"line":108},[1047,2002,2003],{},"    \u002F\u002F Add a custom route\n",[1047,2005,2006],{"class":1049,"line":114},[1047,2007,2008],{},"    srv.Router().Get(\"\u002Fapi\u002Fv1\u002Fping\", func(w http.ResponseWriter, r *http.Request) {\n",[1047,2010,2011],{"class":1049,"line":120},[1047,2012,2013],{},"        httputil.WriteJSON(w, http.StatusOK, map[string]string{\"pong\": \"ok\"})\n",[1047,2015,2016],{"class":1049,"line":181},[1047,2017,2018],{},"    })\n",[1047,2020,2021],{"class":1049,"line":186},[1047,2022,1480],{"emptyLinePlaceholder":1479},[1047,2024,2025],{"class":1049,"line":191},[1047,2026,2027],{},"    log.Fatal(app.Run(inst, srv))\n",[1047,2029,2030],{"class":1049,"line":197},[1047,2031,1608],{},[978,2033,2035],{"id":2034},"step-5-advanced-full-control","Step 5 — Advanced: full control",[974,2037,2038],{},"For cases where you need full control over the app lifecycle:",[1019,2040,2042],{"className":1466,"code":2041,"language":1073,"meta":1027,"style":1027},"package main\n\nimport (\n    \"context\"\n    \"log\"\n    \"time\"\n\n    \"go.mongodb.org\u002Fmongo-driver\u002Fmongo\"\n    \"go.mongodb.org\u002Fmongo-driver\u002Fmongo\u002Foptions\"\n    \"go.uber.org\u002Fzap\"\n\n    \"github.com\u002Fredelay\u002Fgo-framework\u002Fapp\"\n    \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\"\n    \"github.com\u002Fredelay\u002Fgo-framework\u002Fserver\"\n\n    _ \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\u002Fauth\"\n    _ \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\u002Fgroups\"\n    _ \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\u002Fusers\"\n)\n\nfunc main() {\n    logger, _ := zap.NewDevelopment()\n\n    ctx, cancel := context.WithTimeout(context.Background(), 15*time.Second)\n    client, _ := mongo.Connect(ctx, options.Client().ApplyURI(\"mongodb:\u002F\u002Flocalhost:27017\"))\n    cancel()\n\n    application := app.New(\"myapp\", logger)\n    application.DiscoverAndRegister(modules.ModuleDeps{\n        DB:     client.Database(\"myapp\"),\n        Logger: logger,\n    })\n    application.Start(context.Background())\n\n    inst := &app.Instance{App: application, MongoClient: client, Logger: logger}\n    srv := server.FromInstance(inst, server.LoadConfig())\n    \u002F\u002F Add custom routes, middleware, etc.\n    log.Fatal(app.Run(inst, srv))\n}\n",[990,2043,2044,2048,2052,2056,2061,2065,2070,2074,2079,2084,2089,2093,2097,2102,2106,2110,2114,2118,2122,2126,2130,2134,2139,2143,2148,2153,2158,2162,2167,2173,2179,2185,2190,2196,2201,2207,2213,2219,2224],{"__ignoreMap":1027},[1047,2045,2046],{"class":1049,"line":10},[1047,2047,1474],{},[1047,2049,2050],{"class":1049,"line":16},[1047,2051,1480],{"emptyLinePlaceholder":1479},[1047,2053,2054],{"class":1049,"line":22},[1047,2055,1485],{},[1047,2057,2058],{"class":1049,"line":51},[1047,2059,2060],{},"    \"context\"\n",[1047,2062,2063],{"class":1049,"line":57},[1047,2064,1490],{},[1047,2066,2067],{"class":1049,"line":102},[1047,2068,2069],{},"    \"time\"\n",[1047,2071,2072],{"class":1049,"line":108},[1047,2073,1480],{"emptyLinePlaceholder":1479},[1047,2075,2076],{"class":1049,"line":114},[1047,2077,2078],{},"    \"go.mongodb.org\u002Fmongo-driver\u002Fmongo\"\n",[1047,2080,2081],{"class":1049,"line":120},[1047,2082,2083],{},"    \"go.mongodb.org\u002Fmongo-driver\u002Fmongo\u002Foptions\"\n",[1047,2085,2086],{"class":1049,"line":181},[1047,2087,2088],{},"    \"go.uber.org\u002Fzap\"\n",[1047,2090,2091],{"class":1049,"line":186},[1047,2092,1480],{"emptyLinePlaceholder":1479},[1047,2094,2095],{"class":1049,"line":191},[1047,2096,1548],{},[1047,2098,2099],{"class":1049,"line":197},[1047,2100,2101],{},"    \"github.com\u002Fredelay\u002Fgo-framework\u002Fmodules\"\n",[1047,2103,2104],{"class":1049,"line":203},[1047,2105,1553],{},[1047,2107,2108],{"class":1049,"line":214},[1047,2109,1480],{"emptyLinePlaceholder":1479},[1047,2111,2112],{"class":1049,"line":223},[1047,2113,1509],{},[1047,2115,2116],{"class":1049,"line":229},[1047,2117,1514],{},[1047,2119,2120],{"class":1049,"line":234},[1047,2121,1539],{},[1047,2123,2124],{"class":1049,"line":240},[1047,2125,1558],{},[1047,2127,2128],{"class":1049,"line":246},[1047,2129,1480],{"emptyLinePlaceholder":1479},[1047,2131,2132],{"class":1049,"line":251},[1047,2133,1567],{},[1047,2135,2136],{"class":1049,"line":257},[1047,2137,2138],{},"    logger, _ := zap.NewDevelopment()\n",[1047,2140,2141],{"class":1049,"line":1580},[1047,2142,1480],{"emptyLinePlaceholder":1479},[1047,2144,2145],{"class":1049,"line":1586},[1047,2146,2147],{},"    ctx, cancel := context.WithTimeout(context.Background(), 15*time.Second)\n",[1047,2149,2150],{"class":1049,"line":271},[1047,2151,2152],{},"    client, _ := mongo.Connect(ctx, options.Client().ApplyURI(\"mongodb:\u002F\u002Flocalhost:27017\"))\n",[1047,2154,2155],{"class":1049,"line":277},[1047,2156,2157],{},"    cancel()\n",[1047,2159,2160],{"class":1049,"line":282},[1047,2161,1480],{"emptyLinePlaceholder":1479},[1047,2163,2164],{"class":1049,"line":1605},[1047,2165,2166],{},"    application := app.New(\"myapp\", logger)\n",[1047,2168,2170],{"class":1049,"line":2169},29,[1047,2171,2172],{},"    application.DiscoverAndRegister(modules.ModuleDeps{\n",[1047,2174,2176],{"class":1049,"line":2175},30,[1047,2177,2178],{},"        DB:     client.Database(\"myapp\"),\n",[1047,2180,2182],{"class":1049,"line":2181},31,[1047,2183,2184],{},"        Logger: logger,\n",[1047,2186,2188],{"class":1049,"line":2187},32,[1047,2189,2018],{},[1047,2191,2193],{"class":1049,"line":2192},33,[1047,2194,2195],{},"    application.Start(context.Background())\n",[1047,2197,2199],{"class":1049,"line":2198},34,[1047,2200,1480],{"emptyLinePlaceholder":1479},[1047,2202,2204],{"class":1049,"line":2203},35,[1047,2205,2206],{},"    inst := &app.Instance{App: application, MongoClient: client, Logger: logger}\n",[1047,2208,2210],{"class":1049,"line":2209},36,[1047,2211,2212],{},"    srv := server.FromInstance(inst, server.LoadConfig())\n",[1047,2214,2216],{"class":1049,"line":2215},37,[1047,2217,2218],{},"    \u002F\u002F Add custom routes, middleware, etc.\n",[1047,2220,2222],{"class":1049,"line":2221},38,[1047,2223,2027],{},[1047,2225,2227],{"class":1049,"line":2226},39,[1047,2228,1608],{},[978,2230,2232],{"id":2231},"module-routes","Module routes",[974,2234,2235,2236,1017],{},"Built-in modules expose their routes automatically via ",[990,2237,1739],{},[1084,2239,2241,2242,993],{"id":2240},"auth-module-routes-under-auth","auth module routes (under ",[990,2243,2244],{},"\u002Fauth",[983,2246,2247,2259,2265],{},[986,2248,2249,2252,2253,1419,2256,993],{},[990,2250,2251],{},"POST \u002Flogin"," — Login with email + password (also supports OAuth2 form ",[990,2254,2255],{},"username",[990,2257,2258],{},"password",[986,2260,2261,2264],{},[990,2262,2263],{},"POST \u002Frefresh"," — Refresh token pair",[986,2266,2267,2270],{},[990,2268,2269],{},"POST \u002Frevoke"," — Revoke a refresh token",[1084,2272,2274,2275,993],{"id":2273},"users-module-routes-under-users","users module routes (under ",[990,2276,2277],{},"\u002Fusers",[983,2279,2280,2286,2292,2298,2304,2316],{},[986,2281,2282,2285],{},[990,2283,2284],{},"GET \u002Fme"," — Current user profile (authenticated)",[986,2287,2288,2291],{},[990,2289,2290],{},"GET \u002F"," — List users (superuser only)",[986,2293,2294,2297],{},[990,2295,2296],{},"POST \u002F"," — Create user (superuser only)",[986,2299,2300,2303],{},[990,2301,2302],{},"GET \u002F{id}"," — Get user by ID (self or superuser)",[986,2305,2306,2309,2310,1419,2313,993],{},[990,2307,2308],{},"PATCH \u002F{id}"," — Update user (self or superuser; non-superusers cannot change ",[990,2311,2312],{},"is_active",[990,2314,2315],{},"is_superuser",[986,2317,2318,2321],{},[990,2319,2320],{},"DELETE \u002F{id}"," — Delete user (superuser only)",[974,2323,2324,2325,2328,2329,2332,2333,1437],{},"All routes are served under the configured ",[990,2326,2327],{},"ROUTE_PREFIX"," (default ",[990,2330,2331],{},"\u002Fapi\u002Fv1","), so the\nfull path for login is ",[990,2334,2335],{},"POST \u002Fapi\u002Fv1\u002Fauth\u002Flogin",[978,2337,2339],{"id":2338},"built-in-middleware","Built-in middleware",[974,2341,2342,2343,2346],{},"The auth module provides ",[990,2344,2345],{},"net\u002Fhttp"," middleware you can use with chi:",[2348,2349,2350,2363],"table",{},[2351,2352,2353],"thead",{},[2354,2355,2356,2360],"tr",{},[2357,2358,2359],"th",{},"Middleware",[2357,2361,2362],{},"Description",[2364,2365,2366,2377,2387,2397,2410,2420,2430],"tbody",{},[2354,2367,2368,2374],{},[2369,2370,2371],"td",{},[990,2372,2373],{},"auth.AuthMiddleware(jwtCfg)",[2369,2375,2376],{},"Require valid JWT; rejects unauthenticated requests",[2354,2378,2379,2384],{},[2369,2380,2381],{},[990,2382,2383],{},"auth.OptionalAuth(jwtCfg)",[2369,2385,2386],{},"Parse JWT if present, continue if absent",[2354,2388,2389,2394],{},[2369,2390,2391],{},[990,2392,2393],{},"auth.RequireActiveUser",[2369,2395,2396],{},"Ensure claims exist in context",[2354,2398,2399,2404],{},[2369,2400,2401],{},[990,2402,2403],{},"auth.RequireSuperuser",[2369,2405,2406,2407],{},"Require ",[990,2408,2409],{},"is_superuser == true",[2354,2411,2412,2417],{},[2369,2413,2414],{},[990,2415,2416],{},"auth.RequirePermission(\"perm\")",[2369,2418,2419],{},"Check specific permission (superusers bypass)",[2354,2421,2422,2427],{},[2369,2423,2424],{},[990,2425,2426],{},"auth.RequireAnyPermission(\"a\",\"b\")",[2369,2428,2429],{},"Check any of the listed permissions",[2354,2431,2432,2437],{},[2369,2433,2434],{},[990,2435,2436],{},"auth.APISecretMiddleware(secret)",[2369,2438,2439,2440,2443],{},"Validate ",[990,2441,2442],{},"X-API-Secret"," header",[978,2445,2447],{"id":2446},"permissions","Permissions",[974,2449,2450],{},"Permissions are resolved at login\u002Frefresh time from the user's groups and embedded in the JWT:",[1681,2452,2453,2459,2466,2473,2479],{},[986,2454,2455,2456],{},"User model has ",[990,2457,2458],{},"user_groups []ObjectID",[986,2460,2461,2462,2465],{},"Groups module stores ",[990,2463,2464],{},"permissions []string"," per group",[986,2467,2468,2469,2472],{},"At login, auth module calls ",[990,2470,2471],{},"PermissionsResolver.ResolvePermissions(ctx, groupIDs)"," → gets union of all group permissions",[986,2474,2475,2476],{},"Permissions are embedded in ",[990,2477,2478],{},"Claims.Permissions",[986,2480,2481,2484,2485,2487],{},[990,2482,2483],{},"RequirePermission(\"users:write\")"," checks ",[990,2486,2478],{}," — O(1) per request, no DB lookup",[978,2489,2491],{"id":2490},"environment-variables","Environment variables",[1084,2493,2495],{"id":2494},"bootstrap-all-transports","Bootstrap (all transports)",[2348,2497,2498,2510],{},[2351,2499,2500],{},[2354,2501,2502,2505,2508],{},[2357,2503,2504],{},"Variable",[2357,2506,2507],{},"Default",[2357,2509,2362],{},[2364,2511,2512,2526,2541,2556,2571,2585],{},[2354,2513,2514,2519,2523],{},[2369,2515,2516],{},[990,2517,2518],{},"APP_NAME",[2369,2520,2521],{},[990,2522,1005],{},[2369,2524,2525],{},"Application name",[2354,2527,2528,2533,2538],{},[2369,2529,2530],{},[990,2531,2532],{},"ENV",[2369,2534,2535],{},[990,2536,2537],{},"development",[2369,2539,2540],{},"Environment name",[2354,2542,2543,2548,2553],{},[2369,2544,2545],{},[990,2546,2547],{},"DEBUG",[2369,2549,2550],{},[990,2551,2552],{},"false",[2369,2554,2555],{},"Debug mode",[2354,2557,2558,2563,2568],{},[2369,2559,2560],{},[990,2561,2562],{},"MONGO_URI",[2369,2564,2565],{},[990,2566,2567],{},"mongodb:\u002F\u002Flocalhost:27017",[2369,2569,2570],{},"MongoDB connection string",[2354,2572,2573,2578,2582],{},[2369,2574,2575],{},[990,2576,2577],{},"MONGO_DATABASE",[2369,2579,2580],{},[990,2581,1005],{},[2369,2583,2584],{},"Database name",[2354,2586,2587,2592,2597],{},[2369,2588,2589],{},[990,2590,2591],{},"MONGO_TIMEOUT_SECONDS",[2369,2593,2594],{},[990,2595,2596],{},"15",[2369,2598,2599],{},"Connection timeout",[1084,2601,2603],{"id":2602},"http-server","HTTP server",[2348,2605,2606,2616],{},[2351,2607,2608],{},[2354,2609,2610,2612,2614],{},[2357,2611,2504],{},[2357,2613,2507],{},[2357,2615,2362],{},[2364,2617,2618,2633,2648,2661],{},[2354,2619,2620,2625,2630],{},[2369,2621,2622],{},[990,2623,2624],{},"HOST",[2369,2626,2627],{},[990,2628,2629],{},"0.0.0.0",[2369,2631,2632],{},"Listen host",[2354,2634,2635,2640,2645],{},[2369,2636,2637],{},[990,2638,2639],{},"PORT",[2369,2641,2642],{},[990,2643,2644],{},"8000",[2369,2646,2647],{},"Listen port",[2354,2649,2650,2654,2658],{},[2369,2651,2652],{},[990,2653,2327],{},[2369,2655,2656],{},[990,2657,2331],{},[2369,2659,2660],{},"API route prefix",[2354,2662,2663,2668,2673],{},[2369,2664,2665],{},[990,2666,2667],{},"CORS_ORIGINS",[2369,2669,2670],{},[990,2671,2672],{},"*",[2369,2674,2675],{},"Comma-separated allowed origins",[1084,2677,2679],{"id":2678},"auth-module","Auth module",[2348,2681,2682,2692],{},[2351,2683,2684],{},[2354,2685,2686,2688,2690],{},[2357,2687,2504],{},[2357,2689,2507],{},[2357,2691,2362],{},[2364,2693,2694,2709,2724,2739],{},[2354,2695,2696,2701,2706],{},[2369,2697,2698],{},[990,2699,2700],{},"AUTH_JWT_SECRET",[2369,2702,2703],{},[990,2704,2705],{},"change-me",[2369,2707,2708],{},"JWT signing secret",[2354,2710,2711,2716,2721],{},[2369,2712,2713],{},[990,2714,2715],{},"AUTH_JWT_ALGORITHM",[2369,2717,2718],{},[990,2719,2720],{},"HS256",[2369,2722,2723],{},"JWT algorithm (HS256\u002FHS384\u002FHS512)",[2354,2725,2726,2731,2736],{},[2369,2727,2728],{},[990,2729,2730],{},"AUTH_ACCESS_TOKEN_TTL_MINUTES",[2369,2732,2733],{},[990,2734,2735],{},"30",[2369,2737,2738],{},"Access token lifetime",[2354,2740,2741,2746,2751],{},[2369,2742,2743],{},[990,2744,2745],{},"AUTH_REFRESH_TOKEN_TTL_DAYS",[2369,2747,2748],{},[990,2749,2750],{},"7",[2369,2752,2753],{},"Refresh token lifetime",[1084,2755,2757],{"id":2756},"users-module","Users module",[2348,2759,2760,2770],{},[2351,2761,2762],{},[2354,2763,2764,2766,2768],{},[2357,2765,2504],{},[2357,2767,2507],{},[2357,2769,2362],{},[2364,2771,2772,2787,2802],{},[2354,2773,2774,2779,2784],{},[2369,2775,2776],{},[990,2777,2778],{},"USERS_COLLECTION",[2369,2780,2781],{},[990,2782,2783],{},"users",[2369,2785,2786],{},"MongoDB collection name",[2354,2788,2789,2794,2799],{},[2369,2790,2791],{},[990,2792,2793],{},"USERS_DEFAULT_PAGE_SIZE",[2369,2795,2796],{},[990,2797,2798],{},"20",[2369,2800,2801],{},"Default pagination size",[2354,2803,2804,2809,2814],{},[2369,2805,2806],{},[990,2807,2808],{},"USERS_MAX_PAGE_SIZE",[2369,2810,2811],{},[990,2812,2813],{},"100",[2369,2815,2816],{},"Maximum pagination size",[1084,2818,2820],{"id":2819},"groups-module","Groups module",[2348,2822,2823,2833],{},[2351,2824,2825],{},[2354,2826,2827,2829,2831],{},[2357,2828,2504],{},[2357,2830,2507],{},[2357,2832,2362],{},[2364,2834,2835],{},[2354,2836,2837,2842,2847],{},[2369,2838,2839],{},[990,2840,2841],{},"GROUPS_COLLECTION",[2369,2843,2844],{},[990,2845,2846],{},"groups",[2369,2848,2786],{},[978,2850,2852],{"id":2851},"local-development","Local development",[974,2854,2855,2856,2859,2860,1017],{},"The app needs MongoDB (and Redis only if you use Redis-backed features). A minimal\n",[990,2857,2858],{},"docker-compose.yml"," next to ",[990,2861,1097],{},[1019,2863,2865],{"className":1345,"code":2864,"language":1347,"meta":1027,"style":1027},"services:\n  mongo:\n    image: mongo:7\n    ports: [\"27017:27017\"]\n    volumes: [mongo-data:\u002Fdata\u002Fdb]\n  redis:            # optional\n    image: redis:7\n    ports: [\"6379:6379\"]\nvolumes:\n  mongo-data:\n",[990,2866,2867,2874,2881,2891,2911,2925,2935,2944,2961,2967],{"__ignoreMap":1027},[1047,2868,2869,2872],{"class":1049,"line":10},[1047,2870,2871],{"class":1354},"services",[1047,2873,1358],{"class":1060},[1047,2875,2876,2879],{"class":1049,"line":16},[1047,2877,2878],{"class":1354},"  mongo",[1047,2880,1358],{"class":1060},[1047,2882,2883,2886,2888],{"class":1049,"line":22},[1047,2884,2885],{"class":1354},"    image",[1047,2887,1017],{"class":1060},[1047,2889,2890],{"class":1056}," mongo:7\n",[1047,2892,2893,2896,2898,2901,2903,2906,2908],{"class":1049,"line":51},[1047,2894,2895],{"class":1354},"    ports",[1047,2897,1017],{"class":1060},[1047,2899,2900],{"class":1060}," [",[1047,2902,1150],{"class":1060},[1047,2904,2905],{"class":1056},"27017:27017",[1047,2907,1150],{"class":1060},[1047,2909,2910],{"class":1060},"]\n",[1047,2912,2913,2916,2918,2920,2923],{"class":1049,"line":57},[1047,2914,2915],{"class":1354},"    volumes",[1047,2917,1017],{"class":1060},[1047,2919,2900],{"class":1060},[1047,2921,2922],{"class":1056},"mongo-data:\u002Fdata\u002Fdb",[1047,2924,2910],{"class":1060},[1047,2926,2927,2930,2932],{"class":1049,"line":102},[1047,2928,2929],{"class":1354},"  redis",[1047,2931,1017],{"class":1060},[1047,2933,2934],{"class":1226},"            # optional\n",[1047,2936,2937,2939,2941],{"class":1049,"line":108},[1047,2938,2885],{"class":1354},[1047,2940,1017],{"class":1060},[1047,2942,2943],{"class":1056}," redis:7\n",[1047,2945,2946,2948,2950,2952,2954,2957,2959],{"class":1049,"line":114},[1047,2947,2895],{"class":1354},[1047,2949,1017],{"class":1060},[1047,2951,2900],{"class":1060},[1047,2953,1150],{"class":1060},[1047,2955,2956],{"class":1056},"6379:6379",[1047,2958,1150],{"class":1060},[1047,2960,2910],{"class":1060},[1047,2962,2963,2965],{"class":1049,"line":120},[1047,2964,1399],{"class":1354},[1047,2966,1358],{"class":1060},[1047,2968,2969,2972],{"class":1049,"line":181},[1047,2970,2971],{"class":1354},"  mongo-data",[1047,2973,1358],{"class":1060},[1019,2975,2977],{"className":1041,"code":2976,"language":1043,"meta":1027,"style":1027},"docker compose up -d        # start dependencies\ncp .env.example .env        # then export it, e.g. `set -a; . .\u002F.env; set +a`\ngo run .\u002Fcmd\u002Fapi            # run the app\n",[990,2978,2979,2996,3010],{"__ignoreMap":1027},[1047,2980,2981,2984,2987,2990,2993],{"class":1049,"line":10},[1047,2982,2983],{"class":1052},"docker",[1047,2985,2986],{"class":1056}," compose",[1047,2988,2989],{"class":1056}," up",[1047,2991,2992],{"class":1056}," -d",[1047,2994,2995],{"class":1226},"        # start dependencies\n",[1047,2997,2998,3001,3004,3007],{"class":1049,"line":16},[1047,2999,3000],{"class":1052},"cp",[1047,3002,3003],{"class":1056}," .env.example",[1047,3005,3006],{"class":1056}," .env",[1047,3008,3009],{"class":1226},"        # then export it, e.g. `set -a; . .\u002F.env; set +a`\n",[1047,3011,3012,3014,3017,3020],{"class":1049,"line":22},[1047,3013,1073],{"class":1052},[1047,3015,3016],{"class":1056}," run",[1047,3018,3019],{"class":1056}," .\u002Fcmd\u002Fapi",[1047,3021,3022],{"class":1226},"            # run the app\n",[974,3024,3025,3026,3029,3030,3033,3034,3037,3038,3041],{},"The ",[1305,3027,1436],{"href":1433,"rel":3028},[1435]," scaffolds the same\nthing (",[990,3031,3032],{},"infra\u002Fdocker-compose.yml",", plus a Mongo-only ",[990,3035,3036],{},"docker-compose.min.yml"," meant to\npair with ",[990,3039,3040],{},"TRANSPORT=memory",").",[978,3043,3045],{"id":3044},"available-endpoints","Available endpoints",[2348,3047,3048,3060],{},[2351,3049,3050],{},[2354,3051,3052,3055,3058],{},[2357,3053,3054],{},"Method",[2357,3056,3057],{},"Path",[2357,3059,2362],{},[2364,3061,3062,3077,3092,3106,3120,3134,3148,3161,3175,3189,3203,3216,3229,3242,3255,3268,3281],{},[2354,3063,3064,3069,3074],{},[2369,3065,3066],{},[990,3067,3068],{},"GET",[2369,3070,3071],{},[990,3072,3073],{},"\u002Fapi\u002Fv1\u002Fhealth",[2369,3075,3076],{},"Health check",[2354,3078,3079,3084,3089],{},[2369,3080,3081],{},[990,3082,3083],{},"POST",[2369,3085,3086],{},[990,3087,3088],{},"\u002Fapi\u002Fv1\u002Fauth\u002Flogin",[2369,3090,3091],{},"Login (email + password, or OAuth2 form)",[2354,3093,3094,3098,3103],{},[2369,3095,3096],{},[990,3097,3083],{},[2369,3099,3100],{},[990,3101,3102],{},"\u002Fapi\u002Fv1\u002Fauth\u002Frefresh",[2369,3104,3105],{},"Refresh token pair",[2354,3107,3108,3112,3117],{},[2369,3109,3110],{},[990,3111,3083],{},[2369,3113,3114],{},[990,3115,3116],{},"\u002Fapi\u002Fv1\u002Fauth\u002Frevoke",[2369,3118,3119],{},"Revoke refresh token",[2354,3121,3122,3126,3131],{},[2369,3123,3124],{},[990,3125,3068],{},[2369,3127,3128],{},[990,3129,3130],{},"\u002Fapi\u002Fv1\u002Fusers\u002Fme",[2369,3132,3133],{},"Current user profile",[2354,3135,3136,3140,3145],{},[2369,3137,3138],{},[990,3139,3068],{},[2369,3141,3142],{},[990,3143,3144],{},"\u002Fapi\u002Fv1\u002Fusers",[2369,3146,3147],{},"List users (admin)",[2354,3149,3150,3154,3158],{},[2369,3151,3152],{},[990,3153,3083],{},[2369,3155,3156],{},[990,3157,3144],{},[2369,3159,3160],{},"Create user (admin)",[2354,3162,3163,3167,3172],{},[2369,3164,3165],{},[990,3166,3068],{},[2369,3168,3169],{},[990,3170,3171],{},"\u002Fapi\u002Fv1\u002Fusers\u002F{id}",[2369,3173,3174],{},"Get user by ID",[2354,3176,3177,3182,3186],{},[2369,3178,3179],{},[990,3180,3181],{},"PATCH",[2369,3183,3184],{},[990,3185,3171],{},[2369,3187,3188],{},"Update user",[2354,3190,3191,3196,3200],{},[2369,3192,3193],{},[990,3194,3195],{},"DELETE",[2369,3197,3198],{},[990,3199,3171],{},[2369,3201,3202],{},"Delete user (admin)",[2354,3204,3205,3209,3213],{},[2369,3206,3207],{},[990,3208,3068],{},[2369,3210,3211],{},[990,3212,1645],{},[2369,3214,3215],{},"OpenAPI 3.0 spec",[2354,3217,3218,3222,3226],{},[2369,3219,3220],{},[990,3221,3068],{},[2369,3223,3224],{},[990,3225,1649],{},[2369,3227,3228],{},"API reference UI (Scalar\u002FSwagger\u002FRedoc)",[2354,3230,3231,3235,3239],{},[2369,3232,3233],{},[990,3234,3068],{},[2369,3236,3237],{},[990,3238,1655],{},[2369,3240,3241],{},"AsyncAPI 2.6 spec (JSON)",[2354,3243,3244,3248,3252],{},[2369,3245,3246],{},[990,3247,3068],{},[2369,3249,3250],{},[990,3251,1659],{},[2369,3253,3254],{},"AsyncAPI Studio — event browser UI",[2354,3256,3257,3261,3265],{},[2369,3258,3259],{},[990,3260,3068],{},[2369,3262,3263],{},[990,3264,1669],{},[2369,3266,3267],{},"Module spec JSON (routes, events, consumers per module)",[2354,3269,3270,3274,3278],{},[2369,3271,3272],{},[990,3273,3068],{},[2369,3275,3276],{},[990,3277,1665],{},[2369,3279,3280],{},"Module spec browser (links to OpenAPI + AsyncAPI)",[2354,3282,3283,3287,3291],{},[2369,3284,3285],{},[990,3286,3083],{},[2369,3288,3289],{},[990,3290,1675],{},[2369,3292,3293],{},"MCP JSON-RPC endpoint",[974,3295,3296,3299,3300,3303,3304,3307,3308,3311],{},[990,3297,3298],{},"POST \u002Fapi\u002Fv1\u002Fusers\u002Fsignup"," is not in this list: signup is flow-driven and is only bound\nwhen the app also imports flowexec (",[990,3301,3302],{},"go-flowdsl\u002Fflowexec\u002Fmodule",") and\n",[990,3305,3306],{},"go-framework\u002Fmodules\u002Fusers\u002Fflowtemplates",", which auto-publishes the\n",[990,3309,3310],{},"users\u002Fregistration-basic"," flow on first boot.",[3313,3314,3315],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}",{"title":1027,"searchDepth":16,"depth":16,"links":3317},[3318,3319,3320,3323,3327,3328,3329,3330,3336,3337,3338,3345,3346],{"id":980,"depth":16,"text":981},{"id":1009,"depth":16,"text":1010},{"id":1037,"depth":16,"text":1038,"children":3321},[3322],{"id":1086,"depth":22,"text":1087},{"id":1456,"depth":16,"text":1457,"children":3324},[3325,3326],{"id":1678,"depth":22,"text":1679},{"id":1743,"depth":22,"text":1744},{"id":1902,"depth":16,"text":1903},{"id":1961,"depth":16,"text":1962},{"id":2034,"depth":16,"text":2035},{"id":2231,"depth":16,"text":2232,"children":3331},[3332,3334],{"id":2240,"depth":22,"text":3333},"auth module routes (under \u002Fauth)",{"id":2273,"depth":22,"text":3335},"users module routes (under \u002Fusers)",{"id":2338,"depth":16,"text":2339},{"id":2446,"depth":16,"text":2447},{"id":2490,"depth":16,"text":2491,"children":3339},[3340,3341,3342,3343,3344],{"id":2494,"depth":22,"text":2495},{"id":2602,"depth":22,"text":2603},{"id":2678,"depth":22,"text":2679},{"id":2756,"depth":22,"text":2757},{"id":2819,"depth":22,"text":2820},{"id":2851,"depth":16,"text":2852},{"id":3044,"depth":16,"text":3045},"Step-by-step guide to building a backend application using the redelay go-framework.","md",null,{},{"order":10,"icon":72},{"title":69,"description":3347},"F5fq4OXCCQcLj0mem-kQXWTBbRysv6iVprmmhPLBrhE",[3355,3356],{"title":28,"path":60,"stem":61,"description":3349,"order":16,"children":-1},{"title":74,"path":75,"stem":76,"description":3357,"children":-1},"One Playwright harness drives the real Redelay \u002F AsyncShop stack for two jobs — browser E2E tests and branded demo videos for the docs and website. How it works, how to run it in Docker, and how to add a test or a video for FlowDSL, Redelay, or AsyncShop\u002FAsyncCart.",1790332223782]