{"documentCount":400,"nextId":400,"documentIds":{"0":"/documentation","1":"/documentation#documentation","2":"/documentation#what-you-get","3":"/documentation#backend-symfony-php","4":"/documentation#frontend-nuxt-vue","5":"/documentation#devops-deployment","6":"/documentation#tech-stack","7":"/documentation#how-this-documentation-is-organized","8":"/documentation#quick-start","9":"/documentation/getting-started","10":"/documentation/getting-started#getting-started","11":"/documentation/getting-started#whats-covered","12":"/documentation/getting-started#time-estimate","13":"/documentation/getting-started/prerequisites","14":"/documentation/getting-started/prerequisites#prerequisites","15":"/documentation/getting-started/prerequisites#required-software","16":"/documentation/getting-started/prerequisites#required-accounts","17":"/documentation/getting-started/prerequisites#optional-accounts","18":"/documentation/getting-started/prerequisites#stripe-setup","19":"/documentation/getting-started/prerequisites#firebase-setup","20":"/documentation/getting-started/full-stack-setup","21":"/documentation/getting-started/full-stack-setup#full-stack-setup","22":"/documentation/getting-started/full-stack-setup#_1-clone-both-repositories","23":"/documentation/getting-started/full-stack-setup#_2-set-up-the-backend","24":"/documentation/getting-started/full-stack-setup#_3-set-up-the-frontend","25":"/documentation/getting-started/full-stack-setup#_4-test-the-full-flow","26":"/documentation/getting-started/full-stack-setup#common-issues","27":"/documentation/getting-started/full-stack-setup#frontend-cant-reach-the-backend","28":"/documentation/getting-started/full-stack-setup#cors-errors","29":"/documentation/getting-started/full-stack-setup#stripe-webhooks-in-local-development","30":"/documentation/backend","31":"/documentation/backend#backend","32":"/documentation/backend#whats-included","33":"/documentation/backend#tech-stack","34":"/documentation/backend#in-this-section","35":"/documentation/backend/overview","36":"/documentation/backend/overview#backend-overview","37":"/documentation/backend/overview#tech-stack","38":"/documentation/backend/overview#php-85","39":"/documentation/backend/overview#symfony-8","40":"/documentation/backend/overview#frankenphp","41":"/documentation/backend/overview#supporting-technologies","42":"/documentation/backend/overview#whats-included","43":"/documentation/backend/overview#project-structure","44":"/documentation/backend/quick-start","45":"/documentation/backend/quick-start#quick-start","46":"/documentation/backend/quick-start#_1-clone-and-configure","47":"/documentation/backend/quick-start#_2-start-docker","48":"/documentation/backend/quick-start#_3-install-dependencies-and-setup","49":"/documentation/backend/quick-start#_4-verify","50":"/documentation/backend/quick-start#next-steps","51":"/documentation/backend/configuration","52":"/documentation/backend/configuration#configuration","53":"/documentation/backend/configuration#environment-files","54":"/documentation/backend/configuration#environment-variables","55":"/documentation/backend/configuration#core","56":"/documentation/backend/configuration#email-brevo","57":"/documentation/backend/configuration#stripe","58":"/documentation/backend/configuration#firebase","59":"/documentation/backend/configuration#frontend-urls","60":"/documentation/backend/configuration#dokploy-deployment","61":"/documentation/backend/configuration#config-files","62":"/documentation/backend/configuration#stripe-plans-stripe-plans","63":"/documentation/backend/configuration#brevo-email-templates-brevo-email-templates","64":"/documentation/backend/configuration#rate-limiting-rate-limiting","65":"/documentation/backend/configuration#jwt-configpackageslexik_jwt_authenticationyaml","66":"/documentation/backend/configuration#cors-configpackagesnelmio_corsyaml","67":"/documentation/backend/local-development","68":"/documentation/backend/local-development#local-development","69":"/documentation/backend/local-development#docker-services","70":"/documentation/backend/local-development#make-commands","71":"/documentation/backend/local-development#database","72":"/documentation/backend/local-development#run-migrations","73":"/documentation/backend/local-development#create-a-new-migration","74":"/documentation/backend/local-development#reset-database","75":"/documentation/backend/local-development#running-tests","76":"/documentation/backend/local-development#code-quality","77":"/documentation/backend/local-development#viewing-emails","78":"/documentation/backend/local-development#console-commands","79":"/documentation/backend/local-development#debugging-with-xdebug","80":"/documentation/backend/local-development#api-documentation","81":"/documentation/backend/architecture","82":"/documentation/backend/architecture#architecture","83":"/documentation/backend/architecture#hexagonal-architecture-ports-adapters","84":"/documentation/backend/architecture#layer-rules","85":"/documentation/backend/architecture#cqrs","86":"/documentation/backend/architecture#write-side-orm","87":"/documentation/backend/architecture#read-side-dbal","88":"/documentation/backend/architecture#event-system","89":"/documentation/backend/architecture#bounded-contexts","90":"/documentation/backend/architecture#usermanagement","91":"/documentation/backend/architecture#subscription","92":"/documentation/backend/architecture#screaming-architecture","93":"/documentation/backend/architecture#controller-pattern","94":"/documentation/backend/architecture#email-architecture","95":"/documentation/backend/architecture#database","96":"/documentation/backend/features","97":"/documentation/backend/features#features","98":"/documentation/backend/features#whats-included","99":"/documentation/backend/features/user-management","100":"/documentation/backend/features/user-management#user-management","101":"/documentation/backend/features/user-management#whats-included","102":"/documentation/backend/features/user-management#password-authentication","103":"/documentation/backend/features/user-management#social-login-firebase","104":"/documentation/backend/features/user-management#session-management","105":"/documentation/backend/features/user-management#password-reset-flow","106":"/documentation/backend/features/user-management#change-password","107":"/documentation/backend/features/user-management#user-profile","108":"/documentation/backend/features/user-management#rate-limiting","109":"/documentation/backend/features/user-management#security","110":"/documentation/backend/features/subscription-payments","111":"/documentation/backend/features/subscription-payments#subscription-payments","112":"/documentation/backend/features/subscription-payments#whats-included","113":"/documentation/backend/features/subscription-payments#plan-tiers","114":"/documentation/backend/features/subscription-payments#feature-access","115":"/documentation/backend/features/subscription-payments#stripe-setup","116":"/documentation/backend/features/subscription-payments#_1-create-a-stripe-account","117":"/documentation/backend/features/subscription-payments#_2-set-environment-variables","118":"/documentation/backend/features/subscription-payments#_3-configure-plans","119":"/documentation/backend/features/subscription-payments#_4-sync-plans-to-stripe","120":"/documentation/backend/features/subscription-payments#_5-set-up-webhook-production","121":"/documentation/backend/features/subscription-payments#_6-local-testing-with-stripe-cli","122":"/documentation/backend/features/subscription-payments#webhook-events","123":"/documentation/backend/features/subscription-payments#subscription-lifecycle","124":"/documentation/backend/features/admin-panel","125":"/documentation/backend/features/admin-panel#admin-panel","126":"/documentation/backend/features/admin-panel#whats-included","127":"/documentation/backend/features/admin-panel#access","128":"/documentation/backend/features/admin-panel#creating-an-admin-user","129":"/documentation/backend/features/admin-panel#login","130":"/documentation/backend/features/admin-panel#dashboard","131":"/documentation/backend/features/admin-panel#users","132":"/documentation/backend/features/admin-panel#fields","133":"/documentation/backend/features/admin-panel#search","134":"/documentation/backend/features/admin-panel#filters","135":"/documentation/backend/features/admin-panel#disabled-actions","136":"/documentation/backend/features/admin-panel#subscriptions","137":"/documentation/backend/features/admin-panel#fields-1","138":"/documentation/backend/features/admin-panel#search-1","139":"/documentation/backend/features/admin-panel#filters-1","140":"/documentation/backend/features/admin-panel#disabled-actions-1","141":"/documentation/backend/features/admin-panel#security","142":"/documentation/backend/features/communication","143":"/documentation/backend/features/communication#communication","144":"/documentation/backend/features/communication#whats-included","145":"/documentation/backend/features/communication#email-architecture","146":"/documentation/backend/features/communication#transactional-emails","147":"/documentation/backend/features/communication#brevo-setup-production","148":"/documentation/backend/features/communication#_1-create-templates","149":"/documentation/backend/features/communication#_2-configure-template-ids-and-environment-variables","150":"/documentation/backend/features/communication#mailpit-local-development","151":"/documentation/backend/api-reference","152":"/documentation/backend/api-reference#api-reference","153":"/documentation/backend/api-reference#base-url","154":"/documentation/backend/api-reference#authentication","155":"/documentation/backend/api-reference#endpoints","156":"/documentation/backend/api-reference#rate-limits","157":"/documentation/backend/api-reference#error-responses","158":"/documentation/backend/api-reference#common-status-codes","159":"/documentation/backend/api-reference#openapi-specification","160":"/documentation/backend/testing","161":"/documentation/backend/testing#testing","162":"/documentation/backend/testing#whats-included","163":"/documentation/backend/testing#test-structure","164":"/documentation/backend/testing#running-tests","165":"/documentation/backend/testing#unit-tests","166":"/documentation/backend/testing#functional-tests","167":"/documentation/backend/testing#test-doubles","168":"/documentation/backend/testing#writing-new-tests","169":"/documentation/backend/testing#adding-a-unit-test","170":"/documentation/backend/testing#adding-a-functional-test","171":"/documentation/backend/ci-cd","172":"/documentation/backend/ci-cd#cicd-pipeline","173":"/documentation/backend/ci-cd#pipeline-overview","174":"/documentation/backend/ci-cd#stage-1-test","175":"/documentation/backend/ci-cd#stage-2-build-production-image","176":"/documentation/backend/ci-cd#stage-3-deploy","177":"/documentation/backend/ci-cd#required-github-secrets","178":"/documentation/backend/ci-cd#running-checks-locally","179":"/documentation/backend/deployment","180":"/documentation/backend/deployment#deployment","181":"/documentation/backend/deployment#prerequisites","182":"/documentation/backend/deployment#step-by-step-setup","183":"/documentation/backend/deployment#_1-create-the-dokploy-application","184":"/documentation/backend/deployment#_2-create-the-database","185":"/documentation/backend/deployment#_3-configure-environment-variables","186":"/documentation/backend/deployment#_4-mount-jwt-certificates","187":"/documentation/backend/deployment#_5-set-up-the-deployment-webhook","188":"/documentation/backend/deployment#_6-initial-setup-commands","189":"/documentation/backend/deployment#_7-configure-stripe-webhook","190":"/documentation/backend/deployment#deployment-architecture","191":"/documentation/backend/deployment#installing-dokploy","192":"/documentation/backend/deployment#dns-configuration","193":"/documentation/backend/deployment#production-checklist","194":"/documentation/backend/deployment#backend","195":"/documentation/backend/deployment#stripe","196":"/documentation/backend/deployment#email","197":"/documentation/backend/deployment#firebase","198":"/documentation/backend/deployment#cross-project","199":"/documentation/backend/deployment#infrastructure","200":"/documentation/backend/deployment#smoke-test","201":"/documentation/backend/customization","202":"/documentation/backend/customization#customization","203":"/documentation/backend/customization#adding-a-new-command-write-operation","204":"/documentation/backend/customization#_1-create-the-feature-folder","205":"/documentation/backend/customization#_2-create-the-command-dto","206":"/documentation/backend/customization#_3-create-the-handler","207":"/documentation/backend/customization#_4-create-the-controller","208":"/documentation/backend/customization#_5-add-the-route","209":"/documentation/backend/customization#_6-write-tests","210":"/documentation/backend/customization#adding-a-new-query-read-operation","211":"/documentation/backend/customization#_1-create-the-query-and-viewmodel","212":"/documentation/backend/customization#_2-create-the-read-model-repository-interface","213":"/documentation/backend/customization#_3-implement-with-dbal","214":"/documentation/backend/customization#_4-create-the-handler","215":"/documentation/backend/customization#_5-wire-up","216":"/documentation/backend/customization#adding-a-new-bounded-context","217":"/documentation/backend/customization#adding-a-new-domain-event","218":"/documentation/backend/customization#_1-create-the-event","219":"/documentation/backend/customization#_2-dispatch-from-a-handler","220":"/documentation/backend/customization#_3-create-a-listener","221":"/documentation/backend/customization#_4-route-to-async-optional","222":"/documentation/backend/customization#adding-a-new-email-template","223":"/documentation/backend/customization#_1-create-the-template-in-brevo","224":"/documentation/backend/customization#_2-add-the-template-id-to-config","225":"/documentation/backend/customization#_3-add-to-the-emailsender-interface","226":"/documentation/backend/customization#_4-implement-in-both-adapters","227":"/documentation/backend/customization#adding-a-new-stripe-plan","228":"/documentation/backend/customization#redis","229":"/documentation/backend/customization#async-event-processing-messenger","230":"/documentation/backend/customization#distributed-caching","231":"/documentation/frontend","232":"/documentation/frontend#frontend","233":"/documentation/frontend#whats-included","234":"/documentation/frontend#tech-stack","235":"/documentation/frontend#in-this-section","236":"/documentation/frontend/overview","237":"/documentation/frontend/overview#frontend-overview","238":"/documentation/frontend/overview#key-decisions","239":"/documentation/frontend/overview#nuxt-3","240":"/documentation/frontend/overview#vue-3-composition-api","241":"/documentation/frontend/overview#tailwind-css","242":"/documentation/frontend/overview#pinia","243":"/documentation/frontend/overview#typescript","244":"/documentation/frontend/overview#design-system","245":"/documentation/frontend/overview#fonts","246":"/documentation/frontend/overview#architectural-patterns","247":"/documentation/frontend/overview#dual-mode-landing-page","248":"/documentation/frontend/overview#component-based-layouts","249":"/documentation/frontend/overview#auto-import","250":"/documentation/frontend/overview#composable-pattern","251":"/documentation/frontend/overview#api-communication","252":"/documentation/frontend/overview#the-useapi-composable","253":"/documentation/frontend/overview#request-flow","254":"/documentation/frontend/overview#api-endpoints","255":"/documentation/frontend/overview#cors-configuration","256":"/documentation/frontend/overview#error-handling","257":"/documentation/frontend/project-structure","258":"/documentation/frontend/project-structure#project-structure","259":"/documentation/frontend/project-structure#key-conventions","260":"/documentation/frontend/configuration","261":"/documentation/frontend/configuration#configuration","262":"/documentation/frontend/configuration#environment-variables","263":"/documentation/frontend/configuration#nuxt-config-nuxtconfigts","264":"/documentation/frontend/configuration#notable-settings","265":"/documentation/frontend/configuration#tailwind-config-tailwindconfigts","266":"/documentation/frontend/configuration#using-theme-colors","267":"/documentation/frontend/configuration#cross-project-configuration-cross-project-configuration","268":"/documentation/frontend/configuration#css-assetscssmaincss","269":"/documentation/frontend/getting-started","270":"/documentation/frontend/getting-started#getting-started","271":"/documentation/frontend/getting-started#prerequisites","272":"/documentation/frontend/getting-started#setup","273":"/documentation/frontend/getting-started#_1-clone-the-repository","274":"/documentation/frontend/getting-started#_2-configure-environment","275":"/documentation/frontend/getting-started#_3-start-the-development-server","276":"/documentation/frontend/getting-started#_4-verify","277":"/documentation/frontend/getting-started#development-workflow","278":"/documentation/frontend/getting-started#docker-setup","279":"/documentation/frontend/getting-started#available-scripts","280":"/documentation/frontend/features","281":"/documentation/frontend/features#features","282":"/documentation/frontend/features#whats-included","283":"/documentation/frontend/features/authentication","284":"/documentation/frontend/features/authentication#authentication","285":"/documentation/frontend/features/authentication#whats-included","286":"/documentation/frontend/features/authentication#auth-composable-useauth","287":"/documentation/frontend/features/authentication#auth-store-useauthstore","288":"/documentation/frontend/features/authentication#pages","289":"/documentation/frontend/features/authentication#login-page","290":"/documentation/frontend/features/authentication#register-page","291":"/documentation/frontend/features/authentication#social-login","292":"/documentation/frontend/features/authentication#middleware","293":"/documentation/frontend/features/authentication#auth-middleware","294":"/documentation/frontend/features/authentication#guest-middleware","295":"/documentation/frontend/features/authentication#token-refresh","296":"/documentation/frontend/features/authentication#end-to-end-flows","297":"/documentation/frontend/features/authentication#registration-flow","298":"/documentation/frontend/features/authentication#login-flow","299":"/documentation/frontend/features/authentication#social-login-flow-firebasegoogle","300":"/documentation/frontend/features/authentication#token-refresh-flow","301":"/documentation/frontend/features/authentication#password-reset-flow","302":"/documentation/frontend/features/authentication#email-verification-flow","303":"/documentation/frontend/features/authentication#session-persistence","304":"/documentation/frontend/features/authentication#firebase-setup","305":"/documentation/frontend/features/authentication#_1-get-firebase-configuration","306":"/documentation/frontend/features/authentication#_2-enable-google-sign-in","307":"/documentation/frontend/features/authentication#_3-add-authorized-domains-critical","308":"/documentation/frontend/features/authentication#troubleshooting","309":"/documentation/frontend/features/payments-checkout","310":"/documentation/frontend/features/payments-checkout#payments-checkout","311":"/documentation/frontend/features/payments-checkout#whats-included","312":"/documentation/frontend/features/payments-checkout#checkout-composable-usecheckout","313":"/documentation/frontend/features/payments-checkout#plans-composable-useplans","314":"/documentation/frontend/features/payments-checkout#end-to-end-checkout-flow","315":"/documentation/frontend/features/payments-checkout#authenticated-vs-guest-checkout","316":"/documentation/frontend/features/payments-checkout#what-happens-after-payment","317":"/documentation/frontend/features/payments-checkout#successful-payment","318":"/documentation/frontend/features/payments-checkout#failed-payment-recurring","319":"/documentation/frontend/features/payments-checkout#cancelled-checkout","320":"/documentation/frontend/features/payments-checkout#payment-pages","321":"/documentation/frontend/features/payments-checkout#success-page-paymentsuccess","322":"/documentation/frontend/features/payments-checkout#cancel-page-paymentcancel","323":"/documentation/frontend/features/payments-checkout#subscription-status-on-frontend","324":"/documentation/frontend/features/payments-checkout#pricing-section","325":"/documentation/frontend/features/payments-checkout#stripe-test-cards","326":"/documentation/frontend/features/profile-dashboard","327":"/documentation/frontend/features/profile-dashboard#profile-dashboard","328":"/documentation/frontend/features/profile-dashboard#whats-included","329":"/documentation/frontend/features/profile-dashboard#profile-page-profile","330":"/documentation/frontend/features/profile-dashboard#profile-composable-useprofile","331":"/documentation/frontend/features/profile-dashboard#subscription-composable-usesubscription","332":"/documentation/frontend/features/profile-dashboard#authenticated-layout","333":"/documentation/frontend/features/profile-dashboard#dashboard","334":"/documentation/frontend/features/profile-dashboard#feature-pages","335":"/documentation/frontend/features/analytics","336":"/documentation/frontend/features/analytics#analytics","337":"/documentation/frontend/features/analytics#whats-included","338":"/documentation/frontend/features/analytics#setup","339":"/documentation/frontend/features/analytics#how-it-works","340":"/documentation/frontend/features/analytics#why-umami","341":"/documentation/frontend/features/analytics#self-hosting-umami","342":"/documentation/frontend/features/analytics#verification","343":"/documentation/frontend/features/analytics#troubleshooting","344":"/documentation/frontend/components-composables","345":"/documentation/frontend/components-composables#components-composables","346":"/documentation/frontend/components-composables#ui-components","347":"/documentation/frontend/components-composables#appbutton","348":"/documentation/frontend/components-composables#appinput","349":"/documentation/frontend/components-composables#appbadge","350":"/documentation/frontend/components-composables#applogo","351":"/documentation/frontend/components-composables#auth-components","352":"/documentation/frontend/components-composables#landing-components","353":"/documentation/frontend/components-composables#profile-components","354":"/documentation/frontend/components-composables#composables","355":"/documentation/frontend/components-composables#useapi","356":"/documentation/frontend/components-composables#useauth","357":"/documentation/frontend/components-composables#usecheckout","358":"/documentation/frontend/components-composables#useplans","359":"/documentation/frontend/components-composables#useprofile","360":"/documentation/frontend/components-composables#usescrollspy","361":"/documentation/frontend/components-composables#usesubscription","362":"/documentation/frontend/testing","363":"/documentation/frontend/testing#testing","364":"/documentation/frontend/testing#whats-included","365":"/documentation/frontend/testing#setup","366":"/documentation/frontend/testing#vitest-config-vitestconfigts","367":"/documentation/frontend/testing#test-setup-testssetupts","368":"/documentation/frontend/testing#running-tests","369":"/documentation/frontend/testing#test-structure","370":"/documentation/frontend/testing#writing-component-tests","371":"/documentation/frontend/testing#mocking-strategy","372":"/documentation/frontend/ci-cd","373":"/documentation/frontend/ci-cd#cicd-pipeline","374":"/documentation/frontend/ci-cd#pipeline-overview","375":"/documentation/frontend/ci-cd#stage-1-test","376":"/documentation/frontend/ci-cd#stage-2-build-production-image","377":"/documentation/frontend/ci-cd#stage-3-deploy","378":"/documentation/frontend/ci-cd#required-github-secrets","379":"/documentation/frontend/ci-cd#docker-multi-stage-build","380":"/documentation/frontend/ci-cd#dev-stage","381":"/documentation/frontend/ci-cd#production-stage","382":"/documentation/frontend/deployment","383":"/documentation/frontend/deployment#deployment","384":"/documentation/frontend/deployment#docker-setup","385":"/documentation/frontend/deployment#development-docker-composeyml","386":"/documentation/frontend/deployment#production-dockerfile","387":"/documentation/frontend/deployment#dokploy-deployment","388":"/documentation/frontend/deployment#setup","389":"/documentation/frontend/deployment#environment-variables","390":"/documentation/frontend/deployment#deployment-webhook","391":"/documentation/frontend/deployment#deployment-architecture","392":"/documentation/frontend/deployment#installing-dokploy","393":"/documentation/frontend/deployment#dns-configuration","394":"/documentation/frontend/deployment#production-checklist","395":"/documentation/frontend/deployment#frontend","396":"/documentation/frontend/deployment#firebase","397":"/documentation/frontend/deployment#cross-project","398":"/documentation/frontend/deployment#infrastructure","399":"/documentation/frontend/deployment#smoke-test"},"fieldIds":{"title":0,"content":1,"titles":2},"fieldLength":{"0":[1,8,1],"1":[1,31,1],"2":[3,1,1],"3":[5,49,4],"4":[5,38,4],"5":[2,21,4],"6":[2,34,1],"7":[5,21,1],"8":[2,32,1],"9":[2,9,1],"10":[2,31,1],"11":[3,18,2],"12":[2,20,2],"13":[1,8,1],"14":[1,1,1],"15":[2,33,1],"16":[2,29,1],"17":[2,25,1],"18":[2,21,1],"19":[2,38,1],"20":[3,10,1],"21":[3,15,1],"22":[4,1,3],"23":[5,28,3],"24":[5,24,3],"25":[5,40,3],"26":[2,1,3],"27":[6,29,5],"28":[2,16,5],"29":[5,16,5],"30":[1,8,1],"31":[1,27,1],"32":[3,42,1],"33":[2,16,1],"34":[3,47,1],"35":[1,8,1],"36":[2,29,1],"37":[2,1,2],"38":[3,33,4],"39":[2,35,4],"40":[1,64,4],"41":[2,25,4],"42":[3,100,2],"43":[2,1,2],"44":[2,8,1],"45":[2,9,1],"46":[4,25,2],"47":[3,12,2],"48":[5,1,2],"49":[2,23,2],"50":[2,14,2],"51":[1,8,1],"52":[1,1,1],"53":[2,47,1],"54":[2,1,1],"55":[1,54,3],"56":[2,42,3],"57":[1,28,3],"58":[1,7,3],"59":[2,19,3],"60":[3,13,3],"61":[2,1,1],"62":[5,25,3],"63":[7,32,3],"64":[5,17,3],"65":[7,16,3],"66":[6,18,3],"67":[2,8,1],"68":[2,1,1],"69":[2,17,2],"70":[2,46,2],"71":[1,1,2],"72":[2,1,3],"73":[4,7,3],"74":[2,9,3],"75":[2,1,2],"76":[2,9,2],"77":[2,21,2],"78":[2,58,2],"79":[3,31,2],"80":[2,19,2],"81":[1,6,1],"82":[1,1,1],"83":[5,11,1],"84":[2,38,5],"85":[1,25,1],"86":[4,27,2],"87":[4,32,2],"88":[2,25,2],"89":[2,1,1],"90":[1,24,3],"91":[1,23,3],"92":[2,26,1],"93":[2,30,1],"94":[2,31,1],"95":[1,35,1],"96":[1,10,1],"97":[1,15,1],"98":[3,35,1],"99":[2,8,1],"100":[2,1,1],"101":[3,27,2],"102":[2,49,2],"103":[4,56,2],"104":[2,34,2],"105":[3,60,2],"106":[2,20,2],"107":[2,21,2],"108":[2,23,2],"109":[1,42,2],"110":[2,8,1],"111":[2,17,1],"112":[3,27,2],"113":[2,22,2],"114":[2,9,2],"115":[2,1,2],"116":[5,15,4],"117":[4,1,4],"118":[3,15,4],"119":[5,18,4],"120":[6,34,4],"121":[6,1,4],"122":[2,47,2],"123":[2,1,2],"124":[2,7,1],"125":[2,16,1],"126":[3,15,2],"127":[1,17,2],"128":[4,10,3],"129":[1,27,3],"130":[1,14,2],"131":[1,1,2],"132":[1,24,3],"133":[1,6,3],"134":[1,9,3],"135":[2,13,3],"136":[1,1,2],"137":[1,25,3],"138":[1,7,3],"139":[1,15,3],"140":[2,14,3],"141":[1,35,2],"142":[1,7,1],"143":[1,1,1],"144":[3,30,1],"145":[2,37,1],"146":[2,36,1],"147":[4,1,1],"148":[3,16,5],"149":[7,15,5],"150":[4,39,1],"151":[2,6,1],"152":[2,21,1],"153":[2,12,2],"154":[1,23,2],"155":[1,85,2],"156":[2,30,2],"157":[2,14,2],"158":[3,34,4],"159":[2,11,2],"160":[1,7,1],"161":[1,1,1],"162":[3,28,1],"163":[2,1,1],"164":[2,1,1],"165":[2,37,1],"166":[2,23,1],"167":[2,39,1],"168":[3,1,1],"169":[4,25,4],"170":[4,25,4],"171":[2,8,1],"172":[3,15,1],"173":[2,1,3],"174":[3,50,3],"175":[5,24,3],"176":[3,16,3],"177":[3,19,3],"178":[3,23,3],"179":[1,6,1],"180":[1,23,1],"181":[1,17,1],"182":[3,1,1],"183":[5,26,4],"184":[4,21,4],"185":[4,7,4],"186":[4,54,4],"187":[6,18,4],"188":[4,9,4],"189":[4,13,4],"190":[2,18,1],"191":[2,20,1],"192":[2,16,1],"193":[2,6,1],"194":[1,39,3],"195":[1,43,3],"196":[1,26,3],"197":[1,15,3],"198":[2,29,3],"199":[1,29,3],"200":[2,49,3],"201":[1,8,1],"202":[1,12,1],"203":[7,7,1],"204":[5,1,8],"205":[5,1,8],"206":[4,1,8],"207":[4,1,8],"208":[4,6,8],"209":[3,12,8],"210":[7,8,1],"211":[6,1,8],"212":[7,1,8],"213":[4,1,8],"214":[4,1,8],"215":[3,15,8],"216":[5,24,1],"217":[5,1,1],"218":[4,1,6],"219":[5,1,6],"220":[4,1,6],"221":[6,6,6],"222":[5,1,1],"223":[6,14,6],"224":[7,6,6],"225":[6,12,6],"226":[5,12,6],"227":[5,40,1],"228":[1,41,1],"229":[5,31,2],"230":[2,38,2],"231":[1,8,1],"232":[1,21,1],"233":[3,36,1],"234":[2,18,1],"235":[3,33,1],"236":[1,8,1],"237":[2,27,1],"238":[2,1,2],"239":[2,32,4],"240":[4,21,4],"241":[2,28,4],"242":[1,19,4],"243":[1,20,4],"244":[2,25,2],"245":[1,9,4],"246":[2,1,2],"247":[4,26,4],"248":[3,24,4],"249":[2,25,4],"250":[2,27,4],"251":[2,25,2],"252":[3,45,4],"253":[2,1,4],"254":[2,31,4],"255":[2,18,4],"256":[2,29,4],"257":[2,6,1],"258":[2,1,1],"259":[2,41,2],"260":[1,6,1],"261":[1,1,1],"262":[2,53,1],"263":[6,3,1],"264":[2,40,7],"265":[6,9,1],"266":[3,1,7],"267":[7,78,1],"268":[5,34,1],"269":[2,6,1],"270":[2,1,1],"271":[1,26,2],"272":[1,1,2],"273":[4,1,3],"274":[3,14,3],"275":[5,10,3],"276":[2,16,3],"277":[2,23,2],"278":[2,36,2],"279":[2,15,2],"280":[1,9,1],"281":[1,13,1],"282":[3,28,1],"283":[1,6,1],"284":[1,1,1],"285":[3,25,1],"286":[4,22,1],"287":[4,16,1],"288":[1,13,1],"289":[2,23,2],"290":[2,20,2],"291":[2,42,2],"292":[1,1,1],"293":[2,18,2],"294":[2,12,2],"295":[2,31,1],"296":[3,1,1],"297":[2,1,4],"298":[2,1,4],"299":[6,1,4],"300":[3,1,4],"301":[3,1,4],"302":[3,1,4],"303":[2,30,4],"304":[2,20,1],"305":[4,56,3],"306":[5,14,3],"307":[6,48,3],"308":[1,48,3],"309":[2,6,1],"310":[2,1,1],"311":[3,17,2],"312":[4,20,2],"313":[4,21,2],"314":[4,1,2],"315":[4,18,5],"316":[4,1,2],"317":[2,23,6],"318":[4,30,6],"319":[2,21,6],"320":[2,1,2],"321":[5,19,4],"322":[5,17,4],"323":[4,27,2],"324":[2,29,2],"325":[3,27,2],"326":[2,6,1],"327":[2,1,1],"328":[3,17,2],"329":[4,40,2],"330":[4,1,5],"331":[4,16,5],"332":[2,44,2],"333":[1,20,2],"334":[2,28,2],"335":[1,3,1],"336":[1,1,1],"337":[3,24,1],"338":[1,22,1],"339":[3,32,1],"340":[3,23,1],"341":[3,29,1],"342":[1,47,1],"343":[1,64,1],"344":[2,7,1],"345":[2,1,1],"346":[2,7,2],"347":[1,20,3],"348":[1,10,3],"349":[1,8,3],"350":[1,10,3],"351":[2,20,2],"352":[2,29,2],"353":[2,15,2],"354":[1,4,2],"355":[1,23,2],"356":[1,10,2],"357":[1,10,2],"358":[1,11,2],"359":[1,12,2],"360":[1,11,2],"361":[1,16,2],"362":[1,7,1],"363":[1,1,1],"364":[3,20,1],"365":[1,1,1],"366":[6,1,2],"367":[6,49,2],"368":[2,1,1],"369":[2,1,1],"370":[3,1,1],"371":[2,32,1],"372":[2,6,1],"373":[3,18,1],"374":[2,1,3],"375":[3,23,3],"376":[5,30,3],"377":[3,20,3],"378":[3,6,3],"379":[4,8,3],"380":[2,13,7],"381":[2,19,7],"382":[1,8,1],"383":[1,1,1],"384":[2,1,1],"385":[5,25,3],"386":[3,10,3],"387":[2,1,1],"388":[1,25,2],"389":[2,7,2],"390":[2,25,2],"391":[2,18,1],"392":[2,20,1],"393":[2,16,1],"394":[2,6,1],"395":[1,22,3],"396":[1,16,3],"397":[2,21,3],"398":[1,29,3],"399":[2,49,3]},"averageFieldLength":[2.5875,18.639999999999986,2.419999999999998],"storedFields":{"0":{"title":"Documentation","content":"Complete documentation for the production-ready SaaS boilerplate","titles":[]},"1":{"title":"Documentation","content":"This is a production-ready SaaS boilerplate that gives you a complete backend and frontend — fully wired with authentication, payments, subscriptions, emails, and deployment. Clone it, configure your environment, and start building your product.","titles":[]},"2":{"title":"What You Get","content":"","titles":["Documentation"]},"3":{"title":"Backend (Symfony + PHP)","content":"User authentication — email/password registration, social login (Google, Apple via Firebase), JWT tokens with refresh rotationSubscription payments — Stripe Checkout with recurring and one-time plans, webhook handling, feature gatingAdmin panel — EasyAdmin backoffice for managing users and subscriptionsTransactional emails — Brevo for production, Mailpit for local developmentClean architecture — Hexagonal architecture with CQRS, domain events, and full test coverage","titles":["Documentation","What You Get"]},"4":{"title":"Frontend (Nuxt + Vue)","content":"Landing page — Marketing page with hero, features, pricing, FAQ sectionsAuth flows — Login, register, forgot/reset password, social login, email verificationStripe checkout — Seamless payment flow with success/cancel pagesUser dashboard — Profile management, subscription status, password changesDark theme — Polished dark UI with Tailwind CSS","titles":["Documentation","What You Get"]},"5":{"title":"DevOps & Deployment","content":"Docker — Containerized development and production environmentsCI/CD — GitHub Actions pipeline (test → build → deploy)Dokploy — One-click deployment with automatic HTTPS","titles":["Documentation","What You Get"]},"6":{"title":"Tech Stack","content":"LayerTechnologyBackendPHP 8.5, Symfony 8, FrankenPHPFrontendNuxt 3, Vue 3, Tailwind CSS, TypeScriptDatabasePostgreSQL 16CacheRedis 7PaymentsStripe (recurring + one-time)AuthJWT + refresh tokens, Firebase (social login)EmailsBrevo (production), Mailpit (development)AdminEasyAdminCI/CDGitHub Actions → GitHub Container Registry → Dokploy","titles":["Documentation"]},"7":{"title":"How This Documentation Is Organized","content":"Getting Started — Prerequisites and full-stack setup guideBackend — Symfony backend architecture, features, API reference, deployment, and customizationFrontend — Nuxt frontend structure, components, composables, features, and deployment","titles":["Documentation"]},"8":{"title":"Quick Start","content":"Clone both repositories (backend + frontend)Configure environment variablesStart Docker containersRun database migrations and sync Stripe plansOpen the frontend at http://localhost:3000 See the Full-Stack Setup Guide for step-by-step instructions.","titles":["Documentation"]},"9":{"title":"Getting Started","content":"Everything you need to get the application running locally","titles":[]},"10":{"title":"Getting Started","content":"This section walks you through setting up the complete stack on your local machine. For detailed setup of each project individually, see the Backend Quick Start and Frontend Getting Started guides.","titles":[]},"11":{"title":"What's Covered","content":"Prerequisites — Software and accounts you need before startingFull-Stack Setup — Quick guide to get both projects running together","titles":["Getting Started"]},"12":{"title":"Time Estimate","content":"If you have Docker installed and your Stripe/Firebase accounts ready, you can be up and running in about 10 minutes.","titles":["Getting Started"]},"13":{"title":"Prerequisites","content":"Software and accounts needed to run GO-MVP","titles":[]},"14":{"title":"Prerequisites","content":"","titles":[]},"15":{"title":"Required Software","content":"SoftwareVersionPurposeDocker20+Containerized developmentDocker Composev2+Multi-container orchestrationGitAnyVersion control Both the backend and frontend run entirely inside Docker containers — you do not need PHP, Node.js, or any other runtime installed on your host machine.","titles":["Prerequisites"]},"16":{"title":"Required Accounts","content":"ServicePurposeFree TierStripePayment processingYes (test mode)FirebaseSocial login (Google, Apple)Yes You can skip Firebase if you don't need social login. The boilerplate works with email/password authentication only.","titles":["Prerequisites"]},"17":{"title":"Optional Accounts","content":"ServicePurposeFree TierBrevoProduction transactional emailsYes (300 emails/day)GitHubCI/CD pipelineYesDokployProduction deploymentFree (self-hosted) In local development, emails are caught by Mailpit — no Brevo account needed.","titles":["Prerequisites"]},"18":{"title":"Stripe Setup","content":"Create an account at stripe.comNavigate to Developers → API keysCopy your Secret key (sk_test_...)For webhooks (needed later): Developers → Webhooks","titles":["Prerequisites"]},"19":{"title":"Firebase Setup","content":"Go to the Firebase ConsoleCreate a new project (or use an existing one)Enable Authentication → Sign-in method → GoogleGo to Project settings → note your Project ID, API Key, and Auth DomainAdd your frontend URL to Authorized domains (e.g., localhost)","titles":["Prerequisites"]},"20":{"title":"Full-Stack Setup","content":"Step-by-step guide to run the complete stack locally","titles":[]},"21":{"title":"Full-Stack Setup","content":"This guide gets both the backend and frontend running together on your local machine.","titles":[]},"22":{"title":"1. Clone Both Repositories","content":"","titles":["Full-Stack Setup"]},"23":{"title":"2. Set Up the Backend","content":"Follow the Backend Quick Start guide to configure environment variables, start Docker services, install dependencies, run migrations, and sync Stripe plans. Once complete, verify the backend is running:","titles":["Full-Stack Setup"]},"24":{"title":"3. Set Up the Frontend","content":"Follow the Frontend Getting Started guide to configure environment variables and start the development server. The frontend will be available at http://localhost:3000.","titles":["Full-Stack Setup"]},"25":{"title":"4. Test the Full Flow","content":"Register — Click \"Sign Up\" and create an accountCheck email — Open Mailpit at http://localhost:8025 to see the welcome emailLogin — Sign in with your credentialsPurchase — Select a plan and complete Stripe test checkout (use card 4242 4242 4242 4242)Profile — Check your profile page to see the active subscription","titles":["Full-Stack Setup"]},"26":{"title":"Common Issues","content":"","titles":["Full-Stack Setup"]},"27":{"title":"Frontend can't reach the backend","content":"Make sure NUXT_PUBLIC_API_BASE_URL points to the backend URL. In Docker, this is typically http://localhost (port 80) or http://host.docker.internal depending on your setup.","titles":["Full-Stack Setup","Common Issues"]},"28":{"title":"CORS errors","content":"Update the backend's CORS_ALLOW_ORIGIN in .env.local to include your frontend URL:","titles":["Full-Stack Setup","Common Issues"]},"29":{"title":"Stripe webhooks in local development","content":"Use the Stripe CLI to forward webhooks: Copy the webhook signing secret to your backend .env.local.","titles":["Full-Stack Setup","Common Issues"]},"30":{"title":"Backend","content":"Symfony backend documentation — architecture, features, API, and deployment","titles":[]},"31":{"title":"Backend","content":"The GO-MVP backend is a production-ready Symfony application built with hexagonal architecture and CQRS. It provides a complete API for user authentication, subscription payments, and administration.","titles":[]},"32":{"title":"What's Included","content":"User Management — Registration, login, social auth, password flows, JWT tokensSubscription Payments — Stripe Checkout, webhooks, plan tiers, feature gatingAdmin Panel — EasyAdmin backoffice for users and subscriptionsEmail System — Transactional emails via Brevo (production) or Mailpit (development)API Documentation — Interactive Swagger UI at /api/doc","titles":["Backend"]},"33":{"title":"Tech Stack","content":"ComponentTechnologyLanguagePHP 8.5FrameworkSymfony 8ServerFrankenPHP (Caddy + embedded PHP)DatabasePostgreSQL 16Cache / QueueRedis 7PaymentsStripeEmailsBrevo / Symfony MailerSocial LoginFirebase AuthenticationAdminEasyAdmin","titles":["Backend"]},"34":{"title":"In This Section","content":"Overview — Tech stack details and project structureQuick Start — Get running in 5 minutesConfiguration — Environment variables and config filesLocal Development — Daily workflow and commandsArchitecture — Hexagonal architecture and CQRSFeatures — User management, payments, admin, emailsAPI Reference — All API endpointsTesting — Unit and functional test patternsCI/CD — GitHub Actions pipelineDeployment — Dokploy production deploymentCustomization — Extending the boilerplate","titles":["Backend"]},"35":{"title":"Overview","content":"Backend tech stack, architecture overview, and project structure","titles":[]},"36":{"title":"Backend Overview","content":"The backend is a production-ready Symfony application that ships with user authentication, subscription payments, an admin panel, and a CI/CD pipeline — all wired together with hexagonal architecture and CQRS.","titles":[]},"37":{"title":"Tech Stack","content":"","titles":["Backend Overview"]},"38":{"title":"PHP 8.5","content":"The latest version of PHP with modern features: readonly properties, enums, fibers, typed class constants, and property hooks. PHP 8.5 brings significant performance improvements and keeps the codebase concise with constructor promotion and match expressions.","titles":["Backend Overview","Tech Stack"]},"39":{"title":"Symfony 8","content":"Enterprise-grade framework with long-term support. Symfony's component architecture means you only use what you need — from routing and dependency injection to security and messaging. The ecosystem includes mature tooling for testing, profiling, and debugging.","titles":["Backend Overview","Tech Stack"]},"40":{"title":"FrankenPHP","content":"A modern PHP application server built on top of Caddy. Unlike traditional setups (Nginx + PHP-FPM), FrankenPHP embeds PHP directly into the Caddy web server. Key benefits: Worker mode — keeps the application booted in memory between requests, dramatically reducing response timesAutomatic HTTPS — inherits Caddy's automatic TLS certificate provisioning via Let's EncryptHTTP/2 and HTTP/3 — native support out of the boxSingle binary deployment — no need to configure Nginx, PHP-FPM, and a reverse proxy separately","titles":["Backend Overview","Tech Stack"]},"41":{"title":"Supporting Technologies","content":"ComponentTechnologyDatabasePostgreSQL 16Cache / QueueRedis 7PaymentsStripe (recurring + one-time)EmailsBrevo (production) / Mailpit (dev)Social LoginFirebase AuthenticationAuth TokensJWT (access) + Refresh TokensAdmin PanelEasyAdminDeploymentDokploy + GitHub Container RegistryCI/CDGitHub Actions","titles":["Backend Overview","Tech Stack"]},"42":{"title":"What's Included","content":"User Management Email/password registration with email validationSocial login via Firebase (Google, Apple, etc.)JWT access tokens + single-use refresh tokensForgot password / reset password flowChange password, user profileRate limiting on auth endpoints Revenue & Payments Free / Starter / Pro plan tiers with feature gatingStripe Checkout (recurring and one-time payments)Stripe webhook handling (5 events)Guest and authenticated checkout Backoffice Admin Panel EasyAdmin dashboard for users and subscriptionsSearch, filter, and edit records Communication Transactional emails (welcome, password reset, password changed)Brevo for production, Symfony Mailer + Mailpit for development Developer Experience Hexagonal architecture with CQRSFull test suite — unit (fakes, no DB) + functional (real HTTP + DB)PHPStan static analysis, PHP CS FixerOpenAPI/Swagger documentation at /api/doc","titles":["Backend Overview"]},"43":{"title":"Project Structure","content":"","titles":["Backend Overview"]},"44":{"title":"Quick Start","content":"Get the backend running locally in 5 minutes","titles":[]},"45":{"title":"Quick Start","content":"Get the backend running locally in 5 minutes.","titles":[]},"46":{"title":"1. Clone and Configure","content":"Create your local environment file: Edit .env.local and set at minimum: The .env file contains safe defaults and documentation for all variables. .env.local is gitignored and holds your actual secrets.","titles":["Quick Start"]},"47":{"title":"2. Start Docker","content":"This starts 4 services: ServiceURL / PortPHP apphttp://localhostPostgreSQLlocalhost:5432Redislocalhost:6379Mailpithttp://localhost:8025","titles":["Quick Start"]},"48":{"title":"3. Install Dependencies and Setup","content":"","titles":["Quick Start"]},"49":{"title":"4. Verify","content":"Test that the API is working: You should get a JSON response with your Stripe plans. Visit the API documentation at: http://localhost/api/doc","titles":["Quick Start"]},"50":{"title":"Next Steps","content":"Configuration — configure all environment variablesLocal Development — daily workflow and commandsFeatures — explore the API endpoints","titles":["Quick Start"]},"51":{"title":"Configuration","content":"Environment variables and configuration files for the backend","titles":[]},"52":{"title":"Configuration","content":"","titles":[]},"53":{"title":"Environment Files","content":"Symfony loads environment files in this order (later files override earlier ones): .env — committed defaults and documentation.env.local — your local overrides (gitignored).env.{APP_ENV} — environment-specific defaults (e.g., .env.test).env.{APP_ENV}.local — environment-specific local overrides Real environment variables (set in your shell or Docker) always win over .env files. Never commit secrets. Put all real credentials in .env.local or set them as environment variables in your deployment platform.","titles":["Configuration"]},"54":{"title":"Environment Variables","content":"","titles":["Configuration"]},"55":{"title":"Core","content":"VariableDescriptionExampleAPP_ENVSymfony environmentdev, test, prodAPP_SECRETSymfony secret (CSRF, signing)Random 32+ char stringDATABASE_URLPostgreSQL connection stringpostgresql://app:pass@database:5432/app?serverVersion=16&charset=utf8MESSENGER_TRANSPORT_DSNMessage transportsync:// (dev) or redis://redis:6379/messagesDEFAULT_URIBase URL for console route generationhttp://localhostJWT_PASSPHRASEPassphrase for JWT key pairRandom stringCORS_ALLOW_ORIGINAllowed CORS origins (regex)^https?://(localhost|127\\.0\\.0\\.1)(:[0-9]+)?$","titles":["Configuration","Environment Variables"]},"56":{"title":"Email / Brevo","content":"VariableDescriptionExampleEMAIL_SENDER_EMAILFrom address for all emailsnoreply@yourdomain.comEMAIL_SENDER_NAMEFrom name for all emailsYour App NameMAILER_DSNSymfony Mailer transportsmtp://mailer:1025 (dev)BREVO_API_KEYBrevo API key (production emails)xkeysib-... In development, emails go to Mailpit at http://localhost:8025. In production, emails are sent via the Brevo API.","titles":["Configuration","Environment Variables"]},"57":{"title":"Stripe","content":"VariableDescriptionExampleSTRIPE_SECRET_KEYStripe API secret keysk_test_... or sk_live_...STRIPE_WEBHOOK_SECRETStripe webhook signing secretwhsec_...STRIPE_SUCCESS_URLRedirect after successful paymenthttps://yourapp.com/payment/successSTRIPE_CANCEL_URLRedirect after cancelled paymenthttps://yourapp.com/payment/cancel","titles":["Configuration","Environment Variables"]},"58":{"title":"Firebase","content":"VariableDescriptionExampleFIREBASE_PROJECT_IDFirebase project IDmy-app-12345","titles":["Configuration","Environment Variables"]},"59":{"title":"Frontend URLs","content":"VariableDescriptionExampleEMAIL_VALIDATION_REDIRECT_URLWhere users land after email validationhttps://yourapp.com/auth/email-verifiedFRONTEND_RESET_PASSWORD_URLFrontend password reset formhttps://yourapp.com/auth/reset-password","titles":["Configuration","Environment Variables"]},"60":{"title":"Dokploy (Deployment)","content":"VariableDescriptionExampleDOKPLOY_URLDokploy instance URLhttps://your-dokploy.comDOKPLOY_TOKENDokploy API tokenYour Dokploy auth token","titles":["Configuration","Environment Variables"]},"61":{"title":"Config Files","content":"","titles":["Configuration"]},"62":{"title":"Stripe Plans {#stripe-plans}","content":"Defined in config/packages/stripe.yaml. Defines your plan tiers. Supports both one-time and recurring payment models: After changing plan definitions, sync to Stripe:","titles":["Configuration","Config Files"]},"63":{"title":"Brevo Email Templates {#brevo-email-templates}","content":"Defined in config/packages/brevo.yaml. Maps Brevo template IDs to email types: Each template receives specific variables: TemplateIDVariablesWelcome1userName, validationLinkPassword Changed2userNamePassword Reset3userName, resetLink Create these templates in your Brevo dashboard and update the IDs accordingly.","titles":["Configuration","Config Files"]},"64":{"title":"Rate Limiting {#rate-limiting}","content":"Defined in config/packages/rate_limiter.yaml. LimiterLimitWindowScopeauth_signup_ip515 minutesIPauth_signup_email315 minutesEmailauth_login_ip515 minutesIPauth_login_email515 minutesEmailauth_logout101 minuteIP","titles":["Configuration","Config Files"]},"65":{"title":"JWT — config/packages/lexik_jwt_authentication.yaml","content":"SettingValueAccess token TTL3600s (1 hour)Refresh token TTL2592000s (30 days)Refresh tokenSingle-use (rotated on each refresh)","titles":["Configuration","Config Files"]},"66":{"title":"CORS — config/packages/nelmio_cors.yaml","content":"SettingValueAllowed originsRegex from CORS_ALLOW_ORIGIN env varAllowed methodsGET, OPTIONS, POST, PUT, PATCH, DELETEAllowed headersContent-Type, AuthorizationMax age3600s","titles":["Configuration","Config Files"]},"67":{"title":"Local Development","content":"Docker services, Make commands, and daily development workflow","titles":[]},"68":{"title":"Local Development","content":"","titles":[]},"69":{"title":"Docker Services","content":"ServiceContainerAccessPurposePHP (app)phphttp://localhostSymfony + FrankenPHPPostgreSQLdatabaselocalhost:5432DatabaseRedisredislocalhost:6379Cache + message queueMailpitmailerhttp://localhost:8025 (UI) / localhost:1025 (SMTP)Email testing","titles":["Local Development"]},"70":{"title":"Make Commands","content":"CommandDescriptionmake testRun all tests (unit + functional)make test-unitRun unit tests onlymake test-functionalRun functional tests onlymake phpstanRun PHPStan static analysismake csfixFix code style with PHP CS Fixermake bashOpen a shell in the PHP containermake stripe-sync-plansSync plan config to Stripemake dokployAccess Dokploy deployment menumake generate-jwt-keysGenerate JWT key pair","titles":["Local Development"]},"71":{"title":"Database","content":"","titles":["Local Development"]},"72":{"title":"Run Migrations","content":"","titles":["Local Development","Database"]},"73":{"title":"Create a New Migration","content":"After modifying an ORM mapping file:","titles":["Local Development","Database"]},"74":{"title":"Reset Database","content":"Never use doctrine:schema:update --force. Always use migrations.","titles":["Local Development","Database"]},"75":{"title":"Running Tests","content":"","titles":["Local Development"]},"76":{"title":"Code Quality","content":"Run both before pushing to avoid CI failures.","titles":["Local Development"]},"77":{"title":"Viewing Emails","content":"In development, all emails are caught by Mailpit. Open http://localhost:8025 to view sent emails — registration confirmations, password resets, etc.","titles":["Local Development"]},"78":{"title":"Console Commands","content":"CommandDescriptionbin/console app:user:promote-admin {email}Promote a user to admin rolebin/console app:stripe:sync-plansSync plan definitions to Stripebin/console app:stripe:sync-plans --dry-runPreview sync without making changesbin/console app:dokployDokploy deployment helper (JWT mounts, DB)bin/console lexik:jwt:generate-keypairGenerate JWT public/private key pairbin/console doctrine:migrations:migrateRun pending migrationsbin/console doctrine:migrations:diffGenerate migration from mapping changes All commands should be run inside the PHP container:","titles":["Local Development"]},"79":{"title":"Debugging with Xdebug","content":"Xdebug is pre-installed in the dev image. Configure it via the XDEBUG_MODE environment variable in compose.yaml: The PHP IDE config is set to serverName=symfony. Configure your IDE's path mappings: Local pathContainer path.//app","titles":["Local Development"]},"80":{"title":"API Documentation","content":"The interactive Swagger UI is available at http://localhost/api/doc during development. The raw OpenAPI spec is at http://localhost/api/doc/openapi.yaml.","titles":["Local Development"]},"81":{"title":"Architecture","content":"Hexagonal architecture, CQRS, and bounded contexts","titles":[]},"82":{"title":"Architecture","content":"","titles":[]},"83":{"title":"Hexagonal Architecture (Ports & Adapters)","content":"The codebase is organized in three layers per bounded context:","titles":["Architecture"]},"84":{"title":"Layer Rules","content":"LayerCan depend onCannot depend onDomainNothing (pure PHP)Application, Infrastructure, SymfonyApplicationDomainInfrastructure, SymfonyInfrastructureDomain, Application(implements ports) Domain defines ports (interfaces). Infrastructure provides adapters (implementations). This means you can swap Stripe for another payment provider, or Brevo for another email service, without touching domain or application code.","titles":["Architecture","Hexagonal Architecture (Ports & Adapters)"]},"85":{"title":"CQRS","content":"The application uses three Symfony Messenger buses: BusPurposeExamplecommand.busWrite operations (state changes)SignUpCommand, ResetPasswordCommandquery.busRead operations (no side effects)GetUserProfileQuery, GetAvailablePlansQueryevent.busReact to domain eventsUserCreated, SubscriptionPaid","titles":["Architecture"]},"86":{"title":"Write Side (ORM)","content":"Commands go through handlers that use Doctrine ORM entities mapped via XML files: Domain models are rich objects with business logic (e.g., Subscription::upgrade(), Subscription::cancel()).","titles":["Architecture","CQRS"]},"87":{"title":"Read Side (DBAL)","content":"Queries go through handlers that use DBAL repositories returning lightweight view models. Read-model repositories use raw SQL via Doctrine DBAL — no ORM hydration overhead. This keeps reads fast and decoupled from the write model.","titles":["Architecture","CQRS"]},"88":{"title":"Event System","content":"Domain events are dispatched by command handlers via the event.bus: Events are dispatched synchronously (sync:// transport) by default. See Customization for switching to async processing via Redis.","titles":["Architecture","CQRS"]},"89":{"title":"Bounded Contexts","content":"","titles":["Architecture"]},"90":{"title":"UserManagement","content":"Handles authentication, user profiles, and password management. Domain Models: User, EmailValidationToken, PasswordResetToken Domain Events: UserCreated — triggers welcome emailPasswordResetRequested — triggers reset emailPasswordChanged — triggers confirmation email Ports (Interfaces): UserRepositoryInterfaceEmailValidationTokenRepositoryInterfacePasswordResetTokenRepositoryInterfaceEmailSenderInterfaceSocialTokenVerifierInterface","titles":["Architecture","Bounded Contexts"]},"91":{"title":"Subscription","content":"Handles plans, payments, and feature gating. Domain Models: Subscription, PlanType, Feature, PaymentType, BillingInterval, SubscriptionStatus Domain Events: SubscriptionPaid — triggered after successful payment Ports (Interfaces): SubscriptionRepositoryInterfacePaymentGatewayInterface","titles":["Architecture","Bounded Contexts"]},"92":{"title":"Screaming Architecture","content":"Each feature is a folder in Application/ containing its command/query DTO and handler: You can see what the application does just by reading the folder names.","titles":["Architecture"]},"93":{"title":"Controller Pattern","content":"Controllers are thin — they handle HTTP concerns only: Parse the request into a command/query DTODispatch via the appropriate busReturn the result as a JSON response No business logic lives in controllers.","titles":["Architecture"]},"94":{"title":"Email Architecture","content":"Two adapters implement EmailSenderInterface: AdapterUsed inTransportSymfonyMailerEmailSenderdev, testMailpit (SMTP)BrevoTransactionalEmailSenderprodBrevo API The active adapter is configured in config/services.yaml via the when@dev / when@test overrides. In production, the default Brevo adapter is used.","titles":["Architecture"]},"95":{"title":"Database","content":"PostgreSQL with custom Doctrine types for value objects: Doctrine TypePHP Classuser_idUserIdemailEmailhashed_passwordHashedPasswordsubscription_idSubscriptionIdplan_typePlanTypesubscription_statusSubscriptionStatusbilling_intervalBillingIntervalpayment_typePaymentType ORM mapping is done via XML files (not PHP attributes), keeping domain models free of framework annotations.","titles":["Architecture"]},"96":{"title":"Features","content":"Built-in backend features — authentication, payments, admin panel, and emails","titles":[]},"97":{"title":"Features","content":"The backend comes with four core feature areas, each production-ready and fully tested.","titles":[]},"98":{"title":"What's Included","content":"User Management — Registration, login, social auth, JWT tokens, password flows, rate limitingSubscription & Payments — Stripe Checkout, webhook handling, plan tiers, feature gatingAdmin Panel — EasyAdmin backoffice for managing users and subscriptionsCommunication — Transactional email system with Brevo and Mailpit","titles":["Features"]},"99":{"title":"User Management","content":"Authentication, user profiles, password flows, and rate limiting","titles":[]},"100":{"title":"User Management","content":"","titles":[]},"101":{"title":"What's Included","content":"Email/password registration with email validationSocial login via Firebase (Google, Apple)JWT access tokens with refresh token rotationForgot password / reset password flowChange password for authenticated usersRate limiting on all auth endpoints","titles":["User Management"]},"102":{"title":"Password Authentication","content":"Users register with a name, email, and password. On registration: The account is created with emailValidated: falseA UserCreated event dispatches a welcome email containing a validation linkThe user receives a JWT access token and refresh token immediately Clicking the validation link in the email sets emailValidated: true and redirects to your configured EMAIL_VALIDATION_REDIRECT_URL. Login accepts email + password and returns a JWT access token + refresh token.","titles":["User Management"]},"103":{"title":"Social Login (Firebase)","content":"Social authentication is handled via Firebase Authentication. The frontend obtains a Firebase ID token (Google, Apple, etc.) and sends it to the backend, which verifies it via the Firebase Admin SDK. New users are auto-created with emailValidated: true (social providers pre-verify emails) and provider set to google, apple, etc.Existing users (matched by email) get new tokens issuedSocial signup does not send a validation email","titles":["User Management"]},"104":{"title":"Session Management","content":"TokenTypeLifetimeNotesAccess tokenJWT1 hourSent in Authorization: Bearer headerRefresh tokenOpaque30 daysSingle-use — each refresh issues a new pair Refresh exchanges a valid refresh token for a new access + refresh token pair. The old refresh token is invalidated.Logout invalidates all refresh tokens for the user.","titles":["User Management"]},"105":{"title":"Password Reset Flow","content":"Forgot password — user submits their email. A PasswordResetRequested event dispatches a reset email with a tokenized link. The response is always 202 Accepted regardless of whether the email exists (prevents enumeration).Reset redirect — the link in the email hits the backend, which validates the token and redirects to {FRONTEND_RESET_PASSWORD_URL}?token={token}. Expired tokens return 404 and are auto-deleted.Reset password — the frontend submits the token + new password. On success, a PasswordChanged event sends a confirmation email.","titles":["User Management"]},"106":{"title":"Change Password","content":"Authenticated users can change their password by providing their current password and a new one. A PasswordChanged event sends a confirmation email.","titles":["User Management"]},"107":{"title":"User Profile","content":"Returns the current user's profile (id, name, email, emailValidated, provider, createdAt) via a DBAL read model for optimized reads.","titles":["User Management"]},"108":{"title":"Rate Limiting","content":"Authentication endpoints are rate-limited to prevent brute force attacks. See Configuration > Rate Limiting for the full limiter definitions and thresholds.","titles":["User Management"]},"109":{"title":"Security","content":"Password hashing — bcrypt with cost factor 12Email enumeration prevention — forgot password always returns 202, login returns a generic \"Invalid credentials\" errorToken expiry — access tokens (1h), refresh tokens (30d), email validation and password reset tokens are single-use and auto-deleted after use or expirySingle-use refresh tokens — prevents token replay attacks","titles":["User Management"]},"110":{"title":"Subscription & Payments","content":"Stripe integration, plan tiers, webhooks, and feature gating","titles":[]},"111":{"title":"Subscription & Payments","content":"For full endpoint details (request/response schemas, examples), see the interactive API docs at /api/doc.","titles":[]},"112":{"title":"What's Included","content":"Three plan tiers (Free, Starter, Pro) with configurable featuresStripe Checkout for both recurring and one-time paymentsWebhook handling for 5 Stripe eventsFeature gating via FeatureAccessCheckerGuest and authenticated checkout support","titles":["Subscription & Payments"]},"113":{"title":"Plan Tiers","content":"PlanFeaturesFreeBasicAccessStarterBasicAccess, AdvancedReports, ApiAccessProBasicAccess, AdvancedReports, ApiAccess, PrioritySupport, CustomIntegrations Every user starts on the Free plan. Paid plans are activated after Stripe checkout completion.","titles":["Subscription & Payments"]},"114":{"title":"Feature Access","content":"Use FeatureAccessChecker to gate features in your code:","titles":["Subscription & Payments"]},"115":{"title":"Stripe Setup","content":"","titles":["Subscription & Payments"]},"116":{"title":"1. Create a Stripe Account","content":"Sign up at stripe.com and get your API keys from the Developers section.","titles":["Subscription & Payments","Stripe Setup"]},"117":{"title":"2. Set Environment Variables","content":"","titles":["Subscription & Payments","Stripe Setup"]},"118":{"title":"3. Configure Plans","content":"Edit config/packages/stripe.yaml to define your plan tiers and prices. See Configuration.","titles":["Subscription & Payments","Stripe Setup"]},"119":{"title":"4. Sync Plans to Stripe","content":"This creates or updates Stripe Products and Prices to match your config. Use --dry-run to preview changes.","titles":["Subscription & Payments","Stripe Setup"]},"120":{"title":"5. Set Up Webhook (Production)","content":"In the Stripe Dashboard > Developers > Webhooks: Add endpoint: https://yourdomain.com/api/v1/webhooks/stripeSelect events: checkout.session.completed, customer.subscription.updated, customer.subscription.deleted, invoice.payment_failed, invoice.paidCopy the signing secret to STRIPE_WEBHOOK_SECRET","titles":["Subscription & Payments","Stripe Setup"]},"121":{"title":"6. Local Testing with Stripe CLI","content":"","titles":["Subscription & Payments","Stripe Setup"]},"122":{"title":"Webhook Events","content":"Stripe EventActioncheckout.session.completedCreates subscription (free → paid upgrade)customer.subscription.updatedUpdates plan/statuscustomer.subscription.deletedCancels subscriptioninvoice.payment_failedMarks subscription as past dueinvoice.paidReactivates subscription after successful payment Plans are fetched from Stripe and cached for 1 hour. Checkout supports both authenticated users (email pre-filled, user_id in metadata) and guest users (Stripe collects email).","titles":["Subscription & Payments"]},"123":{"title":"Subscription Lifecycle","content":"","titles":["Subscription & Payments"]},"124":{"title":"Admin Panel","content":"EasyAdmin backoffice for managing users and subscriptions","titles":[]},"125":{"title":"Admin Panel","content":"The admin panel is built with EasyAdmin and provides a backoffice for managing users and subscriptions.","titles":[]},"126":{"title":"What's Included","content":"User management with search, filter, and role editingSubscription management with status trackingSecure form-based login with rate limiting","titles":["Admin Panel"]},"127":{"title":"Access","content":"The admin panel is available at /admin. You must have the ROLE_ADMIN role to access it.","titles":["Admin Panel"]},"128":{"title":"Creating an Admin User","content":"Register a user through the APIPromote them to admin:","titles":["Admin Panel","Access"]},"129":{"title":"Login","content":"The admin panel uses form-based login at /admin/login (separate from the API's JWT auth). Login is protected by rate limiting: 5 attempts per 15 minutes.","titles":["Admin Panel","Access"]},"130":{"title":"Dashboard","content":"Title: BackofficeDefault view: Redirects to the Users listMenu sections: User Management (Users) and Subscriptions (Subscriptions)","titles":["Admin Panel"]},"131":{"title":"Users","content":"","titles":["Admin Panel"]},"132":{"title":"Fields","content":"FieldTypeEditableNotesidIDNoHidden on formsnameTextNoDisplayed but disabledemailEmailNoAlways disabledemailValidatedBooleanNoRendered as icon, not switchproviderTextNoemail, google, apple, etc.rolesChoiceYesROLE_USER, ROLE_ADMIN — editable on edit pagecreatedAtDateTimeNoHidden on formsupdatedAtDateTimeNoVisible on detail page only","titles":["Admin Panel","Users"]},"133":{"title":"Search","content":"Search by name or email.","titles":["Admin Panel","Users"]},"134":{"title":"Filters","content":"FilterTypeOptionsEmailTextFree textNameTextFree textEmail ValidatedBooleanYes / NoProviderTextFree textRolesChoiceROLE_USER, ROLE_ADMIN","titles":["Admin Panel","Users"]},"135":{"title":"Disabled Actions","content":"Delete — users cannot be deleted from the admin panelCreate — users must register through the API","titles":["Admin Panel","Users"]},"136":{"title":"Subscriptions","content":"","titles":["Admin Panel"]},"137":{"title":"Fields","content":"FieldTypeEditableNotesidIDNoHidden on formsuserIdTextNoAlways disabledplanTypeTextNoFree Plan, Starter, PropaymentTypeTextNoRecurring or One-TimestatusChoiceYesActive, Past Due, Canceled, ExpiredbillingIntervalTextNoMonthly or YearlystripeCustomerIdTextNoVisible on detail/edit pagesstripeSubscriptionIdTextNoVisible on detail/edit pagesstripePaymentIntentIdTextNoVisible on detail/edit pages onlycurrentPeriodEndDateTimeNoAlways disabledcreatedAtDateTimeNoHidden on formsupdatedAtDateTimeNoVisible on detail page only","titles":["Admin Panel","Subscriptions"]},"138":{"title":"Search","content":"Search by userId, stripeCustomerId, or stripeSubscriptionId.","titles":["Admin Panel","Subscriptions"]},"139":{"title":"Filters","content":"FilterTypeOptionsStatusChoiceActive, Past Due, Canceled, ExpiredPlan TypeChoiceFree Plan, Starter Plan, Pro PlanBilling IntervalChoiceMonthly, YearlyPayment TypeChoiceRecurring, One-Time","titles":["Admin Panel","Subscriptions"]},"140":{"title":"Disabled Actions","content":"Delete — subscriptions cannot be deleted from the admin panelCreate — subscriptions are created through Stripe checkout","titles":["Admin Panel","Subscriptions"]},"141":{"title":"Security","content":"Access control — requires ROLE_ADMIN roleAuthentication — form-based login (separate from API JWT auth)Login throttling — 5 attempts per 15 minutes per IPCSRF protection — enabled on login formPassword hashing — bcrypt with cost factor 12 (same as API)","titles":["Admin Panel"]},"142":{"title":"Communication","content":"Transactional email system with Brevo and Mailpit","titles":[]},"143":{"title":"Communication","content":"","titles":[]},"144":{"title":"What's Included","content":"Three transactional email templates (welcome, password reset, password changed)Brevo integration for production emailsMailpit for local development (catches all outgoing emails)Environment-based adapter swap — no code changes between dev and prod","titles":["Communication"]},"145":{"title":"Email Architecture","content":"Two adapters implement EmailSenderInterface: EnvironmentAdapterDeliveryProductionBrevoTransactionalEmailSenderBrevo API with template IDsDevelopmentSymfonyMailerEmailSenderSymfony Mailer → Mailpit Both adapters implement the same domain port, keeping the application layer decoupled from the delivery mechanism. The swap is configured in config/services.yaml via environment-specific overrides:","titles":["Communication"]},"146":{"title":"Transactional Emails","content":"EmailTriggerTemplate VariablesWelcomeUser registrationuserName, link (validation)Password ResetForgot password requestuserName, link (reset)Password ChangedPassword change or resetuserName All emails are sent asynchronously via domain events. If sending fails, the error is logged but does not block the originating action.","titles":["Communication"]},"147":{"title":"Brevo Setup (Production)","content":"","titles":["Communication"]},"148":{"title":"1. Create Templates","content":"Create 3 transactional email templates in your Brevo dashboard using the template variables listed above.","titles":["Communication","Brevo Setup (Production)"]},"149":{"title":"2. Configure Template IDs and Environment Variables","content":"See Configuration > Brevo Email Templates for template ID mapping and required environment variables.","titles":["Communication","Brevo Setup (Production)"]},"150":{"title":"Mailpit (Local Development)","content":"In development, all emails are caught by Mailpit instead of being sent to real addresses. The Mailpit web UI is available at: http://localhost:8025 All emails sent during development appear here, making it easy to test email flows without configuring a real email provider.","titles":["Communication"]},"151":{"title":"API Reference","content":"Complete list of backend API endpoints","titles":[]},"152":{"title":"API Reference","content":"Full interactive API documentation with request/response schemas is available at /api/doc (Swagger UI) when running the backend locally.","titles":[]},"153":{"title":"Base URL","content":"EnvironmentURLLocalhttp://localhostProductionhttps://yourdomain.com All endpoints are prefixed with /api/v1/.","titles":["API Reference"]},"154":{"title":"Authentication","content":"Protected endpoints require a JWT bearer token: Tokens are obtained from login, register, social login, or token refresh endpoints. Access tokens expire after 1 hour.","titles":["API Reference"]},"155":{"title":"Endpoints","content":"#MethodPathAuthDescription1POST/api/v1/auth/registerPublicRegister a new user2POST/api/v1/auth/loginPublicLogin with email/password3POST/api/v1/auth/socialPublicLogin/register with Firebase token4POST/api/v1/auth/token/refreshPublicRefresh JWT using refresh token5POST/api/v1/auth/logoutJWTLogout and invalidate refresh tokens6GET/api/v1/auth/validate-email/{token}PublicValidate email (redirects)7POST/api/v1/auth/forgot-passwordPublicRequest password reset email8GET/api/v1/auth/reset-password/{token}PublicReset password redirect9POST/api/v1/auth/reset-passwordPublicSubmit new password with reset token10GET/api/v1/user/profileJWTGet current user profile11POST/api/v1/user/change-passwordJWTChange password12GET/api/v1/plansPublicList available subscription plans13POST/api/v1/subscription/checkoutOptionalCreate Stripe checkout session14GET/api/v1/subscriptionJWTGet current subscription status15POST/api/v1/webhooks/stripeStripeStripe webhook receiver16GET/api/docPublicOpenAPI / Swagger UI Auth legend: Public — no authentication requiredJWT — requires Authorization: Bearer headerOptional — works with or without JWT (authenticated checkout pre-fills email)Stripe — verified via Stripe-Signature header","titles":["API Reference"]},"156":{"title":"Rate Limits","content":"Rate limiters are configured in config/packages/rate_limiter.yaml — see Configuration > Rate Limiting for details. EndpointIP LimitEmail LimitRegister5 / 15 min3 / 15 minLogin5 / 15 min5 / 15 minSocial Login5 / 15 min—Logout10 / 1 min—Admin Login5 / 15 min—","titles":["API Reference"]},"157":{"title":"Error Responses","content":"All errors follow a consistent format: Some errors include additional details: Rate limit responses:","titles":["API Reference"]},"158":{"title":"Common Status Codes","content":"CodeMeaning200Success201Created (registration, new social login)202Accepted (forgot password — always, to prevent enumeration)400Bad request (validation errors, missing fields)401Unauthorized (invalid credentials, expired JWT)404Not found (user, subscription, token)429Too many requests (rate limited)","titles":["API Reference","Error Responses"]},"159":{"title":"OpenAPI Specification","content":"Swagger UI: http://localhost/api/docRaw YAML spec: http://localhost/api/doc/openapi.yaml","titles":["API Reference"]},"160":{"title":"Testing","content":"Unit and functional test patterns with fakes","titles":[]},"161":{"title":"Testing","content":"","titles":[]},"162":{"title":"What's Included","content":"Unit tests with in-memory fakes (no database, no framework)Functional tests with real HTTP requests and database rollbackComplete set of test doubles for all external dependenciesPHPStan static analysis and PHP CS Fixer","titles":["Testing"]},"163":{"title":"Test Structure","content":"","titles":["Testing"]},"164":{"title":"Running Tests","content":"","titles":["Testing"]},"165":{"title":"Unit Tests","content":"Unit tests run without a database or framework. They test command handlers and domain logic using in-memory fakes. Key principles: Use fakes (in-memory implementations), not mocksTest the handler's behavior, not its implementationSet up test data manually — no fixtures or factories","titles":["Testing"]},"166":{"title":"Functional Tests","content":"Functional tests make real HTTP requests against the application with a real database. Each test runs inside a database transaction that is rolled back automatically.","titles":["Testing"]},"167":{"title":"Test Doubles","content":"All test doubles live in tests/Doubles/. The project uses fakes (in-memory implementations) rather than mocks: DoubleTypeReplacesInMemoryUserRepositoryFakeDoctrineUserRepositoryInMemorySubscriptionRepositoryFakeDoctrineSubscriptionRepositoryInMemoryEmailValidationTokenRepositoryFakeDoctrine token repositoryInMemoryPasswordResetTokenRepositoryFakeDoctrine token repositoryInMemorySubscriptionStatusReadModelRepositoryFakeDBAL read modelInMemoryUserProfileReadModelRepositoryFakeDBAL read modelInMemoryEmailSenderFakeBrevoTransactionalEmailSenderFakePaymentGatewayFakeStripePaymentGatewayFakeEventBusFakeSymfony Messenger event busFakeSocialTokenVerifierFakeFirebaseTokenVerifierFakePasswordHasherFakeSymfony PasswordHasherStubUrlGeneratorStubSymfony UrlGeneratorPasswordHashableUserHelperTest user with hashable passwordFailingEmailSenderFakeAlways throws (error path testing)FailingPaymentGatewayFakeAlways throws (error path testing)FailingGitHubOrganizationClientFakeAlways throws (error path testing)","titles":["Testing"]},"168":{"title":"Writing New Tests","content":"","titles":["Testing"]},"169":{"title":"Adding a Unit Test","content":"Create a test class extending TestCaseSet up in-memory fakes in setUp()Create the handler with all fakes injectedPrepare test data (create users, tokens, etc.)Call the handler and assert results","titles":["Testing","Writing New Tests"]},"170":{"title":"Adding a Functional Test","content":"Create a test class extending ApiTestCaseMake HTTP requests with static::createClient()Assert response status codes and JSON contentThe database is rolled back after each test automatically","titles":["Testing","Writing New Tests"]},"171":{"title":"CI/CD","content":"GitHub Actions pipeline for testing, building, and deploying","titles":[]},"172":{"title":"CI/CD Pipeline","content":"The backend includes a GitHub Actions pipeline that runs on every push to main.","titles":[]},"173":{"title":"Pipeline Overview","content":"","titles":["CI/CD Pipeline"]},"174":{"title":"Stage 1: Test","content":"Builds the dev Docker image and runs the full quality suite with PostgreSQL 16 and Redis 7 services: Validate composer.jsonCheck composer.lock — verifies lock file is up to dateSecurity audit for known vulnerabilitiesInstall dependenciesSet up test database (PostgreSQL + migrations)Generate JWT keysRun unit testsRun functional testsPHPStan static analysisPHP CS Fixer check (dry-run)","titles":["CI/CD Pipeline"]},"175":{"title":"Stage 2: Build Production Image","content":"Runs only if all tests pass. Builds the frankenphp_prod Docker target and pushes to GitHub Container Registry (ghcr.io/{owner}/{repo}:main).","titles":["CI/CD Pipeline"]},"176":{"title":"Stage 3: Deploy","content":"Sends a POST request to the Dokploy webhook URL. Dokploy pulls the new image and restarts the application.","titles":["CI/CD Pipeline"]},"177":{"title":"Required GitHub Secrets","content":"SecretDescriptionDOKPLOY_WEBHOOK_URLDokploy deployment webhook URL GITHUB_TOKEN is automatically provided by GitHub Actions for pushing to GHCR.","titles":["CI/CD Pipeline"]},"178":{"title":"Running Checks Locally","content":"Before pushing, run the same checks the CI runs: If make csfix changes any files, commit them before pushing — the CI runs CS Fixer in dry-run mode.","titles":["CI/CD Pipeline"]},"179":{"title":"Deployment","content":"Production deployment with Dokploy and Docker","titles":[]},"180":{"title":"Deployment","content":"This guide covers deploying the backend with Dokploy. The CI/CD pipeline builds a production Docker image and triggers deployment via a webhook.","titles":[]},"181":{"title":"Prerequisites","content":"A server with Dokploy installedA domain name pointed to your serverThe CI/CD pipeline configured (see CI/CD)","titles":["Deployment"]},"182":{"title":"Step-by-Step Setup","content":"","titles":["Deployment"]},"183":{"title":"1. Create the Dokploy Application","content":"In the Dokploy dashboard: Create a new applicationSet the source to Docker (from GitHub Container Registry)Configure the image: ghcr.io/{owner}/{repo}:mainSet up a domain with HTTPS","titles":["Deployment","Step-by-Step Setup"]},"184":{"title":"2. Create the Database","content":"Use the built-in Dokploy CLI command: This interactive command helps you create a PostgreSQL database service and configure deployment settings.","titles":["Deployment","Step-by-Step Setup"]},"185":{"title":"3. Configure Environment Variables","content":"Set these in Dokploy application settings:","titles":["Deployment","Step-by-Step Setup"]},"186":{"title":"4. Mount JWT Certificates","content":"JWT keys need to persist between deployments. You can use the built-in Dokploy CLI command: Or mount the certificates manually in Dokploy: Go to your service → Advanced → VolumesClick Add Volume and select File MountMount the private key:\nOpen your local config/jwt/private.pem and paste its content into the File Content fieldSet Filename to private.pemSet Mount Path to /app/config/jwt/private.pemRepeat for the public key:\nOpen your local config/jwt/public.pem and paste its contentSet Filename to public.pemSet Mount Path to /app/config/jwt/public.pem","titles":["Deployment","Step-by-Step Setup"]},"187":{"title":"5. Set Up the Deployment Webhook","content":"In Dokploy → application → Settings → Webhooks, copy the webhook URLAdd it as a GitHub secret: DOKPLOY_WEBHOOK_URL","titles":["Deployment","Step-by-Step Setup"]},"188":{"title":"6. Initial Setup Commands","content":"After the first deployment, run inside the production container:","titles":["Deployment","Step-by-Step Setup"]},"189":{"title":"7. Configure Stripe Webhook","content":"Configure the Stripe webhook endpoint for production — see Subscription & Payments for detailed instructions.","titles":["Deployment","Step-by-Step Setup"]},"190":{"title":"Deployment Architecture","content":"Both services are deployed as Docker containers managed by Dokploy, with automatic HTTPS via Let's Encrypt.","titles":["Deployment"]},"191":{"title":"Installing Dokploy","content":"Dokploy is a self-hosted deployment platform. Install it on your server: Access the Dokploy dashboard at https://your-server-ip:3000.","titles":["Deployment"]},"192":{"title":"DNS Configuration","content":"RecordDomainTargetAyourdomain.comYour server IPAapi.yourdomain.comYour server IP Dokploy handles HTTPS certificates automatically via Let's Encrypt.","titles":["Deployment"]},"193":{"title":"Production Checklist","content":"Verify everything before going live.","titles":["Deployment"]},"194":{"title":"Backend","content":"APP_ENV=prod is set APP_SECRET is a unique random string (not the default) DATABASE_URL points to the production database JWT keys are generated and persisted via volume mount JWT_PASSPHRASE matches the passphrase used to generate keys Database migrations are applied An admin user is created","titles":["Deployment","Production Checklist"]},"195":{"title":"Stripe","content":"STRIPE_SECRET_KEY uses a live key (sk_live_...) STRIPE_WEBHOOK_SECRET is set from the production webhook Stripe webhook is configured with all 5 required events STRIPE_SUCCESS_URL points to https://yourdomain.com/payment/success STRIPE_CANCEL_URL points to https://yourdomain.com/payment/cancel Plans are synced (bin/console app:stripe:sync-plans)","titles":["Deployment","Production Checklist"]},"196":{"title":"Email","content":"BREVO_API_KEY is set with a valid key EMAIL_SENDER_EMAIL uses a verified sender domain in Brevo Brevo templates are created with correct IDs Test emails are sending correctly","titles":["Deployment","Production Checklist"]},"197":{"title":"Firebase","content":"FIREBASE_PROJECT_ID is set on the backend Production domain is added to Firebase authorized domains","titles":["Deployment","Production Checklist"]},"198":{"title":"Cross-Project","content":"CORS_ALLOW_ORIGIN on backend matches the frontend domain EMAIL_VALIDATION_REDIRECT_URL points to frontend /auth/email-verified FRONTEND_RESET_PASSWORD_URL points to frontend /auth/reset-password All redirect URLs use https://","titles":["Deployment","Production Checklist"]},"199":{"title":"Infrastructure","content":"HTTPS is configured on the API domain DNS records point to the server GitHub secrets are set for CI/CD (DOKPLOY_WEBHOOK_URL) CI/CD pipeline passes (test → build → deploy)","titles":["Deployment","Production Checklist"]},"200":{"title":"Smoke Test","content":"After deployment, verify these flows work end-to-end: Landing page loads at https://yourdomain.com Register a new user Check welcome email arrives (via Brevo) Login with the new user Complete a Stripe test checkout Verify subscription appears on profile page Test forgot password flow Test social login (if configured) Access admin panel at https://api.yourdomain.com/admin","titles":["Deployment","Production Checklist"]},"201":{"title":"Customization","content":"How to extend the boilerplate with new features","titles":[]},"202":{"title":"Customization","content":"This guide shows how to extend the boilerplate with new features.","titles":[]},"203":{"title":"Adding a New Command (Write Operation)","content":"Example: adding an \"Update Profile\" feature.","titles":["Customization"]},"204":{"title":"1. Create the Feature Folder","content":"","titles":["Customization","Adding a New Command (Write Operation)"]},"205":{"title":"2. Create the Command DTO","content":"","titles":["Customization","Adding a New Command (Write Operation)"]},"206":{"title":"3. Create the Handler","content":"","titles":["Customization","Adding a New Command (Write Operation)"]},"207":{"title":"4. Create the Controller","content":"","titles":["Customization","Adding a New Command (Write Operation)"]},"208":{"title":"5. Add the Route","content":"In config/routes/api.yaml:","titles":["Customization","Adding a New Command (Write Operation)"]},"209":{"title":"6. Write Tests","content":"Create both a unit test (with fakes) and a functional test (with HTTP requests).","titles":["Customization","Adding a New Command (Write Operation)"]},"210":{"title":"Adding a New Query (Read Operation)","content":"Example: adding a \"List Users\" admin query.","titles":["Customization"]},"211":{"title":"1. Create the Query and ViewModel","content":"","titles":["Customization","Adding a New Query (Read Operation)"]},"212":{"title":"2. Create the Read Model Repository Interface","content":"","titles":["Customization","Adding a New Query (Read Operation)"]},"213":{"title":"3. Implement with DBAL","content":"","titles":["Customization","Adding a New Query (Read Operation)"]},"214":{"title":"4. Create the Handler","content":"","titles":["Customization","Adding a New Query (Read Operation)"]},"215":{"title":"5. Wire Up","content":"Add the repository binding in config/services.yaml and create a controller + route.","titles":["Customization","Adding a New Query (Read Operation)"]},"216":{"title":"Adding a New Bounded Context","content":"Then configure: Add ORM mapping in config/packages/doctrine.yaml: Register controllers in config/services.yaml: Add routes in config/routes/api.yaml.Create a migration for any new database tables.","titles":["Customization"]},"217":{"title":"Adding a New Domain Event","content":"","titles":["Customization"]},"218":{"title":"1. Create the Event","content":"","titles":["Customization","Adding a New Domain Event"]},"219":{"title":"2. Dispatch from a Handler","content":"","titles":["Customization","Adding a New Domain Event"]},"220":{"title":"3. Create a Listener","content":"","titles":["Customization","Adding a New Domain Event"]},"221":{"title":"4. Route to Async (Optional)","content":"In config/packages/messenger.yaml:","titles":["Customization","Adding a New Domain Event"]},"222":{"title":"Adding a New Email Template","content":"","titles":["Customization"]},"223":{"title":"1. Create the Template in Brevo","content":"Create a new transactional email template in your Brevo dashboard. Note the template ID.","titles":["Customization","Adding a New Email Template"]},"224":{"title":"2. Add the Template ID to Config","content":"In config/packages/brevo.yaml:","titles":["Customization","Adding a New Email Template"]},"225":{"title":"3. Add to the EmailSender Interface","content":"Add a new method to src/UserManagement/Domain/Port/EmailSenderInterface.php:","titles":["Customization","Adding a New Email Template"]},"226":{"title":"4. Implement in Both Adapters","content":"Brevo adapter (src/UserManagement/Infrastructure/Email/BrevoTransactionalEmailSender.php): Symfony Mailer adapter (src/UserManagement/Infrastructure/Email/SymfonyMailerEmailSender.php):","titles":["Customization","Adding a New Email Template"]},"227":{"title":"Adding a New Stripe Plan","content":"Edit config/packages/stripe.yaml — see Configuration > Stripe Plans for the full format and examples.Add the plan type to src/Subscription/Domain/Model/PlanType.php: Define its features in the features() method.Sync to Stripe: Create a migration if the plan_type database type needs updating.","titles":["Customization"]},"228":{"title":"Redis","content":"Redis is provisioned but not active at runtime. The Docker container, PHP extension, and client library are all in place — messenger and cache currently use synchronous/in-memory alternatives (sync:// transport, APCu cache). Enable Redis when you need async processing or multi-server deployments.","titles":["Customization"]},"229":{"title":"Async Event Processing (Messenger)","content":"In config/packages/messenger.yaml, switch the transport DSN: Set the Redis transport in .env.local: Start a worker to consume messages: In production, run the worker as a supervised process (systemd, Supervisor, or a separate container).","titles":["Customization","Redis"]},"230":{"title":"Distributed Caching","content":"Switch cache pools from APCu to Redis in config/packages/cache.yaml: This is required for multi-server deployments where APCu (per-process) won't share state across instances. Redis can also back rate limiting (framework.rate_limiter) in the same scenario.","titles":["Customization","Redis"]},"231":{"title":"Frontend","content":"Nuxt 3 frontend documentation — structure, components, and features","titles":[]},"232":{"title":"Frontend","content":"The frontend is a Nuxt 3 application with a polished dark theme, built-in authentication flows, Stripe checkout, and a user dashboard.","titles":[]},"233":{"title":"What's Included","content":"Marketing landing page — Hero, features, pricing, FAQ, and CTA sectionsAuthentication — Login, register, forgot/reset password, social login (Firebase/Google)Payments — Stripe Checkout with success/cancel pagesUser dashboard — Profile, subscription status, password changesDark theme — Consistent design with Tailwind CSS","titles":["Frontend"]},"234":{"title":"Tech Stack","content":"ComponentTechnologyFrameworkNuxt 3UI LibraryVue 3 (Composition API)StylingTailwind CSSStatePiniaTypesTypeScriptTestingVitest + Vue Test UtilsSocial AuthFirebase (Google OAuth)AnalyticsUmami (optional)","titles":["Frontend"]},"235":{"title":"In This Section","content":"Overview — Tech stack and key decisionsProject Structure — Directory layoutConfiguration — Nuxt config and environment variablesGetting Started — Local development setupFeatures — Authentication, payments, dashboard, analyticsComponents & Composables — UI catalogTesting — Vitest setup and patternsCI/CD — GitHub Actions pipelineDeployment — Docker and Dokploy","titles":["Frontend"]},"236":{"title":"Overview","content":"Frontend tech stack, key decisions, and architectural patterns","titles":[]},"237":{"title":"Frontend Overview","content":"The frontend is a Nuxt 3 application providing a marketing landing page, authentication flows, Stripe checkout, and a user dashboard — all styled with a dark theme using Tailwind CSS.","titles":[]},"238":{"title":"Key Decisions","content":"","titles":["Frontend Overview"]},"239":{"title":"Nuxt 3","content":"Nuxt 3 provides server-side rendering (SSR) for SEO, auto-imports for composables and components, file-based routing, and a mature plugin ecosystem. The app uses SSR for the public landing page and client-side rendering for authenticated views.","titles":["Frontend Overview","Key Decisions"]},"240":{"title":"Vue 3 Composition API","content":"All components use the