Configuration Creation

Role: Project Manager | Solution Architect 🏗️

Configuration is the central store for all environment variables, secrets, and connection information that the System needs to run. The AI Agent references this when producing Implementation Plans and technical documents — ensuring correct variable names and the correct environment.

How to use

1. In System Management, select the System from the left list.
2. Switch to the "Configs" tab.

---

Create a new Configuration

1. Click the "New" button (+ icon) in the top-right corner of the tab.

2. The "New Configuration" modal opens. Pick an input source:

   Source 1 — Manual Input:

   Field	Required	Notes
   Name	Yes	Friendly label (for example: Stripe API Key (Prod), Database URL)
   Key Name	Yes	Actual variable name in code (for example: STRIPE_API_KEY, DATABASE_URL) — monospace
   Type	No	Classification: Env Variable, Secret, Database, Queue
   Value	Yes	The variable's value
   Treat as Secret	No	Enable to mask the value (••••••) in the list — use for passwords and API keys
   Environments	No	Assign to one or more environments
   Countries	No	Restrict by deployment region (Global, US, EU...)

   Source 2 — From Credential (from the pre-configured Credentials store):

   Pick a credential from the dropdown — Name, Key, and Type will auto-fill and cannot be edited. You only need to select Environments and Countries. Use this when you want to reuse a credential stored centrally by the admin.

3. Click "Save Configuration". The config appears in the table.

---

Configurations table

The table shows these columns:

Column	Contents
NAME	Friendly label of the configuration
KEY REFERENCE	Variable name (DATABASE_URL, JWT_SECRET...) — monospace
CONFIG VALUE	Value — if Secret, shown as ••••••; click the 👁 icon to reveal temporarily, click the copy icon to copy
TYPE	Color badge: env (green), secret (purple), db (cyan), queue (orange)
COUNTRIES	Applied regions
ENVIRONMENTS	Applied environments
ACTIONS	Edit button

---

Filter by Environment and Country

Click the filter icon on the COUNTRIES or ENVIRONMENTS column to open a filter dropdown. A count badge appears on the icon while a filter is active. Click "Reset" to clear filters.

---

Edit a Configuration

Click the Edit icon (⚙️) in the Actions column → the "Edit Configuration" modal opens → update → click "Save Configuration".

---

Configuration types

Type	Used for	Example
Env Variable	Ordinary environment variables	APP_PORT=3000, LOG_LEVEL=info
Secret	Sensitive information	JWT_SECRET, STRIPE_API_KEY, DB_PASSWORD
Database	Database connection strings	DATABASE_URL=postgresql://...
Queue	Message queue configuration	RABBITMQ_URL, SQS_QUEUE_NAME

Secrets and Production

Do not reuse Secret values between Staging and Production. When creating configs for Dev/Staging, use test/sandbox values. Enable "Treat as Secret" for any field containing passwords, tokens, or API keys to avoid exposing values when sharing your screen.

Next step

After adding Configurations, move on to 05 — API Spec Setup to import the Swagger URL and extract endpoints.