bsogulcan / soft-craft-api

SoftCraft is fastest way to create new web application based on Abp Boilerplate framework

About soft-craft-api!

SoftCraft is fastest way to create new web application based on Abp Boilerplate framework, we call it Generator! This is the backend service of the soft-craft application.

What are the benefits?

SoftCraft creates a backend using (.Net Core 6) and frontend (Angular) application based on the 'Project', 'Entity', 'Enums' and 'Navigation Items' data defined by the user from the web interface.

What Does It Create?

DotNetCodeGenerator creates Entities, Entity Configurations, Repositories, Enums, Dtos, AppServices and Permissions. TypeScriptCodeGenerator creates Dtos, Services, Routes, Enums, List-Create-Edit Components and Navigation Items. ProjectManager creates AbpBoilerplate application according to the generated codes.

Dependent Projects

Client project of SoftCraft: soft-craft-client
Base project to generate projects: soft-craft-base-apb-boilerplate-project

Architecture

Example Entity

C# Code Results

Entity

using System;
using Abp.Domain.Entities.Auditing;
using System.Collections.Generic;
using Abp.Domain.Entities;

namespace EFProject.Domain.Entities
{
	public class Teacher : FullAuditedEntity<int>
	{
		public Teacher()
		{
			Courses = new HashSet<Course>();
		}
		public string TeacherName { get; set; }
		public virtual ICollection<Course>Courses { get; set; }
		public int StandartId { get; set; }
		public virtual Standart Standart { get; set; }
	}
}

Entity Configuration (Entity Framework)

using EFProject.Domain.Entities;
using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Metadata.Builders;

namespace EFProject.Domain.Configurations
{
	public class TeacherConfiguration : IEntityTypeConfiguration<Teacher>
	{
		public void Configure(EntityTypeBuilder<Teacher> builder)
		{
			builder.ToTable("Teachers");
			builder.HasKey(x => x.Id);
			builder.Property(x => x.TeacherName).HasMaxLength(50);

			builder.HasMany(x => x.Courses)
				.WithOne(y => y.Teacher)
				.HasForeignKey(y => y.TeacherId)
				.OnDelete(DeleteBehavior.ClientSetNull);
		}
	}
}

Application Service

using Abp.Application.Services;
using Abp.Authorization;
using EFProject.Authorization;
using EFProject.Domain.Teacher.Dtos;
using EFProject.Domain.Teacher;
using EFProject.Domain.Entities;
using EFProject.EntityFrameworkCore.Repositories;
using System.Collections.Generic;
using System.Threading.Tasks;
using Abp.Application.Services.Dto;

namespace EFProject.Domain.Teacher
{
	[AbpAuthorize(PermissionNames.Teacher)]
	public class TeacherAppService : AsyncCrudAppService<Entities.Teacher, TeacherFullOutput, int, GetTeacherInput, CreateTeacherInput, UpdateTeacherInput, GetTeacherInput, DeleteTeacherInput>, ITeacherAppService
	{
		public TeacherAppService(ITeacherRepository teacherRepository) : base(teacherRepository)
		{
			CreatePermissionName = PermissionNames.Teacher_Create;
			UpdatePermissionName = PermissionNames.Teacher_Update;
			DeletePermissionName = PermissionNames.Teacher_Delete;
			GetPermissionName = PermissionNames.Teacher_Get;
			GetAllPermissionName = PermissionNames.Teacher_GetList;
		}

		[AbpAuthorize(PermissionNames.Teacher_GetList)]
		public async Task<PagedResultDto<TeacherFullOutput>> GetTeachersByStandartId(int standartId)
		{
			var items = await Repository.GetAllListAsync(x => x.StandartId == standartId);
			return new PagedResultDto<TeacherFullOutput>
			{
				TotalCount = items.Count,
				Items = ObjectMapper.Map<List<TeacherFullOutput>>(items)
			};
		}

	}
}

soft-craft-api's Issues

Entity configurations for User and Role

If user add some properties to User and Role.
Generate entity configuration for these entities and call it from DbContext

Refactor Recursive methods

Cant access AbpBoilerplate's default entities

AbpBoilerplate has own default entities like Users, Roles, UserRoles etc.
On Soft-Craft users can access these entities when creating new properties of entity.

Enum properties must show display name on p-table

List Component datagrid columns

Add related entitieses display on list properties to datagrid

CreateComponent Dropdowns selection changes

When selection changes, refresh or clear child dropdowns

Deletion of Linked Properties (Releational Properties)

When user delete an releational property from an entity, linked releational property should be deleted from releated entity.

Create Entity page on Client-Side

• Entity

Name
PrimaryKey type
AuditType(none or fullaudited)
TenantType(none,may,must)
Properties(list)

• Property

Type(string for now)
Name
Nullable
RelationalEntity(if related another entity)

Missing using ICollection and HashSet on User/Role entity

Create component inputs

Generate number, boolean, date and dropdown elements on create component.

Rename project name on client side

Generating angular project named 'BASEABPBOILERPLATEPROJECT' it must rename by project name.

Dynamic page title generation based on entity name

Page titles can be dynamically generated based on entity name.

Date properties cannot set initialize value

PrimeNG p-calendar component cannot set value from string. Throwing InvalidDate error.

Add PartOutput property of one-to-one relations

Modals Buttons must Fix on bottom

Create/Edit Dynamic Modals' Buttons must be Fixed on bottom.

Docs and Examples

Add some documentations and examples

Property Max Length can be null

Edit Component

gRpc-DotNetCodeGenerator

A microservice to stringify Entities.

• CreateEntity

Enumerate Values on components

Add EnumList method ex:

enumArray:[
  {
     name : text,
     id : value
  },
]

Show 'name' values on list components.
Show dropdown list on create/edit components.

Missing TenantId property in entities when entity selected Must/May Tenant

We have to create TenantId property in entity like that
MayTenant => public int? TenantId
MustTenant => public int TenantId