turborfq/bible/usage.md

Usage Guide

1. Login

1. Open the app in a browser (default: http://localhost:8080).
2. In the top login panel enter your MariaDB username and password.
3. Click Login.
4. On success the sidebar populates with a database → table tree.

---

2. Browse Data

1. Click any table in the sidebar.
2. The central grid loads the table's data:
   • Each column shows a header filter input — type to filter that column.
   • Pagination controls appear at the bottom; data is fetched server-side.

---

3. CRUD Operations

Insert a row

1. Click Insert in the toolbar.
2. A new empty row appears in the grid.
3. Fill in the cells and click Save row.

Edit a row

1. Click a row to select it.
2. Edit cells directly in the grid.
3. Click Save row to persist changes.

Updates are performed by primary key. Tables without a primary key should be treated as read-only.

Delete rows

1. Select one or more rows (checkbox column on the left).
2. Click Delete.
3. Confirm the deletion dialog.

---

4. CSV Import

1. Click Import CSV in the toolbar.
2. Select a .csv file from your filesystem.
3. The app inserts rows one by one and reports per-row errors if any.

CSV requirements:

• First row must be a header row matching column names.
• Data types must match the target table schema.

---

5. CSV Export

1. Click Export CSV in the toolbar.
2. The current table data (with active filters applied) is downloaded as a .csv file.

---

6. Database Backup

1. Click Backup in the toolbar.
2. A mysqldump of the current database is generated and downloaded as a .sql file.