Authentication And Account
Explains login, password reset, OTP, TOTP, account profile, password change, preferences, session history, and tenant signup forms in plain language.
Workflow
- LoginAll users: Signs a user into the system with an email address and password.
- Forgot and reset passwordsAll users: Let a user request a reset link and choose a new password after email verification.
- OTP and TOTP challengesUsers with MFA: Verify the user with a one-time code after the password is accepted.
- Account profile, password, and pr.Logged-in users: Lets users maintain their name, contact details, password, dashboard preferences, and.
| Stage | Actor | Action | Result |
|---|---|---|---|
| Login | All users | Signs a user into the system with an email address and password. | The app validates the values, saves the record, and refreshes the relevant table or w. |
| Forgot and reset passwords | All users | Let a user request a reset link and choose a new password after email verification. | The old password stops working and a security notification/audit entry is recorded. |
| OTP and TOTP challenges | Users with MFA | Verify the user with a one-time code after the password is accepted. | The app validates the values, saves the record, and refreshes the relevant table or w. |
| Account profile, password, and pr. | Logged-in users | Lets users maintain their name, contact details, password, dashboard preferences, and. | The app validates the values, saves the record, and refreshes the relevant table or w. |
Login form
Signs a user into the system with an email address and password.
| Essential field | Plain meaning | Example | Required / notes |
|---|---|---|---|
| The login identity tied to the user account. | admin@ovion.tech |
Required; must be a valid email. | |
| Password | The secret for that account. | Demo@12345 |
Required; case-sensitive. |
| Remember me | Keeps the user logged in longer on the same device. | Checked |
Use only on trusted devices. |
Forgot and reset password forms
Let a user request a reset link and choose a new password after email verification.
| Essential field | Plain meaning | Example | Required / notes |
|---|---|---|---|
| Account that should receive the reset link. | sara@ovion.tech |
Required. | |
| Token | Hidden reset code from the emailed link. | auto-filled |
Do not edit manually. |
| New password | Replacement login password. | NewPass@123 |
Must pass password policy. |
| Confirm password | Repeats the new password. | NewPass@123 |
Must match exactly. |
OTP and TOTP challenge forms
Verify the user with a one-time code after the password is accepted.
| Essential field | Plain meaning | Example | Required / notes |
|---|---|---|---|
| OTP code | Temporary code sent by email/SMS/WhatsApp. | 123456 |
Expires based on OTP settings. |
| TOTP code | Authenticator app code. | 482901 |
Changes every short interval. |
| Recovery code | Backup code for lost authenticator access. | ABCD-EFGH |
One-time use. |
| Remember device | Reduces repeated challenges if policy allows it. | No |
Use cautiously. |
Account profile, password, and preferences
Lets users maintain their name, contact details, password, dashboard preferences, and session awareness.
| Essential field | Plain meaning | Example | Required / notes |
|---|---|---|---|
| Name | Display name used in the app. | Ali Ahmed |
Required for clear audit logs. |
| Email / phone | Contact details for login and alerts. | ali@ovion.tech / 03001230002 |
Must stay unique where enforced. |
| Current password | Proof before changing password. | old password |
Required for password change. |
| New password | Replacement password. | BetterPass@2026 |
Must match policy. |
Tenant signup form
Creates a new organization workspace in SaaS/platform mode.
| Essential field | Plain meaning | Example | Required / notes |
|---|---|---|---|
| Organization name | Company requesting a tenant. | Karachi Retail Co |
Required. |
| Owner name | Person who will administer the tenant. | Nimra Iqbal |
Required. |
| Owner email | First tenant admin login. | owner@example.com |
Required and must be unique. |
| Tenant slug/domain | Subdomain or workspace identifier. | karachi-retail |
Must be URL safe. |
| Password | Owner's first password if provided. | Owner@12345 |
May be generated by the system. |
Session and account history table
Shows recent login and account activity so users and admins can spot suspicious behavior.
| Column | What it means | Where it comes from | Example interpretation |
|---|---|---|---|
| Event | What happened to the account. | Activity/session log. | login_success means someone signed in. |
| Device / IP | Where the event came from. | Request metadata. | Unexpected IP should be reviewed. |
| Time | When it happened. | Log timestamp. | A late-night login may need follow-up. |
| Status | Whether it succeeded, failed, or was blocked. | Auth service. | blocked can indicate IP restriction or lockout. |
| 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. |
- 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.
Main docs show essential fields only. Open Documentation Coverage for every detected source field, action, column, route hint, controller hint, and test hint.