netcore-blueprint 0.0.6 → 0.0.8

package/BlueprintTemplate/Host.API/Extensions/DatabaseExtensions.cs

@@ -1,5 +1,5 @@
 using Microsoft.EntityFrameworkCore;
-using Shared.Infrastructure;
+using Shared.Infrastructure.Database;
 
 namespace Host.API.Extensions
 {

package/BlueprintTemplate/Host.API/Extensions/ModuleExtension.cs

@@ -0,0 +1,34 @@
+using Shared.Core.Interfaces.Modules;
+
+namespace Host.API.Extensions
+{
+    public static class ModuleExtensions
+    {
+        public static IServiceCollection AddModules(
+            this IServiceCollection services,
+            IConfiguration config)
+        {
+            var modules = AppDomain.CurrentDomain
+                .GetAssemblies()
+                .SelectMany(a => a.GetTypes())
+                .Where(t => typeof(IModule).IsAssignableFrom(t)
+                         && !t.IsInterface
+                         && !t.IsAbstract)
+                .Select(t => (IModule)Activator.CreateInstance(t)!);
+
+            foreach (var module in modules)
+            {
+                // Enable/disable via config (optional V1)
+                module.Register(services, config);
+
+                services.AddControllers()
+                    .AddApplicationPart(module.ApiAssembly);
+
+                services.AddAutoMapper(cfg => { }, module.MappingAssembly);
+            }
+
+            return services;
+        }
+    }
+
+}

package/BlueprintTemplate/Host.API/Extensions/ServiceCollectionExtensions.cs

@@ -12,9 +12,7 @@ namespace Host.API.Extensions
             this IServiceCollection services,
             IConfiguration configuration)
         {
-            services.AddControllers()
-                .AddApplicationPart(typeof(UserController).Assembly)
-                .AddApplicationPart(typeof(ItemController).Assembly);
+            services.AddControllers();
 
             services.AddEndpointsApiExplorer();
             services.AddSwaggerGen();
@@ -33,19 +31,7 @@ namespace Host.API.Extensions
             return services;
         }
 
-        public static IServiceCollection AddUserModule(this IServiceCollection services)
-        {
-            UserDependencyInjection.AddUserModuleInfra(services);
-            return services;
-        }
-
         public static IServiceCollection AddItemModule(this IServiceCollection services)
-        {
-            ItemDependencyInjection.AddItemModuleInfra(services);
-            return services;
-        }
-
-        public static IServiceCollection AddSharedModule(this IServiceCollection services)
         {
             SharedDependencyInjection.AddSharedInfrastructure(services);
             return services;

package/BlueprintTemplate/Host.API/Extensions/ThirdPartyExtensions.cs

@@ -1,6 +1,4 @@
 using Asp.Versioning;
-using ItemModule.API.Mappers;
-using UserModule.API.Mappers;
 
 namespace Host.API.Extensions
 {
@@ -9,9 +7,7 @@ namespace Host.API.Extensions
         public static IServiceCollection AddThirdParty(this IServiceCollection services)
         {
             services.AddAutoMapper(
-                cfg => { },
-                typeof(DtoItemMappingProfile).Assembly,
-                typeof(DtoUserMappingProfile).Assembly
+                cfg => { }
             );
 
             services.AddApiVersioning(opt =>

package/BlueprintTemplate/Host.API/Program.cs

@@ -9,9 +9,8 @@ builder.Services.AddApiCore(builder.Configuration);
 builder.Services.AddThirdParty();
 
 // Modules
-builder.Services.AddUserModule();
 builder.Services.AddItemModule();
-builder.Services.AddSharedModule();
+builder.Services.AddModules(builder.Configuration);
 
 // Database
 builder.Services.AddMySqlDatabase(builder.Configuration);

package/BlueprintTemplate/ItemModule.API/ItemModule.API.csproj

@@ -20,6 +20,7 @@
 
   <ItemGroup>
     <ProjectReference Include="..\ItemModule.Core\ItemModule.Core.csproj" />
+    <ProjectReference Include="..\ItemModule.Infrastructure\ItemModule.Infrastructure.csproj" />
     <ProjectReference Include="..\Shared.Core\Shared.Core.csproj" />
   </ItemGroup>
 

package/BlueprintTemplate/ItemModule.API/ItemModule.cs

@@ -0,0 +1,24 @@
+using ItemModule.API.Controllers.Public;
+using ItemModule.API.Mappers;
+using ItemModule.Core;
+using ItemModule.Infrastructure;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using Shared.Core.Interfaces.Modules;
+using System.Reflection;
+
+namespace ItemModule.API
+{
+    public class ItemModule : IModule
+    {
+        public string Name => "Item";
+        public void Register(IServiceCollection services, IConfiguration config)
+        {
+            ItemCoreDependencyInjection.AddModule(services);
+            ItemInfraDependencyInjection.AddModule(services);
+        }
+
+        public Assembly ApiAssembly => typeof(ItemController).Assembly;
+        public Assembly MappingAssembly => typeof(DtoItemMappingProfile).Assembly;
+    }
+}

package/BlueprintTemplate/ItemModule.Core/ItemCoreDependencyInjection.cs

@@ -0,0 +1,19 @@
+using ItemModule.Core.Interfaces.API;
+using ItemModule.Core.Services;
+using Microsoft.Extensions.DependencyInjection;
+using Shared.Core.Interfaces.API;
+using Shared.Core.Services;
+
+namespace ItemModule.Core
+{
+    public static class ItemCoreDependencyInjection
+    {
+        public static IServiceCollection AddModule(
+             this IServiceCollection services)
+        {
+            services.AddScoped(typeof(IItemService<>), typeof(ItemService<>));
+            services.AddScoped<IItemService, ItemService>();
+            return services;
+        }
+    }
+}

package/BlueprintTemplate/ItemModule.Infrastructure/{ItemDependencyInjection.cs → ItemInfraDependencyInjection.cs}

@@ -1,26 +1,20 @@
-using ItemModule.Core.Interfaces.API;
-using ItemModule.Core.Interfaces.SPI;
-using ItemModule.Core.Services;
+using ItemModule.Core.Interfaces.SPI;
 using ItemModule.Infrastructure.Database;
 using ItemModule.Infrastructure.Services;
 using Microsoft.Extensions.DependencyInjection;
-using Shared.Core.Interfaces.API;
 using Shared.Core.Interfaces.SPI;
-using Shared.Core.Services;
 using Shared.Infrastructure.Services.MySQL;
 
 namespace ItemModule.Infrastructure
 {
-    public static class ItemDependencyInjection
+    public static class ItemInfraDependencyInjection
     {
-        public static IServiceCollection AddItemModuleInfra(
+        public static IServiceCollection AddModule(
             this IServiceCollection services)
         {
             services.AddScoped<IModuleSeeder, Seeder>();
-            services.AddScoped(typeof(IItemService<>), typeof(ItemService<>));
-            services.AddScoped(typeof(IItemInfra<>), typeof(MySQLItemInfra<>));
             services.AddScoped<IItemInfra, MySQLItemInfra>();
-            services.AddScoped<IItemService, ItemService>();
+            services.AddScoped(typeof(IItemInfra<>), typeof(MySQLItemInfra<>));
             return services;
         }
     }

package/BlueprintTemplate/ItemModule.Infrastructure/Services/MySQLItemInfra.cs

@@ -1,7 +1,7 @@
 using ItemModule.Core.Entities;
 using ItemModule.Core.Interfaces.SPI;
 using Microsoft.Extensions.Logging;
-using Shared.Infrastructure;
+using Shared.Infrastructure.Database;
 using Shared.Infrastructure.Services.MySQL;
 
 namespace ItemModule.Infrastructure.Services

package/BlueprintTemplate/README.md

@@ -7,16 +7,22 @@
 6. Tạo mới 1 module
 	- Copy lại thư mục item để thêm module mới
 	- Sửa lại tên và toàn bộ namespace
-	- Sửa lại các nội dung sau (Trong Host.API): 
-		+ Đăng ký ở ServiceCollectionExtensions.cs: 
-			. Controller: .AddApplicationPart(typeof(ItemController).Assembly);
-			. Injection: ItemDependencyInjection.AddItemModuleInfra(services);
-		+ Đăng ký Mapping ở ThirdPartyExtensions.cs: typeof(DtoItemMappingProfile).Assembly,
-		+ Gọi ở Program.cs: builder.Services.AddItemModule();
+	- Bật tắt các module không cần thiết
+	- Bật tắt hoặc chuyển đổi DB nếu cần
 
 7. Mock Data
 	- Tools → NuGet Package Manager → Package Manager Console
 	- Default project: catalog.Infra
 	- Xóa Migration cũ
 	- Add-Migration SeedInitialData
-	- Update-Database
+	- Update-Database
+	
+8. Todos
+	- Tách migration theo module
+	- Plug/ Unplug module (config)
+	- Plug/ Unplug database provider (config)
+	- Thêm chức năng tạo module qua script
+	
+	(Chỉnh sửa khi làm Mock back-end)
+	- Channge DB to NoSQL
+	- Simple infra for DocumentDb and Lambda

package/BlueprintTemplate/Shared.Core/Interfaces/Modules/IModule.cs

@@ -0,0 +1,14 @@
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using System.Reflection;
+
+namespace Shared.Core.Interfaces.Modules
+{
+    public interface IModule
+    {
+        string Name { get; }
+        void Register(IServiceCollection services, IConfiguration config);
+        Assembly ApiAssembly { get; }
+        Assembly MappingAssembly { get; }
+    }
+}

package/BlueprintTemplate/Shared.Core/Shared.Core.csproj

@@ -8,6 +8,7 @@
 
   <ItemGroup>
     <PackageReference Include="Microsoft.EntityFrameworkCore" Version="9.0.0" />
+    <PackageReference Include="Microsoft.Extensions.Configuration.Abstractions" Version="10.0.2" />
   </ItemGroup>
 
 </Project>

package/BlueprintTemplate/Shared.Infrastructure/{DbInitializer.cs → Database/DbInitializer.cs}

@@ -1,7 +1,7 @@
 using Microsoft.EntityFrameworkCore;
 using Shared.Core.Interfaces.SPI;
 
-namespace Shared.Infrastructure
+namespace Shared.Infrastructure.Database
 {
     public static class DbInitializer
     {

package/BlueprintTemplate/Shared.Infrastructure/{MyDbContext.cs → Database/MyDbContext.cs}

@@ -1,7 +1,7 @@
 using Microsoft.EntityFrameworkCore;
 using Shared.Core.Interfaces.SPI;
 
-namespace Shared.Infrastructure
+namespace Shared.Infrastructure.Database
 {
     public class MyDbContext : DbContext
     {

package/BlueprintTemplate/Shared.Infrastructure/Migrations/20260131121133_SeedInitialData.Designer.cs

@@ -5,7 +5,7 @@ using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Metadata;
 using Microsoft.EntityFrameworkCore.Migrations;
 using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
-using Shared.Infrastructure;
+using Shared.Infrastructure.Database;
 
 #nullable disable
 

package/BlueprintTemplate/Shared.Infrastructure/Migrations/MyDbContextModelSnapshot.cs

@@ -4,7 +4,7 @@ using Microsoft.EntityFrameworkCore;
 using Microsoft.EntityFrameworkCore.Infrastructure;
 using Microsoft.EntityFrameworkCore.Metadata;
 using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
-using Shared.Infrastructure;
+using Shared.Infrastructure.Database;
 
 #nullable disable
 

package/BlueprintTemplate/Shared.Infrastructure/Services/MySQL/MySQLItemInfra.cs

@@ -5,6 +5,7 @@ using Shared.Core.Enums;
 using Shared.Core.Exceptions;
 using Shared.Core.Interfaces.SPI;
 using Shared.Core.Shared.Models;
+using Shared.Infrastructure.Database;
 using System.Linq.Expressions;
 
 namespace Shared.Infrastructure.Services.MySQL

package/BlueprintTemplate/User.API/UserModule.API.csproj

@@ -3,6 +3,7 @@
   <ItemGroup>
     <ProjectReference Include="..\User.Core\UserModule.Core.csproj" />
     <ProjectReference Include="..\Shared.Core\Shared.Core.csproj" />
+    <ProjectReference Include="..\User.Infrastructure\UserModule.Infrastructure.csproj" />
   </ItemGroup>
 
   <ItemGroup>

package/BlueprintTemplate/User.API/UserModule.cs

@@ -0,0 +1,24 @@
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using Shared.Core.Interfaces.Modules;
+using System.Reflection;
+using UserModule.API.Controllers.Admin;
+using UserModule.API.Mappers;
+using UserModule.Core;
+using UserModule.Infrastructure;
+
+namespace UserModule.API
+{
+    public class UserModule: IModule
+    {
+        public string Name => "User";
+        public void Register(IServiceCollection services, IConfiguration config)
+        {
+            UserCoreDependencyInjection.AddModule(services);
+            UserInfraDependencyInjection.AddModule(services);
+        }
+
+        public Assembly ApiAssembly => typeof(UserController).Assembly;
+        public Assembly MappingAssembly => typeof(DtoUserMappingProfile).Assembly;
+    }
+}

package/BlueprintTemplate/User.Core/UserCoreDependencyInjection.cs

@@ -0,0 +1,16 @@
+using Microsoft.Extensions.DependencyInjection;
+using UserModule.Core.Interfaces.API;
+using UserModule.Core.Services;
+
+namespace UserModule.Core
+{
+    public static class UserCoreDependencyInjection
+    {
+        public static IServiceCollection AddModule(
+            this IServiceCollection services)
+        {
+            services.AddScoped<IUserService, UserService>();
+            return services;
+        }
+    }
+}

package/BlueprintTemplate/User.Infrastructure/Services/MySQLUserInfra.cs

@@ -1,5 +1,5 @@
 using Microsoft.Extensions.Logging;
-using Shared.Infrastructure;
+using Shared.Infrastructure.Database;
 using Shared.Infrastructure.Services.MySQL;
 using UserModule.Core.Entities;
 using UserModule.Core.Interfaces.SPI;

package/BlueprintTemplate/User.Infrastructure/{UserDependencyInjection.cs → UserInfraDependencyInjection.cs}

@@ -1,21 +1,18 @@
 using Microsoft.Extensions.DependencyInjection;
 using Shared.Core.Interfaces.SPI;
-using UserModule.Core.Interfaces.API;
 using UserModule.Core.Interfaces.SPI;
-using UserModule.Core.Services;
 using UserModule.Infrastructure.Database;
 using UserModule.Infrastructure.Services;
 
 namespace UserModule.Infrastructure
 {
-    public static class UserDependencyInjection
+    public static class UserInfraDependencyInjection
     {
-        public static IServiceCollection AddUserModuleInfra(
+        public static IServiceCollection AddModule(
             this IServiceCollection services)
         {
             services.AddScoped<IModuleSeeder, Seeder>();
             services.AddScoped<IUserInfra, MySQLUserInfra>();
-            services.AddScoped<IUserService, UserService>();
             return services;
         }
     }

package/README.md

@@ -1,22 +1,5 @@
-How to make a blueprint (Ex: init-blueprint)
-1. Change the name of the blueprint project in package.json file: 
-	Ex: "name": "init-blueprint",
-	  "bin": {
-		"init-blueprint": "create.js"
-	  },
-2. Copy the template into BlueprintTemplate. The template include: 
-	- Basic files
-	- Add gitignore file and change it from .gitignore=> gitignore file
-3. Add git to the blueprint, and change the root branch from master to main
-	- rm -rf .git
-	- Add git
-	- git branch -m master main
-4. Create new repo in git
-	- Add environment variables into the git repo: Project > Settings > CI/CD > Variables
-		+ NPM_TOKEN: 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
-		+ PACKAGE_NAME: init-blueprint
-	- push the blueprint to main branch
-5. Use the lib from npm: 
+How to make a blueprint 
+1. Use the lib from npm: 
     - npm uninstall -g netcore-blueprint
 	- npm install -g netcore-blueprint
 	- npm list -g netcore-blueprint

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "netcore-blueprint",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "A custom project blueprint",
   "main": "create.js",
   "bin": {