Add Config Schema
Developmentadd-config-schemaAdd Config Schema is an Agent Skill for development published in the talkincode/toughradius repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Add a dynamic config item editable on the system config page (TR-F014). Use when adding a RADIUS runtime parameter that must support query/edit/reload.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/talkincode/toughradius/blob/HEAD/.agents/skills/add-config-schema/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/add-config-schema, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Skill: Add a Dynamic Config Item
Feature ID:
TR-F014
When to use
When adding a RADIUS runtime parameter that should be editable on the system config page.
Pre-research
view internal/app/config_schemas.json # config schema (edit here first)
view internal/app/config_manager.go # read / reload logic
view internal/adminapi/settings.go # config endpoints
grep_search "GetSettingsStringValue\|GetSettingsInt64Value" --include internal/**
Implementation steps
- Schema: add the config item to
config_schemas.jsonwithdefault / type / range / i18n key. - Read: read via
app.GApp().GetSettings*Value("<group>", "<Key>"); do not hardcode. - Default initialization: confirm
checkSettings()/ init logic writes the default value. - Frontend: the system config page
web/src/pages/SystemConfigPage.tsxrenders from the schema automatically; customize only if a special control is needed.
Conventions
- A new config item must enter the schema before any code reads it.
- Type, range, default, and i18n key are all required.
Acceptance
- The config can be queried / edited / reloaded in the backend
- The new config read path has a test
-
go test ./internal/app/...passes - PR references
TR-F014