Files
ZitPlane/project/FEATURES-AND-PAGES.md

5.3 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.

P05-CI-03 verified backend runtime, not a user page

Gitea Run #86 verified P02's PostgreSQL, ZITADEL API, prebuilt Login V2 and Traefik running/healthy in a disposable runner, including restart persistence, exact http://localhost:8080 OIDC issuer discovery/JWKS, negative metadata fixtures and cleanup. This is not verification of a human pressing Login/Sign Up/MFA or any positive Account Portal session. Those remain unverified and must be documented when future phases implement isolated real-identity E2E.