Module Configuration Guide

Overview

The Go backend uses a configuration-driven module loading system that allows you to selectively enable or disable optional modules. This enables:

Fast startup times in CI/test environments by loading only essential modules
Environment-specific feature control without code changes
Fine-grained module management through named profiles and individual overrides

App Profiles

Profiles are named presets that set the initial state of all module flags. Choose a profile based on your deployment needs:

`full` (Default)

Enables all optional modules. Use this in production environments where all features are needed. Modules enabled:

Leave Management
CRM
Automation
Bulk Operations
Export
Reports
AI
Notifications
Admin

# Default profile (no configuration needed)
APP_PROFILE=full

Or simply omit APP_PROFILE entirely—it defaults to full.

`smb`

Optimized for small-to-medium business (SMB) deployments with all business modules enabled. Modules enabled: Leave, CRM, Automation, Bulk, Export, Reports, AI, Notifications, Admin

APP_PROFILE=smb

`leave`

Minimal configuration for leave management-only deployments. Modules enabled: Leave Management, Admin

APP_PROFILE=leave

`core`

Minimal configuration with only core functionality. Use in CI/test environments to reduce startup time and resource usage. Modules enabled: User, Organizations (always-on)

APP_PROFILE=core

Individual Module Overrides

You can override individual modules on top of any profile using MODULE_<NAME> environment variables.

Example: Disable AI in SMB Deployment

APP_PROFILE=smb
MODULE_AI=false

Result: All SMB modules are enabled except AI.

Example: Enable CRM in Core Profile

APP_PROFILE=core
MODULE_CRM=true

Result: Only core modules plus CRM are enabled.

Available Modules

Module	Variable	Toggleable
User	N/A	❌ Always-on
Organizations	N/A	❌ Always-on
Leave	`MODULE_LEAVE`	✅ Yes
CRM	`MODULE_CRM`	✅ Yes
Automation	`MODULE_AUTOMATION`	✅ Yes
Bulk	`MODULE_BULK`	✅ Yes
Export	`MODULE_EXPORT`	✅ Yes
Reports	`MODULE_REPORTS`	✅ Yes
AI	`MODULE_AI`	✅ Yes
Notifications	`MODULE_NOTIFICATIONS`	✅ Yes
Admin	`MODULE_ADMIN`	✅ Yes

Configuration Precedence

The configuration system applies settings in this order (highest to lowest priority):

Hardcoded — User and Organizations are always enabled
Individual overrides — MODULE_<NAME> environment variables
Profile baseline — APP_PROFILE preset

Common Deployment Scenarios

Production (Full Features)

APP_PROFILE=full

All optional modules enabled. Use when all features are needed.

Staging (Selective Disable)

APP_PROFILE=full
MODULE_AI=false

Start with all features but disable experimental AI features for stability testing.

CI/Tests (Minimal Startup)

APP_PROFILE=core

Load only essential core modules. Fastest startup time for test runs.

Leave Management Only

APP_PROFILE=leave

Dedicated leave management deployment.

Observability

Startup Logging

The server logs module configuration at startup:

{
  "level": "info",
  "msg": "Module configuration",
  "user": true,
  "organizations": true,
  "leave": true,
  "crm": false,
  "automation": false,
  "bulk": false,
  "export": true,
  "reports": true,
  "ai": false,
  "notifications": true,
  "admin": true
}

This log confirms which modules are enabled after profile and overrides are applied.

Health Check Endpoint

The /health endpoint includes per-module status:

curl http://localhost:8080/health

Response:

{
  "status": "healthy",
  "modules": {
    "user": { "enabled": true },
    "organizations": { "enabled": true },
    "leave": { "enabled": true },
    "crm": { "enabled": false },
    "automation": { "enabled": false },
    "bulk": { "enabled": false },
    "export": { "enabled": true },
    "reports": { "enabled": true },
    "ai": { "enabled": false },
    "notifications": { "enabled": true },
    "admin": { "enabled": true }
  }
}

Use this endpoint for:

Frontend feature detection
DevOps tooling verification
Debugging module initialization issues

Backward Compatibility

If APP_PROFILE is not set, the system defaults to full, enabling all modules exactly as they were before this feature. Existing deployments require zero changes.

Environment Variable Reference

Profile Selection

Variable	Default	Valid Values	Purpose
`APP_PROFILE`	`full`	`full`, `smb`, `leave`, `core`	Select named module preset

Module Overrides

Variable	Default	Type	Purpose
`MODULE_LEAVE`	(profile)	bool	Override Leave module
`MODULE_CRM`	(profile)	bool	Override CRM module
`MODULE_AUTOMATION`	(profile)	bool	Override Automation module
`MODULE_BULK`	(profile)	bool	Override Bulk module
`MODULE_EXPORT`	(profile)	bool	Override Export module
`MODULE_REPORTS`	(profile)	bool	Override Reports module
`MODULE_AI`	(profile)	bool	Override AI module
`MODULE_NOTIFICATIONS`	(profile)	bool	Override Notifications module
`MODULE_ADMIN`	(profile)	bool	Override Admin module

Configuration File Example

Update your .env file:

# Full profile (default)
APP_PROFILE=full

# Or use core profile for CI
# APP_PROFILE=core

# Or disable specific modules
# APP_PROFILE=smb
# MODULE_AI=false

Architecture Overview: docs/backend/go/architecture/
Getting Started: docs/backend/go/getting-started.mdx
Troubleshooting: docs/backend/go/guides/troubleshooting.md

Documentations

Getting Started

API

Modules

Infrastructure

Development

Guides

Module Configuration Guide

Module Configuration Guide

Overview

App Profiles

`full` (Default)

`smb`

`leave`

`core`

Individual Module Overrides

Example: Disable AI in SMB Deployment

Example: Enable CRM in Core Profile

Available Modules

Configuration Precedence

Common Deployment Scenarios

Production (Full Features)

Staging (Selective Disable)

CI/Tests (Minimal Startup)

Leave Management Only

Observability

Startup Logging

Health Check Endpoint

Backward Compatibility

Environment Variable Reference

Profile Selection

Module Overrides

Configuration File Example

​Module Configuration Guide

​Overview

​App Profiles

​full (Default)

​smb

​leave

​core

​Individual Module Overrides

​Example: Disable AI in SMB Deployment

​Example: Enable CRM in Core Profile

​Available Modules

​Configuration Precedence

​Common Deployment Scenarios

​Production (Full Features)

​Staging (Selective Disable)

​CI/Tests (Minimal Startup)

​Leave Management Only

​Observability

​Startup Logging

​Health Check Endpoint

​Backward Compatibility

​Environment Variable Reference

​Profile Selection

​Module Overrides

​Configuration File Example

​Related Documentation

Module Configuration Guide

Overview

App Profiles

`full` (Default)

`smb`

`leave`

`core`

Individual Module Overrides

Example: Disable AI in SMB Deployment

Example: Enable CRM in Core Profile

Available Modules

Configuration Precedence

Common Deployment Scenarios

Production (Full Features)

Staging (Selective Disable)

CI/Tests (Minimal Startup)

Leave Management Only

Observability

Startup Logging

Health Check Endpoint

Backward Compatibility

Environment Variable Reference

Profile Selection

Module Overrides

Configuration File Example

Related Documentation