docs: establish ZitPlane notes project and user documentation governance

This commit is contained in:
Vib Tools committed 2026-11-22 04:40:27 -08:00
1 parent 40af500750
commit 7ecf531697
22 files changed
+1507

No files matched your search

+47
View File
@@ -0,0 +1,47 @@
# ZitPlane developer architecture
**Reviewed source baseline:** `40af5007503501643d1e9ad2ab3939ba57dab5f9` (2026-11-22). **Build/runtime/deploy acceptance: pending.**
## 1. Component ownership
| Layer | Source of truth | Responsibility | Status |
| --- | --- | --- | --- |
| Identity backend | Official ZITADEL `ghcr.io/zitadel/zitadel:v4.20.4` pinned in `deployment/docker/compose.backend.dev.yaml` | Identity/OIDC, policies, built-in Console; not copied into Git | Development Compose source only |
| Data | `postgres:17.10-alpine` in same Compose | Local disposable-but-persistent ZITADEL database | Configured; runtime not verified |
| Login UI V2 | `auth/ui/v2/apps/login/` + nested workspace deps | Official upstream Next.js login/recovery/MFA UI | Import-only, upstream `v4.20.4`, original behavior, build pending |
| User account portal | `users/ui/` | Separate Next.js read-only user profile and security landing pages, Auth.js OIDC relying party | Source implemented; build/flows pending |
| Dev proxy | Traefik `v3.7.7` in P02 Compose | `127.0.0.1:8080` loopback entry to prebuilt Login V2 + ZITADEL API | Configured; live routing pending |
| Production stack | Not present | Future Coolify routing/TLS/volumes/backups | NOT IMPLEMENTED |
## 2. Identity and session flow (designed/implemented in source, not proven)
1. Browser visits portal at `/account`. `users/ui/src/app/(protected)/layout.tsx` calls `requireIdentity()` in `src/lib/identity.ts`.
2. Missing or expired user identity redirects to `/signin`; public form uses Auth.js `signIn("zitadel")`.
3. Auth.js provider is defined in `users/ui/src/auth.ts` using configured issuer, client ID/secret, PKCE/state/nonce and `openid profile email` scopes.
4. Browser is redirected to ZITADEL's identity/login service (external issuer). Auth.js handles callback at `/api/auth/callback/zitadel`, JWT session cookies and local portal session.
5. The `sub` / `providerAccountId` is the immutable identity key used by the portal; **email is only display data**.
6. Protected pages and `GET /api/account/me` check for nonempty `session.user.id`. The session callback clears that ID if token expiry is absent or in the past.
7. Portal sign-out calls Auth.js `signOut`; it does **not** guarantee ZITADEL-wide SSO logout. Token refresh, federated logout and user edits are future work.
**Boundary:** P02 Compose still uses the official **prebuilt** `zitadel-login` image. It does **not** build or run the imported P03 Login UI source, and does **not** run the P04 account portal. These are P05+ integration tasks.
## 3. Configuration and data flow
`core/backend/zitadel/dev.py` -> ignored root `.env` (local random secrets only) -> `deployment/docker/compose.backend.dev.yaml` -> local Postgres/ZITADEL/prebuilt Login/Traefik.
`users/ui/.env.example` is **documentation only** for `ZITADEL_ISSUER`, `ZITADEL_CLIENT_ID`, `ZITADEL_CLIENT_SECRET`, `AUTH_SECRET`, `AUTH_URL`, `AUTH_TRUST_HOST`. Runtime credentials must not be committed. The portal has **no own database** in P04.
## 4. Safety properties and constraints
- Keep production and development secrets/volumes entirely separate; never use loopback HTTP Compose publicly.
- No browser-side admin PAT/master key; Account Portal uses its own confidential OIDC client.
- Authentication logic, cookies, session/expiry, callbacks and passkey behavior are protected from UI-only edits.
- Login V2 upstream code is vendor-imported under its exact workspace-relative paths; preserve provenance and license notices.
- Later production must verify trusted proxy headers, HTTPS origin, cookie scope, WebAuthn domain and ZITADEL health/readiness.
- ZITADEL Console handles identity admin; app-specific billing and entitlements stay in external SaaS apps.
## 5. Implementation status versus acceptance
P01 folder foundation committed. P02 local Compose source completed (prior 3/3 static tests; no Docker). P03 source import integrity audited (638/638 Git blobs), but no build. P04 Account Portal scope audit passed; no dependency install, lockfile, TypeScript build, E2E or CI run. All runtime behavior remains **unverified**.
See `docs/PHASES.md`, `docs/P02-EVIDENCE.md`, `docs/P03-SOURCE-IMPORT.md` and `docs/P04-ACCOUNT-PORTAL.md` for exact historical evidence.
+15
View File
@@ -0,0 +1,15 @@
# ZitPlane development changelog
This is the **developer-focused implementation history**. `notes/CHANGELOG.md` is the compact planning/phase log; `docs/` is for users.
| Date | Phase | Files / behavior introduced | Git / evidence |
| --- | --- | --- | --- |
| 2026-11-22 | P01 | Initial Monorepo directories, root AGENTS/README, architecture & phase docs | `8f54ccb`, `docs/PHASES.md` |
| 2026-11-22 | P02 | `core/backend/zitadel/dev.py`, local-only Compose with official ZITADEL/Postgres/Traefik and prebuilt Login | `433a0a3` then `eadd0e5`; `docs/P02-EVIDENCE.md`. Live runtime blocked |
| 2026-11-22 | P03 | `auth/ui/v2/` official v4.20.4 source and matching client/proto/pnpm/Nx dependencies | `4404849`; `docs/P03-SOURCE-IMPORT.md`; no build |
| 2026-11-22 | P04 | `users/ui/` Account Portal OIDC, pages, styling, read-only identity API | `40af500`; `docs/P04-ACCOUNT-PORTAL.md`; no build/CI |
| 2026-11-22 | DOCS-01 | Documentation governance; developer architecture, reviewed first-party function/file/page mapping and 701-path source inventory; user manual/setup/status/troubleshooting | Documentation complete; manifest/link/source-scope audit PASS; `notes/DOCS-01.md`, local commit SHA via Git history |
## Required entry for each future change
Date, phase, approval/scope, baseline SHA, source files changed, reason/functional effect, interface/security impacts, migration/config steps, test/CI evidence, docs updated, commit SHA, verified/unverified limitations. Append one record for every approved change/fix, including documentation-only changes. Never overwrite old conclusions without noting correction.
+46
View File
@@ -0,0 +1,46 @@
# 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.
+96
View File
@@ -0,0 +1,96 @@
# File and module ownership map
**Baseline:** commit `40af500` with documentation phase DOCS-01 in progress. This is an **exact first-party role map** plus pointers to the complete upstream source inventory. See [SOURCE-INVENTORY.md](SOURCE-INVENTORY.md) for the individual paths of **all Git-tracked files**, including the imported upstream.
## Repository root / governance
| Path | Purpose / when to change |
| --- | --- |
| `README.md` | Entry point, project status, quick navigation; update whenever phase/status changes |
| `AGENTS.md` | Mandatory coding/AI rules, scope, docs-first updates and security boundaries |
| `.gitignore` | Prevent local secrets/build data from being staged; change only with explicit review |
| `.editorconfig` | Editor line ending/indentation defaults |
| `.env.example` | Non-secret sample keys for P02 backend helper; **never commit actual root `.env`** |
| `notes/` | Pre-change plans, decisions, chronological implementation and evidence logs |
| `project/` | Developer explanations, module/function/page map and actual source inventory |
| `docs/` | End-user how-to, setup, features, existing phase/evidence documents |
## P02 backend + deployment
| Path | What it actually owns | Phase |
| --- | --- | --- |
| `core/backend/zitadel/dev.py` | Python stdlib helper `init`, `config`, `up`, `check`, `ps`, `down`; creates ignored local secrets and invokes Compose, readiness probe | P02 |
| `core/backend/zitadel/README.md` | Dev-only infrastructure setup guidance, assumptions and warnings | P02 |
| `deployment/docker/compose.backend.dev.yaml` | Named `postgres`, `zitadel-api`, `zitadel-login` (prebuilt), `proxy`; Postgres/Bootstrap volumes, Docker network, local port, health checks | P02 |
| `deployment/README.md` | Deployment scope/hardening placeholder; no production Compose exists | P01 |
| `tests/test_backend_dev.py` | Prior three focused Python stdlib static/secret-generation checks; NOT a live Docker acceptance test | P02 |
| `tests/README.md` | Test folder introduction | P01 |
| `scripts/README.md` | Placeholder for future scripts; no standalone project scripts yet | P01 |
## P03 imported official ZITADEL Login V2
| Path | Responsibility | What to change |
| --- | --- | --- |
| `auth/ui/v2/apps/login/src/app/` | Official Next.js login route/page implementation; login, registration, challenges, IDP and recovery | Only within approved Login UI phase; auth behavior protected |
| `auth/ui/v2/apps/login/src/components/` | Official reusable form/UI components | Later visual phase with regression checks |
| `auth/ui/v2/apps/login/src/styles/` | Official Login presentation styling | Later visual phase |
| `auth/ui/v2/apps/login/public/` | Login static assets, logos, favicons | Later branding phase |
| `auth/ui/v2/apps/login/locales/` | Upstream translations | Later translation phase |
| `auth/ui/v2/apps/login/src/lib/` | Protected login backend/session helpers | Separate security-scoped approval |
| `auth/ui/v2/apps/login/src/proxy.ts` | Official Next.js request/proxy route handling | Protected routing code |
| `auth/ui/v2/apps/login/package.json` | Login scripts/dependencies, workspace linkages | Version/security phase only |
| `auth/ui/v2/apps/login/project.json` | Nx targets and dependencies | Build infrastructure phase |
| `auth/ui/v2/apps/login/Dockerfile` | Official Login UI image definition | Image-build integration phase |
| `auth/ui/v2/packages/zitadel-client/` | Upstream ZITADEL JS client | Do not edit for visual UI |
| `auth/ui/v2/packages/zitadel-proto/` | Upstream generated API type project | Generated output; not hand-edit |
| `auth/ui/v2/proto/` | Upstream protocol definitions | No UI edit |
| `auth/ui/v2/pnpm-lock.yaml` | Original upstream dependency graph; frozen-build compatibility pending CI | Dependency phase only |
| `auth/ui/v2/pnpm-workspace.yaml`, `nx.json`, `package.json` | Original workspace structure/tooling | Dependency/build phase |
| `auth/ui/v2/LICENSING.md`, `LICENSE` | Upstream licensing terms; preserve | Legal compliance |
| `auth/ui/v2/README.md` | ZitPlane import/user-maintainer guide | When upstream login source changes |
Upstream import: official ZITADEL `v4.20.4` / Git `384bb9ec96b501ad39dc232ee2061a40fe180bbd`. Imported files are intentionally byte-for-byte identical except two excluded upstream environment files. **No source edit was performed in P03.** See `docs/P03-SOURCE-IMPORT.md`.
## P04 Account Portal (first-party) — complete source file map
| Source | Purpose |
| --- | --- |
| `users/ui/package.json` | Next.js/React/Auth.js dependency versions and dev/build/start/typecheck scripts; lockfile not yet generated |
| `users/ui/tsconfig.json` | TypeScript strict configuration and `@/*` alias |
| `users/ui/next-env.d.ts` | Next.js TypeScript references |
| `users/ui/next.config.ts` | Standalone output, security-related response headers, strict React mode |
| `users/ui/.env.example` | Configuration key names only; never real secrets |
| `users/ui/.gitignore` | Ignore Next.js build output, node_modules, and env data |
| `users/ui/src/auth.ts` | Auth.js ZITADEL provider/callbacks and encrypted cookie session integration; protected security logic |
| `users/ui/src/lib/env.ts` | Validates OIDC issuer/portal origin/client credentials/secret |
| `users/ui/src/lib/identity.ts` | `requireIdentity()` and issuer-derived ZITADEL self-service link |
| `users/ui/src/types/next-auth.d.ts` | Session user ID and JWT subject/expiry type augmentation |
| `users/ui/src/app/layout.tsx` | Root page shell, metadata, global stylesheet import |
| `users/ui/src/app/page.tsx` | `/` redirects to `/account` |
| `users/ui/src/app/signin/page.tsx` | Sign-in form; server action triggers Auth.js ZITADEL OIDC redirect |
| `users/ui/src/app/(protected)/layout.tsx` | Mandatory server-side account identity gate + sidebar shell |
| `users/ui/src/app/(protected)/account/page.tsx` | Account overview cards and identity greeting |
| `users/ui/src/app/(protected)/account/profile/page.tsx` | Read-only profile fields and ZITADEL account link |
| `users/ui/src/app/(protected)/account/security/page.tsx` | Password/MFA/passkey informational rows and ZITADEL security link |
| `users/ui/src/app/api/auth/[...nextauth]/route.ts` | Auth.js handlers for sign-in/callback/session support |
| `users/ui/src/app/api/account/me/route.ts` | GET current user ID/name/email, or 401 |
| `users/ui/src/components/account-shell.tsx` | Responsive sidebar/topbar/footer/sign-out form |
| `users/ui/src/components/account-card.tsx` | Reusable overview Card and profile DataRow |
| `users/ui/src/styles/globals.css` | Design tokens, compact layout, responsive/mobile/light-dark styling |
| `users/ui/README.md` | Beginner maintainer guide, routes/config/security contract |
These paths describe **source**, not a verified running app. Do not infer API compatibility or production availability from files existing.
## Other first-party folders
`packages/README.md`: intentionally empty shared-package placeholder, not the upstream `auth/ui/v2/packages/`.
`users/ui/public/`: currently no public assets registered. `project/` and `docs/` files are indexed by their own `MINIFEST.md`.
## Exact-file maintenance workflow
For any approved update:
1. Find target in this map, then open the actual source file and verify current behavior.
2. Record before/after and Scope Lock in `notes/`.
3. Change only approved files. Update relevant function/feature and user docs in the same phase.
4. Add change record to `project/CHANGELOG.md` and sync `MINIFEST.md` / source inventory if structure changes.
5. Do not rewrite or claim knowledge of every upstream function without examining it. Imported source internals stay officially sourced until audited for an approved edit.
+70
View File
@@ -0,0 +1,70 @@
# Functions, API handlers and important logic — reviewed first-party source
**Scope:** ZitPlane-owned P02 backend helper and P04 Account Portal at baseline `40af500`. Imported Login V2 upstream functions are **not invented or paraphrased**; consult the exact paths in `auth/ui/v2/` and the full tracked-file inventory in `SOURCE-INVENTORY.md`. On an approved future Login UI change, add a reviewed function entry here with signature, inputs/outputs and caller.
## Python backend helper: `core/backend/zitadel/dev.py`
| Function / entry | Purpose / input-output | Used from / protection |
| --- | --- | --- |
| `random_chars(alphabet, length)` | Uses Python `secrets.choice` to create unpredictable strings | Called when generating initial local dev credentials |
| `create_dev_env()` | Creates ignored root `.env` **once** with random Postgres password, 32-char ZITADEL master key, initial admin password and Login session cookie secret; refuses overwrites; returns created flag | `main init`; never print secrets or use for production |
| `validate_env()` | Reads local `.env`, asserts four required settings and minimum lengths; raises on invalid/missing values | Invoked before running Compose helper actions |
| `docker_compose(*args)` | Ensures Docker CLI exists, then executes Compose with explicit dev YAML and local env; raises if nonzero | `main` for `up`, `down`, `ps`, `config` |
| `check_ready()` | GET `http://localhost:8080/debug/ready`, requires HTTP 200, otherwise raises; prints expected Admin Console URL | `main check` or after `up` |
| `main()` | CLI dispatcher with `init`, `up`, `check`, `down`, `ps`, `config`; prints BLOCKED on RuntimeError | Script entrypoint |
| `if __name__ == "__main__"` | Calls `main()` and exits with its status | Python execution entrypoint |
**Related YAML:** `deployment/docker/compose.backend.dev.yaml` defines Postgres readiness via `pg_isready`, ZITADEL health command `/app/zitadel ready`, official Login V2 health, and Traefik path routing. These are container declarations, **not Python functions**.
## OIDC: `users/ui/src/auth.ts`
| Function / callback | Actual responsibility | Caveat |
| --- | --- | --- |
| `NextAuth(() => {...})` configuration callback | Creates `handlers`, `auth`, `signIn`, `signOut` with dedicated ZITADEL OIDC provider; PKCE, state and nonce requests; Auth.js-managed JWT sessions | Config and dependency compatibility unverified |
| `callbacks.signIn({account,profile})` | Accepts only provider `zitadel` and nonempty OIDC `profile.sub` | Does not implement external account permissions |
| `callbacks.jwt({token,account})` | Stores OIDC provider account subject and provider access-token expiry in Auth.js JWT metadata; expiry absent => 0 | No token refresh implementation |
| `callbacks.session({session,token})` | Sets `session.user.id` only if subject exists and stored expiry is future; otherwise sets empty ID | All protected actions must check nonempty `user.id`, not mere session presence |
## Config + identity helpers
| Function | Source | Inputs, use and guard |
| --- | --- | --- |
| `required(name)` | `users/ui/src/lib/env.ts` | Server-only required environment lookup; rejects blank/example placeholders |
| `validatedUrl(name)` | Same | Parses URL and checks scheme, credentials, query/hash/path; production requires HTTPS; dev allows HTTP localhost |
| `oidcSettings()` | Same | Loads valid issuer, client ID/secret, Auth.js secret (length 32+), portal URL and trusted-host boolean |
| `requireIdentity()` | `users/ui/src/lib/identity.ts` | Reads `auth()`; no valid `session.user.id` => `redirect("/signin")`; otherwise returns current user |
| `zitadelSelfServiceUrl()` | Same | Builds issuer-origin `/ui/console/users/me` link. Route/permission availability **not tested**; never accepts a browser-supplied redirect URL |
## Next.js pages and server actions
| Export/function | File | Action / user impact |
| --- | --- | --- |
| `RootLayout({children})` | `src/app/layout.tsx` | Renders `html` / `body` wrapper and imports global stylesheet |
| `Home()` | `src/app/page.tsx` | Server-side redirect from `/` to `/account` |
| `SignInPage()` | `src/app/signin/page.tsx` | Calls `auth()`; sends valid users to `/account`; otherwise renders sign-in form |
| `startLogin()` | Same, nested server action | Calls `signIn("zitadel", {redirectTo:"/account"})` on button submission |
| `ProtectedLayout({children})` | `src/app/(protected)/layout.tsx` | Guards all routes in this route group using `requireIdentity()` |
| `AccountPage()` | `src/app/(protected)/account/page.tsx` | Protected overview greeting and profile/security action cards |
| `ProfilePage()` | `src/app/(protected)/account/profile/page.tsx` | Protected, read-only display name/email/subject plus self-service link |
| `SecurityPage()` | `src/app/(protected)/account/security/page.tsx` | Protected informational password/MFA/passkeys page plus link |
| `AccountShell({user,children})` | `src/components/account-shell.tsx` | Nav, authenticated identity tile, sign-out form, topbar and footer |
| `portalLogout()` | Same, nested server action | Calls Auth.js `signOut({redirectTo:"/signin"})`; not global SSO logout |
| `AccountCard({title,description,href,action})` | `src/components/account-card.tsx` | Reusable linked overview card |
| `DataRow({label,value})` | Same | Read-only `dt/dd` identity field with Not provided fallback |
## Next.js HTTP/API handlers
| Export | File | Security and behavior |
| --- | --- | --- |
| `GET`, `POST` (Auth.js handlers) | `src/app/api/auth/[...nextauth]/route.ts` | Delegated to Auth.js `handlers`; callback and session endpoints |
| `GET()` | `src/app/api/account/me/route.ts` | Calls `auth()`; nonempty `session.user.id` required; 401 otherwise; returns current id/name/email with private/no-store |
| `generateMetadata` | No first-party custom implementation present | Do not invent one; static metadata objects exist in pages |
| `next.config.ts async headers()` | `users/ui/next.config.ts` | Declares response security headers via Next config; not an account API |
## Previous first-party unit test functions (prior phase)
`tests/test_backend_dev.py`: `BackendDevContract.test_initialization_is_private_and_idempotent`, `test_compose_local_only_and_version_pinned`, `test_secrets_ignored`. They validate **static P02 contracts**, not real authentication or Docker.
## Future update minimum for each function
Record: exact path, function name/signature, callers, inputs/outputs, error behavior, security assumptions, user-visible effect, tests/CI reference, phase + commit. Do not speculate from a filename alone.
+15
View File
@@ -0,0 +1,15 @@
# project/ manifest
| File | Details | Phase / status |
| --- | --- | --- |
| [README.md](README.md) | Purpose, ownership and update rules for internal developer knowledge | DOCS-01 / active |
| [MINIFEST.md](MINIFEST.md) | Exact direct-child file inventory | DOCS-01 / active |
| [ARCHITECTURE.md](ARCHITECTURE.md) | Verified component boundaries, identity flows, future integration boundary | DOCS-01 / active |
| [FILE-MAP.md](FILE-MAP.md) | First-party file + module explanation; upstream source references | DOCS-01 / active |
| [FUNCTIONS.md](FUNCTIONS.md) | First-party function/route map, safeguards and responsibilities | DOCS-01 / active |
| [FEATURES-AND-PAGES.md](FEATURES-AND-PAGES.md) | Every ZitPlane-owned Account Portal page/API and backend/login capability status | DOCS-01 / active |
| [SETUP-AND-DEPENDENCIES.md](SETUP-AND-DEPENDENCIES.md) | Runtime deps, config, local setup behavior, deployment gaps | DOCS-01 / active |
| [SOURCE-INVENTORY.md](SOURCE-INVENTORY.md) | Exact Git-tracked file inventory (snapshot; see baseline) | DOCS-01 / active |
| [CHANGELOG.md](CHANGELOG.md) | Chronological feature/change/fix records and links to notes | DOCS-01 / active |
Update this manifest whenever this directory's direct children change. Use exact case-sensitive filenames. Refer to Git for a reproducible baseline of what is actually in the repository.
+28
View File
@@ -0,0 +1,28 @@
# project/ — Developer knowledge base (source of implementation truth)
This Git-tracked folder describes **how ZitPlane is built**, what each first-party module/file/function does, why technologies are used, how components communicate, the implementation status of each feature/page, and exactly which phase changed each part.
Use this folder for **architecture, behavior and maintainers' internal details**. Use `notes/` for pre-change scope/decisions/checkpoint logs; use `docs/` for **end-user usage** and practical setup instructions.
## Mandatory update workflow
1. Before any code or configuration change, create a dated, scoped plan in `notes/`.
2. Identify every relevant entry in [FILE-MAP.md](FILE-MAP.md), [FUNCTIONS.md](FUNCTIONS.md), [FEATURES-AND-PAGES.md](FEATURES-AND-PAGES.md) and [SETUP-AND-DEPENDENCIES.md](SETUP-AND-DEPENDENCIES.md).
3. During/after implementation, update those exact descriptions: what changed, reason, location, API/flow impacts, dependencies, security effects, status, test evidence, commit reference.
4. Update [CHANGELOG.md](CHANGELOG.md), relevant `docs/` user guides, and manifests **in the same approved phase**.
5. Record verified facts only. Distinguish source-implemented from test-passed and deployed. Never invent a button, feature, exact endpoint, passing test or production state.
## Key entrypoints
- [ARCHITECTURE.md](ARCHITECTURE.md) — component boundaries and data/auth flows
- [FILE-MAP.md](FILE-MAP.md) — first-party file ownership and upstream source grouping
- [FUNCTIONS.md](FUNCTIONS.md) — reviewed first-party function/route ownership
- [FEATURES-AND-PAGES.md](FEATURES-AND-PAGES.md) — feature + page register and actual status
- [SETUP-AND-DEPENDENCIES.md](SETUP-AND-DEPENDENCIES.md) — versions, setup paths and gaps
- [SOURCE-INVENTORY.md](SOURCE-INVENTORY.md) — complete tracked-source path index **at the recorded Git baseline**, including upstream import
- [CHANGELOG.md](CHANGELOG.md) — development phase history
- [MINIFEST.md](MINIFEST.md) — direct-file manifest
The upstream ZITADEL Login V2 was imported unmodified from a pinned revision. Its own read-only internals should be referenced with exact file paths (and added to this knowledge base when modified in an approved later phase), not silently replaced with guessed descriptions.
**Security:** This is public-repository-appropriate documentation. Never include credentials, session cookies, real account IDs, tokens, production data or sensitive configuration values.
+40
View File
@@ -0,0 +1,40 @@
# Setup, modules and dependency rationale
Baseline: P04 source, Git `40af500`; runtime not verified.
| Technology / module | Actual source location | Why it exists / configured version |
| --- | --- | --- |
| ZITADEL Go server | Official Docker image in `deployment/docker/compose.backend.dev.yaml` | Central IAM/OIDC/security policy server, pinned `v4.20.4`; **Go source is not vendored** |
| ZITADEL Login V2 | `auth/ui/v2/apps/login/` | Original customisable Next.js login/recovery/MFA frontend, upstream tag `v4.20.4`; import-only |
| ZITADEL JS client/protos | `auth/ui/v2/packages/zitadel-client`, `zitadel-proto`, `proto` | Matched Login V2 generated API types/client and source protocol definitions |
| pnpm + Nx | `auth/ui/v2/package.json`, lockfile, `nx.json` | Original upstream Login V2 multi-package build chain; root workspace pins `pnpm@10.30.3`, imported Login package pins a different `pnpm@10.28.2` in its manifest; compatibility to verify in future CI |
| Next.js / React | `users/ui/package.json` | Account Portal App Router and server components; `next@16.4.3`, `react@19.2.6` |
| Auth.js 5 / ZITADEL provider | `users/ui/src/auth.ts`, `package.json` | OIDC Authorization Code + PKCE, state, nonce and portal-local JWT sessions; `next-auth@5.0.0-beta.32`; compatibility/security CI pending |
| PostgreSQL | P02 Compose | ZITADEL storage, `postgres:17.10-alpine` |
| Traefik | P02 Compose | Local HTTP/2 h2c proxy, `traefik:v3.7.7` |
| Python stdlib helper | `core/backend/zitadel/dev.py` | Secure local secret generator, Compose wrapper, ready check; requires Python 3.10+ according to prior docs |
## Exact local development entrypoint (P02 only; no claim it ran)
From project root: `py core/backend/zitadel/dev.py init` (writes ignored `.env` once); `config`, `up`, `ps`, `check`, `down` subcommands require Docker. The production configuration is **not** built or deployed.
In `deployment/docker/compose.backend.dev.yaml`, named volumes `postgres-data` and `zitadel-bootstrap` preserve DB and bootstrap token. Proxy only publishes `127.0.0.1:8080:80`. Local ZITADEL admin username is `zitadel-admin@zitadel.localhost`, initial password generated in ignored `.env`; no real user account setup has been verified.
## Account portal environments (not provisioned)
`users/ui/.env.example` documents `ZITADEL_ISSUER`, `ZITADEL_CLIENT_ID`, `ZITADEL_CLIENT_SECRET`, `AUTH_SECRET`, `AUTH_URL`, `AUTH_TRUST_HOST`. All must be securely provisioned before a live OIDC session can work. Proposed callback: `/api/auth/callback/zitadel`, matching dedicated confidential ZITADEL Web client.
The Account Portal has **no dependency lockfile** yet. `npm ci`/reproducible build is unavailable until a separately approved lockfile/CI phase. The P03 slim workspace retains the original upstream `pnpm-lock.yaml` with unverified frozen-install compatibility.
## Why modules live where they do
- `core/` contains ZitPlane orchestration, *not a ZITADEL Go fork*; updates to Go backend are done by deliberate image upgrades.
- `auth/` retains upstream source-relative layout to avoid breaking shared imports and make merge/supply-chain audits possible.
- `users/ui/` is a separate product surface because account self-service is not the same as login/challenge flows.
- `deployment/` separates local infrastructure from a future production Compose/Coolify stack.
- `packages/` is a placeholder for future ZitPlane-owned reusable UI; do not confuse with `auth/ui/v2/packages/` which are pinned upstream dependencies.
- `notes/` = phase plans/evidence; `project/` = developer truth; `docs/` = user guides.
## Pending checks before any release
Version security review, reproducible installs, TypeScript/typecheck, Next.js build, OIDC state/PKCE, callback, token expiry, local vs global logout, self-service access, routing, secrets handling, production TLS, backup/restore, monitoring, and isolated Gitea CI verification. No current public deployment exists per recorded phase evidence.
+757
View File
@@ -0,0 +1,757 @@
# Source inventory ? all Git-tracked paths
**Snapshot:** 2026-11-22, P04 baseline `40af500` + staged DOCS-01 documentation changes. Paths read from the local Git **index**; the pending documentation commit preserves the same tracked file set.
**Tracked paths in this snapshot: 701.** Ignored `.env` secrets and unrelated untracked `AI_INSTRUCTIONS.md` are **not included**.
This is an **exact path and ownership locator**, not a claim that every imported function has been reviewed. For first-party behavior see `project/FILE-MAP.md` and `project/FUNCTIONS.md`. The upstream Login V2 subtree is preserved from v4.20.4.
| Group | Files | Ownership / history |
| --- | ---: | --- |
| `(repository root)` | 6 | First-party root configuration and entrypoints |
| `auth` | 639 | P03 pinned upstream Login V2 import |
| `core` | 2 | P02 ZITADEL orchestration, not Go backend source |
| `deployment` | 2 | P02 local-only Compose |
| `docs` | 12 | P01-P04 user/phase evidence + DOCS-01 |
| `notes` | 4 | DOCS-01 phase plans and records |
| `packages` | 1 | P01 future shared package placeholder |
| `project` | 9 | DOCS-01 developer knowledge and inventory |
| `scripts` | 1 | P01 future script placeholder |
| `tests` | 2 | P02 backend helper contracts |
| `users` | 23 | P04 Account Portal Next.js source |
## Exact tracked paths
### (repository root) ? 6 files
- `.editorconfig`
- `.env.example`
- `.gitignore`
- `AGENTS.md`
- `MINIFEST.md`
- `README.md`
### auth ? 639 files
- `auth/ui/v2/.npmrc`
- `auth/ui/v2/.nvmrc`
- `auth/ui/v2/.nxignore`
- `auth/ui/v2/LICENSE`
- `auth/ui/v2/LICENSING.md`
- `auth/ui/v2/README.md`
- `auth/ui/v2/apps/login/.env.theme.example`
- `auth/ui/v2/apps/login/.gitignore`
- `auth/ui/v2/apps/login/.prettierignore`
- `auth/ui/v2/apps/login/AGENTS.md`
- `auth/ui/v2/apps/login/Dockerfile`
- `auth/ui/v2/apps/login/Dockerfile.fips`
- `auth/ui/v2/apps/login/LICENSE`
- `auth/ui/v2/apps/login/THEME_ARCHITECTURE.md`
- `auth/ui/v2/apps/login/THEME_CUSTOMIZATION.md`
- `auth/ui/v2/apps/login/acceptance/.gitignore`
- `auth/ui/v2/apps/login/acceptance/eslint.config.mjs`
- `auth/ui/v2/apps/login/acceptance/go-command.Dockerfile`
- `auth/ui/v2/apps/login/acceptance/idp/oidc/go.mod`
- `auth/ui/v2/apps/login/acceptance/idp/oidc/go.sum`
- `auth/ui/v2/apps/login/acceptance/idp/oidc/main.go`
- `auth/ui/v2/apps/login/acceptance/idp/saml/go.mod`
- `auth/ui/v2/apps/login/acceptance/idp/saml/go.sum`
- `auth/ui/v2/apps/login/acceptance/idp/saml/main.go`
- `auth/ui/v2/apps/login/acceptance/oidcrp/go.mod`
- `auth/ui/v2/apps/login/acceptance/oidcrp/go.sum`
- `auth/ui/v2/apps/login/acceptance/oidcrp/main.go`
- `auth/ui/v2/apps/login/acceptance/pat/.gitignore`
- `auth/ui/v2/apps/login/acceptance/pat/.gitkeep`
- `auth/ui/v2/apps/login/acceptance/playwright-report/.gitignore`
- `auth/ui/v2/apps/login/acceptance/playwright-report/.gitkeep`
- `auth/ui/v2/apps/login/acceptance/playwright.config.ts`
- `auth/ui/v2/apps/login/acceptance/samlsp/go.mod`
- `auth/ui/v2/apps/login/acceptance/samlsp/go.sum`
- `auth/ui/v2/apps/login/acceptance/samlsp/main.go`
- `auth/ui/v2/apps/login/acceptance/setup/go.mod`
- `auth/ui/v2/apps/login/acceptance/setup/go.sum`
- `auth/ui/v2/apps/login/acceptance/setup/main.go`
- `auth/ui/v2/apps/login/acceptance/setup/setup.sh`
- `auth/ui/v2/apps/login/acceptance/sink/go.mod`
- `auth/ui/v2/apps/login/acceptance/sink/go.sum`
- `auth/ui/v2/apps/login/acceptance/sink/main.go`
- `auth/ui/v2/apps/login/acceptance/test-results/.gitignore`
- `auth/ui/v2/apps/login/acceptance/test-results/.gitkeep`
- `auth/ui/v2/apps/login/acceptance/tests/admin.spec.ts`
- `auth/ui/v2/apps/login/acceptance/tests/code-screen.ts`
- `auth/ui/v2/apps/login/acceptance/tests/code.ts`
- `auth/ui/v2/apps/login/acceptance/tests/email-verify-screen.ts`
- `auth/ui/v2/apps/login/acceptance/tests/email-verify.spec.ts`
- `auth/ui/v2/apps/login/acceptance/tests/email-verify.ts`
- `auth/ui/v2/apps/login/acceptance/tests/idp-apple.spec.ts`
- `auth/ui/v2/apps/login/acceptance/tests/idp-generic-jwt.spec.ts`
- `auth/ui/v2/apps/login/acceptance/tests/idp-generic-oauth.spec.ts`
- `auth/ui/v2/apps/login/acceptance/tests/idp-generic-oidc.spec.ts`
- `auth/ui/v2/apps/login/acceptance/tests/idp-github-enterprise.spec.ts`
- `auth/ui/v2/apps/login/acceptance/tests/idp-github.spec.ts`
- `auth/ui/v2/apps/login/acceptance/tests/idp-gitlab-self-hosted.spec.ts`
- `auth/ui/v2/apps/login/acceptance/tests/idp-gitlab.spec.ts`
- `auth/ui/v2/apps/login/acceptance/tests/idp-google.spec.ts`
- `auth/ui/v2/apps/login/acceptance/tests/idp-ldap.spec.ts`
- `auth/ui/v2/apps/login/acceptance/tests/idp-microsoft.spec.ts`
- `auth/ui/v2/apps/login/acceptance/tests/idp-saml.spec.ts`
- `auth/ui/v2/apps/login/acceptance/tests/login-configuration-possiblities.spec.ts`
- `auth/ui/v2/apps/login/acceptance/tests/login.ts`
- `auth/ui/v2/apps/login/acceptance/tests/loginname-screen.ts`
- `auth/ui/v2/apps/login/acceptance/tests/loginname.ts`
- `auth/ui/v2/apps/login/acceptance/tests/passkey.ts`
- `auth/ui/v2/apps/login/acceptance/tests/password-screen.ts`
- `auth/ui/v2/apps/login/acceptance/tests/password.ts`
- `auth/ui/v2/apps/login/acceptance/tests/register-screen.ts`
- `auth/ui/v2/apps/login/acceptance/tests/register.spec.ts`
- `auth/ui/v2/apps/login/acceptance/tests/register.ts`
- `auth/ui/v2/apps/login/acceptance/tests/select-account.ts`
- `auth/ui/v2/apps/login/acceptance/tests/sink.ts`
- `auth/ui/v2/apps/login/acceptance/tests/user.ts`
- `auth/ui/v2/apps/login/acceptance/tests/username-passkey.spec.ts`
- `auth/ui/v2/apps/login/acceptance/tests/username-password-change-required.spec.ts`
- `auth/ui/v2/apps/login/acceptance/tests/username-password-changed.spec.ts`
- `auth/ui/v2/apps/login/acceptance/tests/username-password-otp_email.spec.ts`
- `auth/ui/v2/apps/login/acceptance/tests/username-password-otp_sms.spec.ts`
- `auth/ui/v2/apps/login/acceptance/tests/username-password-set.spec.ts`
- `auth/ui/v2/apps/login/acceptance/tests/username-password-totp.spec.ts`
- `auth/ui/v2/apps/login/acceptance/tests/username-password-u2f.spec.ts`
- `auth/ui/v2/apps/login/acceptance/tests/username-password.spec.ts`
- `auth/ui/v2/apps/login/acceptance/tests/welcome.ts`
- `auth/ui/v2/apps/login/acceptance/tests/zitadel.ts`
- `auth/ui/v2/apps/login/acceptance/zitadel.yaml`
- `auth/ui/v2/apps/login/checks/eslint-module-boundaries.mjs`
- `auth/ui/v2/apps/login/checks/server-actions.allowlist.json`
- `auth/ui/v2/apps/login/checks/server-actions.mjs`
- `auth/ui/v2/apps/login/constants/csp.js`
- `auth/ui/v2/apps/login/dockerized/await-api/await-api.integration.test.ts`
- `auth/ui/v2/apps/login/dockerized/await-api/mock-zitadel-server.js`
- `auth/ui/v2/apps/login/dockerized/ca/ca.integration.test.ts`
- `auth/ui/v2/apps/login/dockerized/ca/utils/tls.ts`
- `auth/ui/v2/apps/login/dockerized/otel/mock-zitadel-server.js`
- `auth/ui/v2/apps/login/dockerized/otel/otel-collector-config.yaml`
- `auth/ui/v2/apps/login/dockerized/otel/otel.integration.test.ts`
- `auth/ui/v2/apps/login/dockerized/ssl/tls.integration.test.ts`
- `auth/ui/v2/apps/login/eslint.config.mjs`
- `auth/ui/v2/apps/login/locales/ar.json`
- `auth/ui/v2/apps/login/locales/de.json`
- `auth/ui/v2/apps/login/locales/en.json`
- `auth/ui/v2/apps/login/locales/es.json`
- `auth/ui/v2/apps/login/locales/fr.json`
- `auth/ui/v2/apps/login/locales/hu.json`
- `auth/ui/v2/apps/login/locales/it.json`
- `auth/ui/v2/apps/login/locales/ja.json`
- `auth/ui/v2/apps/login/locales/nl.json`
- `auth/ui/v2/apps/login/locales/pl.json`
- `auth/ui/v2/apps/login/locales/pt.json`
- `auth/ui/v2/apps/login/locales/ru.json`
- `auth/ui/v2/apps/login/locales/tr.json`
- `auth/ui/v2/apps/login/locales/uk.json`
- `auth/ui/v2/apps/login/locales/zh.json`
- `auth/ui/v2/apps/login/next-env-vars.d.ts`
- `auth/ui/v2/apps/login/next.config.mjs`
- `auth/ui/v2/apps/login/package.json`
- `auth/ui/v2/apps/login/postcss.config.cjs`
- `auth/ui/v2/apps/login/prettier.config.mjs`
- `auth/ui/v2/apps/login/project.json`
- `auth/ui/v2/apps/login/public/checkbox.svg`
- `auth/ui/v2/apps/login/public/favicon.ico`
- `auth/ui/v2/apps/login/public/favicon/android-chrome-192x192.png`
- `auth/ui/v2/apps/login/public/favicon/android-chrome-512x512.png`
- `auth/ui/v2/apps/login/public/favicon/apple-touch-icon.png`
- `auth/ui/v2/apps/login/public/favicon/browserconfig.xml`
- `auth/ui/v2/apps/login/public/favicon/favicon-16x16.png`
- `auth/ui/v2/apps/login/public/favicon/favicon-32x32.png`
- `auth/ui/v2/apps/login/public/favicon/favicon.ico`
- `auth/ui/v2/apps/login/public/favicon/mstile-150x150.png`
- `auth/ui/v2/apps/login/public/favicon/site.webmanifest`
- `auth/ui/v2/apps/login/public/grid-dark.svg`
- `auth/ui/v2/apps/login/public/grid-light.svg`
- `auth/ui/v2/apps/login/public/logo/zitadel-logo-solo-darkdesign.svg`
- `auth/ui/v2/apps/login/public/logo/zitadel-logo-solo-lightdesign.svg`
- `auth/ui/v2/apps/login/public/zitadel-logo-dark.svg`
- `auth/ui/v2/apps/login/public/zitadel-logo-light.svg`
- `auth/ui/v2/apps/login/screenshots/accounts.png`
- `auth/ui/v2/apps/login/screenshots/accounts_jumpto.png`
- `auth/ui/v2/apps/login/screenshots/collage.png`
- `auth/ui/v2/apps/login/screenshots/idp.png`
- `auth/ui/v2/apps/login/screenshots/loginname.png`
- `auth/ui/v2/apps/login/screenshots/mfa.png`
- `auth/ui/v2/apps/login/screenshots/mfaset.png`
- `auth/ui/v2/apps/login/screenshots/otp.png`
- `auth/ui/v2/apps/login/screenshots/otpset.png`
- `auth/ui/v2/apps/login/screenshots/passkey.png`
- `auth/ui/v2/apps/login/screenshots/password.png`
- `auth/ui/v2/apps/login/screenshots/password_change.png`
- `auth/ui/v2/apps/login/screenshots/password_set.png`
- `auth/ui/v2/apps/login/screenshots/register.png`
- `auth/ui/v2/apps/login/screenshots/register_password.png`
- `auth/ui/v2/apps/login/screenshots/signedin.png`
- `auth/ui/v2/apps/login/screenshots/u2f.png`
- `auth/ui/v2/apps/login/screenshots/u2fset.png`
- `auth/ui/v2/apps/login/screenshots/verify.png`
- `auth/ui/v2/apps/login/scripts/entrypoint.sh`
- `auth/ui/v2/apps/login/scripts/healthcheck.mjs`
- `auth/ui/v2/apps/login/scripts/load-ssl-cert-dir.cjs`
- `auth/ui/v2/apps/login/scripts/server.mjs`
- `auth/ui/v2/apps/login/src/app/(login)/accounts/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/authenticator/set/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/device/consent/page.test.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/device/consent/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/device/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/error.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/idp/[provider]/account-not-found/page.test.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/idp/[provider]/account-not-found/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/idp/[provider]/complete-registration/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/idp/[provider]/failure/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/idp/[provider]/linking-failed/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/idp/[provider]/process/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/idp/[provider]/registration-failed/page.test.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/idp/[provider]/registration-failed/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/idp/ldap/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/idp/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/layout.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/loginname/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/logout/done/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/logout/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/mfa/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/mfa/set/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/otp/[method]/page.test.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/otp/[method]/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/otp/[method]/set/page.test.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/otp/[method]/set/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/passkey/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/passkey/set/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/password/change/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/password/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/password/set/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/register/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/register/password/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/signedin/page.test.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/signedin/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/u2f/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/u2f/set/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/verify/page.tsx`
- `auth/ui/v2/apps/login/src/app/(login)/verify/success/page.tsx`
- `auth/ui/v2/apps/login/src/app/global-error.tsx`
- `auth/ui/v2/apps/login/src/app/healthy/route.ts`
- `auth/ui/v2/apps/login/src/app/login/route.ts`
- `auth/ui/v2/apps/login/src/app/otel-test/route.ts`
- `auth/ui/v2/apps/login/src/app/ready/route.test.ts`
- `auth/ui/v2/apps/login/src/app/ready/route.ts`
- `auth/ui/v2/apps/login/src/components/LoginLayout.tsx`
- `auth/ui/v2/apps/login/src/components/address-bar.tsx`
- `auth/ui/v2/apps/login/src/components/alert.tsx`
- `auth/ui/v2/apps/login/src/components/app-avatar.tsx`
- `auth/ui/v2/apps/login/src/components/auth-methods.test.tsx`
- `auth/ui/v2/apps/login/src/components/auth-methods.tsx`
- `auth/ui/v2/apps/login/src/components/authentication-method-radio.tsx`
- `auth/ui/v2/apps/login/src/components/auto-submit-form.tsx`
- `auth/ui/v2/apps/login/src/components/avatar.test.tsx`
- `auth/ui/v2/apps/login/src/components/avatar.tsx`
- `auth/ui/v2/apps/login/src/components/back-button.tsx`
- `auth/ui/v2/apps/login/src/components/background-wrapper.tsx`
- `auth/ui/v2/apps/login/src/components/boundary.tsx`
- `auth/ui/v2/apps/login/src/components/branding-context.tsx`
- `auth/ui/v2/apps/login/src/components/button.test.tsx`
- `auth/ui/v2/apps/login/src/components/button.tsx`
- `auth/ui/v2/apps/login/src/components/card.test.tsx`
- `auth/ui/v2/apps/login/src/components/card.tsx`
- `auth/ui/v2/apps/login/src/components/change-password-form.test.tsx`
- `auth/ui/v2/apps/login/src/components/change-password-form.tsx`
- `auth/ui/v2/apps/login/src/components/checkbox.tsx`
- `auth/ui/v2/apps/login/src/components/choose-authenticator-to-login.tsx`
- `auth/ui/v2/apps/login/src/components/choose-authenticator-to-setup.tsx`
- `auth/ui/v2/apps/login/src/components/choose-second-factor-to-setup.tsx`
- `auth/ui/v2/apps/login/src/components/choose-second-factor.tsx`
- `auth/ui/v2/apps/login/src/components/consent.test.tsx`
- `auth/ui/v2/apps/login/src/components/consent.tsx`
- `auth/ui/v2/apps/login/src/components/copy-to-clipboard.tsx`
- `auth/ui/v2/apps/login/src/components/default-tags.tsx`
- `auth/ui/v2/apps/login/src/components/device-code-form.test.tsx`
- `auth/ui/v2/apps/login/src/components/device-code-form.tsx`
- `auth/ui/v2/apps/login/src/components/dynamic-theme.tsx`
- `auth/ui/v2/apps/login/src/components/external-link.tsx`
- `auth/ui/v2/apps/login/src/components/idp-process-handler.tsx`
- `auth/ui/v2/apps/login/src/components/idps/base-button.tsx`
- `auth/ui/v2/apps/login/src/components/idps/sign-in-with-apple.tsx`
- `auth/ui/v2/apps/login/src/components/idps/sign-in-with-azure-ad.tsx`
- `auth/ui/v2/apps/login/src/components/idps/sign-in-with-generic.tsx`
- `auth/ui/v2/apps/login/src/components/idps/sign-in-with-github.tsx`
- `auth/ui/v2/apps/login/src/components/idps/sign-in-with-gitlab.test.tsx`
- `auth/ui/v2/apps/login/src/components/idps/sign-in-with-gitlab.tsx`
- `auth/ui/v2/apps/login/src/components/idps/sign-in-with-google.test.tsx`
- `auth/ui/v2/apps/login/src/components/idps/sign-in-with-google.tsx`
- `auth/ui/v2/apps/login/src/components/idps/sign-in-with-zitadel.tsx`
- `auth/ui/v2/apps/login/src/components/input.test.tsx`
- `auth/ui/v2/apps/login/src/components/input.tsx`
- `auth/ui/v2/apps/login/src/components/language-provider.tsx`
- `auth/ui/v2/apps/login/src/components/language-switcher.tsx`
- `auth/ui/v2/apps/login/src/components/layout-providers.tsx`
- `auth/ui/v2/apps/login/src/components/ldap-username-password-form.test.tsx`
- `auth/ui/v2/apps/login/src/components/ldap-username-password-form.tsx`
- `auth/ui/v2/apps/login/src/components/login-otp.test.tsx`
- `auth/ui/v2/apps/login/src/components/login-otp.tsx`
- `auth/ui/v2/apps/login/src/components/login-passkey.test.tsx`
- `auth/ui/v2/apps/login/src/components/login-passkey.tsx`
- `auth/ui/v2/apps/login/src/components/logo.tsx`
- `auth/ui/v2/apps/login/src/components/otp-add-form.test.tsx`
- `auth/ui/v2/apps/login/src/components/otp-add-form.tsx`
- `auth/ui/v2/apps/login/src/components/password-complexity.test.tsx`
- `auth/ui/v2/apps/login/src/components/password-complexity.tsx`
- `auth/ui/v2/apps/login/src/components/password-form.test.tsx`
- `auth/ui/v2/apps/login/src/components/password-form.tsx`
- `auth/ui/v2/apps/login/src/components/privacy-policy-checkboxes.test.tsx`
- `auth/ui/v2/apps/login/src/components/privacy-policy-checkboxes.tsx`
- `auth/ui/v2/apps/login/src/components/register-form-idp-incomplete.test.tsx`
- `auth/ui/v2/apps/login/src/components/register-form-idp-incomplete.tsx`
- `auth/ui/v2/apps/login/src/components/register-form.test.tsx`
- `auth/ui/v2/apps/login/src/components/register-form.tsx`
- `auth/ui/v2/apps/login/src/components/register-passkey.tsx`
- `auth/ui/v2/apps/login/src/components/register-u2f.tsx`
- `auth/ui/v2/apps/login/src/components/self-service-menu.tsx`
- `auth/ui/v2/apps/login/src/components/session-clear-item.tsx`
- `auth/ui/v2/apps/login/src/components/session-item.tsx`
- `auth/ui/v2/apps/login/src/components/sessions-clear-list.tsx`
- `auth/ui/v2/apps/login/src/components/sessions-list.tsx`
- `auth/ui/v2/apps/login/src/components/set-password-form.test.tsx`
- `auth/ui/v2/apps/login/src/components/set-password-form.tsx`
- `auth/ui/v2/apps/login/src/components/set-register-password-form.test.tsx`
- `auth/ui/v2/apps/login/src/components/set-register-password-form.tsx`
- `auth/ui/v2/apps/login/src/components/sign-in-with-idp.tsx`
- `auth/ui/v2/apps/login/src/components/skeleton-card.tsx`
- `auth/ui/v2/apps/login/src/components/skeleton.tsx`
- `auth/ui/v2/apps/login/src/components/spinner.tsx`
- `auth/ui/v2/apps/login/src/components/state-badge.tsx`
- `auth/ui/v2/apps/login/src/components/tab-group.tsx`
- `auth/ui/v2/apps/login/src/components/tab.tsx`
- `auth/ui/v2/apps/login/src/components/theme-provider.tsx`
- `auth/ui/v2/apps/login/src/components/theme-switch.tsx`
- `auth/ui/v2/apps/login/src/components/theme-wrapper.tsx`
- `auth/ui/v2/apps/login/src/components/totp-register.test.tsx`
- `auth/ui/v2/apps/login/src/components/totp-register.tsx`
- `auth/ui/v2/apps/login/src/components/translated.tsx`
- `auth/ui/v2/apps/login/src/components/user-avatar.tsx`
- `auth/ui/v2/apps/login/src/components/username-form.test.tsx`
- `auth/ui/v2/apps/login/src/components/username-form.tsx`
- `auth/ui/v2/apps/login/src/components/verify-form.test.tsx`
- `auth/ui/v2/apps/login/src/components/verify-form.tsx`
- `auth/ui/v2/apps/login/src/components/verify-success-continue.tsx`
- `auth/ui/v2/apps/login/src/components/zitadel-logo-dark.tsx`
- `auth/ui/v2/apps/login/src/components/zitadel-logo-light.tsx`
- `auth/ui/v2/apps/login/src/components/zitadel-logo.tsx`
- `auth/ui/v2/apps/login/src/helpers/base64.test.ts`
- `auth/ui/v2/apps/login/src/helpers/base64.ts`
- `auth/ui/v2/apps/login/src/helpers/colors.test.ts`
- `auth/ui/v2/apps/login/src/helpers/colors.ts`
- `auth/ui/v2/apps/login/src/helpers/validators.test.ts`
- `auth/ui/v2/apps/login/src/helpers/validators.ts`
- `auth/ui/v2/apps/login/src/i18n/request.ts`
- `auth/ui/v2/apps/login/src/instrumentation.node.ts`
- `auth/ui/v2/apps/login/src/instrumentation.test.ts`
- `auth/ui/v2/apps/login/src/instrumentation.ts`
- `auth/ui/v2/apps/login/src/lib/actions/device.test.ts`
- `auth/ui/v2/apps/login/src/lib/actions/device.ts`
- `auth/ui/v2/apps/login/src/lib/actions/flow.ts`
- `auth/ui/v2/apps/login/src/lib/actions/idp-intent.test.ts`
- `auth/ui/v2/apps/login/src/lib/actions/idp-intent.ts`
- `auth/ui/v2/apps/login/src/lib/actions/idp.test.ts`
- `auth/ui/v2/apps/login/src/lib/actions/idp.ts`
- `auth/ui/v2/apps/login/src/lib/actions/language.test.ts`
- `auth/ui/v2/apps/login/src/lib/actions/language.ts`
- `auth/ui/v2/apps/login/src/lib/actions/loginname.test.ts`
- `auth/ui/v2/apps/login/src/lib/actions/loginname.ts`
- `auth/ui/v2/apps/login/src/lib/actions/oidc.test.ts`
- `auth/ui/v2/apps/login/src/lib/actions/oidc.ts`
- `auth/ui/v2/apps/login/src/lib/actions/otp.test.ts`
- `auth/ui/v2/apps/login/src/lib/actions/otp.ts`
- `auth/ui/v2/apps/login/src/lib/actions/passkeys.test.ts`
- `auth/ui/v2/apps/login/src/lib/actions/passkeys.ts`
- `auth/ui/v2/apps/login/src/lib/actions/password-send.test.ts`
- `auth/ui/v2/apps/login/src/lib/actions/password.test.ts`
- `auth/ui/v2/apps/login/src/lib/actions/password.ts`
- `auth/ui/v2/apps/login/src/lib/actions/register-idp-flow.test.ts`
- `auth/ui/v2/apps/login/src/lib/actions/register.test.ts`
- `auth/ui/v2/apps/login/src/lib/actions/register.ts`
- `auth/ui/v2/apps/login/src/lib/actions/session.test.ts`
- `auth/ui/v2/apps/login/src/lib/actions/session.ts`
- `auth/ui/v2/apps/login/src/lib/actions/u2f.test.ts`
- `auth/ui/v2/apps/login/src/lib/actions/u2f.ts`
- `auth/ui/v2/apps/login/src/lib/actions/verify.test.ts`
- `auth/ui/v2/apps/login/src/lib/actions/verify.ts`
- `auth/ui/v2/apps/login/src/lib/client-utils.test.ts`
- `auth/ui/v2/apps/login/src/lib/client-utils.ts`
- `auth/ui/v2/apps/login/src/lib/constants.ts`
- `auth/ui/v2/apps/login/src/lib/i18n.ts`
- `auth/ui/v2/apps/login/src/lib/idp-errors.test.ts`
- `auth/ui/v2/apps/login/src/lib/idp-errors.ts`
- `auth/ui/v2/apps/login/src/lib/idp.test.ts`
- `auth/ui/v2/apps/login/src/lib/idp.ts`
- `auth/ui/v2/apps/login/src/lib/legal-links.test.ts`
- `auth/ui/v2/apps/login/src/lib/legal-links.ts`
- `auth/ui/v2/apps/login/src/lib/server/api.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/api.ts`
- `auth/ui/v2/apps/login/src/lib/server/auth-flow.ts`
- `auth/ui/v2/apps/login/src/lib/server/auth-utils.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/auth-utils.ts`
- `auth/ui/v2/apps/login/src/lib/server/cache.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/cache.ts`
- `auth/ui/v2/apps/login/src/lib/server/challenges.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/challenges.ts`
- `auth/ui/v2/apps/login/src/lib/server/cookies.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/cookies.ts`
- `auth/ui/v2/apps/login/src/lib/server/csp.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/csp.ts`
- `auth/ui/v2/apps/login/src/lib/server/custom-headers.ts`
- `auth/ui/v2/apps/login/src/lib/server/demos.ts`
- `auth/ui/v2/apps/login/src/lib/server/deployment.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/deployment.ts`
- `auth/ui/v2/apps/login/src/lib/server/device-code-check.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/device-code-check.ts`
- `auth/ui/v2/apps/login/src/lib/server/enrollment-guard.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/enrollment-guard.ts`
- `auth/ui/v2/apps/login/src/lib/server/fingerprint.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/fingerprint.ts`
- `auth/ui/v2/apps/login/src/lib/server/flow-initiation.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/flow-initiation.ts`
- `auth/ui/v2/apps/login/src/lib/server/grpc/interceptors/error-classification.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/grpc/interceptors/error-classification.ts`
- `auth/ui/v2/apps/login/src/lib/server/grpc/interceptors/otel.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/grpc/interceptors/otel.ts`
- `auth/ui/v2/apps/login/src/lib/server/grpc/interceptors/retry.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/grpc/interceptors/retry.ts`
- `auth/ui/v2/apps/login/src/lib/server/host.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/host.ts`
- `auth/ui/v2/apps/login/src/lib/server/idp-flow-proof.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/idp-flow-proof.ts`
- `auth/ui/v2/apps/login/src/lib/server/idp-linking.ts`
- `auth/ui/v2/apps/login/src/lib/server/idp-session.ts`
- `auth/ui/v2/apps/login/src/lib/server/instance-roles.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/instance-roles.ts`
- `auth/ui/v2/apps/login/src/lib/server/logger.ts`
- `auth/ui/v2/apps/login/src/lib/server/merge-messages.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/merge-messages.ts`
- `auth/ui/v2/apps/login/src/lib/server/metrics.ts`
- `auth/ui/v2/apps/login/src/lib/server/mfa-helper.ts`
- `auth/ui/v2/apps/login/src/lib/server/next-url.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/next-url.ts`
- `auth/ui/v2/apps/login/src/lib/server/oidc.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/oidc.ts`
- `auth/ui/v2/apps/login/src/lib/server/reauthenticate.ts`
- `auth/ui/v2/apps/login/src/lib/server/saml.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/saml.ts`
- `auth/ui/v2/apps/login/src/lib/server/security-settings.ts`
- `auth/ui/v2/apps/login/src/lib/server/service-url.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/service-url.ts`
- `auth/ui/v2/apps/login/src/lib/server/service.ts`
- `auth/ui/v2/apps/login/src/lib/server/session-cookie-signature.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/session-cookie-signature.ts`
- `auth/ui/v2/apps/login/src/lib/server/session-cookie.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/session-cookie.ts`
- `auth/ui/v2/apps/login/src/lib/server/session.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/session.ts`
- `auth/ui/v2/apps/login/src/lib/server/signed-proof.ts`
- `auth/ui/v2/apps/login/src/lib/server/verification-check.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/verification-check.ts`
- `auth/ui/v2/apps/login/src/lib/server/verification-email.ts`
- `auth/ui/v2/apps/login/src/lib/server/verify-credentials.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/verify-credentials.ts`
- `auth/ui/v2/apps/login/src/lib/server/verify-helper.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/verify-helper.ts`
- `auth/ui/v2/apps/login/src/lib/server/zitadel.test.ts`
- `auth/ui/v2/apps/login/src/lib/server/zitadel.ts`
- `auth/ui/v2/apps/login/src/lib/theme-hooks.ts`
- `auth/ui/v2/apps/login/src/lib/theme.test.ts`
- `auth/ui/v2/apps/login/src/lib/theme.ts`
- `auth/ui/v2/apps/login/src/lib/themeUtils.tsx`
- `auth/ui/v2/apps/login/src/proxy.ts`
- `auth/ui/v2/apps/login/src/styles/globals.scss`
- `auth/ui/v2/apps/login/tailwind.config.mjs`
- `auth/ui/v2/apps/login/test-mocks/server-only.ts`
- `auth/ui/v2/apps/login/test-setup.ts`
- `auth/ui/v2/apps/login/test-theme.js`
- `auth/ui/v2/apps/login/tsconfig.build.json`
- `auth/ui/v2/apps/login/tsconfig.json`
- `auth/ui/v2/apps/login/vercel.json`
- `auth/ui/v2/apps/login/vitest.config.dockerized.ts`
- `auth/ui/v2/apps/login/vitest.config.ts`
- `auth/ui/v2/buf.gen.yaml`
- `auth/ui/v2/buf.work.yaml`
- `auth/ui/v2/nx.json`
- `auth/ui/v2/package.json`
- `auth/ui/v2/packages/zitadel-client/.gitignore`
- `auth/ui/v2/packages/zitadel-client/CHANGELOG.md`
- `auth/ui/v2/packages/zitadel-client/README.md`
- `auth/ui/v2/packages/zitadel-client/eslint.config.mjs`
- `auth/ui/v2/packages/zitadel-client/knip.json`
- `auth/ui/v2/packages/zitadel-client/node/package.json`
- `auth/ui/v2/packages/zitadel-client/package.json`
- `auth/ui/v2/packages/zitadel-client/project.json`
- `auth/ui/v2/packages/zitadel-client/src/helpers.ts`
- `auth/ui/v2/packages/zitadel-client/src/index.ts`
- `auth/ui/v2/packages/zitadel-client/src/interceptors.test.ts`
- `auth/ui/v2/packages/zitadel-client/src/interceptors.ts`
- `auth/ui/v2/packages/zitadel-client/src/node.ts`
- `auth/ui/v2/packages/zitadel-client/src/v1.ts`
- `auth/ui/v2/packages/zitadel-client/src/v2.ts`
- `auth/ui/v2/packages/zitadel-client/src/v3alpha.ts`
- `auth/ui/v2/packages/zitadel-client/src/web.ts`
- `auth/ui/v2/packages/zitadel-client/tsconfig.json`
- `auth/ui/v2/packages/zitadel-client/tsup.config.ts`
- `auth/ui/v2/packages/zitadel-client/v1/package.json`
- `auth/ui/v2/packages/zitadel-client/v2/package.json`
- `auth/ui/v2/packages/zitadel-client/v3alpha/package.json`
- `auth/ui/v2/packages/zitadel-client/web/package.json`
- `auth/ui/v2/packages/zitadel-proto/.gitignore`
- `auth/ui/v2/packages/zitadel-proto/.npmignore`
- `auth/ui/v2/packages/zitadel-proto/.nxignore`
- `auth/ui/v2/packages/zitadel-proto/CHANGELOG.md`
- `auth/ui/v2/packages/zitadel-proto/README.md`
- `auth/ui/v2/packages/zitadel-proto/buf.gen.yaml`
- `auth/ui/v2/packages/zitadel-proto/package.json`
- `auth/ui/v2/packages/zitadel-proto/project.json`
- `auth/ui/v2/pnpm-lock.yaml`
- `auth/ui/v2/pnpm-workspace.yaml`
- `auth/ui/v2/proto/AGENTS.md`
- `auth/ui/v2/proto/buf.lock`
- `auth/ui/v2/proto/buf.yaml`
- `auth/ui/v2/proto/zitadel/action.proto`
- `auth/ui/v2/proto/zitadel/action/v2/action_service.proto`
- `auth/ui/v2/proto/zitadel/action/v2/execution.proto`
- `auth/ui/v2/proto/zitadel/action/v2/query.proto`
- `auth/ui/v2/proto/zitadel/action/v2/target.proto`
- `auth/ui/v2/proto/zitadel/action/v2beta/action_service.proto`
- `auth/ui/v2/proto/zitadel/action/v2beta/execution.proto`
- `auth/ui/v2/proto/zitadel/action/v2beta/query.proto`
- `auth/ui/v2/proto/zitadel/action/v2beta/target.proto`
- `auth/ui/v2/proto/zitadel/admin.proto`
- `auth/ui/v2/proto/zitadel/analytics/v2beta/telemetry.proto`
- `auth/ui/v2/proto/zitadel/analytics/v2beta/telemetry_service.proto`
- `auth/ui/v2/proto/zitadel/app.proto`
- `auth/ui/v2/proto/zitadel/app/v2beta/api.proto`
- `auth/ui/v2/proto/zitadel/app/v2beta/app.proto`
- `auth/ui/v2/proto/zitadel/app/v2beta/app_service.proto`
- `auth/ui/v2/proto/zitadel/app/v2beta/login.proto`
- `auth/ui/v2/proto/zitadel/app/v2beta/oidc.proto`
- `auth/ui/v2/proto/zitadel/app/v2beta/saml.proto`
- `auth/ui/v2/proto/zitadel/application/v2/api.proto`
- `auth/ui/v2/proto/zitadel/application/v2/application.proto`
- `auth/ui/v2/proto/zitadel/application/v2/application_service.proto`
- `auth/ui/v2/proto/zitadel/application/v2/login.proto`
- `auth/ui/v2/proto/zitadel/application/v2/oidc.proto`
- `auth/ui/v2/proto/zitadel/application/v2/saml.proto`
- `auth/ui/v2/proto/zitadel/auth.proto`
- `auth/ui/v2/proto/zitadel/auth_n_key.proto`
- `auth/ui/v2/proto/zitadel/authorization/v2/authorization.proto`
- `auth/ui/v2/proto/zitadel/authorization/v2/authorization_service.proto`
- `auth/ui/v2/proto/zitadel/authorization/v2beta/authorization.proto`
- `auth/ui/v2/proto/zitadel/authorization/v2beta/authorization_service.proto`
- `auth/ui/v2/proto/zitadel/change.proto`
- `auth/ui/v2/proto/zitadel/docs/zitadel-md.tmpl`
- `auth/ui/v2/proto/zitadel/event.proto`
- `auth/ui/v2/proto/zitadel/feature.proto`
- `auth/ui/v2/proto/zitadel/feature/v2/feature.proto`
- `auth/ui/v2/proto/zitadel/feature/v2/feature_service.proto`
- `auth/ui/v2/proto/zitadel/feature/v2/instance.proto`
- `auth/ui/v2/proto/zitadel/feature/v2/organization.proto`
- `auth/ui/v2/proto/zitadel/feature/v2/system.proto`
- `auth/ui/v2/proto/zitadel/feature/v2/user.proto`
- `auth/ui/v2/proto/zitadel/feature/v2beta/feature.proto`
- `auth/ui/v2/proto/zitadel/feature/v2beta/feature_service.proto`
- `auth/ui/v2/proto/zitadel/feature/v2beta/instance.proto`
- `auth/ui/v2/proto/zitadel/feature/v2beta/organization.proto`
- `auth/ui/v2/proto/zitadel/feature/v2beta/system.proto`
- `auth/ui/v2/proto/zitadel/feature/v2beta/user.proto`
- `auth/ui/v2/proto/zitadel/filter/v2/filter.proto`
- `auth/ui/v2/proto/zitadel/filter/v2beta/filter.proto`
- `auth/ui/v2/proto/zitadel/idp.proto`
- `auth/ui/v2/proto/zitadel/idp/v2/idp.proto`
- `auth/ui/v2/proto/zitadel/idp/v2/idp_service.proto`
- `auth/ui/v2/proto/zitadel/instance.proto`
- `auth/ui/v2/proto/zitadel/instance/v2/instance.proto`
- `auth/ui/v2/proto/zitadel/instance/v2/instance_service.proto`
- `auth/ui/v2/proto/zitadel/instance/v2beta/instance.proto`
- `auth/ui/v2/proto/zitadel/instance/v2beta/instance_service.proto`
- `auth/ui/v2/proto/zitadel/internal_permission/v2/internal_permission_service.proto`
- `auth/ui/v2/proto/zitadel/internal_permission/v2/query.proto`
- `auth/ui/v2/proto/zitadel/internal_permission/v2beta/internal_permission_service.proto`
- `auth/ui/v2/proto/zitadel/internal_permission/v2beta/query.proto`
- `auth/ui/v2/proto/zitadel/management.proto`
- `auth/ui/v2/proto/zitadel/member.proto`
- `auth/ui/v2/proto/zitadel/message.proto`
- `auth/ui/v2/proto/zitadel/metadata.proto`
- `auth/ui/v2/proto/zitadel/metadata/v2/metadata.proto`
- `auth/ui/v2/proto/zitadel/metadata/v2beta/metadata.proto`
- `auth/ui/v2/proto/zitadel/milestone/v1/milestone.proto`
- `auth/ui/v2/proto/zitadel/object.proto`
- `auth/ui/v2/proto/zitadel/object/v2/object.proto`
- `auth/ui/v2/proto/zitadel/object/v2beta/object.proto`
- `auth/ui/v2/proto/zitadel/object/v3alpha/object.proto`
- `auth/ui/v2/proto/zitadel/oidc/v2/authorization.proto`
- `auth/ui/v2/proto/zitadel/oidc/v2/oidc_service.proto`
- `auth/ui/v2/proto/zitadel/oidc/v2beta/authorization.proto`
- `auth/ui/v2/proto/zitadel/oidc/v2beta/oidc_service.proto`
- `auth/ui/v2/proto/zitadel/options.proto`
- `auth/ui/v2/proto/zitadel/org.proto`
- `auth/ui/v2/proto/zitadel/org/v2/org.proto`
- `auth/ui/v2/proto/zitadel/org/v2/org_service.proto`
- `auth/ui/v2/proto/zitadel/org/v2/query.proto`
- `auth/ui/v2/proto/zitadel/org/v2beta/org.proto`
- `auth/ui/v2/proto/zitadel/org/v2beta/org_service.proto`
- `auth/ui/v2/proto/zitadel/policy.proto`
- `auth/ui/v2/proto/zitadel/project.proto`
- `auth/ui/v2/proto/zitadel/project/v2/project_service.proto`
- `auth/ui/v2/proto/zitadel/project/v2/query.proto`
- `auth/ui/v2/proto/zitadel/project/v2beta/project_service.proto`
- `auth/ui/v2/proto/zitadel/project/v2beta/query.proto`
- `auth/ui/v2/proto/zitadel/protoc_gen_zitadel/v2/options.proto`
- `auth/ui/v2/proto/zitadel/quota.proto`
- `auth/ui/v2/proto/zitadel/resources/debug_events/v3alpha/debug_events_service.proto`
- `auth/ui/v2/proto/zitadel/resources/debug_events/v3alpha/event.proto`
- `auth/ui/v2/proto/zitadel/resources/debug_events/v3alpha/state.proto`
- `auth/ui/v2/proto/zitadel/resources/object/v3alpha/object.proto`
- `auth/ui/v2/proto/zitadel/resources/user/v3alpha/authenticator.proto`
- `auth/ui/v2/proto/zitadel/resources/user/v3alpha/communication.proto`
- `auth/ui/v2/proto/zitadel/resources/user/v3alpha/query.proto`
- `auth/ui/v2/proto/zitadel/resources/user/v3alpha/user.proto`
- `auth/ui/v2/proto/zitadel/resources/user/v3alpha/user_service.proto`
- `auth/ui/v2/proto/zitadel/resources/userschema/v3alpha/user_schema.proto`
- `auth/ui/v2/proto/zitadel/resources/userschema/v3alpha/user_schema_service.proto`
- `auth/ui/v2/proto/zitadel/saml/v2/authorization.proto`
- `auth/ui/v2/proto/zitadel/saml/v2/saml_service.proto`
- `auth/ui/v2/proto/zitadel/session/v2/challenge.proto`
- `auth/ui/v2/proto/zitadel/session/v2/session.proto`
- `auth/ui/v2/proto/zitadel/session/v2/session_service.proto`
- `auth/ui/v2/proto/zitadel/session/v2beta/challenge.proto`
- `auth/ui/v2/proto/zitadel/session/v2beta/session.proto`
- `auth/ui/v2/proto/zitadel/session/v2beta/session_service.proto`
- `auth/ui/v2/proto/zitadel/settings.proto`
- `auth/ui/v2/proto/zitadel/settings/object/v3alpha/object.proto`
- `auth/ui/v2/proto/zitadel/settings/v2/branding_settings.proto`
- `auth/ui/v2/proto/zitadel/settings/v2/domain_settings.proto`
- `auth/ui/v2/proto/zitadel/settings/v2/legal_settings.proto`
- `auth/ui/v2/proto/zitadel/settings/v2/lockout_settings.proto`
- `auth/ui/v2/proto/zitadel/settings/v2/login_settings.proto`
- `auth/ui/v2/proto/zitadel/settings/v2/password_settings.proto`
- `auth/ui/v2/proto/zitadel/settings/v2/security_settings.proto`
- `auth/ui/v2/proto/zitadel/settings/v2/settings.proto`
- `auth/ui/v2/proto/zitadel/settings/v2/settings_service.proto`
- `auth/ui/v2/proto/zitadel/settings/v2beta/branding_settings.proto`
- `auth/ui/v2/proto/zitadel/settings/v2beta/domain_settings.proto`
- `auth/ui/v2/proto/zitadel/settings/v2beta/legal_settings.proto`
- `auth/ui/v2/proto/zitadel/settings/v2beta/lockout_settings.proto`
- `auth/ui/v2/proto/zitadel/settings/v2beta/login_settings.proto`
- `auth/ui/v2/proto/zitadel/settings/v2beta/password_settings.proto`
- `auth/ui/v2/proto/zitadel/settings/v2beta/security_settings.proto`
- `auth/ui/v2/proto/zitadel/settings/v2beta/settings.proto`
- `auth/ui/v2/proto/zitadel/settings/v2beta/settings_service.proto`
- `auth/ui/v2/proto/zitadel/system.proto`
- `auth/ui/v2/proto/zitadel/text.proto`
- `auth/ui/v2/proto/zitadel/user.proto`
- `auth/ui/v2/proto/zitadel/user/v2/auth.proto`
- `auth/ui/v2/proto/zitadel/user/v2/email.proto`
- `auth/ui/v2/proto/zitadel/user/v2/idp.proto`
- `auth/ui/v2/proto/zitadel/user/v2/key.proto`
- `auth/ui/v2/proto/zitadel/user/v2/password.proto`
- `auth/ui/v2/proto/zitadel/user/v2/pat.proto`
- `auth/ui/v2/proto/zitadel/user/v2/phone.proto`
- `auth/ui/v2/proto/zitadel/user/v2/query.proto`
- `auth/ui/v2/proto/zitadel/user/v2/user.proto`
- `auth/ui/v2/proto/zitadel/user/v2/user_service.proto`
- `auth/ui/v2/proto/zitadel/user/v2beta/auth.proto`
- `auth/ui/v2/proto/zitadel/user/v2beta/email.proto`
- `auth/ui/v2/proto/zitadel/user/v2beta/idp.proto`
- `auth/ui/v2/proto/zitadel/user/v2beta/password.proto`
- `auth/ui/v2/proto/zitadel/user/v2beta/phone.proto`
- `auth/ui/v2/proto/zitadel/user/v2beta/query.proto`
- `auth/ui/v2/proto/zitadel/user/v2beta/user.proto`
- `auth/ui/v2/proto/zitadel/user/v2beta/user_service.proto`
- `auth/ui/v2/proto/zitadel/v1.proto`
- `auth/ui/v2/proto/zitadel/webkey/v2/key.proto`
- `auth/ui/v2/proto/zitadel/webkey/v2/webkey_service.proto`
- `auth/ui/v2/proto/zitadel/webkey/v2beta/key.proto`
- `auth/ui/v2/proto/zitadel/webkey/v2beta/webkey_service.proto`
### core ? 2 files
- `core/backend/zitadel/README.md`
- `core/backend/zitadel/dev.py`
### deployment ? 2 files
- `deployment/README.md`
- `deployment/docker/compose.backend.dev.yaml`
### docs ? 12 files
- `docs/ARCHITECTURE.md`
- `docs/DEVELOPMENT.md`
- `docs/FEATURES-STATUS.md`
- `docs/MINIFEST.md`
- `docs/P02-EVIDENCE.md`
- `docs/P03-SOURCE-IMPORT.md`
- `docs/P04-ACCOUNT-PORTAL.md`
- `docs/PHASES.md`
- `docs/README.md`
- `docs/SETUP-GUIDE.md`
- `docs/TROUBLESHOOTING.md`
- `docs/USER-GUIDE.md`
### notes ? 4 files
- `notes/CHANGELOG.md`
- `notes/DOCS-01.md`
- `notes/MINIFEST.md`
- `notes/README.md`
### packages ? 1 files
- `packages/README.md`
### project ? 9 files
- `project/ARCHITECTURE.md`
- `project/CHANGELOG.md`
- `project/FEATURES-AND-PAGES.md`
- `project/FILE-MAP.md`
- `project/FUNCTIONS.md`
- `project/MINIFEST.md`
- `project/README.md`
- `project/SETUP-AND-DEPENDENCIES.md`
- `project/SOURCE-INVENTORY.md`
### scripts ? 1 files
- `scripts/README.md`
### tests ? 2 files
- `tests/README.md`
- `tests/test_backend_dev.py`
### users ? 23 files
- `users/ui/.env.example`
- `users/ui/.gitignore`
- `users/ui/README.md`
- `users/ui/next-env.d.ts`
- `users/ui/next.config.ts`
- `users/ui/package.json`
- `users/ui/src/app/(protected)/account/page.tsx`
- `users/ui/src/app/(protected)/account/profile/page.tsx`
- `users/ui/src/app/(protected)/account/security/page.tsx`
- `users/ui/src/app/(protected)/layout.tsx`
- `users/ui/src/app/api/account/me/route.ts`
- `users/ui/src/app/api/auth/[...nextauth]/route.ts`
- `users/ui/src/app/layout.tsx`
- `users/ui/src/app/page.tsx`
- `users/ui/src/app/signin/page.tsx`
- `users/ui/src/auth.ts`
- `users/ui/src/components/account-card.tsx`
- `users/ui/src/components/account-shell.tsx`
- `users/ui/src/lib/env.ts`
- `users/ui/src/lib/identity.ts`
- `users/ui/src/styles/globals.css`
- `users/ui/src/types/next-auth.d.ts`
- `users/ui/tsconfig.json`