rdbr 0.1.0

data/app/views/data.haml

@@ -0,0 +1,166 @@
+%section.page-heading.table-page-heading
+  .heading-copy
+    %h2= @relation.name
+    - if @relation.comment
+      %p= @relation.comment
+  %form.table-search{ action: '/data', method: 'get', role: 'search' }
+    %input{ name: 'namespace', type: 'hidden', value: @namespace.name }
+    %input{ name: 'relation', type: 'hidden', value: @relation.name }
+    %input{ name: 'per_page', type: 'hidden', value: @page.per_page }
+    - if params['sort'].to_s != ''
+      %input{ name: 'sort', type: 'hidden', value: params['sort'] }
+    - filter_entries.each do |entry|
+      %input{ name: "filter[#{entry.fetch(:column)}][#{entry.fetch(:operator)}]", type: 'hidden', value: entry.fetch(:value) }
+    %span{ 'aria-hidden': 'true' } 🔍
+    %input{ id: 'search', name: 'search', type: 'search', value: params['search'], placeholder: 'Search',
+            'aria-label': 'Search text columns' }
+  .heading-actions.table-heading-actions
+    .table-pagination
+      .rows-control
+        %label{ for: 'per-page' } Rows
+        %select{ id: 'per-page', data: { page_size: true } }
+          - RDBr::Web::Application::PAGE_SIZES.each do |size|
+            %option{ value: size, selected: @page.per_page == size }= size
+      - if @page.total_pages > 1
+        %nav.pagination{ 'aria-label': 'Pagination' }
+          - if @page.page > 1
+            %a{ href: page_url(@page.page - 1), rel: 'prev', 'aria-label': 'Previous page' } ‹
+          - else
+            %span.disabled{ 'aria-label': 'Previous page' } ‹
+          %a{ href: page_url(1), 'aria-label': 'First page' } 1
+          %label.visually-hidden{ for: 'page-number' } Page number
+          %input{ id: 'page-number', type: 'text', inputmode: 'numeric', pattern: '[0-9]*', value: @page.page,
+                  data: { page_jump: true, last_page: @page.total_pages }, 'aria-label': 'Page number' }
+          %a{ href: page_url(@page.total_pages), 'aria-label': 'Last page' }= @page.total_pages
+          - if @page.has_next
+            %a{ href: page_url(@page.page + 1), rel: 'next', 'aria-label': 'Next page' } ›
+          - else
+            %span.disabled{ 'aria-label': 'Next page' } ›
+    %button.column-picker-trigger{ type: 'button', data: { column_picker_trigger: true },
+                                   'aria-haspopup': 'dialog', 'aria-controls': 'column-picker',
+                                   'aria-expanded': 'false' } Columns
+    %a{ href: query_url('/data.json', request.params) } JSON
+
+#date-filter.date-filter.popup-backdrop{ role: 'dialog', 'aria-modal': 'true', 'aria-labelledby': 'date-filter-title', hidden: true }
+  .date-filter-panel.popup-surface
+    %button.dialog-close{ type: 'button', data: { close_date_filter: true }, 'aria-label': 'Close' } ×
+    %h3#date-filter-title Filter dates
+    %p.date-filter-column
+    .date-presets
+      %button{ type: 'button', data: { date_preset: 'today' } } Today
+      %button{ type: 'button', data: { date_preset: 'yesterday' } } Yesterday
+      %button{ type: 'button', data: { date_preset: 'last-7-days' } } Last 7 days
+      %button{ type: 'button', data: { date_preset: 'last-30-days' } } Last 30 days
+      %button{ type: 'button', data: { date_preset: 'this-month' } } This month
+    %form.date-range-form
+      %label
+        From
+        .iso-date-input
+          %input{ type: 'text', data: { date_from: true }, required: true, inputmode: 'numeric',
+                  placeholder: 'YYYY-MM-DD', pattern: '\d{4}-\d{2}-\d{2}',
+                  title: 'Enter a date in YYYY-MM-DD format' }
+          %button.date-picker-button{ type: 'button', data: { open_date_picker: 'from' },
+                                      'aria-label': 'Choose From date from calendar' } 📅
+          %input.native-date-picker{ type: 'date', data: { native_date_from: true },
+                                     tabindex: '-1', 'aria-hidden': 'true' }
+      %label
+        To
+        .iso-date-input
+          %input{ type: 'text', data: { date_to: true }, required: true, inputmode: 'numeric',
+                  placeholder: 'YYYY-MM-DD', pattern: '\d{4}-\d{2}-\d{2}',
+                  title: 'Enter a date in YYYY-MM-DD format' }
+          %button.date-picker-button{ type: 'button', data: { open_date_picker: 'to' },
+                                      'aria-label': 'Choose To date from calendar' } 📅
+          %input.native-date-picker{ type: 'date', data: { native_date_to: true },
+                                     tabindex: '-1', 'aria-hidden': 'true' }
+      %button{ type: 'submit' } Apply
+
+#column-picker.column-picker.popup-surface{ role: 'dialog', 'aria-labelledby': 'column-picker-title', hidden: true }
+  %div{ data: { column_picker_form: true } }
+    .column-picker-heading
+      %h3#column-picker-title Columns
+      %button.dialog-close{ type: 'button', data: { close_column_picker: true }, 'aria-label': 'Close' } ×
+    %p Drag to reorder, or use the arrow buttons.
+    %ol.column-picker-list
+      - @available_columns.each do |column|
+        %li{ draggable: 'true', data: { column_name: column.name } }
+          %span.column-drag-handle{ 'aria-hidden': 'true' } ⋮⋮
+          %label
+            %input{ type: 'checkbox', checked: @visible_columns.include?(column) }
+            %span= display_column_name(column)
+          .column-move-actions
+            %button{ type: 'button', data: { move_column: 'up' },
+                     title: "Move #{column.name} left", 'aria-label': "Move #{column.name} left" } ←
+            %button{ type: 'button', data: { move_column: 'down' },
+                     title: "Move #{column.name} right", 'aria-label': "Move #{column.name} right" } →
+    .column-picker-actions
+      %button.secondary-button{ type: 'button', data: { show_all_columns: true } } Show all
+      %button.secondary-button{ type: 'button', data: { reset_columns: true } } Reset
+
+- if filter_entries.any? || params['search'].to_s != ''
+  %section.active-filters{ 'aria-label': 'Active filters' }
+    .filter-chips
+      - filter_entries.each do |entry|
+        - filter_value, filter_column = filter_chip_parts(entry)
+        - filter_related = filter_related_value(entry)
+        %span.filter-chip
+          %small= filter_column
+          %strong= filter_value
+          - if filter_related
+            %a.relationship-link{ href: related_value_url(filter_related),
+                                  title: "Open related #{entry.fetch(:column)}",
+                                  'aria-label': "Open related #{entry.fetch(:column)}" } ↗
+          %a.remove-filter{ href: remove_filter_url(entry.fetch(:column), entry.fetch(:operator)),
+                            title: "Remove #{entry.fetch(:column)} filter", 'aria-label': "Remove #{entry.fetch(:column)} filter" } ×
+      - if params['search'].to_s != ''
+        %span.filter-chip.search-chip
+          %small Search
+          %strong= params['search']
+          %a.remove-filter{ href: remove_search_url, title: 'Remove search', 'aria-label': 'Remove search' } ×
+      %a.clear-all{ href: clear_filters_url } Clear all
+
+%section.data-section{ data: { column_preference_cookie: @column_preferences.cookie_name,
+                              column_preference_storage: @column_preferences.storage_key } }
+  - if @relation.keyless?
+    .table-meta
+      %p.notice No primary key: record detail links are unavailable.
+  .table-scroll
+    %table.data-table
+      %thead
+        %tr
+          - unless @relation.keyless?
+            %th.record-link-column Record
+          - if @visible_columns.empty? && @relation.keyless?
+            %th Matching rows
+          - @available_columns.each do |column|
+            %th{ data: { column: column.name }, hidden: !@visible_columns.include?(column) }
+              .column-heading
+                - if settings.query_service.sortable_column?(column)
+                  %a.column-name{ href: sort_url(column.name), title: column.sql_type || column.logical_type }!= "#{Rack::Utils.escape_html(display_column_name(column))}#{sort_indicator(column.name)}"
+                - else
+                  %span.column-name{ title: column.sql_type || column.logical_type }= display_column_name(column)
+                - if settings.query_service.groupable_column?(column) && !@relation.uniquely_constrained_column?(column.name)
+                  %a.group-link{ href: group_url(@namespace.name, @relation.name, column.name), title: "Group by #{column.name}" } Group
+                - if temporal_column?(column)
+                  %button.date-filter-trigger{ type: 'button', data: { date_filter_column: column.name },
+                                               title: "Filter #{column.name} by date range",
+                                               'aria-label': "Filter #{column.name} by date range" } 📅
+      %tbody
+        - if @page.rows.empty?
+          %tr
+            %td.empty-state{ colspan: @visible_columns.length + (@relation.keyless? ? 0 : 1) } No matching records
+        - @page.rows.each do |row|
+          %tr
+            - unless @relation.keyless?
+              %td.record-link-column
+                %a{ href: record_url(@namespace.name, @relation.name, row,
+                                     @relation.primary_key) }= record_label(@relation, row, exclude: fixed_filter_columns)
+            - if @visible_columns.empty? && @relation.keyless?
+              %td Match
+            - @available_columns.each do |column|
+              %td{ data: { column_cell: column.name }, hidden: !@visible_columns.include?(column) }
+                != render_table_value(@relation, column, row[column.name])
+                - related_url = foreign_record_url(@namespace, @relation, column, row)
+                - if related_url
+                  %a.relationship-link{ href: related_url, title: "Open related #{column.name}",
+                                        'aria-label': "Open related #{column.name}" } ↗

data/app/views/group.haml

@@ -0,0 +1,50 @@
+%section.page-heading
+  .heading-copy
+    %p.eyebrow Grouped values
+    %h2= @column.name
+    %p #{@relation.name} · #{@column.sql_type || @column.logical_type}
+
+- if filter_entries.any? || params['search'].to_s != ''
+  %section.active-filters{ 'aria-label': 'Active filters' }
+    .filter-heading
+      %h3 Applied before grouping
+    .filter-chips
+      - filter_entries.each do |entry|
+        - filter_related = filter_related_value(entry)
+        %span.filter-chip
+          = filter_description(entry)
+          - if filter_related
+            %a.relationship-link{ href: related_value_url(filter_related),
+                                  title: "Open related #{entry.fetch(:column)}",
+                                  'aria-label': "Open related #{entry.fetch(:column)}" } ↗
+      - if params['search'].to_s != ''
+        %span.filter-chip Search: #{params['search']}
+
+%section.data-section
+  .table-scroll
+    %table.data-table.group-table
+      %thead
+        %tr
+          %th Value
+          %th Count
+          %th Records
+      %tbody
+        - @page.rows.each do |row|
+          - condition = row['value'].nil? ? { is_null: true } : { eq: row['value'] }
+          - filter = @filters.merge(@column.name => condition)
+          %tr
+            - related = related_value_for(@column, row['value'])
+            %td!= related ? render_related_value(related, compact: false) : render_value(row['value'])
+            %td.number= row['count']
+            %td
+              %a{ href: relation_url(@namespace.name, @relation.name, filter: filter) } Browse
+  %nav.pagination{ 'aria-label': 'Pagination' }
+    - if @page.page > 1
+      %a{ href: page_url(@page.page - 1), rel: 'prev' } ← Previous
+    - else
+      %span.disabled ← Previous
+    %span Page #{@page.page}
+    - if @page.has_next
+      %a{ href: page_url(@page.page + 1), rel: 'next' } Next →
+    - else
+      %span.disabled Next →

data/app/views/index.haml

@@ -0,0 +1,108 @@
+%section
+  - if settings.catalog
+    .catalog-actions
+      %button{ type: 'button', data: { open_database_diagram: true } } Database diagram
+    - settings.catalog.namespaces.each do |namespace|
+      %section.namespace
+        %h3= namespace.name
+        - if namespace.relations.empty?
+          %p No relations discovered.
+        - else
+          %table
+            %thead
+              %tr
+                %th Relation
+                %th Kind
+                %th Columns
+                %th Primary key
+                %th JSON
+            %tbody
+              - namespace.relations.each do |relation|
+                %tr
+                  %td.relation-cell
+                    %a{ href: relation_url(namespace.name, relation.name) }= relation.name
+                    %details.relation-schema{ 'data-row-count-url': query_url('/count.json', namespace: namespace.name, relation: relation.name) }
+                      %summary{ title: "View definition for #{namespace.name}.#{relation.name}", 'aria-label': "View definition for #{namespace.name}.#{relation.name}" }
+                        %span{ 'aria-hidden': 'true' } i
+                      .schema-popover.popup-surface{ role: 'dialog', 'aria-label': "Definition for #{namespace.name}.#{relation.name}" }
+                        %button.dialog-close{ type: 'button', 'data-close-schema': true, 'aria-label': 'Close table definition' } ×
+                        .schema-popover-heading
+                          %div
+                            %p.eyebrow Table definition
+                            %h4 #{namespace.name}.#{relation.name}
+                          %small.schema-row-count{ 'aria-live': 'polite' } Rows: …
+                        .schema-table-scroll
+                          %table.schema-table
+                            %thead
+                              %tr
+                                %th Column
+                                %th Type
+                                %th Nullable
+                                %th Key
+                                %th Default
+                            %tbody
+                              - relation.columns.each do |column|
+                                - key_labels = []
+                                - key_labels << 'PK' if relation.primary_key&.columns&.include?(column.name)
+                                - relation.foreign_keys.each do |foreign_key|
+                                  - column_index = foreign_key.columns.index(column.name)
+                                  - if column_index
+                                    - target_namespace = foreign_key.referenced_namespace || namespace.name
+                                    - target_column = foreign_key.referenced_columns.fetch(column_index)
+                                    - key_labels << "FK → #{target_namespace}.#{foreign_key.referenced_relation}.#{target_column}"
+                                %tr
+                                  %th{ scope: 'row' }= column.name
+                                  %td= column.sql_type || column.logical_type || 'Unknown'
+                                  %td= column.nullable ? 'Yes' : 'No'
+                                  %td
+                                    - if key_labels.empty?
+                                      %span.schema-empty —
+                                    - else
+                                      - key_labels.each do |label|
+                                        %span.schema-key= label
+                                  %td
+                                    - if column.generated?
+                                      %span{ title: column.generated_expression } Generated
+                                    - elsif column.default.nil?
+                                      %span.schema-empty —
+                                    - else
+                                      %code= column.default
+                  %td= relation.kind.to_s.tr('_', ' ')
+                  %td= relation.columns.length
+                  %td= relation.primary_key&.columns&.join(', ') || 'None'
+                  %td
+                    %a{ href: query_url('/data.json', namespace: namespace.name, relation: relation.name) } JSON
+  - else
+    %p RDBr is ready. Supply a database URL to discover a live relational database.
+    %pre rdbr serve --database-url postgresql://user:password@host/database
+
+- if settings.catalog
+  #database-diagram.database-diagram.popup-backdrop{ role: 'dialog', 'aria-modal': 'true',
+                                                     'aria-labelledby': 'database-diagram-title', hidden: true,
+                                                     data: { graph_url: '/database-graph.json' } }
+    .database-diagram-shell.popup-surface
+      %header.database-diagram-heading
+        %div
+          %p.eyebrow Database structure
+          %h2#database-diagram-title= settings.catalog.name
+        .database-diagram-actions
+          %button.secondary-button{ type: 'button', data: { diagram_zoom_out: true },
+                                    title: 'Zoom out', 'aria-label': 'Zoom out' } −
+          %button.secondary-button{ type: 'button', data: { diagram_fit: true } } Fit
+          %button.secondary-button{ type: 'button', data: { diagram_zoom_in: true },
+                                    title: 'Zoom in', 'aria-label': 'Zoom in' } +
+          %button.dialog-close{ type: 'button', data: { close_database_diagram: true },
+                                'aria-label': 'Close database diagram' } ×
+      .database-diagram-toolbar
+        %label
+          %span.visually-hidden Search tables
+          %input{ type: 'search', placeholder: 'Search tables', data: { diagram_search: true },
+                  'aria-label': 'Search tables' }
+        %p.database-diagram-help Drag to pan · Scroll to zoom · Dashed links are inferred
+      .database-diagram-body
+        .database-diagram-canvas{ data: { diagram_canvas: true } }
+          %p.database-diagram-status{ data: { diagram_status: true }, 'aria-live': 'polite' } Loading diagram…
+          %svg{ data: { diagram_svg: true }, role: 'img', 'aria-label': 'Database relationship diagram' }
+        %aside.database-diagram-details{ data: { diagram_details: true }, 'aria-live': 'polite' }
+          %p Select a table to inspect its columns.
+  %script{ src: versioned_asset_url('/database-diagram.js') }

data/app/views/layout.haml

@@ -0,0 +1,59 @@
+!!!
+%html{ lang: 'en' }
+  %head
+    %meta{ charset: 'utf-8' }
+    %meta{ content: 'width=device-width, initial-scale=1', name: 'viewport' }
+    %title RDBr
+    :javascript
+      (() => {
+        const storedTheme = window.localStorage.getItem('rdbr-theme');
+        const theme = storedTheme === 'madhat2r' ? 'dark' : storedTheme;
+        if (theme === 'dark') {
+          document.documentElement.dataset.theme = theme;
+          if (storedTheme !== theme) window.localStorage.setItem('rdbr-theme', theme);
+        }
+        const scrollKey = `rdbr.tableScroll:${window.location.pathname}${window.location.search}`;
+        if (window.sessionStorage.getItem(scrollKey) !== null) {
+          document.documentElement.dataset.restoreTableScroll = 'true';
+        }
+      })();
+    %link{ href: versioned_asset_url('/styles.css'), rel: 'stylesheet' }
+  %body
+    %header
+      .brand-container
+        %a.brand{ href: '/', 'aria-describedby': settings.catalog ? 'database-summary' : nil }
+          %svg.brand-logo{ viewBox: '0 0 128 48', width: 128, height: 48, role: 'img', 'aria-labelledby': 'rdbr-logo-title rdbr-logo-description' }
+            %title#rdbr-logo-title RDBr
+            %desc#rdbr-logo-description RDBr wordmark with two closely overlapping letter Bs
+            %g{ fill: 'none', stroke: 'currentColor', 'stroke-linecap': 'round', 'stroke-linejoin': 'round', 'stroke-width': 5 }
+              %path{ d: 'M7 41V7h12c8 0 13 4 13 10s-5 10-13 10H7m14 0 13 14', transform: 'translate(.84) scale(.88 1)' }
+              %path{ d: 'M43 7v34h10c12 0 19-6 19-17S65 7 53 7H43Z', transform: 'translate(1.16) scale(.88 1)' }
+              %path{ d: 'M81 41V7h12c8 0 13 3 13 9 0 5-4 8-11 8H81m14 0c8 0 13 3 13 9s-5 8-13 8H81', transform: 'translate(1.72) scale(.88 1)' }
+              %path{ d: 'M87 41V7h12c8 0 13 3 13 9 0 5-4 8-11 8H87m14 0c8 0 13 3 13 9s-5 8-13 8H87', opacity: 0.75, transform: 'translate(2.44) scale(.88 1)' }
+              %path{ d: 'M124 41V19m0 8c2-6 7-9 14-8', transform: 'translate(-.12) scale(.88 1)' }
+          %span Relational Database Browser
+        - if settings.catalog
+          #database-summary.database-summary.popup-surface{ role: 'tooltip' }
+            %p
+              Connected to
+              %strong= settings.catalog.name
+              using the
+              %strong= settings.catalog.adapter
+              adapter.
+            %dl
+              %div
+                %dt Namespaces
+                %dd= settings.catalog.namespaces.length
+              %div
+                %dt Relations
+                %dd= settings.catalog.relations.length
+      %nav
+        %a{ href: '/catalog.json' } Catalog JSON
+        %label.theme-picker
+          %span Theme
+          %select{ data: { theme_picker: true }, 'aria-label': 'Theme' }
+            %option{ value: 'default' } Light
+            %option{ value: 'dark' } Dark
+    %main
+      != yield
+    %script{ src: versioned_asset_url('/application.js') }

data/app/views/record.haml

@@ -0,0 +1,81 @@
+%section.page-heading
+  .heading-copy
+    %h2= record_label(@relation, @record)
+    %p
+      %a{ href: relation_url(@namespace.name, @relation.name) } #{@namespace.name}.#{@relation.name}
+
+%section.record-section
+  %dl.record-fields
+    - @relation.columns.each do |column|
+      %div
+        %dt
+          %span{ title: column.sql_type || column.logical_type }= display_column_name(column)
+        - related = related_value_for(column, @record[column.name])
+        - if related
+          %dd.related-record-value
+            %a{ href: related_value_url(related) }!= render_related_value(related, compact: false)
+        - else
+          %dd!= render_record_value(column, @record[column.name])
+
+- unless @outgoing_relationships.empty?
+  %section.relationship-section
+    %h3 Referenced records
+    %ul.relationship-list
+      - @outgoing_relationships.each do |relationship|
+        %li
+          %a{ href: relationship.fetch(:url) }
+            = "#{relationship.fetch(:namespace).name}.#{relationship.fetch(:relation).name}"
+          %small
+            = relationship.fetch(:foreign_key).columns.join(', ')
+            - if relationship.fetch(:inferred)
+              · inferred
+
+- unless @through_relationships.empty?
+  %section.relationship-section
+    %h3 Associated records
+    - @through_relationships.each do |entry|
+      - relationship = entry.fetch(:relationship)
+      %article.related-records
+        %header
+          %h4= "#{relationship.target_namespace.name}.#{relationship.target_relation.name}"
+          %span
+            through
+            %a{ href: entry.fetch(:junction_url) }
+              = "#{relationship.junction_namespace.name}.#{relationship.junction_relation.name}"
+            - if relationship.inferred
+              · inferred
+        - if entry.fetch(:targets).empty?
+          %p.empty-related-records No associated records
+        - else
+          %ul
+            - entry.fetch(:targets).each do |target|
+              %li
+                - if target.fetch(:row)
+                  %a{ href: target.fetch(:url) }
+                    = record_label(relationship.target_relation, target.fetch(:row))
+                  ·
+                %a.secondary-link{ href: target.fetch(:junction_url) } View association record
+        %a.secondary-link{ href: entry.fetch(:junction_url) } Browse association records
+
+- unless @incoming_relationships.empty?
+  %section.relationship-section
+    %h3 Related records
+    - @incoming_relationships.each do |relationship|
+      %article.related-records
+        %header
+          %h4
+            %a{ href: relationship.fetch(:url) }
+              = "#{relationship.fetch(:namespace).name}.#{relationship.fetch(:relation).name}"
+          %span= relationship.fetch(:page).has_next ? 'More available' : "#{relationship.fetch(:page).rows.length} found"
+          - if relationship.fetch(:inferred)
+            %small inferred relationship
+        %ul
+          - relationship.fetch(:page).rows.each do |row|
+            %li
+              - source_relation = relationship.fetch(:relation)
+              - if source_relation.primary_key
+                %a{ href: record_url(relationship.fetch(:namespace).name, source_relation.name, row,
+                                     source_relation.primary_key) }
+                  = record_label(source_relation, row)
+              - else
+                != render_value(row.values.first, compact: true)

data/demo/README.md

@@ -0,0 +1,47 @@
+# RDBr demonstration
+
+The demo is a small fictional online shop containing customers, addresses,
+categories, products, tags, orders, order items, and shipments. Its generated
+data is deterministic and uses reserved `example.test` email addresses.
+
+The schema exercises declared one-to-many and many-to-many relationships,
+meaningful junction records with quantities and prices, inferred record
+identities, dates, timestamps, nullable fields, long text, JSON, unique values,
+and realistic filters. It is deliberately familiar and generic: no source data
+or schema comes from a real organisation.
+
+The seed command is destructive only for a database named `rdbr_demo` on
+`localhost`/`127.0.0.1`, or its fixed SQLite file under `tmp`. It refuses every
+other target.
+
+## SQLite
+
+```sh
+bundle install
+bundle exec ruby demo/seed.rb
+bundle exec ruby demo/smoke.rb
+bundle exec rdbr serve --database-url sqlite3:$(pwd)/tmp/rdbr-demo.sqlite3
+```
+
+## PostgreSQL
+
+```sh
+docker compose -f demo/compose.yml up -d postgres
+DEMO_DATABASE_URL=postgresql://postgres:postgres@127.0.0.1:55432/rdbr_demo \
+  bundle exec ruby demo/seed.rb
+bundle exec rdbr serve \
+  --database-url postgresql://postgres:postgres@127.0.0.1:55432/rdbr_demo
+```
+
+## MariaDB
+
+```sh
+docker compose -f demo/compose.yml up -d mariadb
+DEMO_DATABASE_URL=mysql2://root:mariadb@127.0.0.1:53306/rdbr_demo \
+  bundle exec ruby demo/seed.rb
+bundle exec rdbr serve \
+  --database-url mysql2://root:mariadb@127.0.0.1:53306/rdbr_demo
+```
+
+Stop the containers with `docker compose -f demo/compose.yml down`. Add `-v` if
+you also want to remove the disposable demonstration volumes.

data/demo/compose.yml

@@ -0,0 +1,34 @@
+services:
+  postgres:
+    image: postgres:18
+    environment:
+      POSTGRES_DB: rdbr_demo
+      POSTGRES_PASSWORD: postgres
+    ports:
+      - "55432:5432"
+    healthcheck:
+      test: [ "CMD-SHELL", "pg_isready -U postgres -d rdbr_demo" ]
+      interval: 2s
+      timeout: 5s
+      retries: 20
+    volumes:
+      - rdbr-demo-postgres:/var/lib/postgresql
+
+  mariadb:
+    image: mariadb:11.8
+    environment:
+      MARIADB_DATABASE: rdbr_demo
+      MARIADB_ROOT_PASSWORD: mariadb
+    ports:
+      - "53306:3306"
+    healthcheck:
+      test: [ "CMD", "healthcheck.sh", "--connect", "--innodb_initialized" ]
+      interval: 2s
+      timeout: 5s
+      retries: 30
+    volumes:
+      - rdbr-demo-mariadb:/var/lib/mysql
+
+volumes:
+  rdbr-demo-postgres:
+  rdbr-demo-mariadb: