feat(docs): database documentation viewer and DBML export
* feat(docs): add SchemaSnapshot model * feat(docs): infer relationship cardinality from foreign keys * fix(docs): resolve foreign keys within the source schema * feat(docs): convert group hue to sRGB hex for DBML * feat(docs): add DBML lexical primitives * feat(docs): render DBML table blocks * feat(docs): render DBML refs, enums and table groups * feat(docs): assemble complete DBML documents * feat(docs): collect schema snapshots with bounded fan-out * fix(docs): gate FK warning on engine capability and reference synthesized enums * fix(docs): qualify synthesized enum references in multi-schema output * test(docs): anchor the multi-schema enum reference assertion * feat(docs): add snapshot collection route * feat(docs): add collect_docs_snapshot to DbxBackend * feat(docs): add dbx dbml command * test(docs): add live snapshot and DBML verification Runs collect_snapshot + to_dbml against a real PostgreSQL database (organon, 47 tables) and asserts structural DBML validity: Project header, every table present, balanced braces, trailing newline. * refactor(docs): use sort_by_key for snapshot table ordering * docs(docs): add database documentation design and implementation plan Records the Part 1 design (SchemaSnapshot + DBML export) and the plan that produced it. The plan carries an appendix listing the thirteen assumptions that proved wrong during execution, so the corrected facts are not re-derived from the surrounding prose. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TKcC15gEuQBHMidPCFFYwn * fix(docs): use native enum names, canonical engine labels, and surface metadata failures Final review fix wave covering four findings: - PostgreSQL named enums (e.g. `ConversationStatus`) now keep their own type name and synthesized: false, instead of being renamed to `{table}_{column}` and losing identity. A type shared by several columns now dedupes to a single Enum block instead of colliding or duplicating. `synthesize_enum` and `render_type` route through one shared `enum_type_name` helper so the two can't drift apart again. - `database_type` (and the CommentsUnsupported/NoForeignKeyMetadata warnings) now use the same canonical engine label already used throughout table_structure_sql's own warning prose, instead of a raw Rust Debug string (`Postgres`, `SqlServer`, `MongoDb`). - An index-fetch failure during collection now surfaces as a TableSkipped warning instead of silently degrading to an empty index list, which relations.rs uses to infer relationship cardinality. - A schema-enumeration failure now surfaces as a warning instead of silently proceeding against schema "". - Removed the redundant Arc<Semaphore>; buffer_unordered already caps concurrency at MAX_CONCURRENT_TABLES. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TKcC15gEuQBHMidPCFFYwn * feat(docs): add annotation file model * test(docs): assert full round-trip fidelity for the annotation model * feat(docs): add per-engine annotation key folding * fix(docs): do not fold identifiers on case-sensitive engines * feat(docs): load and validate the notes file * fix(docs): report a version mismatch before unknown-field errors * feat(docs): merge annotations into the schema snapshot * feat(docs): detect orphaned annotations without deleting them * feat(docs): add --notes to dbx dbml * feat(docs): remember a notes file path per connection Adds docs_notes_path to ConnectionConfig so the desktop app (Part 3) can persist where a connection's documentation notes file lives. The CLI is unaffected — it takes an explicit --notes path. ConnectionConfig has a hand-written Deserialize impl that delegates to a mirror struct, ConnectionConfigData, and converts via From. Adding the field only to ConnectionConfig would compile but never populate from stored JSON, since ConnectionConfigData's fields are what serde actually reads. The field is threaded through all three places: ConnectionConfig, ConnectionConfigData, and the From impl, mirroring the existing `color` field. * test(docs): verify annotations against a live database * test(docs): assert exactly one orphaned annotation * feat(docs): add snapshot types for the docs viewer * fix(docs): correct snapshot type nullability and add missing column fields * feat(docs): add a real-output fixture and drift conformance test The fixture is generated by dump_docs_fixture.rs from a live collect_snapshot run against the keycloak database in the shared local-infra stack, with annotations applied so a LOCAL note, column note, group and orphanedNotes warning are all present. fixtureConformance.spec.ts asserts against that real JSON rather than a hand-written literal, so a change to the Rust snapshot shape breaks the test instead of silently drifting from the hand-maintained types.ts. Keycloak is used because its schema is public open-source knowledge, so the committed fixture carries no private schema. The kept tables are an explicit allowlist rather than an alphabetical slice, because the conformance test needs a connected foreign-key subgraph: protocol_mapper has two foreign keys to different tables and composite_role has two to the same one. * feat(docs): add index grouping for the docs viewer * feat(docs): describe snapshot warnings for the viewer * feat(docs): add client-side search for the docs viewer * test(docs): make the search fixture able to fail * feat(docs): expose group hue as a CSS custom property * docs(plan): add annotations and viewer plans, correct Task 7 Parts 2 and 3a were planned after the first plan was committed and were never tracked. docs/superpowers/ is gitignored, so both needed -f, matching how the existing specs and plans in that directory were added. The viewer plan's Task 7 is corrected against the installed marked@18.0.4. Its original text carried four defects, found by probing the library rather than by review: an assertion that fails against a correct implementation, a pre-escaping approach that double-escapes entities, a javascript: blocklist with live bypasses (entity-encoded, vbscript:, data:text/html, and <img src>, which was never covered at all), and a link renderer whose text property is raw markdown source rather than parsed HTML — an XSS hole found while verifying the fix for the previous defect. The viewer plan also gains a corrections appendix grouping defects by failure mode. The annotations plan is committed as written; its defects are recorded in a follow-up. * feat(docs): render note markdown with raw HTML escaped * fix(docs): drop protocol-relative URLs in note markdown The URL allowlist permitted anything starting with / so relative paths work, and //evil.com qualifies. Over https that grants nothing a note author could not do with an ordinary https link, but the Part 3b standalone export is opened via file://, where //host/path is a UNC path. On Windows that opens an SMB connection and leaks an NTLM hash, with no click required since images auto-load, and it is plantable from a COMMENT ON value. Found by an adversarial probe of the committed module rather than by review; the backslash form was already dropped, only the slash form slipped through. * docs(plan): add corrections appendix to the annotations plan Groups the defects found executing Part 2 by failure mode, matching the form of the viewer plan's appendix. The notable one is Mode A: docs_notes_path had to be added in three places because ConnectionConfig has a serde mirror struct, and adding it in one place compiles, passes a round-trip test written against the same struct, and then reads None forever after every load. Also records a controller hypothesis that turned out to be wrong, since checking it cost one read. * fix(docs): reject backslash protocol-relative URLs in notes The // guard from the previous commit was itself a blocklist: /\evil.com starts with a single slash, so it passed, and the WHATWG URL spec treats /\ identically to // for special schemes. Browsers normalise the backslash, so it reaches the same file:// UNC path and the same no-click NTLM leak. Rejecting both separator characters in both positions closes it. Found by probing what String(raw).trim() leaves unnormalised before the prefix checks; the third defect on this file found by probing rather than by reading. * feat(docs): add docs viewer components Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TKcC15gEuQBHMidPCFFYwn * test(docs): pin each theme's legacy colour base independently The ordering check indexOf(hsl) < indexOf(@supports) quantified over any occurrence, so deleting the light .docs-group block left the dark block's hsl satisfying it. The test passed while every table group rendered colourless on light-theme WebViews without oklch. Asserting each selector's own base block catches deleting either one. Found by the task implementer, which deleted one block and then both to show the guard pinned 'some base exists' rather than 'each selector has a base'. * fix(docs): escape single quotes in note attribute values escapeHtml covered & < > and double quotes but not single quotes. Not exploitable today because every attribute in this file is double-quoted, but that is a formatting convention enforced nowhere and living in a different part of the file from the escaper. A future edit writing title='...' would turn a formatting choice into an attribute breakout. Raised by review as latent fragility rather than a defect; fixed because the escaper should be correct on its own rather than correct-given-an-invariant. * test(docs): match single-quoted v-html bindings in the contract guard The guard matched /v-html\s*=\s*"([^"]*)"/ — double quotes only. A binding written `v-html='table.note'` produced zero matches and passed, handing a database COMMENT ON value straight to the DOM with the renderNote sanitiser bypassed. Both quote styles are valid Vue and nothing in the repo enforces one, so the guard had a hole exactly where it mattered most. Verified by temporarily rewriting a real WikiIndex binding as `v-html='table.note'`: the test now fails with "WikiIndex.vue: v-html must render renderNote output: expected 'table.note' to contain 'renderNote'". Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TKcC15gEuQBHMidPCFFYwn * fix(docs): cap search results per kind instead of overall DocsSearch sliced searchDocs output to 40 AFTER concatenation, and the concatenation order is tables -> columns -> groups -> enums. Columns always flooded the list, so the cap deleted the tail — every group and enum hit. Against the real fixture, "e" produced 155 hits (9 table, 133 column, 1 group, 12 enum) and rendered 9 tables, 31 columns and nothing else; groups and enums were structurally unreachable through search. Cap each kind against its own limit inside docsSearch.ts, where the logic is tested, and drop the slice from the template so exactly one place limits results. Ranking is unchanged: tables still precede columns. Verified by reverting to a single .slice(0, 40) over the concatenation: the new tests fail with "enums must survive a column flood: expected false to be true" and "expected 30 to be 20". Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TKcC15gEuQBHMidPCFFYwn * fix(docs): move the index card note out of its button The card rendered renderNote output with v-html inside the <button>. A note containing a markdown link — [spec](https://example.com) — put an <a> inside a <button>: invalid nesting, and the anchor was not keyboard reachable because the button swallows it in the tab order. The <li> now carries the card's border, background and hover, the button holds only the table name and kind, and the note is its sibling. Visually identical — same padding, same 0.5 gap, previously mt-0.5 — and the name row still spans the full width as the click target. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TKcC15gEuQBHMidPCFFYwn * test(docs): pin every fixture struct's key set in both directions The guard pinned ColumnInfo and IndexInfo plus three DocTable keys, and only in the "no missing key" direction. Relationship, FieldRef, DocEnum, ProjectMeta, ColumnNote, ForeignKeyInfo, TableGroup and 10 of 13 DocTable keys were unchecked. Renaming Relationship::to to `target` in Rust kept the suite at 67/67 and vue-tsc at exit 0 while RelationshipList read `field.table` on undefined and every table page rendered blank. Every struct in the fixture is now pinned both ways — no missing key, no unexpected key — over every instance rather than element [0]. Each direction catches a different half of a rename. Object.hasOwn throughout, so a key that is present and null stays distinguishable from one skip_serializing_if omitted. ForeignKeyInfo, TableGroup and the SchemaSnapshot root are included beyond the list the review gave: they are equally present in the fixture and equally unpinned. Verified against a modified copy of the fixture outside the repo with Relationship::to renamed: "Relationship[0] must always carry to: expected false to be true". Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TKcC15gEuQBHMidPCFFYwn * fix(cli): error when an explicit --notes path does not exist load_annotations returns Ok(None) for a missing file, which is right for the implicit per-connection notes path — it may legitimately not exist yet. It is wrong for --notes, where the user named a specific file: a mistyped path produced DBML with every note silently absent and no diagnostic at all, indistinguishable from a database that has no documentation. Both final reviewers independently ruled this must-fix-before-merge. * fix(docs): treat an explicit FK ref_schema as authoritative find_target tried the explicit ref_schema, then fell through to the source table's own schema on failure. When the referenced schema was not collected — routine, since users select schemas — an FK from sales.orders to archive.customers resolved to sales.customers instead: a different table, and a diagram that is confidently wrong rather than visibly incomplete. The function's own doc comment already promised that keys pointing outside the collected set are dropped. Now it does that. This is a regression of the defect found in Part 1: the three-tier lookup was added then, but tier one was written to fall through rather than to decide. * fix(docs): corroborate engine capability warnings against what was collected supports_comments and supports_foreign_keys delegate to the structure editor's DDL-generation capabilities, not to introspection support. IRIS is the proven divergence: it reports %DESCRIPTION on introspection but DBX cannot ALTER an existing one, so the flag is false while the collector reads and includes those comments — producing a snapshot that warned comments were unsupported alongside the comments themselves. Each warning now fires only when the flag says the engine cannot AND collection found nothing of the kind to contradict it. ClickHouse and Doris, which genuinely report no foreign keys, still warn. The doc comments now say what the functions actually measure. Found by final review, which traced every other caller to establish the flag's real semantics. * docs(fixture): finish repointing the fixture source to keycloak Follows the rebase that replaced the fixture at its origin commit. Repoints the live annotation test's project identity and both plans, and records the one capability keycloak costs us. Keycloak declares no PostgreSQL enum types, so the fixture cannot exercise DocEnum — a Rust-side rename of a DocEnum field would pass every test here and break the viewer's enum rendering silently. Rather than delete the test, it now asserts the gap, so it fails the day the fixture source gains an enum and prompts restoring the pin. * docs(spec): design for in-app database documentation (Part 3b) Mounts the Part 3a viewer in DBX and makes it editable: table/column notes, table groups, and per-group colour, autosaved to a notes file that can live in the user's repository. Two findings shaped the scope. DBX already ships SchemaDiagramDialog, so the viewer links to it rather than building a second ER diagram — only the Part 3c export needs its own minimal renderer, because that dialog reaches into stores and cannot be inlined. And nothing currently reads docs_notes_path or writes annotations at all, so 'in-app editing' needs new Rust rather than frontend wiring alone. The standalone export, dbx docs verb and hash routing are deferred to 3c. * docs(plan): implementation plan for in-app database documentation Ten tasks: atomic annotation save and path resolution, Tauri commands, web route parity, the frontend facade, pure edit transforms, the i18n namespace with a parity guard, editing components, the enum page, edit plumbing through the viewer, and the dialog with debounced autosave. Self-review caught three defects before dispatch, all the same class that cost Part 3a ten fix rounds: a return type named DescribedWarning that does not exist (it is WarningNotice), a test calling emptySnapshot() which does not exist, and a table() helper invoked with columns when its real signature takes a groupId. Every identifier the plan names is a claim about the codebase. * docs(plan): resolve the data directory without a dbx-mcp dependency Tasks 2 and 3 called dbx_mcp::paths::app_data_dir(), but neither src-tauri nor dbx-web depends on dbx-mcp, so neither would have compiled. Both already have a better source: AppState.storage.data_dir() honours a custom data dir, and WebState already carries data_dir. Found by the pre-flight scan before any implementer saw it. * docs(plan): fix Task 1 against the real crate (no Default, no tempfile) ConnectionConfig has no Default derive and ~60 fields, so resolve_notes_path now takes the connection id and the optional override directly — the two fields it actually reads. The test pain was pointing at the signature. dbx-core has no dev-dependencies, so the tests use the temp_dir + uuid idiom already present in annotations.rs rather than tempfile. * feat(docs): add atomic annotation save and notes path resolution * docs(plan): guard the autosave against concurrent writes flush() cleared the debounce timer but not an in-flight write, so closing the dialog while a debounced save was awaiting the backend started a second one. Two concurrent saves of the same file waste a round trip, race to land stale, and are the exact concurrency that corrupts the notes file when the temp path is not unique per writer. Found while adjudicating the Task 1 review, which demonstrated the Rust half of the same problem. * fix(docs): make temp paths unique to prevent concurrent save corruption * fix(docs): replace vacuous atomicity test with inode-based verification * docs(plan): correct the apply_annotations import path dbx_core::docs re-exports collector, color, dbml, keys, relations and snapshot but NOT annotations, so apply_annotations and friends are only reachable at dbx_core::docs::annotations. Tasks 2 and 3 both used the shorter path and would not have compiled. Verified against crates/dbx-core/src/docs/mod.rs before either was dispatched. * fix(docs): truncate temp filename to stay within 255-byte filesystem limit * feat(docs): add Tauri commands for docs snapshot and annotations * docs(plan): propagate the resolve_notes_path signature to its callers Pre-flight changed resolve_notes_path to take (connection_id, docs_notes_path, data_dir) instead of a ConnectionConfig, but only Task 1 was updated. Tasks 2 and 3 still called it with the old signature and would not have compiled. The Task 2 implementer caught it and used the correct form from its dispatch note. Task 3 had the identical stale call and had not been dispatched yet. The plan's self-review checks signature consistency across tasks; this changed AFTER that review, during pre-flight, and nothing re-ran the check. * docs(plan): pin Task 4's http.ts idiom and the Tauri argument names http.ts uses a post<T>(url, body) helper at line 222; the plan said only 'match the existing idiom', which is delegating verification to someone with less context. Written out concretely now. Also records what Task 2's review flagged as unverifiable from its own diff: Tauri serialises command arguments by name, so the invoke object keys must match the Rust parameter names. That mismatch compiles cleanly on both sides and fails only when a user clicks — and it falls in the gap between two task-scoped reviews, since neither diff contains both halves. * feat(docs): add web routes for annotation load, apply and save Mirrors the Tauri commands (docs_load_annotations, docs_apply_annotations, docs_save_annotations) added in the previous task: collect returns the raw snapshot, apply is separate so the shadowedNote rule stays in one place. * docs(plan): make the i18n parity guard actually observable Every non-English locale is export default withEnglishFallback({...}) — the fallback is applied at module level, inside the locale file. Only en.ts is a bare object. So importing a locale's default export yields the ALREADY-MERGED object, and the parity test would have found every key present in every locale and passed while translations were missing. The test written to catch silent English fallback would have been silently defeated by that fallback. Task 6 now puts the new namespace in per-locale modules under locales/docs/, which the test imports directly and unwrapped. Scoped entirely to the new namespace; the existing 315 KB of keys are untouched. Step 6 also asks the implementer to demonstrate the trap: point the imports back at the merged modules and watch a missing key pass. * feat(docs): expose docs snapshot and annotations to the frontend * docs(plan): locate the duplicated table-key rule correctly in Task 8 The plan said docsIndex.ts builds the qualified table key inline. It does not — it groups by table.schema, a section key. The table key rule lives in a private qualified() in docsSearch.ts and in a hand-rolled tableKey() in DocsApp.vue, DocsSidebar.vue and WikiIndex.vue. Part 3a's final review flagged that duplication as a Minor and it was deferred. Task 8 was about to add a fifth copy, so it now extracts docsKeys.ts first and replaces the existing ones. This is the key annotations are stored under, so two call sites disagreeing attaches a note to the wrong table. * feat(docs): add pure annotation edit transforms * docs(plan): ground the group hue picker in DBX's existing swatch idiom ConnectionDialog.vue already has a swatch row — h-6 w-6 rounded-full buttons, ring-2 selected state, i18n titles. Task 7 now points at it so the new picker looks native. With an explicit warning not to copy the fill mechanism: connection colours are hex painted via Tailwind classes, group colours are hues rendered through docs.css. A naive copy introduces hex literals and fails the contract test — correctly, since a hardcoded hex cannot stay legible on both grounds, which is why groups store a hue at all. * docs(plan): make Task 10's dialog wiring concrete Five exact locations, all verified: the store ref and its export, the useDialogSources watcher, the AppDialogs import and render, and the ObjectBrowser trigger plus its context-menu entry. Records the non-obvious part: the watcher clears the source back to null after firing, and that clearing is what makes the dialog re-openable — without it, setting the same value twice does not re-trigger the watch. ObjectBrowser is the entry point rather than the connection tree, because the tree has no diagram entry either and ObjectBrowser already supplies exactly the prefills the docs dialog needs. * feat(docs): add the docs i18n namespace with a parity guard * fix(docs): ban vue-i18n from standalone-exportable docs components WarningBanner.vue used useI18n() directly, which throws with no Vue app instance -- exactly the standalone HTML export case describeWarning's translator parameter exists to avoid. Thread translate as a prop from DocsApp instead, and add vue-i18n/useI18n( to the component contract's forbidden list so the constraint is enforced, not just documented. * docs(plan): note that DocsApp already has snapshot and translate Task 6's fix added translate to DocsApp when describeWarning started taking a translator. Task 9 said to add it, which would have been a duplicate prop. It now says to add only annotations and readonly to the existing defineProps. * feat(docs): add note editor, group editor and group picker * docs(plan): give Task 10 the dialog shell from SchemaDiagramDialog Exact Dialog primitives, the get/set computed every dialog here uses to bridge the open prop, and the sizing class copied verbatim from SchemaDiagramDialog.vue:827 — the docs viewer is the same kind of full-window workspace, not a form, so it should not invent dimensions. Also states explicitly that this component lives outside src/docs/ and so may and must use useI18n(): it is what supplies the translate prop the viewer components need, since they are banned from importing vue-i18n themselves. * test(docs): guard the light-ground group tokens too * feat(docs): add the enum page and a shared table-key helper EnumPage renders an enum's values and every column declared with that type. It is read-only on purpose: AnnotationFile has no `enums` key, so an edited note would have nowhere to be saved. qualifiedTableKey moves the `schema.name` rule — bare name on schema-less engines like SQLite and MySQL — into docsKeys, where the call sites that had each copied it can share one definition. It is the key annotations are stored under, so two call sites disagreeing would attach a note to the wrong table. columnsUsingEnum matches data_type exactly rather than by substring: an enum named `state` would otherwise claim every `estado` and `statement` column. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VTBWnT4goXLA9iqDrfTPqk * refactor(docs): share one qualified table key across the viewer Six call sites had each copied the `schema.name` rule; they now import qualifiedTableKey from docsKeys instead. Two were not in the plan's list: TablePage.vue and RelationshipList.vue. RelationshipList passes a remapped FieldRef rather than a DocTable, which is why the helper takes Pick<DocTable, "schema" | "name"> — that widening is what let every call site be adapted directly instead of keeping a thin delegating wrapper. Also strengthens the columnsUsingEnum substring guard, which was not guarding anything. Its only column had type `integer`, and "integer".includes("state") is false, so replacing the exact match with includes() left all 8 tests green. Adds a `statement` column — the only type here that really contains `state` — and drops `estado` from the doc comment, since it does not. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VTBWnT4goXLA9iqDrfTPqk * feat(docs): thread editing through the viewer as emitted events DocsApp gains `annotations` and `readonly` and re-emits a DocsEdit for every change its children request. Nothing under src/docs/ persists anything, which is what keeps the directory bundleable into the standalone HTML export; a new contract guard now pins that by rejecting any component that names save/load/applyDocsAnnotations. NoteEditor is fed the MERGED snapshot note, not the local annotation layer. It renders and edits one value, so seeding it locally would show nothing for a note that came from a database comment. Writing over one shadows it, which is what noteSource and shadowedNote already exist to disclose. `annotations` is threaded for what the merge erases: `groups` carries the editable GroupAnnotation records, while snapshot.groups carries resolved TableGroups that GroupPicker and GroupEditor cannot write back to. Also makes enums reachable. EnumPage rendered nowhere and search returned enum hits that DocsSearch deliberately disabled, since enums carry no table key; they now navigate by bare name, which is how columnsUsingEnum resolves them too. Groups remain unclickable — they still have no page. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VTBWnT4goXLA9iqDrfTPqk * feat(docs): mount the documentation viewer in DBX with autosaved editing DatabaseDocsDialog hosts DocsApp outside src/docs/, which is what lets it use useI18n() and supply the `translate` prop the viewer components are banned from importing for themselves. It collects the snapshot, loads the notes file (falling back to emptyAnnotations), and holds the raw snapshot so every edit can re-derive the merged view through applyDocsAnnotations. createAutosave debounces writes and, above all, makes a failure visible: a silently swallowed write is the worst outcome here, because the user keeps typing and believes their notes are saved. It also refuses to run two writes at once — flush() clearing the timer does not stop a write already awaiting save, and two concurrent writes of the same file is the exact race that corrupted the notes file before the Rust side used a unique temp path. Both properties are pinned by tests I confirmed fail when the guard is removed. Loads and re-derivations carry a generation number so a slow response cannot overwrite a newer one, and closing flushes the debounce rather than dropping a note typed a moment earlier. Trigger mirrors the schema diagram's wiring: docsSource on connectionStore, a watch in useDialogSources that clears the source so the dialog is re-openable, an async component in AppDialogs, and openDocs in ObjectBrowser. The context entry is added at BOTH object menus — the plan named only the table one, but views offer diagram.open too and documentation is no less relevant there. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VTBWnT4goXLA9iqDrfTPqk * docs(plan): record Tasks 1-10 as done The plan carried 58 unticked boxes after ten completed tasks, so progress had to be reconstructed from the commit trail instead of read off the document. Tasks 1-7 are ticked from that commit evidence rather than from step-by-step observation — they landed in earlier sessions. Tasks 8-10 were executed and verified directly. Task 8 Step 2 stays open on purpose. `columnsUsingEnum` was already implemented and committed before that step was reached, so its failure was never observed; the exact-match guard was verified by Step 5 instead, which is what exposed that the test could not detect a substring match at all. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01VTBWnT4goXLA9iqDrfTPqk * feat(docs): print snapshot warnings as prose from the CLI `dbx dbml` printed `{warning:?}`, so a skipped table surfaced as `TableSkipped { table: "public.orders", reason: "permission denied" }` — the struct shape, reading like a panic rather than like advice. The prose lives in Rust rather than in the `docs.warnings` i18n namespace because the CLI has no i18n runtime. That is the same constraint that made `describeWarning` take a translator instead of importing vue-i18n: the viewer translates, the CLI cannot, so each needs its own source for the same text. A second test asserts the rendering is not the Debug form, because reverting the CLI to `{warning:?}` is a one-character edit that still compiles and still prints something. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Ro4mfGEmsbbH32WYsvxsfH * feat(docs): let a connection point its notes file at a repository `docs_notes_path` has existed on `ConnectionConfig` since Part 2 and has been read by `resolve_notes_path` since Part 3b, but nothing ever set it — so every connection silently used the app data directory default and the override was unreachable. The field is what makes schema documentation reviewable: pointing it at a file inside a repository puts notes in the same diff as the migration that changed the schema. Gated on `isSchemaAware`, matching the row above it, since documentation is a relational-only feature. A cleared field is normalised to absent rather than "" — `resolve_notes_path` treats blank as unset, but an empty string would still be persisted as though a path had been chosen. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Ro4mfGEmsbbH32WYsvxsfH * docs: document database documentation and DBML export Covers opening the viewer, notes and groups, the LOCAL/database-comment rule, the notes file format and where it lives, every warning the viewer can raise, and the `dbx dbml` verb including the CI drift check. States the boundaries explicitly — relational engines only, no triggers or procedures, and DBML export is one-way — because each of those is a question the feature invites and would otherwise be answered by trying it. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Ro4mfGEmsbbH32WYsvxsfH --------- Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com> Co-authored-by: t8y2 <t8y2@users.noreply.github.com>
This commit is contained in:
117 files changed
+18546
-3
No files matched your search
@@ -0,0 +1,45 @@
|
||||
import { describe, expect, it } from "vitest";
|
||||
import en from "../locales/docs/en";
|
||||
import es from "../locales/docs/es";
|
||||
import it_ from "../locales/docs/it";
|
||||
import ja from "../locales/docs/ja";
|
||||
import ko from "../locales/docs/ko";
|
||||
import ptBR from "../locales/docs/pt-BR";
|
||||
import zhCN from "../locales/docs/zh-CN";
|
||||
import zhTW from "../locales/docs/zh-TW";
|
||||
|
||||
// These import the per-locale DOCS modules, NOT ../locales/<name>.
|
||||
//
|
||||
// Every non-English locale file is `export default withEnglishFallback({...})`,
|
||||
// which deep-merges `en` UNDER the locale at module level. Importing those
|
||||
// default exports yields the ALREADY-MERGED object, so every locale appears to
|
||||
// have every key and this test would pass while translations were missing —
|
||||
// the fallback would silently defeat the test written to catch it.
|
||||
const locales: Array<[string, Record<string, unknown>]> = [
|
||||
["es", es],
|
||||
["it", it_],
|
||||
["ja", ja],
|
||||
["ko", ko],
|
||||
["pt-BR", ptBR],
|
||||
["zh-CN", zhCN],
|
||||
["zh-TW", zhTW],
|
||||
];
|
||||
|
||||
function leafKeys(value: unknown, prefix = ""): string[] {
|
||||
if (value === null || typeof value !== "object" || Array.isArray(value)) {
|
||||
return [prefix];
|
||||
}
|
||||
return Object.entries(value as Record<string, unknown>).flatMap(([key, child]) => leafKeys(child, prefix ? `${prefix}.${key}` : key));
|
||||
}
|
||||
|
||||
describe("docs i18n namespace parity", () => {
|
||||
const expected = leafKeys(en as Record<string, unknown>).sort();
|
||||
|
||||
it("english declares the docs namespace", () => {
|
||||
expect(expected.length, "locales/docs/en.ts must declare keys").toBeGreaterThan(0);
|
||||
});
|
||||
|
||||
it.each(locales)("%s declares exactly the same docs keys as en", (_name, locale) => {
|
||||
expect(leafKeys(locale).sort()).toEqual(expected);
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,48 @@
|
||||
export default {
|
||||
title: "Documentation",
|
||||
groupBySchema: "Schemas",
|
||||
groupByTableGroup: "Table Groups",
|
||||
noGroup: "(no group)",
|
||||
noSchema: "(no schema)",
|
||||
search: "Search tables, columns, groups…",
|
||||
columns: "Columns",
|
||||
indexes: "Indexes",
|
||||
references: "References",
|
||||
referencedBy: "Referenced by",
|
||||
localNote: "LOCAL",
|
||||
shadowedComment: "Database comment: {comment}",
|
||||
addNote: "Add a note",
|
||||
editNote: "Edit note",
|
||||
newGroup: "New group…",
|
||||
groupName: "Group name",
|
||||
groupColour: "Colour",
|
||||
deleteGroup: "Delete group",
|
||||
enumValues: "Values",
|
||||
usedBy: "Used by",
|
||||
openDiagram: "Open schema diagram",
|
||||
saving: "Saving…",
|
||||
saved: "Saved",
|
||||
saveFailed: "Could not save notes: {error}",
|
||||
warnings: {
|
||||
tableSkipped: {
|
||||
title: "A table could not be documented",
|
||||
detail: "{table} was skipped: {reason}. It is missing from this documentation.",
|
||||
},
|
||||
noForeignKeyMetadata: {
|
||||
title: "No relationships available",
|
||||
detail: "{engine} does not report foreign key metadata, so no relationship edges could be derived. The diagram is complete for this engine.",
|
||||
},
|
||||
commentsUnsupported: {
|
||||
title: "Database comments unavailable",
|
||||
detail: "{engine} does not support table or column comments, so every description here comes from this project's own notes.",
|
||||
},
|
||||
orphanedNotes: {
|
||||
title: "Some notes no longer match anything",
|
||||
detail: "{count} note(s) refer to a table or column that no longer exists. Nothing was deleted — re-map or remove them in the notes file.",
|
||||
},
|
||||
dbmlOmitted: {
|
||||
title: "Not representable in DBML",
|
||||
detail: "{item} on {table} is documented here but omitted from the exported DBML: {reason}.",
|
||||
},
|
||||
},
|
||||
};
|
||||
@@ -0,0 +1,48 @@
|
||||
export default {
|
||||
title: "Documentación",
|
||||
groupBySchema: "Esquemas",
|
||||
groupByTableGroup: "Grupos de tablas",
|
||||
noGroup: "(sin grupo)",
|
||||
noSchema: "(sin esquema)",
|
||||
search: "Buscar tablas, columnas, grupos…",
|
||||
columns: "Columnas",
|
||||
indexes: "Índices",
|
||||
references: "Referencias",
|
||||
referencedBy: "Referenciado por",
|
||||
localNote: "LOCAL",
|
||||
shadowedComment: "Comentario de la base de datos: {comment}",
|
||||
addNote: "Agregar una nota",
|
||||
editNote: "Editar nota",
|
||||
newGroup: "Nuevo grupo…",
|
||||
groupName: "Nombre del grupo",
|
||||
groupColour: "Color",
|
||||
deleteGroup: "Eliminar grupo",
|
||||
enumValues: "Valores",
|
||||
usedBy: "Usado por",
|
||||
openDiagram: "Abrir diagrama del esquema",
|
||||
saving: "Guardando…",
|
||||
saved: "Guardado",
|
||||
saveFailed: "No se pudieron guardar las notas: {error}",
|
||||
warnings: {
|
||||
tableSkipped: {
|
||||
title: "No se pudo documentar una tabla",
|
||||
detail: "{table} fue omitida: {reason}. Falta en esta documentación.",
|
||||
},
|
||||
noForeignKeyMetadata: {
|
||||
title: "No hay relaciones disponibles",
|
||||
detail: "{engine} no reporta metadatos de claves foráneas, por lo que no se pudieron derivar relaciones. El diagrama está completo para este motor.",
|
||||
},
|
||||
commentsUnsupported: {
|
||||
title: "Comentarios de base de datos no disponibles",
|
||||
detail: "{engine} no admite comentarios en tablas o columnas, por lo que toda descripción aquí proviene de las notas de este proyecto.",
|
||||
},
|
||||
orphanedNotes: {
|
||||
title: "Algunas notas ya no coinciden con nada",
|
||||
detail: "{count} nota(s) hacen referencia a una tabla o columna que ya no existe. No se eliminó nada — vuelva a asignarlas o elimínelas en el archivo de notas.",
|
||||
},
|
||||
dbmlOmitted: {
|
||||
title: "No representable en DBML",
|
||||
detail: "{item} en {table} está documentado aquí pero se omitió del DBML exportado: {reason}.",
|
||||
},
|
||||
},
|
||||
};
|
||||
@@ -0,0 +1,48 @@
|
||||
export default {
|
||||
title: "Documentazione",
|
||||
groupBySchema: "Schemi",
|
||||
groupByTableGroup: "Gruppi di tabelle",
|
||||
noGroup: "(nessun gruppo)",
|
||||
noSchema: "(nessuno schema)",
|
||||
search: "Cerca tabelle, colonne, gruppi…",
|
||||
columns: "Colonne",
|
||||
indexes: "Indici",
|
||||
references: "Riferimenti",
|
||||
referencedBy: "Referenziato da",
|
||||
localNote: "LOCALE",
|
||||
shadowedComment: "Commento del database: {comment}",
|
||||
addNote: "Aggiungi una nota",
|
||||
editNote: "Modifica nota",
|
||||
newGroup: "Nuovo gruppo…",
|
||||
groupName: "Nome del gruppo",
|
||||
groupColour: "Colore",
|
||||
deleteGroup: "Elimina gruppo",
|
||||
enumValues: "Valori",
|
||||
usedBy: "Usato da",
|
||||
openDiagram: "Apri diagramma dello schema",
|
||||
saving: "Salvataggio…",
|
||||
saved: "Salvato",
|
||||
saveFailed: "Impossibile salvare le note: {error}",
|
||||
warnings: {
|
||||
tableSkipped: {
|
||||
title: "Impossibile documentare una tabella",
|
||||
detail: "{table} è stata saltata: {reason}. Manca da questa documentazione.",
|
||||
},
|
||||
noForeignKeyMetadata: {
|
||||
title: "Nessuna relazione disponibile",
|
||||
detail: "{engine} non riporta i metadati delle chiavi esterne, quindi non è stato possibile derivare alcuna relazione. Il diagramma è completo per questo motore.",
|
||||
},
|
||||
commentsUnsupported: {
|
||||
title: "Commenti del database non disponibili",
|
||||
detail: "{engine} non supporta i commenti su tabelle o colonne, quindi ogni descrizione qui proviene dalle note di questo progetto.",
|
||||
},
|
||||
orphanedNotes: {
|
||||
title: "Alcune note non corrispondono più a nulla",
|
||||
detail: "{count} nota/e fanno riferimento a una tabella o colonna che non esiste più. Nulla è stato eliminato — rimappa o rimuovi queste note nel file delle note.",
|
||||
},
|
||||
dbmlOmitted: {
|
||||
title: "Non rappresentabile in DBML",
|
||||
detail: "{item} su {table} è documentato qui ma omesso dal DBML esportato: {reason}.",
|
||||
},
|
||||
},
|
||||
};
|
||||
@@ -0,0 +1,48 @@
|
||||
export default {
|
||||
title: "ドキュメント",
|
||||
groupBySchema: "スキーマ",
|
||||
groupByTableGroup: "テーブルグループ",
|
||||
noGroup: "(グループなし)",
|
||||
noSchema: "(スキーマなし)",
|
||||
search: "テーブル、カラム、グループを検索…",
|
||||
columns: "カラム",
|
||||
indexes: "インデックス",
|
||||
references: "参照",
|
||||
referencedBy: "参照元",
|
||||
localNote: "ローカル",
|
||||
shadowedComment: "データベースのコメント: {comment}",
|
||||
addNote: "メモを追加",
|
||||
editNote: "メモを編集",
|
||||
newGroup: "新しいグループ…",
|
||||
groupName: "グループ名",
|
||||
groupColour: "色",
|
||||
deleteGroup: "グループを削除",
|
||||
enumValues: "値",
|
||||
usedBy: "使用元",
|
||||
openDiagram: "スキーマ図を開く",
|
||||
saving: "保存中…",
|
||||
saved: "保存済み",
|
||||
saveFailed: "メモを保存できませんでした: {error}",
|
||||
warnings: {
|
||||
tableSkipped: {
|
||||
title: "ドキュメント化できないテーブルがあります",
|
||||
detail: "{table} はスキップされました: {reason}。このドキュメントには含まれていません。",
|
||||
},
|
||||
noForeignKeyMetadata: {
|
||||
title: "リレーションシップを表示できません",
|
||||
detail: "{engine} は外部キーのメタデータを報告しないため、リレーションシップを導出できませんでした。この図はこのエンジンについては完全です。",
|
||||
},
|
||||
commentsUnsupported: {
|
||||
title: "データベースのコメントは利用できません",
|
||||
detail: "{engine} はテーブルやカラムのコメントをサポートしていないため、ここでの説明はすべてこのプロジェクトのメモから提供されています。",
|
||||
},
|
||||
orphanedNotes: {
|
||||
title: "対象がなくなったメモがあります",
|
||||
detail: "{count} 件のメモが、既に存在しないテーブルまたはカラムを参照しています。何も削除されていません。メモファイルで再割り当てまたは削除してください。",
|
||||
},
|
||||
dbmlOmitted: {
|
||||
title: "DBMLでは表現できません",
|
||||
detail: "{table} の {item} はここに記載されていますが、エクスポートされたDBMLからは除外されています: {reason}。",
|
||||
},
|
||||
},
|
||||
};
|
||||
@@ -0,0 +1,48 @@
|
||||
export default {
|
||||
title: "문서",
|
||||
groupBySchema: "스키마",
|
||||
groupByTableGroup: "테이블 그룹",
|
||||
noGroup: "(그룹 없음)",
|
||||
noSchema: "(스키마 없음)",
|
||||
search: "테이블, 컬럼, 그룹 검색…",
|
||||
columns: "컬럼",
|
||||
indexes: "인덱스",
|
||||
references: "참조",
|
||||
referencedBy: "참조된 위치",
|
||||
localNote: "로컬",
|
||||
shadowedComment: "데이터베이스 코멘트: {comment}",
|
||||
addNote: "메모 추가",
|
||||
editNote: "메모 편집",
|
||||
newGroup: "새 그룹…",
|
||||
groupName: "그룹 이름",
|
||||
groupColour: "색상",
|
||||
deleteGroup: "그룹 삭제",
|
||||
enumValues: "값",
|
||||
usedBy: "사용처",
|
||||
openDiagram: "스키마 다이어그램 열기",
|
||||
saving: "저장 중…",
|
||||
saved: "저장됨",
|
||||
saveFailed: "메모를 저장할 수 없습니다: {error}",
|
||||
warnings: {
|
||||
tableSkipped: {
|
||||
title: "문서화할 수 없는 테이블이 있습니다",
|
||||
detail: "{table} 을(를) 건너뛰었습니다: {reason}. 이 문서에서 누락되었습니다.",
|
||||
},
|
||||
noForeignKeyMetadata: {
|
||||
title: "표시할 관계가 없습니다",
|
||||
detail: "{engine} 은(는) 외래 키 메타데이터를 보고하지 않으므로 관계를 도출할 수 없습니다. 이 엔진에 대해서는 다이어그램이 완전합니다.",
|
||||
},
|
||||
commentsUnsupported: {
|
||||
title: "데이터베이스 코멘트를 사용할 수 없습니다",
|
||||
detail: "{engine} 은(는) 테이블 또는 컬럼 코멘트를 지원하지 않으므로 여기의 모든 설명은 이 프로젝트의 메모에서만 제공됩니다.",
|
||||
},
|
||||
orphanedNotes: {
|
||||
title: "더 이상 일치하는 대상이 없는 메모가 있습니다",
|
||||
detail: "{count} 개의 메모가 더 이상 존재하지 않는 테이블 또는 컬럼을 참조하고 있습니다. 삭제된 항목은 없습니다 — 메모 파일에서 다시 매핑하거나 제거하세요.",
|
||||
},
|
||||
dbmlOmitted: {
|
||||
title: "DBML로 표현할 수 없습니다",
|
||||
detail: "{table} 의 {item} 은(는) 여기에 문서화되어 있지만 내보낸 DBML에서는 제외되었습니다: {reason}.",
|
||||
},
|
||||
},
|
||||
};
|
||||
@@ -0,0 +1,48 @@
|
||||
export default {
|
||||
title: "Documentação",
|
||||
groupBySchema: "Schemas",
|
||||
groupByTableGroup: "Grupos de tabelas",
|
||||
noGroup: "(sem grupo)",
|
||||
noSchema: "(sem schema)",
|
||||
search: "Buscar tabelas, colunas, grupos…",
|
||||
columns: "Colunas",
|
||||
indexes: "Índices",
|
||||
references: "Referências",
|
||||
referencedBy: "Referenciado por",
|
||||
localNote: "LOCAL",
|
||||
shadowedComment: "Comentário do banco de dados: {comment}",
|
||||
addNote: "Adicionar uma nota",
|
||||
editNote: "Editar nota",
|
||||
newGroup: "Novo grupo…",
|
||||
groupName: "Nome do grupo",
|
||||
groupColour: "Cor",
|
||||
deleteGroup: "Excluir grupo",
|
||||
enumValues: "Valores",
|
||||
usedBy: "Usado por",
|
||||
openDiagram: "Abrir diagrama do schema",
|
||||
saving: "Salvando…",
|
||||
saved: "Salvo",
|
||||
saveFailed: "Não foi possível salvar as notas: {error}",
|
||||
warnings: {
|
||||
tableSkipped: {
|
||||
title: "Uma tabela não pôde ser documentada",
|
||||
detail: "{table} foi ignorada: {reason}. Ela está faltando nesta documentação.",
|
||||
},
|
||||
noForeignKeyMetadata: {
|
||||
title: "Nenhum relacionamento disponível",
|
||||
detail: "{engine} não reporta metadados de foreign key, então nenhum relacionamento pôde ser derivado. O diagrama está completo para este engine.",
|
||||
},
|
||||
commentsUnsupported: {
|
||||
title: "Comentários do banco de dados indisponíveis",
|
||||
detail: "{engine} não suporta comentários em tabelas ou colunas, então toda descrição aqui vem apenas das notas deste projeto.",
|
||||
},
|
||||
orphanedNotes: {
|
||||
title: "Algumas notas não correspondem mais a nada",
|
||||
detail: "{count} nota(s) referenciam uma tabela ou coluna que não existe mais. Nada foi excluído — remapeie ou remova essas notas no arquivo de notas.",
|
||||
},
|
||||
dbmlOmitted: {
|
||||
title: "Não representável em DBML",
|
||||
detail: "{item} em {table} está documentado aqui mas foi omitido do DBML exportado: {reason}.",
|
||||
},
|
||||
},
|
||||
};
|
||||
@@ -0,0 +1,48 @@
|
||||
export default {
|
||||
title: "文档",
|
||||
groupBySchema: "Schema",
|
||||
groupByTableGroup: "表分组",
|
||||
noGroup: "(无分组)",
|
||||
noSchema: "(无 Schema)",
|
||||
search: "搜索表、列、分组…",
|
||||
columns: "列",
|
||||
indexes: "索引",
|
||||
references: "引用",
|
||||
referencedBy: "被引用",
|
||||
localNote: "本地",
|
||||
shadowedComment: "数据库注释: {comment}",
|
||||
addNote: "添加备注",
|
||||
editNote: "编辑备注",
|
||||
newGroup: "新建分组…",
|
||||
groupName: "分组名称",
|
||||
groupColour: "颜色",
|
||||
deleteGroup: "删除分组",
|
||||
enumValues: "值",
|
||||
usedBy: "被使用于",
|
||||
openDiagram: "打开 Schema 图",
|
||||
saving: "保存中…",
|
||||
saved: "已保存",
|
||||
saveFailed: "无法保存备注: {error}",
|
||||
warnings: {
|
||||
tableSkipped: {
|
||||
title: "有一张表无法生成文档",
|
||||
detail: "{table} 被跳过: {reason}。此文档中缺少该表。",
|
||||
},
|
||||
noForeignKeyMetadata: {
|
||||
title: "没有可用的关系",
|
||||
detail: "{engine} 不报告外键元数据,因此无法推导出任何关系。此图对该数据库引擎而言已经完整。",
|
||||
},
|
||||
commentsUnsupported: {
|
||||
title: "数据库注释不可用",
|
||||
detail: "{engine} 不支持表或列注释,因此这里的所有描述均仅来自本项目的备注。",
|
||||
},
|
||||
orphanedNotes: {
|
||||
title: "部分备注已不再对应任何内容",
|
||||
detail: "{count} 条备注引用的表或列已不存在。没有任何内容被删除 — 请在备注文件中重新映射或移除它们。",
|
||||
},
|
||||
dbmlOmitted: {
|
||||
title: "无法在 DBML 中表示",
|
||||
detail: "{table} 上的 {item} 已在此处记录,但已从导出的 DBML 中省略: {reason}。",
|
||||
},
|
||||
},
|
||||
};
|
||||
@@ -0,0 +1,48 @@
|
||||
export default {
|
||||
title: "文件",
|
||||
groupBySchema: "Schema",
|
||||
groupByTableGroup: "資料表分組",
|
||||
noGroup: "(無分組)",
|
||||
noSchema: "(無 Schema)",
|
||||
search: "搜尋資料表、欄位、分組…",
|
||||
columns: "欄位",
|
||||
indexes: "索引",
|
||||
references: "參照",
|
||||
referencedBy: "被參照",
|
||||
localNote: "本機",
|
||||
shadowedComment: "資料庫註解: {comment}",
|
||||
addNote: "新增備註",
|
||||
editNote: "編輯備註",
|
||||
newGroup: "新增分組…",
|
||||
groupName: "分組名稱",
|
||||
groupColour: "顏色",
|
||||
deleteGroup: "刪除分組",
|
||||
enumValues: "值",
|
||||
usedBy: "被使用於",
|
||||
openDiagram: "開啟 Schema 圖",
|
||||
saving: "儲存中…",
|
||||
saved: "已儲存",
|
||||
saveFailed: "無法儲存備註: {error}",
|
||||
warnings: {
|
||||
tableSkipped: {
|
||||
title: "有一張資料表無法產生文件",
|
||||
detail: "{table} 被略過: {reason}。此文件中缺少該資料表。",
|
||||
},
|
||||
noForeignKeyMetadata: {
|
||||
title: "沒有可用的關聯",
|
||||
detail: "{engine} 未回報外鍵中繼資料,因此無法推導出任何關聯。此圖對該資料庫引擎而言已經完整。",
|
||||
},
|
||||
commentsUnsupported: {
|
||||
title: "資料庫註解無法使用",
|
||||
detail: "{engine} 不支援資料表或欄位註解,因此這裡的所有說明均僅來自本專案的備註。",
|
||||
},
|
||||
orphanedNotes: {
|
||||
title: "部分備註已不再對應任何內容",
|
||||
detail: "{count} 筆備註參照的資料表或欄位已不存在。沒有任何內容被刪除 — 請在備註檔案中重新對應或移除它們。",
|
||||
},
|
||||
dbmlOmitted: {
|
||||
title: "無法在 DBML 中表示",
|
||||
detail: "{table} 上的 {item} 已在此處記錄,但已從匯出的 DBML 中省略: {reason}。",
|
||||
},
|
||||
},
|
||||
};
|
||||
@@ -1,7 +1,10 @@
|
||||
import docs from "./docs/en";
|
||||
|
||||
export default {
|
||||
app: {
|
||||
name: "DBX",
|
||||
},
|
||||
docs,
|
||||
auth: {
|
||||
rateLimited: "Please try again in {seconds}s",
|
||||
setupTitle: "Set up access password",
|
||||
@@ -770,6 +773,9 @@ export default {
|
||||
readOnlyHint: "Block all write operations (INSERT, UPDATE, DELETE, etc.)",
|
||||
showSystemSchemas: "Show System Schemas",
|
||||
showSystemSchemasHint: "Show built-in and metadata schemas in the sidebar and schema pickers for this connection.",
|
||||
docsNotesPath: "Notes file",
|
||||
docsNotesPathPlaceholder: "docs/dbx-docs.json",
|
||||
docsNotesPathHint: "Where documentation notes are stored. Leave empty to keep them in the app data directory, or point this at a file in your repository to review schema documentation in pull requests.",
|
||||
readOnlyBadge: "Read-only",
|
||||
proxy: "Proxy",
|
||||
proxyEnable: "Connect database through proxy",
|
||||
|
||||
@@ -1,9 +1,11 @@
|
||||
import { withEnglishFallback } from "./fallback";
|
||||
import docs from "./docs/es";
|
||||
|
||||
export default withEnglishFallback({
|
||||
app: {
|
||||
name: "DBX",
|
||||
},
|
||||
docs,
|
||||
auth: {
|
||||
rateLimited: "Vuelva a intentarlo en {seconds} s",
|
||||
setupTitle: "Configurar contraseña de acceso",
|
||||
@@ -750,6 +752,9 @@ export default withEnglishFallback({
|
||||
jdbcMissingRuntimeDependencyHint: "El controlador JDBC actual carece de dependencias de ejecución. Utilice las coordenadas Maven en 'Administración de controladores' para instalar, o importe el controlador y todos los JAR de dependencia de una vez.",
|
||||
showSystemSchemas: "Mostrar Schema del sistema",
|
||||
showSystemSchemasHint: "Mostrar el Schema integrado/de metadatos para la conexión actual en la barra lateral y el selector de Schema.",
|
||||
docsNotesPath: "Archivo de notas",
|
||||
docsNotesPathPlaceholder: "docs/dbx-docs.json",
|
||||
docsNotesPathHint: "Dónde se guardan las notas de documentación. Déjalo vacío para mantenerlas en el directorio de datos de la aplicación, o apunta a un archivo de tu repositorio para revisar la documentación del schema en los pull requests.",
|
||||
sshHostKeyVerifyTitle: "Confirmar clave de host SSH desconocida",
|
||||
sshHostKeyVerifyMessage: "No se puede confirmar la autenticidad del host '{host}:{port}'. Para evitar ataques de intermediario, verifique la huella digital de la clave del host con el administrador del servidor antes de continuar.",
|
||||
sshHostKeyVerifyKeyType: "Tipo de clave",
|
||||
|
||||
@@ -1,8 +1,10 @@
|
||||
import { withEnglishFallback } from "./fallback";
|
||||
import docs from "./docs/it";
|
||||
export default withEnglishFallback({
|
||||
app: {
|
||||
name: "DBX",
|
||||
},
|
||||
docs,
|
||||
auth: {
|
||||
rateLimited: "Riprova tra {seconds} s",
|
||||
setupTitle: "Imposta la password di accesso",
|
||||
@@ -748,6 +750,9 @@ export default withEnglishFallback({
|
||||
jdbcMissingRuntimeDependencyHint: "Il driver JDBC corrente manca di dipendenze runtime. Installare utilizzando le coordinate Maven in 'Gestione driver', o importare il driver e tutti i JAR delle dipendenze in una volta.",
|
||||
showSystemSchemas: "Mostra Schema di sistema",
|
||||
showSystemSchemasHint: "Mostra lo Schema built-in/di metadati nella barra laterale e nel selettore Schema per la connessione corrente.",
|
||||
docsNotesPath: "File delle note",
|
||||
docsNotesPathPlaceholder: "docs/dbx-docs.json",
|
||||
docsNotesPathHint: "Dove vengono salvate le note della documentazione. Lascia vuoto per tenerle nella directory dati dell'applicazione, oppure indica un file nel tuo repository per revisionare la documentazione dello schema nelle pull request.",
|
||||
sshHostKeyVerifyTitle: "Conferma chiave host SSH sconosciuta",
|
||||
sshHostKeyVerifyMessage: "Impossibile confermare l'autenticità dell'host '{host}:{port}'. Per prevenire attacchi man-in-the-middle, verifica l'impronta della chiave host con l'amministratore del server prima di procedere.",
|
||||
sshHostKeyVerifyKeyType: "Tipo di chiave",
|
||||
|
||||
@@ -1,9 +1,11 @@
|
||||
import { withEnglishFallback } from "./fallback";
|
||||
import docs from "./docs/ja";
|
||||
|
||||
export default withEnglishFallback({
|
||||
app: {
|
||||
name: "DBX",
|
||||
},
|
||||
docs,
|
||||
auth: {
|
||||
rateLimited: "{seconds} 秒後に再試行してください",
|
||||
setupTitle: "アクセスパスワードを設定",
|
||||
@@ -748,6 +750,9 @@ export default withEnglishFallback({
|
||||
jdbcMissingRuntimeDependencyHint: "現在のJDBCドライバーには実行依存関係が不足しています。「ドライバ管理」でMaven座標を使用してインストールするか、ドライバーとすべての依存JARを一度にインポートしてください。",
|
||||
showSystemSchemas: "システムスキーマを表示",
|
||||
showSystemSchemasHint: "現在の接続で、サイドバーとスキーマセレクターに組み込み/メタデータスキーマを表示します。",
|
||||
docsNotesPath: "ノートファイル",
|
||||
docsNotesPathPlaceholder: "docs/dbx-docs.json",
|
||||
docsNotesPathHint: "ドキュメントのノートの保存先です。空のままにするとアプリのデータディレクトリに保存されます。リポジトリ内のファイルを指定すると、スキーマのドキュメントをプルリクエストでレビューできます。",
|
||||
sshHostKeyVerifyTitle: "不明なSSHホストキーの確認",
|
||||
sshHostKeyVerifyMessage: "ホスト '{host}:{port}' の正当性を確認できません。中間者攻撃を防ぐため、続行する前にサーバー管理者にホストキーのフィンガープリントを確認してください。",
|
||||
sshHostKeyVerifyKeyType: "キータイプ",
|
||||
|
||||
@@ -1,9 +1,11 @@
|
||||
import { withEnglishFallback } from "./fallback";
|
||||
import docs from "./docs/ko";
|
||||
|
||||
export default withEnglishFallback({
|
||||
app: {
|
||||
name: "DBX",
|
||||
},
|
||||
docs,
|
||||
auth: {
|
||||
rateLimited: "{seconds}초 후에 다시 시도해 주세요",
|
||||
setupTitle: "접속 비밀번호 설정",
|
||||
@@ -687,6 +689,9 @@ export default withEnglishFallback({
|
||||
readOnlyHint: "모든 쓰기 작업 차단 (INSERT, UPDATE, DELETE 등)",
|
||||
showSystemSchemas: "시스템 스키마 표시",
|
||||
showSystemSchemasHint: "이 연결의 사이드바와 스키마 선택기에 내장 및 메타데이터 스키마를 표시합니다.",
|
||||
docsNotesPath: "노트 파일",
|
||||
docsNotesPathPlaceholder: "docs/dbx-docs.json",
|
||||
docsNotesPathHint: "문서 노트를 저장할 위치입니다. 비워 두면 앱 데이터 디렉터리에 저장되며, 저장소 내 파일을 지정하면 스키마 문서를 풀 리퀘스트에서 검토할 수 있습니다.",
|
||||
readOnlyBadge: "읽기 전용",
|
||||
proxy: "프록시",
|
||||
proxyEnable: "프록시를 통해 데이터베이스 연결",
|
||||
|
||||
@@ -1,9 +1,11 @@
|
||||
import { withEnglishFallback } from "./fallback";
|
||||
import docs from "./docs/pt-BR";
|
||||
|
||||
export default withEnglishFallback({
|
||||
app: {
|
||||
name: "DBX",
|
||||
},
|
||||
docs,
|
||||
auth: {
|
||||
rateLimited: "Tente novamente em {seconds}s",
|
||||
setupTitle: "Configurar senha de acesso",
|
||||
@@ -749,6 +751,9 @@ export default withEnglishFallback({
|
||||
jdbcMissingRuntimeDependencyHint: "O driver JDBC atual está sem dependências de execução. Por favor, instale-o usando as coordenadas Maven no 'Gerenciamento de Drivers' ou importe o driver e todos os JARs de dependência de uma só vez.",
|
||||
showSystemSchemas: "Mostrar Schema do sistema",
|
||||
showSystemSchemasHint: "Exibir Schemas de sistema/metadados integrados na barra lateral e no seletor de Schema para a conexão atual.",
|
||||
docsNotesPath: "Arquivo de notas",
|
||||
docsNotesPathPlaceholder: "docs/dbx-docs.json",
|
||||
docsNotesPathHint: "Onde as notas da documentação são gravadas. Deixe vazio para mantê-las no diretório de dados do aplicativo, ou aponte para um arquivo do seu repositório para revisar a documentação do schema em pull requests.",
|
||||
sshHostKeyVerifyTitle: "Confirmar chave de host SSH desconhecida",
|
||||
sshHostKeyVerifyMessage: "Não foi possível confirmar a autenticidade do host '{host}:{port}'. Para evitar ataques man-in-the-middle, verifique a impressão digital da chave do host com o administrador do servidor antes de continuar.",
|
||||
sshHostKeyVerifyKeyType: "Tipo de chave",
|
||||
|
||||
@@ -1,9 +1,11 @@
|
||||
import { withEnglishFallback } from "./fallback";
|
||||
import docs from "./docs/zh-CN";
|
||||
|
||||
export default withEnglishFallback({
|
||||
app: {
|
||||
name: "DBX",
|
||||
},
|
||||
docs,
|
||||
auth: {
|
||||
rateLimited: "请 {seconds} 秒后再试",
|
||||
setupTitle: "设置访问密码",
|
||||
@@ -774,6 +776,9 @@ export default withEnglishFallback({
|
||||
readOnlyHint: "阻止所有写操作(INSERT、UPDATE、DELETE 等)",
|
||||
showSystemSchemas: "显示系统 Schema",
|
||||
showSystemSchemasHint: "为当前连接在侧边栏和 Schema 选择器中显示内置/元数据 Schema。",
|
||||
docsNotesPath: "笔记文件",
|
||||
docsNotesPathPlaceholder: "docs/dbx-docs.json",
|
||||
docsNotesPathHint: "文档笔记的存储位置。留空则保存在应用数据目录中;指向仓库中的文件后,即可在 Pull Request 中审阅 Schema 文档。",
|
||||
readOnlyBadge: "只读",
|
||||
proxy: "代理",
|
||||
proxyEnable: "通过代理连接数据库",
|
||||
|
||||
@@ -1,9 +1,11 @@
|
||||
import { withEnglishFallback } from "./fallback";
|
||||
import docs from "./docs/zh-TW";
|
||||
|
||||
export default withEnglishFallback({
|
||||
app: {
|
||||
name: "DBX",
|
||||
},
|
||||
docs,
|
||||
auth: {
|
||||
rateLimited: "請 {seconds} 秒後再試",
|
||||
setupTitle: "設定存取密碼",
|
||||
@@ -748,6 +750,9 @@ export default withEnglishFallback({
|
||||
jdbcMissingRuntimeDependencyHint: "目前 JDBC 驅動缺少執行依賴。請在「驅動管理」中使用 Maven 座標安裝,或一次匯入驅動及全部依賴 JAR。",
|
||||
showSystemSchemas: "顯示系統 Schema",
|
||||
showSystemSchemasHint: "為目前連線在側邊欄和 Schema 選擇器中顯示內建/中繼資料 Schema。",
|
||||
docsNotesPath: "筆記檔案",
|
||||
docsNotesPathPlaceholder: "docs/dbx-docs.json",
|
||||
docsNotesPathHint: "文件筆記的儲存位置。留空則儲存在應用程式資料目錄中;指向存放庫中的檔案後,即可在 Pull Request 中審閱 Schema 文件。",
|
||||
sshHostKeyVerifyTitle: "確認未知的 SSH 主機金鑰",
|
||||
sshHostKeyVerifyMessage: "無法確認主機 '{host}:{port}' 的真實性。為防止中間人攻擊,請在繼續前與伺服器管理員核對主機金鑰指紋。",
|
||||
sshHostKeyVerifyKeyType: "金鑰類型",
|
||||
|
||||
Reference in new issue
Block a user