Revamp SeaORM Tutorials (Issue #8)

.github/workflows/main.yml

@@ -17,10 +17,10 @@ jobs:
           toolchain: stable
 
       # Try to build all examples
-      - name: Build simple-crud example
-        run: cargo build --manifest-path simple-crud/Cargo.toml
-      - name: Build todo-app example
-        run: cargo build --manifest-path todo-app/Cargo.toml
+      - name: Build bakery-backend example
+        run: cargo build --manifest-path bakery-backend/Cargo.toml
+      - name: Build rocket-example
+        run: cargo build --manifest-path rocket-example/Cargo.toml
 
       # Try to build mdbooks
       - name: Install mdbook

Cargo.toml

@@ -0,0 +1,2 @@
+[workspace]
+members = ["bakery-backend", "rocket-example"]

README.md

@@ -1,21 +1,21 @@
 # SeaORM Tutorials
 
-This repository contains step-by-step tutorials on how to use SeaORM to do CRUD operations from simple ones to very complex online applications in Rust Language.
+This repository contains step-by-step tutorials on how to use SeaORM to do CRUD operations on databases in the Rust Language.
 
-The tutorial is based on a software system for managing fruits in a fruit market.
+The tutorial is based on a software system for managing a simple database to store information of bakeries.
 
-The tutorials are
+The tutorials contain the following chapters:
 
-1. [**Simple CRUD operations**](https://www.sea-ql.org/sea-orm-tutorial/ch01-00-simple-crud-getting-started.html) - This tutorials explains how to use SeaORM to do basic tasks like create a table in a database, insert a row into the table, update a column, delete operations and logging the results to the console. The database used is MySQL
-2. [**TODO Application**](https://www.sea-ql.org/sea-orm-tutorial/ch02-00-todo-app-getting-started.html) - This tutorial shows how to use SeaORM, SQLite and PostgreSQL to create a realtime sync TODO application where a user can buy fruits from the mango market.
+1. [**Bakery Backend**](https://www.sea-ql.org/sea-orm-tutorial/ch01-00-build-backend-getting-started.html) - This chapter covers the basics of using SeaORM to interact with the database (a MySQL database is used for illustration). On top of this backend you can build any interface you need.
+2. [**Rocket Integration**](https://www.sea-ql.org/sea-orm-tutorial/ch02-00-integration-with-rocket.html) - This chapter explains how to integrate the SeaORM backend into the Rocket framework to create a web application that provides a web API or even a simple frontend.
 
 [![Discord](https://img.shields.io/discord/873880840487206962?label=Discord)](https://discord.com/invite/uCPdDXzbdv)
 
 For additional help on **SeaORM** specific questions, join the support Discord chat.
 
 ## Running the tutorials
 
-To run the tutorial code, switch to the directory of the turorial and run cargo
+To run the tutorial code, switch to the directory of the tutorial and run cargo
 
 ```sh
 # Switch to tutorial directory

bakery-backend/.gitignore

@@ -0,0 +1 @@
+target

bakery-backend/Cargo.toml

@@ -0,0 +1,11 @@
+[package]
+name = "bakery-backend"
+version = "0.1.0"
+edition = "2021"
+
+# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
+
+[dependencies]
+futures = "0.3.21"
+sea-orm = { version = "0.8.0", features = [ "sqlx-mysql", "runtime-async-std-native-tls", "macros", "mock" ] }
+sea-orm-migration = "0.8.3"

bakery-backend/src/entities/baker.rs

@@ -0,0 +1,33 @@
+//! SeaORM Entity. Generated by sea-orm-codegen 0.8.0
+
+use sea_orm::entity::prelude::*;
+
+#[derive(Clone, Debug, PartialEq, DeriveEntityModel)]
+#[sea_orm(table_name = "baker")]
+pub struct Model {
+    #[sea_orm(primary_key)]
+    pub id: i32,
+    pub name: String,
+    pub contact_details: Option<Json>,
+    pub bakery_id: i32,
+}
+
+#[derive(Copy, Clone, Debug, EnumIter, DeriveRelation)]
+pub enum Relation {
+    #[sea_orm(
+        belongs_to = "super::bakery::Entity",
+        from = "Column::BakeryId",
+        to = "super::bakery::Column::Id",
+        on_update = "NoAction",
+        on_delete = "NoAction"
+    )]
+    Bakery,
+}
+
+impl Related<super::bakery::Entity> for Entity {
+    fn to() -> RelationDef {
+        Relation::Bakery.def()
+    }
+}
+
+impl ActiveModelBehavior for ActiveModel {}

bakery-backend/src/entities/bakery.rs

@@ -0,0 +1,26 @@
+//! SeaORM Entity. Generated by sea-orm-codegen 0.8.0
+
+use sea_orm::entity::prelude::*;
+
+#[derive(Clone, Debug, PartialEq, DeriveEntityModel)]
+#[sea_orm(table_name = "bakery")]
+pub struct Model {
+    #[sea_orm(primary_key)]
+    pub id: i32,
+    pub name: String,
+    pub profit_margin: f64,
+}
+
+#[derive(Copy, Clone, Debug, EnumIter, DeriveRelation)]
+pub enum Relation {
+    #[sea_orm(has_many = "super::baker::Entity")]
+    Baker,
+}
+
+impl Related<super::baker::Entity> for Entity {
+    fn to() -> RelationDef {
+        Relation::Baker.def()
+    }
+}
+
+impl ActiveModelBehavior for ActiveModel {}

bakery-backend/src/entities/mod.rs

@@ -0,0 +1,6 @@
+//! SeaORM Entity. Generated by sea-orm-codegen 0.8.0
+
+pub mod prelude;
+
+pub mod baker;
+pub mod bakery;

bakery-backend/src/entities/prelude.rs

@@ -0,0 +1,4 @@
+//! SeaORM Entity. Generated by sea-orm-codegen 0.8.0
+
+pub use super::baker::Entity as Baker;
+pub use super::bakery::Entity as Bakery;