Customer self-service portal
Sofar USER
The customer-facing entry point to the Sofar platform. Residential and commercial customers create their account here, register their devices, manage warranty, raise tickets, and access their monitoring dashboards in Sofar CLOUD.
In build
What customers do here
- Create an account (passkey + email, or social federation later).
- Register devices — link inverters, batteries, ESI all-in-one units to the account by serial number.
- View warranty status, register a new device under warranty, file a warranty claim.
- Open a support ticket — routed to Sofar Tickets / hotline agents.
- See the history of every case Sofar has worked on for them.
- Click through to Sofar CLOUD for live monitoring of their installation.
- Access Sofar Knowledge articles relevant to their devices.
Data model
- CustomerAccount
- userId (Zitadel), kind (residential / commercial), preferredLocale, contact + billing addresses
- AccountAsset
- accountId, assetId (FK to CORP Asset), addedAt, verifiedAt, ownership (owner / installer / tenant)
- WarrantyRegistration
- assetId, accountId, productId, registeredAt, warrantyStartAt, warrantyEndAt, certificateUrl
- WarrantyClaim
- accountId, assetId, ticketId, status, filedAt, resolvedAt
- AccessGrant
- accountId, scope (cloud / knowledge / training), grantedAt, expiresAt
API surface
POST /api/users/sign-upPOST /api/users/verify-emailGET /api/users/mePATCH /api/users/meGET /api/users/me/devicesPOST /api/users/me/devices (register by serial)GET /api/users/me/warrantyPOST /api/users/me/warranty/claimsGET /api/users/me/ticketsPOST /api/users/me/tickets (opens upstream in Sofar Tickets)
Auth model
Customer accounts live in a separate Zitadel realm from Sofar staff (different role and scope set). Customers can never see internal apps like CSP or TMS. Staff with the elevated customer_admin grant can view a customer account read-only and impersonate for support when authorised by the customer.
Integrates with
Sofar CORP (identity + assets)Sofar CLOUD (monitoring access)Sofar Tickets (open new ticket)Sofar CSP (warranty + service history view)Sofar Knowledge (article access)