From 1c4d3f138ec73187fd58bb83ebd76d29fc70ccac Mon Sep 17 00:00:00 2001 From: Xeevis Date: Sat, 22 Jun 2019 16:09:57 +0200 Subject: [PATCH 1/9] Copy Nightly-Builds.md --- docs/cs/Nightly-Builds.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 docs/cs/Nightly-Builds.md diff --git a/docs/cs/Nightly-Builds.md b/docs/cs/Nightly-Builds.md new file mode 100644 index 0000000000..e7ebe0f33b --- /dev/null +++ b/docs/cs/Nightly-Builds.md @@ -0,0 +1,26 @@ +# Nightly Builds + +All framework & module packages are deployed to MyGet every night in weekdays. So, you can use or test the latest code without waiting the next release. + +## Configure Visual Studio + +> Requires Visual Studio 2017+ + +1. Go to `Tools > Options > NuGet Package Manager > Package Source`. +2. Click the green `+` icon. +3. Set `ABP Nightly` as *Name* and `https://www.myget.org/F/abp-nightly/api/v3/index.json` as the *Source* as shown below: + ![night-build-add-nuget-source](images/night-build-add-nuget-source.png) +4. Click the `Update` button. +5. Click the `OK` button to save changes. + +## Install Package + +Now, you can install preview / nightly packages to your project from Nuget Browser or Package Manager Console. + +![night-build-add-nuget-package](images/night-build-add-nuget-package.png) + +1. In the nuget browser, select "Include prereleases". +2. Change package source to "All". +3. Search a package. You will see prereleases of the package formatted as `(VERSION)-preview(DATE)` (like *v0.16.0-preview20190401* in this sample). +4. You can click to the `Install` button to add package to your project. + From be3f886b047dc0f47fd06479b89467ca59eabc94 Mon Sep 17 00:00:00 2001 From: Xeevis Date: Sat, 22 Jun 2019 16:10:33 +0200 Subject: [PATCH 2/9] Translate Nightly-Builds.md --- docs/cs/Nightly-Builds.md | 30 +++++++++++++++--------------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/docs/cs/Nightly-Builds.md b/docs/cs/Nightly-Builds.md index e7ebe0f33b..e69588f5ff 100644 --- a/docs/cs/Nightly-Builds.md +++ b/docs/cs/Nightly-Builds.md @@ -1,26 +1,26 @@ -# Nightly Builds +# Noční sestavení -All framework & module packages are deployed to MyGet every night in weekdays. So, you can use or test the latest code without waiting the next release. +Všechny balíky frameworku a modulů jsou každý večer nasazeny na MyGet. Takže můžete používat nebo testovat nejnovější kód bez čekání na další vydání. -## Configure Visual Studio +## Konfigurace Visual Studia -> Requires Visual Studio 2017+ +> Vyžaduje Visual Studio 2017+ -1. Go to `Tools > Options > NuGet Package Manager > Package Source`. -2. Click the green `+` icon. -3. Set `ABP Nightly` as *Name* and `https://www.myget.org/F/abp-nightly/api/v3/index.json` as the *Source* as shown below: +1. Přejděte do `Tools > Options > NuGet Package Manager > Package Source`. +2. Klikněte na zelenou ikonku `+`. +3. Nastavte `ABP Nightly` jako *Name* a `https://www.myget.org/F/abp-nightly/api/v3/index.json` jako *Source* podle vyobrazení níže: ![night-build-add-nuget-source](images/night-build-add-nuget-source.png) -4. Click the `Update` button. -5. Click the `OK` button to save changes. +4. Klikněte na `Update`. +5. Klikněte na `OK` k uložení změn. -## Install Package +## Instalace balíku -Now, you can install preview / nightly packages to your project from Nuget Browser or Package Manager Console. +Nyní můžete instalovat náhledové / noční balíky do Vašeho projektu z NuGet prohlížeče nebo Package Manager Console. ![night-build-add-nuget-package](images/night-build-add-nuget-package.png) -1. In the nuget browser, select "Include prereleases". -2. Change package source to "All". -3. Search a package. You will see prereleases of the package formatted as `(VERSION)-preview(DATE)` (like *v0.16.0-preview20190401* in this sample). -4. You can click to the `Install` button to add package to your project. +1. V nuget prohlížeči, vyberte "Include prereleases". +2. Změňte zdroj balíků na "All". +3. Vyhledejte balík. Uvidíte prerelease balík formátovaný jako `(VERZE)-preview(DATUM)` (např *v0.16.0-preview20190401* jako v tomto vzorku). +4. Můžete kliknout na `Install` k přídání balíku do projektu. From 4b1a14438983d5b780cd6b41597af410546de0b9 Mon Sep 17 00:00:00 2001 From: Xeevis Date: Sat, 22 Jun 2019 16:11:34 +0200 Subject: [PATCH 3/9] Copy CLI.md --- docs/cs/CLI.md | 137 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 137 insertions(+) create mode 100644 docs/cs/CLI.md diff --git a/docs/cs/CLI.md b/docs/cs/CLI.md new file mode 100644 index 0000000000..1f461c9997 --- /dev/null +++ b/docs/cs/CLI.md @@ -0,0 +1,137 @@ +# ABP CLI + +ABP CLI (Command Line Interface) is a command line tool to perform some common operations for ABP based solutions. + +## Installation + +ABP CLI is a [dotnet global tool](https://docs.microsoft.com/en-us/dotnet/core/tools/global-tools). Install it using a command line window: + +````bash +dotnet tool install -g Volo.Abp.Cli +```` + +To update an existing installation: + +````bash +dotnet tool update -g Volo.Abp.Cli +```` + +## Commands + +### new + +Generates a new solution based on the ABP [startup templates](Startup-Templates/Index.md). + +Basic usage: + +````bash +abp new [options] +```` + +Example: + +````bash +abp new Acme.BookStore +```` + +* Acme.BookStore is the solution name here. +* Common convention is to name a solution is like *YourCompany.YourProject*. However, you can use different naming like *YourProject* (single level namespacing) or *YourCompany.YourProduct.YourModule* (three levels namespacing). + +#### Options + +* `--template` or `-t`: Specifies the template name. Default template name is `mvc`. Available templates: + * `mvc` (default): ASP.NET Core [MVC application template](Startup-Templates/Mvc.md). Additional options: + * `--database-provider` or `-d`: Specifies the database provider. Default provider is `ef`. Available providers: + * `ef`: Entity Framework Core. + * `mongodb`: MongoDB. + * `--tiered`: Creates a tiered solution where Web and Http API layers are physically separated. If not specified, it creates a layered solution which is less complex and suitable for most scenarios. + * `mvc-module`: ASP.NET Core [MVC module template](Startup-Templates/Mvc-Module.md). Additional options: + * `--no-ui`: Specifies to not include the UI. This makes possible to create service-only modules (a.k.a. microservices - without UI). +* `--output-folder` or `-o`: Specifies the output folder. Default value is the current directory. + +### add-package + +Adds a new ABP package to a project by, + +* Adding related nuget package as a dependency to the project. +* Adding `[DependsOn(...)]` attribute to the module class in the project (see the [module development document](Module-Development-Basics.md)). + +> Notice that the added module may require additional configuration which is generally indicated in the documentation of the related package. + +Basic usage: + +````bash +abp add-package [options] +```` + +Example: + +```` +abp add-package Volo.Abp.MongoDB +```` + +* This example adds the Volo.Abp.MongoDB package to the project. + +#### Options + +* `--project` or `-p`: Specifies the project (.csproj) file path. If not specified, CLI tries to find a .csproj file in the current directory. + +### add-module + +Adds a multi-package module to a solution by finding all packages of the module, finding related projects in the solution and adding each package to the corresponding project in the solution. + +> A business module generally consists of several packages (because of layering, different database providr options or other reasons). Using `add-module` command dramatically simplifies adding a module to a solution. However, each module may require some additional configurations which is generally indicated in the documentation of the related module. + +Basic usage: + +````bash +abp add-module [options] +```` + +Example: + +```bash +abp add-module Volo.Blogging +``` + +* This example add the Volo.Blogging module to the solution. + +#### Options + +* `--solution` or `-s`: Specifies the solution (.sln) file path. If not specified, CLI tries to find a .sln file in the current directory. +* `--skip-db-migrations`: For EF Core database provider, it automatically adds a new code first migration (`Add-Migration`) and updates the database (`Update-Database`) if necessary. Specify this option to skip this operation. + +### update + +Updating all ABP related packages can be tedious since there are many packages of the framework and modules. This command automatically updates all ABP NuGet related packages and NPM packages in a solution or project to the latest versions. + +Usage: + +````bash +abp update [options] +```` + +* If you run in a directory with a .sln file, it updates all ABP related packages of the all projects of the solution to the latest versions. +* If you run in a directory with a .csproj file, it updates all ABP related packages of the project to the latest versions. + +#### Options + +* `--include-previews` or `-p`: Includes preview, beta and rc packages while checking the latest versions. + +### help + +Writes basic usage information of the CLI. + +Usage: + +````bash +abp help [command-name] +```` + +Examples: + +````bash +abp help # Shows a general help. +abp help new # Shows help about the "new" command. +```` + From f6515f9cb12f7a8ac61d784dc8c6b21adb3b7113 Mon Sep 17 00:00:00 2001 From: Xeevis Date: Sat, 22 Jun 2019 20:47:29 +0200 Subject: [PATCH 4/9] Translate CLI.md --- docs/cs/CLI.md | 102 ++++++++++++++++++++++++------------------------- 1 file changed, 51 insertions(+), 51 deletions(-) diff --git a/docs/cs/CLI.md b/docs/cs/CLI.md index 1f461c9997..928b302946 100644 --- a/docs/cs/CLI.md +++ b/docs/cs/CLI.md @@ -1,137 +1,137 @@ # ABP CLI -ABP CLI (Command Line Interface) is a command line tool to perform some common operations for ABP based solutions. +ABP CLI (Command Line Interface) je nástroj v příkazovém řádku k provádění některých běžných úkonů v řešeních založených na ABP. -## Installation +## Instalace -ABP CLI is a [dotnet global tool](https://docs.microsoft.com/en-us/dotnet/core/tools/global-tools). Install it using a command line window: +ABP CLI je [dotnet global tool](https://docs.microsoft.com/en-us/dotnet/core/tools/global-tools). Nainstalujete jej pomocí okna příkazového řádku: ````bash dotnet tool install -g Volo.Abp.Cli ```` -To update an existing installation: +Aktualizace stávající instalace: ````bash dotnet tool update -g Volo.Abp.Cli ```` -## Commands +## Příkazy ### new -Generates a new solution based on the ABP [startup templates](Startup-Templates/Index.md). +Vygeneruje nové řešení založené na ABP [startovací šabloně](Startup-Templates/Index.md). -Basic usage: +Základní použití: ````bash -abp new [options] +abp new [možnosti] ```` -Example: +Příklad: ````bash abp new Acme.BookStore ```` -* Acme.BookStore is the solution name here. -* Common convention is to name a solution is like *YourCompany.YourProject*. However, you can use different naming like *YourProject* (single level namespacing) or *YourCompany.YourProduct.YourModule* (three levels namespacing). +* Acme.BookStore je tady název řešení. +* Běžná konvence je nazvat řešení stylem *VašeSpolečnost.VášProjekt*. Nicméně můžete použít i jiné pojmenování jako *VášProjekt* (jednostupňový jmenný prostor) nebo *VašeSpolečnost.VášProdukt.VášModul* (třístupňový jmenný prostor). -#### Options +#### Možnosti -* `--template` or `-t`: Specifies the template name. Default template name is `mvc`. Available templates: - * `mvc` (default): ASP.NET Core [MVC application template](Startup-Templates/Mvc.md). Additional options: - * `--database-provider` or `-d`: Specifies the database provider. Default provider is `ef`. Available providers: +* `--template` nebo `-t`: Určuje název šablony. Výchozí šablona je `mvc`. Dostupné šablony: + * `mvc` (výchozí): ASP.NET Core [MVC aplikační šablona](Startup-Templates/Mvc.md). Dodatečné možnosti: + * `--database-provider` nebo `-d`: Určuje poskytovatele databáze. Vychozí poskytovatel je `ef`. Dostupní poskytovatelé: * `ef`: Entity Framework Core. * `mongodb`: MongoDB. - * `--tiered`: Creates a tiered solution where Web and Http API layers are physically separated. If not specified, it creates a layered solution which is less complex and suitable for most scenarios. - * `mvc-module`: ASP.NET Core [MVC module template](Startup-Templates/Mvc-Module.md). Additional options: - * `--no-ui`: Specifies to not include the UI. This makes possible to create service-only modules (a.k.a. microservices - without UI). -* `--output-folder` or `-o`: Specifies the output folder. Default value is the current directory. + * `--tiered`: Vytvoří stupňovité řešení, kde jsou vrstvy Web a Http API fyzicky odděleny. Pokud není uvedeno tak vytvoří vrstvené řešení, které je méně složité a vhodné pro většinu scénářů. + * `mvc-module`: ASP.NET Core [MVC modulová šablona](Startup-Templates/Mvc-Module.md). Dodatečné možnosti: + * `--no-ui`: Určuje, že nebude zahrnuto uživatelské rozhraní. To umožňuje vytvářet moduly pouze pro služby (a.k.a. mikroslužby - bez UI). +* `--output-folder` nebo `-o`: Určuje výstupní složku. Výchozí hodnota je aktuální adresář. ### add-package -Adds a new ABP package to a project by, +Přidá nový balíček ABP do projektu pomocí, -* Adding related nuget package as a dependency to the project. -* Adding `[DependsOn(...)]` attribute to the module class in the project (see the [module development document](Module-Development-Basics.md)). +* Přidání souvisejícícho nuget balíčku jako závislost do projektu. +* Přidáním `[DependsOn(...)]` atributu k modulové tříde v projektu (podívejte se na [dokument vývoje modulu](Module-Development-Basics.md)). -> Notice that the added module may require additional configuration which is generally indicated in the documentation of the related package. +> Všimněte si, že přidaný modul může vyžadovat další konfiguraci, která je obecně uvedena v dokumentaci příslušného balíčku. -Basic usage: +Základní použití: ````bash -abp add-package [options] +abp add-package [možnosti] ```` -Example: +Příklad: ```` abp add-package Volo.Abp.MongoDB ```` -* This example adds the Volo.Abp.MongoDB package to the project. +* Tento příklad přidá do projektu balíček Volo.Abp.MongoDB. -#### Options +#### Možnosti -* `--project` or `-p`: Specifies the project (.csproj) file path. If not specified, CLI tries to find a .csproj file in the current directory. +* `--project` nebo `-p`: Určuje cestu k projektu (.csproj). Pokud není zadáno, CLI se pokusí najít soubor .csproj v aktuálním adresáři. ### add-module -Adds a multi-package module to a solution by finding all packages of the module, finding related projects in the solution and adding each package to the corresponding project in the solution. +Přidá více-balíčkový modul k řešení tím, že najde všechny balíčky modulu, vyhledá související projekty v řešení a přidá každý balíček do odpovídajícího projektu v řešení. -> A business module generally consists of several packages (because of layering, different database providr options or other reasons). Using `add-module` command dramatically simplifies adding a module to a solution. However, each module may require some additional configurations which is generally indicated in the documentation of the related module. +> Modul se obecně skládá z několika balíčků (z důvodu vrstvení, různých možností poskytovatele databáze nebo jiných důvodů). Použití příkazu `add-module` dramaticky zjednodušuje přidání modulu do řešení. Každý modul však může vyžadovat další konfiguraci, která je obecně uvedena v dokumentaci příslušného modulu. -Basic usage: +Základní použití: ````bash -abp add-module [options] +abp add-module [možnosti] ```` -Example: +Příklad: ```bash abp add-module Volo.Blogging ``` -* This example add the Volo.Blogging module to the solution. +* Tento příklad přidá do projektu modul Volo.Blogging. -#### Options +#### Možnosti -* `--solution` or `-s`: Specifies the solution (.sln) file path. If not specified, CLI tries to find a .sln file in the current directory. -* `--skip-db-migrations`: For EF Core database provider, it automatically adds a new code first migration (`Add-Migration`) and updates the database (`Update-Database`) if necessary. Specify this option to skip this operation. +* `--solution` nebo `-s`: Určuje cestu k řešení (.sln). Pokud není zadáno, CLI se pokusí najít soubor .sln v aktuálním adresáři. +* `--skip-db-migrations`: Pro poskytovatele databáze EF Core automaticky přidá nový kód první migrace (`Add-Migration`) a v případě potřeby aktualizuje databázi (`Update-Database`). Tuto možnost určete k vynechání této operace. ### update -Updating all ABP related packages can be tedious since there are many packages of the framework and modules. This command automatically updates all ABP NuGet related packages and NPM packages in a solution or project to the latest versions. +Aktualizace všech balíčků souvisejících s ABP může být únavná, protože existuje mnoho balíčků frameworku a modulů. Tento příkaz automaticky aktualizuje na poslední verze všechny související ABP NuGet a NPM balíčky v řešení nebo projektu. -Usage: +Použití: ````bash -abp update [options] +abp update [možnosti] ```` -* If you run in a directory with a .sln file, it updates all ABP related packages of the all projects of the solution to the latest versions. -* If you run in a directory with a .csproj file, it updates all ABP related packages of the project to the latest versions. +* Pokud spouštíte v adresáři se souborem .sln, aktualizuje všechny balíčky všech projektů v řešení souvisejících s ABP na nejnovější verze. +* Pokud spouštíte v adresáři se souborem .csproj, aktualizuje všechny balíčky v projektu na nejnovější verze. -#### Options +#### Možnosti -* `--include-previews` or `-p`: Includes preview, beta and rc packages while checking the latest versions. +* `--include-previews` nebo `-p`: Zahrne náhledové, beta a rc balíčky při kontrole nových verzí. ### help -Writes basic usage information of the CLI. +Vypíše základní informace k používání CLI. -Usage: +Použítí: ````bash -abp help [command-name] +abp help [název-příkazu] ```` -Examples: +Příklady: ````bash -abp help # Shows a general help. -abp help new # Shows help about the "new" command. +abp help # Zobrazí obecnou nápovědu. +abp help new # Zobrazí nápovědu k příkazu "new". ```` From 1e4877a4659862813ef3767ab8d6428d4121fff4 Mon Sep 17 00:00:00 2001 From: Xeevis Date: Sun, 23 Jun 2019 07:35:53 +0200 Subject: [PATCH 5/9] Copy Autofac-Integration.md --- docs/cs/Autofac-Integration.md | 84 ++++++++++++++++++++++++++++++++++ 1 file changed, 84 insertions(+) create mode 100644 docs/cs/Autofac-Integration.md diff --git a/docs/cs/Autofac-Integration.md b/docs/cs/Autofac-Integration.md new file mode 100644 index 0000000000..b3aced3e94 --- /dev/null +++ b/docs/cs/Autofac-Integration.md @@ -0,0 +1,84 @@ +# Autofac Integration + +Autofac is one of the most used dependency injection frameworks for .Net. It provides some advanced features compared to .Net Core standard DI library, like dynamic proxying and property injection. + +## Install Autofac Integration + +> All startup templates and samples are Autofac integrated. So, most of the time you don't need to manually install this package. + +Install [Volo.Abp.Autofac](https://www.nuget.org/packages/Volo.Abp.Autofac) nuget package to your project (for a multi-projects application, it's suggested to add to the executable/web project.) + +```` +Install-Package Volo.Abp.Autofac +```` + +Then add `AbpAutofacModule` dependency to your module: + +```csharp +using Volo.Abp.Modularity; +using Volo.Abp.Autofac; + +namespace MyCompany.MyProject +{ + [DependsOn(typeof(AbpAutofacModule))] + public class MyModule : AbpModule + { + //... + } +} +``` + +Finally, configure `AbpApplicationCreationOptions` to replace default dependency injection services by Autofac. It depends on the application type. + +### ASP.NET Core Application + +Call `UseAutofac()` in the **Startup.cs** file as shown below: + +````csharp +public class Startup +{ + public IServiceProvider ConfigureServices(IServiceCollection services) + { + services.AddApplication(options => + { + //Integrate Autofac! + options.UseAutofac(); + }); + + return services.BuildServiceProviderFromFactory(); + } + + public void Configure(IApplicationBuilder app) + { + app.InitializeApplication(); + } +} +```` + +### Console Application + +Call `UseAutofac()` method in the `AbpApplicationFactory.Create` options as shown below: + +````csharp +using System; +using Microsoft.Extensions.DependencyInjection; +using Volo.Abp; + +namespace AbpConsoleDemo +{ + class Program + { + static void Main(string[] args) + { + using (var application = AbpApplicationFactory.Create(options => + { + options.UseAutofac(); //Autofac integration + })) + { + //... + } + } + } +} +```` + From 082d81ed78bd0c5f993b3419951bb4377b753f5c Mon Sep 17 00:00:00 2001 From: Xeevis Date: Sun, 23 Jun 2019 08:08:35 +0200 Subject: [PATCH 6/9] Translate Autofac-Integration.md --- docs/cs/Autofac-Integration.md | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/docs/cs/Autofac-Integration.md b/docs/cs/Autofac-Integration.md index b3aced3e94..109dca6286 100644 --- a/docs/cs/Autofac-Integration.md +++ b/docs/cs/Autofac-Integration.md @@ -1,18 +1,18 @@ -# Autofac Integration +# Autofac integrace -Autofac is one of the most used dependency injection frameworks for .Net. It provides some advanced features compared to .Net Core standard DI library, like dynamic proxying and property injection. +Autofac je jedním z nejpoužívanějších frameworků pro .Net pro vkládání závislostí (DI). Poskytuje pokročilejší funkce v porovnáním se standardní .Net Core DI knihovnou, jako dynamickou proxy a injekci vlastností. -## Install Autofac Integration +## Instalace Autofac integrace -> All startup templates and samples are Autofac integrated. So, most of the time you don't need to manually install this package. +> Všechny startovací šablony a vzorky jsou s Autofac již integrovány. Takže většinou nemusíte tento balíček instalovat ručně. -Install [Volo.Abp.Autofac](https://www.nuget.org/packages/Volo.Abp.Autofac) nuget package to your project (for a multi-projects application, it's suggested to add to the executable/web project.) +Nainstalujte do vašeho projektu balíček [Volo.Abp.Autofac](https://www.nuget.org/packages/Volo.Abp.Autofac) (pro víceprojektovou aplikaci se doporučuje přidat do spustitelného/webového projektu.) ```` Install-Package Volo.Abp.Autofac ```` -Then add `AbpAutofacModule` dependency to your module: +Poté přídejte k vašemu modulu závislost na `AbpAutofacModule`: ```csharp using Volo.Abp.Modularity; @@ -28,11 +28,11 @@ namespace MyCompany.MyProject } ``` -Finally, configure `AbpApplicationCreationOptions` to replace default dependency injection services by Autofac. It depends on the application type. +Nakonec nastavte `AbpApplicationCreationOptions` aby nahradil výchozí služby pro vkládání závislostí na Autofac. Záleží na typu aplikace. -### ASP.NET Core Application +### ASP.NET Core aplikace -Call `UseAutofac()` in the **Startup.cs** file as shown below: +Volejte `UseAutofac()` v souboru **Startup.cs** jako je ukázáno níže: ````csharp public class Startup @@ -41,7 +41,7 @@ public class Startup { services.AddApplication(options => { - //Integrate Autofac! + //Integrace Autofac! options.UseAutofac(); }); @@ -55,9 +55,9 @@ public class Startup } ```` -### Console Application +### Konzolová aplikace -Call `UseAutofac()` method in the `AbpApplicationFactory.Create` options as shown below: +Volejte metodu `UseAutofac()` v možnostech `AbpApplicationFactory.Create` jako je ukázáno níže: ````csharp using System; @@ -72,7 +72,7 @@ namespace AbpConsoleDemo { using (var application = AbpApplicationFactory.Create(options => { - options.UseAutofac(); //Autofac integration + options.UseAutofac(); //Autofac integrace })) { //... From 241be8f46afeb43b14499f8fed9ff52621b0371b Mon Sep 17 00:00:00 2001 From: Xeevis Date: Sun, 23 Jun 2019 08:11:11 +0200 Subject: [PATCH 7/9] Fix Cli.md --- docs/cs/CLI.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cs/CLI.md b/docs/cs/CLI.md index 928b302946..f3f2d21a96 100644 --- a/docs/cs/CLI.md +++ b/docs/cs/CLI.md @@ -35,7 +35,7 @@ abp new Acme.BookStore ```` * Acme.BookStore je tady název řešení. -* Běžná konvence je nazvat řešení stylem *VašeSpolečnost.VášProjekt*. Nicméně můžete použít i jiné pojmenování jako *VášProjekt* (jednostupňový jmenný prostor) nebo *VašeSpolečnost.VášProdukt.VášModul* (třístupňový jmenný prostor). +* Běžná konvence je nazvat řešení stylem *VaseSpolecnost.VasProjekt*. Nicméně můžete použít i jiné pojmenování jako *VasProjekt* (jednostupňový jmenný prostor) nebo *VaseSpolecnost.VasProjekt.VasModul* (třístupňový jmenný prostor). #### Možnosti From 93221c69ecfa36001440eaa73bfbcaa461828459 Mon Sep 17 00:00:00 2001 From: Xeevis Date: Sun, 23 Jun 2019 08:17:41 +0200 Subject: [PATCH 8/9] Copy Domain-Driven-Design.md --- docs/cs/Domain-Driven-Design.md | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 docs/cs/Domain-Driven-Design.md diff --git a/docs/cs/Domain-Driven-Design.md b/docs/cs/Domain-Driven-Design.md new file mode 100644 index 0000000000..4f2d06be7d --- /dev/null +++ b/docs/cs/Domain-Driven-Design.md @@ -0,0 +1,33 @@ +# Domain Driven Design + +## What is DDD? + +ABP framework provides an **infrastructure** to make **DDD** based development easier to implement. DDD is [defined in the Wikipedia](https://en.wikipedia.org/wiki/Domain-driven_design) as below: + +> **Domain-driven design** (**DDD**) is an approach to software development for complex needs by connecting the implementation to an evolving model. The premise of domain-driven design is the following: +> +> - Placing the project's primary focus on the core domain and domain logic; +> - Basing complex designs on a model of the domain; +> - Initiating a creative collaboration between technical and domain experts to iteratively refine a conceptual model that addresses particular domain problems. + +### Layers + +ABP follows DDD principles and patterns to achieve a layered application model which consists of four fundamental layers: + +- **Presentation Layer**: Provides an interface to the user. Uses the *Application Layer* to achieve user interactions. +- **Application Layer**: Mediates between the Presentation and Domain Layers. Orchestrates business objects to perform specific application tasks. Implements use cases as the application logic. +- **Domain Layer**: Includes business objects and their business rules. This is the heart of the application. +- **Infrastructure Layer**: Provides generic technical capabilities that support higher layers mostly using 3rd-party libraries. + +## Contents + +* **Domain Layer** + * [Entities & Aggregate Roots](Entities.md) + * Value Objects + * [Repositories](Repositories.md) + * Domain Services + * Specifications +* **Application Layer** + * [Application Services](Application-Services.md) + * [Data Transfer Objects (DTOs)](Data-Transfer-Objects.md) + * Unit of Work \ No newline at end of file From 473813e3980c8c42ce435f1cc5314b20969ab11b Mon Sep 17 00:00:00 2001 From: Xeevis Date: Sun, 23 Jun 2019 16:56:20 +0200 Subject: [PATCH 9/9] Translate Domain-Driven-Design.md --- docs/cs/Domain-Driven-Design.md | 56 ++++++++++++++++----------------- 1 file changed, 28 insertions(+), 28 deletions(-) diff --git a/docs/cs/Domain-Driven-Design.md b/docs/cs/Domain-Driven-Design.md index 4f2d06be7d..161e92c8a2 100644 --- a/docs/cs/Domain-Driven-Design.md +++ b/docs/cs/Domain-Driven-Design.md @@ -1,33 +1,33 @@ # Domain Driven Design -## What is DDD? +## Co je DDD? -ABP framework provides an **infrastructure** to make **DDD** based development easier to implement. DDD is [defined in the Wikipedia](https://en.wikipedia.org/wiki/Domain-driven_design) as below: +ABP framework poskytuje **infrastrukturu**, která zjednodušuje implementaci vývoje založeného na **DDD**. DDD je [definován ve Wikipedii](https://en.wikipedia.org/wiki/Domain-driven_design) takto: -> **Domain-driven design** (**DDD**) is an approach to software development for complex needs by connecting the implementation to an evolving model. The premise of domain-driven design is the following: +> **Domain-driven design** (**DDD**) je přístup k vývoji softwaru pro komplexní potřeby propojením implementace s vyvíjejícím se modelem. Předpoklad DDD je následující: > -> - Placing the project's primary focus on the core domain and domain logic; -> - Basing complex designs on a model of the domain; -> - Initiating a creative collaboration between technical and domain experts to iteratively refine a conceptual model that addresses particular domain problems. - -### Layers - -ABP follows DDD principles and patterns to achieve a layered application model which consists of four fundamental layers: - -- **Presentation Layer**: Provides an interface to the user. Uses the *Application Layer* to achieve user interactions. -- **Application Layer**: Mediates between the Presentation and Domain Layers. Orchestrates business objects to perform specific application tasks. Implements use cases as the application logic. -- **Domain Layer**: Includes business objects and their business rules. This is the heart of the application. -- **Infrastructure Layer**: Provides generic technical capabilities that support higher layers mostly using 3rd-party libraries. - -## Contents - -* **Domain Layer** - * [Entities & Aggregate Roots](Entities.md) - * Value Objects - * [Repositories](Repositories.md) - * Domain Services - * Specifications -* **Application Layer** - * [Application Services](Application-Services.md) - * [Data Transfer Objects (DTOs)](Data-Transfer-Objects.md) - * Unit of Work \ No newline at end of file +> - Primární zaměření projektu je na jádře domény a doménové logice; +> - Zakládání komplexních návrhů na modelu domény; +> - Iniciování tvůrčí spolupráce mezi technickými a doménovými odborníky s cílem iterativně zdokonalit koncepční model, který řeší konkrétní problémy v doméně. + +### Vrstvy + +ABP dodržuje principy a vzorce DDD pro dosažení vrstveného aplikačního modelu, který se skládá ze čtyř základních vrstev: + +- **Prezentační vrstva**: Poskytuje uživateli rozhraní. Používá *Aplikační vrstvu* k dosažení uživatelských interakcí. +- **Aplikační vrstva**: Prostředník mezi prezentační a doménovou vrstvou. Instrumentuje business objekty k provádění specifických úloh aplikace. Implementuje případy použití jako logiku aplikace. +- **Doménová vrstva**: Zahrnuje business objekty a jejich business pravidla. Je jádrem aplikace. +- **Vrstva infrastruktury**: Poskytuje obecné technické možnosti, které podporují vyšší vrstvy většinou pomocí knihoven třetích stran. + +## Obsah + +* **Doménová vrstva** + * [Entity & agregované kořeny](Entities.md) + * Hodnotové objekty + * [Repozitáře](Repositories.md) + * Doménové služby + * Specifikace +* **Aplikační vrstva** + * [Aplikační služby](Application-Services.md) + * [Objekty přenosu dat (DTOs)](Data-Transfer-Objects.md) + * Jednotka práce \ No newline at end of file