RealmDigital.Architecture 0.0.9

The Realm Archicture - .NET Template

Installation

$ dotnet new install RealmDigital.Architecture

Usage

$ dotnet new realm-architecture -o [YOUR_PROJECT_NAME]

Use what you want, delete what you don't

Includes a fully featured application (.NET 7 Web API + Next.js UI)

Technology

• .NET 7
• EF Core 7
• PostgreSQL
• MediatR
• Source Generators
• Docker
• NextJS
• Identity
• Terraform

Preamble

1. Write a business operation as a MediatR Query/Command

[Authorize(Roles = nameof(Role.Admin))]
public sealed record GetUsersQuery : IQuery<List<CrudContracts.User>>
{
    public sealed class Handler : IQueryHandler<GetUsersQuery, List<CrudContracts.User>>
    {
        private readonly ApplicationContext _applicationContext;
        private readonly IMapper _mapper;

        public Handler(ApplicationContext applicationContext, IMapper mapper)
        {
            _applicationContext = applicationContext;
            _mapper = mapper;
        }

        public async Task<ErrorOr<List<CrudContracts.User>>> Handle(GetUsersQuery query, CancellationToken cancellationToken)
        {
            var users = await _applicationContext.Users.OrderByDescending(x => x.Id).ToListAsync(cancellationToken);
            return _mapper.Map<List<CrudContracts.User>>(users);
        }
    }
}

2. Magic happens *

3. Use the query/mutation in your React (or Vue) application

const getUsersQuery = UsersQueries.useGetUsersQuery()

if (getUsersQuery.isError) return <div>Failed to load</div>
if (getUsersQuery.isLoading) return <div>Loading...</div>

return (
    <ul>
    {users.map(user => (
        <li>{user.name}
    ))}
    </ul>
)

4. Profit?!?!

* The magic is 3 parts

1. Source generators automatically create Web API Controllers for each Query/Command - automatically, on build
2. Nswag generates an OpenAPI specificiation document for these controllers - automatically, on build
3. A .NET console application generates an Axios based TypeScript API client along with TanStack Query queries & mutations - manually, by running:

$ cd application/tools/[Application.Name].CodeGen.Console
$ dotnet run