diff --git a/docs/en/docs-nav.json b/docs/en/docs-nav.json index 2ffd98439a..04be0c67b0 100644 --- a/docs/en/docs-nav.json +++ b/docs/en/docs-nav.json @@ -67,7 +67,7 @@ ] }, { - "text": "Web Application Development", + "text": "Book Store Application", "items": [ { "text": "Overview", @@ -115,6 +115,19 @@ } ] }, + { + "text": "Book Store Application (with ABP Suite)", + "items": [ + { + "text": "Overview", + "path": "tutorials/book-store-with-abp-suite" + }, + { + "text": "1: Creating the Solution", + "path": "tutorials/book-store-with-abp-suite/part-01.md" + } + ] + }, { "text": "Modular Monolith Application", "items": [ diff --git a/docs/en/tutorials/book-store-with-abp-suite/images/book-store-suite-solution-explorer.png b/docs/en/tutorials/book-store-with-abp-suite/images/book-store-suite-solution-explorer.png new file mode 100644 index 0000000000..ad2fd1de23 Binary files /dev/null and b/docs/en/tutorials/book-store-with-abp-suite/images/book-store-suite-solution-explorer.png differ diff --git a/docs/en/tutorials/book-store-with-abp-suite/index.md b/docs/en/tutorials/book-store-with-abp-suite/index.md new file mode 100644 index 0000000000..6add9dfadf --- /dev/null +++ b/docs/en/tutorials/book-store-with-abp-suite/index.md @@ -0,0 +1,39 @@ +# Web Application Development (with ABP Suite) Tutorial +````json +//[doc-params] +{ + "UI": ["MVC"], + "DB": ["EF"] +} +```` +````json +//[doc-nav] +{ + "Next": { + "Name": "Creating the Solution", + "Path": "tutorials/book-store-with-abp-suite/part-01" + } +} +```` + +## About This Tutorial + +> In this tutorial, you will use the [ABP Suite](../../suite/index.md) to generate everything you need to build the **BookStore** application, such as [*Entities*](../../framework/architecture/domain-driven-design/entities.md), [*Domain Services*](../../framework/architecture/domain-driven-design/domain-services.md), [*Application Services*](../../framework/architecture/domain-driven-design/application-services.md), *CRUD pages* and more... + +> You must have an **ABP Team** or a higher license to use the ABP Suite. + +In this tutorial series, you will build an ABP based web application named `Acme.BookStore`. This application is used to manage a list of books and their authors. It is developed using the following technologies: + +* **{{DB_Value}}** as the database provider. +* **{{UI_Value}}** as the UI Framework. + +This tutorial is organized as the following parts: + +- [Part 1: Creating the Solution](part-01.md), +- [Part 2: Creating the Books](part-02.md) +- [Part 3: Creating the Authors](part-03.md) +- [Part 4: Customizing the Generated Code](part-04.md) + +### Download the Source Code + +//TODO: create the sample application in the abp-commercial-samples repository and place the links here!!! \ No newline at end of file diff --git a/docs/en/tutorials/book-store-with-abp-suite/part-01.md b/docs/en/tutorials/book-store-with-abp-suite/part-01.md new file mode 100644 index 0000000000..f74315afc9 --- /dev/null +++ b/docs/en/tutorials/book-store-with-abp-suite/part-01.md @@ -0,0 +1,35 @@ +# Web Application Development (with ABP Suite) Tutorial - Part 1: Creating the Solution +````json +//[doc-params] +{ + "UI": ["MVC"], + "DB": ["EF"] +} +```` +````json +//[doc-nav] +{ + "Next": { + "Name": "Creating the Books", + "Path": "tutorials/book-store-with-abp-suite/part-02" + } +} +```` + +Before starting the development, create a new solution named `Acme.BookStore` and run it by following the [getting started tutorial](../../get-started/layered-web-application.md) + +You can use the following configurations: + +* **Solution Name:** `Acme.BookStore` +* **UI Framework:** {{if UI=="MVC}} ASP.NET Core MVC / Razor Pages {{end}} +* **UI Theme:** LeptonX +* **Mobile Framwork:** None +* **Database Provider:** {{if DB=="EF"}} Entity Framework Core {{end}} + +You can select the other options based on your preference. + +> **Please complete the [Get Stared](../../get-started/layered-web-application.md) guide and run the web application before going further.** + +The initial solution structure should be like the following in the ABP Studio's [Solution Explorer](../../studio/solution-explorer.md): + +![](./images/book-store-suite-solution-explorer.png) \ No newline at end of file