Engineer Reference
Auth and Entry
Sign in, register, and understand the brief app-entry routing that moves engineers into the main mobile workspace.
Purpose
- Provide the first-touch entry path into Deucalion for engineers and new account holders.
- Keep unauthenticated access limited to landing, sign-in, and registration before routing into the main app tabs.
Entry Points
- App launch routes unauthenticated users to
Landing. LandingoffersSign In,Get Started, and aForgot password?path that returns engineers to the login flow.LoginandRegisterare the dedicated auth forms.
Major Interactions
- Use
Landingto choose between returning sign-in and account creation. - Sign in with email and password from
Login. - Create an account from
Registerwith name, business name, email, password, and optional SDI certification and phone number. - Use back navigation from login to return to the landing screen.
Hidden and Tested Behaviors
- Root-stack routing gates the app: authenticated users enter
Main, while unauthenticated users stay on the auth flow. - Login validates email format and required password before calling the auth provider.
- Registration enforces business name, strong password rules, and required identity fields before submission.
- Registration can require email verification before the user is sent back to sign in.
Outputs and Side Effects
- Successful login creates an authenticated app session.
- Successful registration creates an engineer account and personal workspace context, with optional email-verification follow-up.
- Failed auth attempts trigger clear alerts instead of silent failures.
Exits and Navigation
- Successful sign-in routes engineers into the
Maintab navigator with dashboard, sites, inspections, and profile. - Registration can return to
Loginafter verification guidance. - Back from
Loginreturns toLanding.
Admin Handoffs
- Auth itself is mostly self-service for engineers.
- The first meaningful admin handoff happens later when an engineer joins or switches into an organization workspace with sponsored access and shared work.
Troubleshooting
| Problem | What to check |
|---|---|
| Login fails immediately | Confirm the email format and that both fields are filled before retrying. |
| Registration is blocked | Check the password rules: at least 12 characters with uppercase, lowercase, and a number. |
| You created an account but are not entering the app | Look for the email-verification prompt and complete that step before signing in again. |
Related
Engineer Screen Index
Browse every customer-facing mobile screen family and jump straight to the reference page for its controls, exits, and side effects.
Dashboard Screen Reference
Understand the engineer dashboard’s day-run cards, quick launches, sync cues, commercial shortcuts, and announcement actions.