Initial Configuration
Overview
This guide provides step-by-step instructions for configuring timveroOS after installation. Initial configuration establishes the foundation for your lending operations by setting up core system components and basic workflows.
Pre-Configuration Requirements
Before beginning configuration, ensure you have:
System administrator access credentials
Organizational structure documentation
List of initial users and their roles
Basic product requirements defined
External system integration details (if applicable)
Core Configuration Steps
1. Organization Structure Setup
Define your organizational hierarchy within the system:
Departments Configuration:
Navigate to Settings → Catalogs → Decision Departments
Create departments matching your organizational structure
Assign department codes and descriptions
Set active status for operational departments
Standard Department Examples (from documentation):
Underwriting - Credit analysis and risk assessment
KYC - Identity and document verification
AML - Anti-money laundering compliance
Financial - Income and asset verification
2. User Roles and Permissions
Role Configuration Process:
Access Settings → Roles
Create roles aligned with job functions
Assign specific permissions to each role
Map roles to appropriate departments
Key Principles:
Implement role-based access control (RBAC)
Ensure segregation of duties
Configure audit trail requirements
Set up approval hierarchies
Initial System Access:
The timveroOS SDK automatically creates a default God Admin user named "admin" during project launch as part of standard RBAC components. Use this account for initial system configuration.
Using the Default Admin Account:
Log in with the default "admin" credentials provided by your development team
Verify access to all administrative menus
Confirm God Admin permissions are active
Keep this account active for initial configuration steps
Critical Requirements:
The default "admin" user has full God Admin permissions
Use this account to complete initial configuration (steps 1-3)
Do NOT create additional users until after notification setup is complete (step 3)
Additional users require one-time passwords delivered via notifications
Creating Additional Users:
After completing notification configuration in step 3, you can create additional administrative and operational users:
Navigate to Settings → Users
Click "Create New User"
Enter user details:
Full name
Email address
Username
Contact information
Assign appropriate role based on job function
System will send one-time password via configured notification channels
User receives one-time password and can activate their account
Note: Additional user creation is covered in detail after notification setup. The default "admin" account is sufficient for completing initial configuration steps 1-3.
3. Notification Setup
Configure admin-level notification delivery to enable automated communication with applicants, borrowers, and internal teams. This section focuses on administrator configuration tasks, distinct from SDK-level notification event setup completed by your development team.
Overview:
Notification configuration enables timveroOS to send automated messages through email, SMS, and messenger platforms. Proper setup ensures stakeholders receive timely updates throughout the lending process while supporting operational efficiency and compliance requirements.
Important Distinction:
SDK Setup (Development team): Creating notification events in code that define when notifications can trigger
Admin Setup (This guide): Configuring delivery gateways, creating message templates, and testing notification delivery
Prerequisites Check:
Before configuring notifications, verify that SDK prerequisites are complete:
Check Event Type Availability:
Navigate to Admin Panel → Notifications → Templates → Create New
Examine the "Event Type" dropdown
Verify expected event types appear (e.g., LOAN_APPROVED, PAYMENT_REMINDER)
If event types are missing, contact development team
Verify Recipient Types:
Check "Recipient Type" dropdown shows required types
Standard types: BORROWER, GUARANTOR, AGENT, Organization Employees
For complete SDK prerequisites and verification steps, see Notification Configuration.
Gateway Configuration:
Verify that notification gateways have been configured by your development team at the SDK level. Administrators configure sender presentation details only.
Email Gateway (SMTP):
Prerequisites: Your development team must configure SMTP server connection details (host, port, authentication) at the SDK level before you can use email notifications.
Admin Panel Configuration:
Navigate to Settings → Notifications → Email Gateway
Configure sender presentation:
From Email Address: [email protected]
From Name: Your Company Name
Reply-To Address (optional): [email protected]
Test connection to verify SDK configuration is working
Note: SMTP server settings (host, port, connection security, authentication credentials) are configured at the SDK level by your development team, not through the admin panel.
SMS Gateway:
Prerequisites: Your development team must configure SMS provider connection details (API credentials, provider selection) at the SDK level.
Admin Panel Configuration:
Navigate to Settings → Notifications → SMS Gateway
Verify gateway is configured and active
Test SMS sending to confirm SDK configuration
Configure sender display name (if supported by provider)
Note: SMS gateway settings (provider selection, API credentials, authentication) are configured at the SDK level by your development team.
Messenger Gateway:
Prerequisites: Your development team must configure messenger platform connections (API tokens, webhook URLs) at the SDK level.
Admin Panel Configuration:
Navigate to Settings → Notifications → Messenger Gateway
Verify messenger platforms are configured and active
Test message delivery
Configure sender display details (bot name, icon) if applicable
Note: Messenger gateway settings (API tokens, webhook configurations, platform credentials) are configured at the SDK level by your development team.
Initial Template Creation:
Create essential notification templates:
Loan Approval Notification:
Event Type: LOAN_APPROVED
Recipient: BORROWER
Gateway: EMAIL
Content: Approval details with loan terms
Document Request:
Event Type: DOCUMENT_REQUIRED
Recipient: BORROWER
Gateway: EMAIL
Content: List of required documents with upload instructions
Payment Reminder:
Event Type: PAYMENT_REMINDER
Recipient: BORROWER
Gateway: SMS
Content: Payment amount and due date
Testing Notification Templates:
Use "Test" or "Check" button in template editor
Select test entity (application, credit, etc.)
The tool generates a preview showing:
How variables populate with actual entity data
Final rendered content with all substitutions
Conditional logic evaluation
Review the preview to verify correct variable population and formatting
Note: The test function creates a preview of the notification content but does not actually send notifications. To test actual delivery, trigger the notification event in a staging environment or use the notification logs to monitor real event-triggered sends.
Reference:
For comprehensive notification configuration guidance including:
Complete SDK prerequisites verification
Detailed gateway configuration steps
Advanced template creation with variables and conditional logic
Troubleshooting delivery issues
Integration with workflows and other modules
See Notification Configuration.
4. Initial Product Setup
Create your first credit products:
Product Creation Steps:
Navigate to Settings → Credit Products
Define product parameters:
Product name and code
Amount ranges
Term options
Base interest rates
Create at least one additive per product
Configure basic pricing rules
Note: Each product requires at least one additive to be functional.
Reference:
For comprehensive product configuration guidance including:
Product architecture and component relationships
Additive configuration and pricing rules
Product lifecycle management
Integration with workflows and underwriting
See Product Architecture and Pricing Configuration.
5. Basic Workflow Configuration
Initial Workflow Setup:
Access the Workflow Designer
Create a simple approval workflow:
Add data source connections
Define basic decision criteria
Set up approval/decline paths
Configure manual review triggers
Test workflow with sample data
Reference:
For comprehensive workflow configuration guidance including:
Workflow fundamentals and architecture
Decision automation logic
Manual review process configuration
Workflow vs business process distinctions
See Workflow Fundamentals and Decision Automation.
6. Document Template Creation
Set up essential document templates:
Required Templates:
Application forms
Approval notifications
Decline letters
Basic loan agreements
Template Configuration:
Use the document designer interface
Add merge fields for dynamic data
Configure document layout and formatting
Note: Document generation triggers and storage locations are configured at the SDK level by your development team, not through the admin panel.
For detailed document template configuration guidance, see Document Management.
7. Launchpad Configuration
Setup Steps:
Map warning types to departments
Configure assignment rules
Set up review forms
Define escalation procedures
Reference:
For comprehensive Launchpad configuration guidance including:
Work queue setup and management
Warning type mapping and routing
Assignment rules and escalation logic
Review form configuration
Integration with workflows and notifications
See Launchpad.
8. Initial Testing
Before going live, validate your configuration:
Testing Checklist:
Verify default "admin" account has full God Admin access
Test additional user accounts and role-based permissions
Confirm user one-time password delivery via notifications
Create test applications
Verify workflow execution
Check document generation
Validate notification delivery through all configured gateways
Test notification template rendering with actual data
Confirm email, SMS, and messenger notifications send correctly
Confirm data integration (if configured)
Configuration Sequence
Follow this recommended sequence for optimal results:
Foundation: Organization structure and roles (using default "admin" account)
Notifications: Gateway verification and essential templates
Additional Users: Create users who will receive one-time passwords via notifications
Products: Basic product and pricing setup
Workflows: Simple decision logic
Documents: Essential templates
Operations: Launchpad and queues
Testing: End-to-end validation including user access and notification delivery
Note: The default "admin" user with God Admin permissions is created automatically by the SDK during project launch. Use this account for initial configuration steps 1-2.
Common Configuration Considerations
Naming Conventions
Establish consistent naming patterns:
Products: Clear, descriptive names
Workflows: Include version and date
Roles: Department and function based
Documents: Type and version indicated
Change Management
Document all configuration decisions:
Record configuration choices
Note business rationale
Track change history
Maintain configuration inventory
Testing Approach
Validate configurations systematically:
Test individual components first
Perform integration testing
Include edge case scenarios
Document test results
Next Steps
After completing initial configuration:
Expand Products: Add additional products and additives
Enhance Workflows: Build more complex decision logic
Integrate Systems: Connect external data sources
Configure Analytics: Set up dashboards and reports
Optimize Operations: Refine based on usage patterns
Additional Resources
For detailed configuration guidance:
Consult the specific module documentation
Contact your implementation team
Reference the user guides
Utilize sandbox environment for testing
This guide covers essential initial configuration steps. For advanced configuration options, refer to the relevant module documentation.
Last updated
Was this helpful?