47 lines
4.1 KiB
Markdown
47 lines
4.1 KiB
Markdown
# 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.
|