Settings Reference
Every settings tab explained in plain English: company profile, branding, attendance capture, AI, channels, security, sessions, OTP/TOTP, HR, payroll, tools, and updates.
Workflow
- GeneralAdmin: Set company, app identity, formats, timezone, and branding.
- SecurityAdmin / IT: Set passwords, sessions, OTP/TOTP, lockout, and access policy.
- ChannelsAdmin / IT: Configure SMTP, SMS, WhatsApp, queue, and sender settings.
- WorkforceAdmin / HR: Set attendance, HR, payroll, tools, and update options.
| Stage | Actor | Action | Result |
|---|---|---|---|
| General | Admin | Set company, app identity, formats, timezone, and branding. | Reports and screens show correct business context. |
| Security | Admin / IT | Set passwords, sessions, OTP/TOTP, lockout, and access policy. | Login and account behavior is controlled. |
| Channels | Admin / IT | Configure SMTP, SMS, WhatsApp, queue, and sender settings. | Notifications and reports can be delivered. |
| Workforce | Admin / HR | Set attendance, HR, payroll, tools, and update options. | Operational modules follow the selected policy. |
Essential fields
Admin
Company profile settings
Stores the legal and contact identity printed in reports, emails, and system references.
| Essential field | Plain meaning | Example | Required / notes |
|---|---|---|---|
| Company name | Business name displayed in the app. | Ovion Tech |
Required. |
| Company email | Main contact email. | hr@ovion.tech |
Used in templates and support references. |
| Website | Public website URL. | https://ovion.tech |
Optional. |
| Registration / tax no. | Legal identifiers. | NTN-123456 |
Optional; important for payroll/reporting. |
Essential fields
Admin
Branding and general settings
Controls app name, description, logo, colors, login branding, timezone, date and time display.
| Essential field | Plain meaning | Example | Required / notes |
|---|---|---|---|
| App name | Product name users see. | AttendPro |
Required. |
| Description | Short helper text in login/emails. | HR Management System |
Optional. |
| Timezone | Business time zone for records. | Asia/Karachi |
Critical for attendance and payroll. |
| Date format | How dates appear. | d M Y |
Affects display, not stored values. |
Essential fields
Admin / HR
Attendance capture and HR settings
Defines how attendance, self-service check-in, holidays, and HR policy defaults behave.
| Essential field | Plain meaning | Example | Required / notes |
|---|---|---|---|
| Self attendance | Allows employees to check in/out from portal. | On |
Requires permissions. |
| Holiday override | Allows attendance on holidays with confirmation. | On |
Useful for duty days. |
| Default grace minutes | Minutes allowed after shift start. | 15 |
Impacts late status. |
| Employee code prefix | Prefix for new employee codes. | EMP |
Keep stable. |
| Document visibility | Whether employees can see selected documents. | Visible to employee |
Controlled per document too. |
Essential fields
Admin / IT
AI settings and credential test
Stores the Responses-compatible provider configuration used by Organization Mindmap prompt imports. API keys are encrypted, masked in the UI, preserved when blank, and verified through the AI test endpoint.
| Essential field | Plain meaning | Example | Required / notes |
|---|---|---|---|
| Provider / endpoint | OpenAI or compatible Responses API endpoint. | OpenAI / https://api.openai.com/v1/responses |
Endpoint may be a base /v1 URL. |
Essential fields
Admin / IT
Channels, SMTP, and notification settings
Stores email, SMS, WhatsApp, and queue options used for OTPs, password reset, reports, and alerts. SMTP and Twilio secrets are encrypted, masked, and preserved when blank.
| Essential field | Plain meaning | Example | Required / notes |
|---|---|---|---|
| Mail host | SMTP server. | smtp.mailtrap.io |
Required for emails. |
| Mail port | SMTP port. | 587 |
Common values: 587, 465, 1025. |
| Mail username/password | SMTP credentials. | smtp-user / Stored encrypted |
Private; password is never rendered back. |
| From address | Sender email. | no-reply@company.com |
Should match domain policy. |
| Queue connection | Where background jobs run. | database |
Workers must be running. |
Essential fields
Admin / IT
Security, sessions, OTP, and TOTP policy
Controls password strength, login lockouts, session behavior, OTP expiry, rate limits, and authenticator settings.
| Essential field | Plain meaning | Example | Required / notes |
|---|---|---|---|
| Password length | Minimum accepted password length. | 8 |
Raise for stricter security. |
| Require uppercase/number/symbol | Password complexity switches. | On |
Applies to reset/change flows. |
| Session lifetime | Minutes before idle session expires. | 120 |
Balance safety and convenience. |
| OTP TTL | Seconds an OTP remains valid. | 300 |
Shorter is safer. |
| TOTP issuer/window | Authenticator app label and time tolerance. | AttendPro / 1 |
Use a stable issuer name. |
Essential fields
Admin / Payroll / IT
Payroll settings, tools, and updates
Controls global payroll policy, maintenance actions, license checks, release upload, and update history.
| Essential field | Plain meaning | Example | Required / notes |
|---|---|---|---|
| Monthly start day | Day payroll month begins. | 1 |
Affects period generation. |
| Week starts on | Start day for weekly payroll. | Monday |
Affects weekly periods. |
| Overtime rounding | Rounds overtime minutes. | 15 |
Used in calculations. |
| Payslip visibility | Employee access to payslips. | On |
Only after payroll is ready. |
| Purchase code | License code for updates. | ABCD-1234 |
Private. |
| Release ZIP | Uploaded update package. | attendpro-update.zip |
Verify source before install. |
Essential table
Database listing
Settings summary and update history tables
Shows current settings health, maintenance status, license state, and previous update runs.
Filters: Settings tab, Health, Update status
| Column | What it means | Where it comes from | Example interpretation |
|---|---|---|---|
| Section | Settings area being summarized. | Settings service. | Security. |
| Current value | The saved value or status. | settings table. | Lock after 5 attempts. |
| Health indicator | Whether the setting looks complete. | Computed UI state. | SMTP missing password needs attention. |
| Last run / version | Update or tool execution result. | system_update_runs table or command output. | Rollback available after failed update. |
| Status | Current workflow state for the row. | The record status field or computed workflow state. | Pending means someone still needs to act. |
| Created / Updated | When the row entered or last changed in the system. | Audit timestamps. | Recent updates usually explain why the list order changed. |
Available actions
- Open or edit the record when permission allows it.
- Filter the list without losing the current page context.
- Use status badges to decide which item needs attention first.
Full field appendix
Main docs show essential fields only. Open Documentation Coverage for every detected source field, action, column, route hint, controller hint, and test hint.