Struct InitialAdminSetup 

pub struct InitialAdminSetup {
    _marker: PhantomData<()>,
    function_component: FunctionComponent<Self>,
}

Component for the initial admin account setup page.

This page is displayed when a fresh system has no administrator accounts. It provides a form to create the first admin user. Key functionality:

• Admin Check: On mount, verifies if an admin already exists by calling /api/check-admin. If an admin is found, the user is redirected to the login page (crate::Route::Login).
• Form Fields: Collects first_name, last_name, username, password, and confirm_password.
• Form Validation:
  • Ensures password fields are not empty.
  • Verifies that password and confirm_password match.
  • Ensures the username field is not empty.
• API Interaction: On form submission, a POST request is sent to /api/setup-admin with the new admin’s details.
• Password Hashing: The backend is responsible for hashing the password using Argon2 before storage; this component only sends the plain text password.
• Auto-redirect: On successful admin account creation, the user is automatically redirected to the login page (crate::Route::Login).
• State Management: Uses Yew’s use_state hooks to manage:
  • Input field values (first_name, last_name, username, pwd, pwd_confirm).
  • UI states like error messages, success status, and loading indicators.
  • admin_check_done to prevent rendering the form before the initial admin check completes.

Example Flow

1. User navigates to /setup.
2. The component checks /api/check-admin.
3. If an admin exists, redirects to /login.
4. If no admin exists, the setup form is displayed.
5. User fills out the form and submits.
6. Form data is sent via POST to /api/setup-admin.
7. On successful response (HTTP 200), redirects to /login.
8. On error, displays an error message to the user.

Security Notes

• The initial admin check prevents re-creating an admin if one already exists.
• Password confirmation helps prevent user typos for critical credentials.
• Backend validation further ensures non-empty and secure credentials.

Fields

_marker: PhantomData<()>

function_component: FunctionComponent<Self>

Trait Implementations

impl BaseComponent for InitialAdminSetup

where Self: 'static,

type Message = ()

The Component’s Message.

type Properties = ()

The Component’s Properties.

fn create(ctx: &Context<Self>) -> Self

Creates a component.

fn update(&mut self, _ctx: &Context<Self>, _msg: Self::Message) -> bool

Updates component’s internal state.

fn changed( &mut self, _ctx: &Context<Self>, _old_props: &Self::Properties, ) -> bool

React to changes of component properties.

fn view(&self, ctx: &Context<Self>) -> HtmlResult

Returns a component layout to be rendered.

fn rendered(&mut self, _ctx: &Context<Self>, _first_render: bool)

Notified after a layout is rendered.

fn destroy(&mut self, _ctx: &Context<Self>)

Notified before a component is destroyed.

fn prepare_state(&self) -> Option<String>

Prepares the server-side state.

impl Debug for InitialAdminSetup

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FunctionProvider for InitialAdminSetup

type Properties = ()

Properties for the Function Component.

fn run(ctx: &mut HookContext, props: &Self::Properties) -> HtmlResult

Render the component. This function returns the Html to be rendered for the component.