4.7 KiB
Feature, route and page register (actual source state)
Baseline: 40af500 (2026-11-22). Source implemented means source exists; it does not mean CI/build/manual acceptance passed.
Portal routes and actions
| Page/endpoint | File | User-visible/action behavior from source | Status |
|---|---|---|---|
/ |
users/ui/src/app/page.tsx |
Redirect to /account |
Source implemented; untested |
/signin |
users/ui/src/app/signin/page.tsx |
Continue with ZITADEL button submits server action; OIDC redirect; Back to account home link |
Source implemented; untested |
/account |
users/ui/src/app/(protected)/account/page.tsx |
Shows identity-backed greeting, cards linking to profile/security, informational note and review link | Source implemented; untested |
/account/profile |
users/ui/src/app/(protected)/account/profile/page.tsx |
Read-only display name, email, immutable ZITADEL user ID; link to ZITADEL self-service if available | Source implemented; untested |
/account/security |
users/ui/src/app/(protected)/account/security/page.tsx |
Password, MFA, passkey informational rows; Open central security settings external link |
Source implemented; untested |
/api/account/me (GET) |
users/ui/src/app/api/account/me/route.ts |
Returns current identity only when session.user.id present; otherwise intended 401 |
Source implemented; untested |
/api/auth/[...nextauth] |
users/ui/src/app/api/auth/[...nextauth]/route.ts |
Auth.js GET/POST handlers including callback | Source implemented; untested |
| Protected layout | users/ui/src/app/(protected)/layout.tsx |
Calls requireIdentity to gate child pages |
Source implemented; untested |
Portal visible UI elements
| UI | Location / exact behavior |
|---|---|
Sidebar Overview |
AccountShell -> /account |
Sidebar Profile |
AccountShell -> /account/profile |
Sidebar Security |
AccountShell -> /account/security |
Sign out of portal |
AccountShell server action -> Auth.js signOut -> /signin; not global logout |
Continue with ZITADEL |
Signin form -> Auth.js signIn (provider zitadel) -> intended /account |
View profile |
Overview Card -> /account/profile |
Security options |
Overview Card -> /account/security |
Review account details |
Overview note -> /account/profile |
Open ZITADEL account settings |
Profile link -> derived issuer /ui/console/users/me; policy/route availability not verified |
Open central security settings |
Security link -> same ZITADEL self-service location, conditional upon access |
| Responsive UI | users/ui/src/styles/globals.css CSS media query at 760px, prefers-color-scheme dark |
ZITADEL login/source functionality
The upstream Login V2 app is imported with its original page source, not remapped or redesigned. Actual source route folders at auth/ui/v2/apps/login/src/app/(login)/ include loginname, password, register, verify, otp/[method], mfa, passkey, u2f, authenticator, logout, idp, accounts, device, and their nested steps where present. These are upstream source files only; ZitPlane has not independently verified each flow, field or UI action. See auth/ui/v2/apps/login/src/app and upstream acceptance tests for implementation details.
P02 also configures an official prebuilt Login UI container for ZITADEL Console sign-in. This is distinct from compiling the imported workspace.
Not implemented (do not advertise as working)
Custom profile edits, password/MFA/passkey changes inside the portal, sessions/device management UI, federated logout, app marketplace, subscription/billing, product entitlements, production domains, production Docker/Coolify integration, CI workflow, release, E2E verification, and clean auth.vib.tools/login URL rewrite.
Feature-update contract
For every future page/feature change, record exact route/file, action, data source, guards, validation, errors, dependency version, accessibility details, status (proposed/source/CI verified/deployed), and phase/commit. Update user button-by-button guidance in docs/USER-GUIDE.md alongside this register.
P05 CI verification (not a UI feature)
New manually dispatched workflow .gitea/workflows/p05-ci.yml defines four isolated runner gates: Account Portal reproducible dependency install/build, official Login V2 frozen install/build/unit, dependency security advisory triage, and disposable Docker ZITADEL/OIDC discovery smoke. Exact verification scripts reside at tests/ci/source_contract.py and tests/ci/oidc_discovery.py. The full Account Portal interactive OIDC callback/session/SSO flow is not implemented as a CI test; it remains a pending acceptance gate. Status must be updated from the actual Gitea run report in notes/P05-CI-01.md.