alla-allaos-fullstack/docs/implementation/task-d79-installation-profiles-setup-plugin-registry.md

Task D.7.9 Installation Profiles & Setup Plugin Registry

Date: 2026-07-03 Status: implemented

Scope Delivered

Added setup plugin platform layer:

• src/features/setup/plugins/plugin-types.ts
• src/features/setup/plugins/plugin-registry.ts
• src/features/setup/plugins/installation-profile.ts
• src/features/setup/plugins/foundation/foundation-plugin.ts
• src/features/setup/plugins/crm/crm-setup-plugin.ts
• src/features/setup/plugins/crm/crm-installation-profile.ts

Added installation profile API:

• GET /api/setup/profiles

Updated existing setup APIs:

• GET /api/setup/templates?profile=<profileId> now returns plugin-aware metadata while preserving legacy template fields.
• GET /api/setup/readiness?profile=<profileId> includes plugin registry readiness checks.
• POST /api/setup/verify accepts optional profileId and includes plugin registry verification checks.

Updated Setup Wizard:

• Loads installation profiles from the setup plugin registry.
• Allows profile selection.
• Builds wizard stepper from profile-resolved wizard steps with fallback to existing steps.
• Displays installed setup modules/plugins.

Added plugin documentation:

• docs/setup/installation-profiles.md
• docs/setup/setup-plugin-development.md

Added setup tests:

• src/tests/setup/setup-plugin-registry.test.ts

Profiles

Implemented profiles:

• crm_starter
• crm_demo
• production
• restore_backup
• custom

Plugins

Implemented built-in plugins:

• foundation
  • owns setup platform foundations, setup state, seed manifests, reset framework, CSV framework, and foundation golden dataset registration
• crm
  • owns CRM templates, CRM verification registration, CRM reset scopes, CRM reseed target registration, and CRM golden dataset registration

Compatibility Notes

• No breaking API field removals were introduced.
• Existing template metadata fields remain: file, seedType, importOrder, supported, requiredColumns, description.
• New template metadata fields are additive: plugin, profiles, visible.
• Existing CSV preview/commit behavior is unchanged.
• Existing reset/reseed behavior is unchanged.
• External plugin loading, marketplace behavior, and new business modules remain out of scope.

Validation

• npm run typecheck -- --pretty false passed.
• npm run test:setup passed: 20 tests.
• npx oxlint src/features/setup/plugins src/app/api/setup/profiles src/app/api/setup/templates src/app/api/setup/readiness src/app/api/setup/verify src/features/setup/components/setup-wizard.tsx src/features/setup/api src/tests/setup passed.

Residual Notes

• Readiness and verification services now aggregate plugin registry checks additively. Existing concrete CRM checks remain in place to avoid regression.
• Future module plugins should register through plugin-registry.ts rather than editing the setup wizard directly.