Config Documentation

adr/012-configs.md

@@ -0,0 +1,43 @@
+# 12. Partner configuration
+
+Date: 2024-12-12
+
+## Decision
+
+We will store partner config settings in an Azure container
+
+## Status
+
+Accepted.
+
+## Context
+
+In order to enable the usage of partner-specific settings in the different parts of the app, we are going to store the settings
+in a config container in our Azure storage account. Each partner will have its own separate file within the container to minimize potential
+blast radius when changing settings.
+
+
+## Notes
+- config files should only contain non-secret values
+- secrets will use a consistent naming pattern based on the partner ID used in config (so we can dynamically assemble the key names in code)
+- config keys are their file names (minus .json) and match org names in ReportStream
+
+## Impact
+
+### Positive
+
+- We can continue to meet our partners where they are by having partner specific settings in the app in order to provide any needed customizations.
+- We can create separate testing config for the Flexion organizations
+
+### Negative
+
+- Some added complexity for the implementation of configs.
+- Initial implementation of the config will require either restarting or redeploying the app
+
+### Risks
+
+- None
+
+## Related Issues
+
+- #1082

docs/configs.md

@@ -0,0 +1,7 @@
+# FAQ
+
+- We don't load configs in the PR environment.  
+- See [The partner settings struct](/src/config/config.go) for the config structure
+- Configs load prior to the application running.  Any changes to the config will require a restart of the Azure container to load those changes
+- For local non-partner specific testing, we have a Flexion based config that can be used in non-prod environments
+

src/config/config.go

@@ -8,6 +8,9 @@ import (
 	"slices"
 )
 
+/*
+The below struct is the struct for the values of partner configs. If adding new configs add to this struct
+*/
 type PartnerSettings struct {
 	DisplayName              string `json:"displayName"` // full name if we need pretty names
 	IsActive                 bool   `json:"isActive"`