Rename nested-forms to Master-Detail Forms

sqlpage · Jul 6, 2023 · 89bf840 · 89bf840
1 parent 5dad371
commit 89bf840
Show file tree

Hide file tree

Showing 12 changed files with 37 additions and 13 deletions.
diff --git a/README.md b/README.md
@@ -115,6 +115,7 @@ to the user's browser.
 
 - [Tiny splitwise clone](./examples/splitwise): a shared expense tracker app
 - [Corporate Conundrum](./examples/corporate-conundrum/): a board game implemented in SQL
+- [Master-Detail Form](./examples/master-detail-form/): shows how to implement a simple set of forms to insert data into database tables that have a one-to-many relationship.
 - [SQLPage's own official website and documentation](./examples/official-site/): The SQL source code for the project's official site, https://sql.ophir.dev
 
 ## Configuration

diff --git a/examples/master-detail-forms/README.md b/examples/master-detail-forms/README.md
@@ -0,0 +1,33 @@
+# Master-Detail Forms (Nested Forms)
+
+This example shows how to handle inserting data into multiple tables
+with a one-to-many relationship.
+
+![db schema](./screenshots/db-schema.png)
+
+A single master page features two forms based on two related tables or views.
+Users insert data in the master form first to update information from the parent table.
+Then, they can insert data in the detail forms to update information from the child tables.
+
+This example application contains a main form to create users,
+and a second form to create their addresses.
+
+Once an user has been added, multiple addresses can be added to it.
+
+See https://github.com/lovasoa/SQLpage/discussions/16 for more details.
+
+The main idea is to create two separate forms.
+In this example, we put both forms on the same page, in [`edit-user.sql`](./edit-user.sql).
+The first one is an edition form for the already-existing user record,
+and the second is a form to add an address to the user.
+
+When you initially load the user creation form,
+we do not display the address form.
+Only when the user has been created,
+you are redirected to the user edition form that contains the address form.
+
+
+## Screenshots
+
+![homepage](./screenshots/home-screenshot.png)
+![user addition](./screenshots//user-add-screenshot.png)
diff --git a/examples/nested-forms/edit_user.sql → examples/master-detail-forms/edit_user.sql b/examples/nested-forms/edit_user.sql → examples/master-detail-forms/edit_user.sql
diff --git a/examples/nested-forms/index.sql → examples/master-detail-forms/index.sql b/examples/nested-forms/index.sql → examples/master-detail-forms/index.sql
diff --git a/examples/nested-forms/insert_address.sql → ...es/master-detail-forms/insert_address.sql b/examples/nested-forms/insert_address.sql → ...es/master-detail-forms/insert_address.sql
diff --git a/examples/nested-forms/insert_user.sql → examples/master-detail-forms/insert_user.sql b/examples/nested-forms/insert_user.sql → examples/master-detail-forms/insert_user.sql
diff --git a/examples/master-detail-forms/screenshots/db-schema.png b/examples/master-detail-forms/screenshots/db-schema.png
diff --git a/examples/nested-forms/home-screenshot.png → ...ail-forms/screenshots/home-screenshot.png b/examples/nested-forms/home-screenshot.png → ...ail-forms/screenshots/home-screenshot.png
diff --git a/...ples/nested-forms/user-add-screenshot.png → ...forms/screenshots/user-add-screenshot.png b/...ples/nested-forms/user-add-screenshot.png → ...forms/screenshots/user-add-screenshot.png
diff --git a/...-forms/sqlpage/migrations/0000_schema.sql → ...-forms/sqlpage/migrations/0000_schema.sql b/...-forms/sqlpage/migrations/0000_schema.sql → ...-forms/sqlpage/migrations/0000_schema.sql
diff --git a/examples/nested-forms/README.md b/examples/nested-forms/README.md
diff --git a/examples/read-and-set-http-cookies/Dockerfile b/examples/read-and-set-http-cookies/Dockerfile
@@ -0,0 +1,3 @@
+FROM lovasoa/sqlpage
+
+COPY *.sql sqlpage ./