Giter VIP home page Giter VIP logo

docs's Introduction

FullStackHero's Documentation

How to contribute?

  1. Fork this Repository.
  2. Navigate to your newly forked Repository -> Settings -> Secrets.
  3. Here, Add a new Repository Secret with a name GT_TOKEN. As for the value, paste in your GitHub Token (https://github.com/settings/tokens)
  4. Now, clone this repository locally.
  5. Ensure that you have Node.js and Visual Code installed.
  6. At the root of the repository run npm install. This installs all the required packages.
  7. All the documentations are to be written in markdown format.
  8. Refer https://github.com/fullstackhero/docs/blob/main/content/en/dotnet-webapi-boilerplate/general/getting-started/index.md to get an idea on how to write documentation and include images, code snippets and stuff.
  9. To run the application locally, run the command npm run start and navigate to localhost:1313
  10. Once ready, send a Pull Request.

docs's People

Contributors

deepakbaliga avatar dependabot-preview[bot] avatar dependabot[bot] avatar devjr14 avatar dsjamison avatar filefabrik avatar fretje avatar gialan avatar github-actions[bot] avatar h-enk avatar iammukeshm avatar imgbotapp avatar juststeve avatar marcelo-maciel avatar mikepianka avatar mluepkes avatar nandkishor-yadav avatar ocram85 avatar sharjeelaziz avatar soichih avatar umatare5 avatar xlogex avatar zerotask avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar

docs's Issues

Readme

The readme of this project says to create a GT_TOKEN secret, but I actually just did a pull request without doing that.

That probably shouldn't be in the readme, or otherwise the readme should also explain why exactly this is necessary.

Unable to create an object of type 'ApplicationDbContext'

on running the command
dotnet ef migrations add "brand_extend" --project ./src/Migrators/Migrators.PostgreSQL/ --context ApplicationDbContext -o Migrations/Application

return error
Unable to create an object of type 'ApplicationDbContext'. For the different patterns supported at design time, see https://go.microsoft.com/fwlink/?linkid=851728

the command provided in documentation
dotnet ef migrations add "brand_extend" --project .././Migrators/Migrators.PostgreSQL/ --context ApplicationDbContext -o Migrations/Application

returns
No project was found in directory '.././Migrators/Migrators.PostgreSQL/'.

is that a known bug
I am trying to use this template for my MVP
Please help me if I am doing something wrong
thanks

Understanding Identity integration

Hi, first of all, great project!

When I found it I was interested on how you integrated .NET Core identity into it but I got confused. Hope you can clarify my doubts. I can see you have in the migration files

modelBuilder.Entity("FSH.WebApi.Infrastructure.Identity.ApplicationRole", b =>
                {
                    b.Property<string>("Id")
                        .HasColumnType("nvarchar(450)");

                    ...

                    b.Property<string>("TenantId")
                        .IsRequired()
                        .HasMaxLength(64)
                        .HasColumnType("nvarchar(64)");

                    b.HasKey("Id");

                    b.HasIndex("NormalizedName", "TenantId")
                        .IsUnique()
                        .HasDatabaseName("RoleNameIndex")
                        .HasFilter("[NormalizedName] IS NOT NULL");

                   ...

but you haven't added any additional properties to ApplicationRole or any other classes

public ApplicationRole(string roleName, string? description = null)
        : base(roleName)
    {
        Description = description;
        NormalizedName = roleName.ToUpperInvariant();
    }

So my question is, did you generate the migration files manually? How is TenantId appearing in the ApplicationRole entity? If yes, why didn't you customize Identity classes to receive these new properties?

My other question is, do all Identity User and Role methods work taking into account the TenantId? I'm asking this because I didn't find any UserStore or RoleStore customizations to deal with this property with CRUD operations.

Thank you and please keep up with this project!

[Documentation] Update Documentation of Project Dependencies

The documentation on project structure refers to the Core/Application project as having no dependencies.

Note that the Application project does not depend on any other project.

This is no longer a true statement.

Looking at Application.csproj:

<ItemGroup>
    <ProjectReference Include="..\..\Core\Domain\Domain.csproj" />
    <ProjectReference Include="..\..\Shared\Shared.DTOs\Shared.DTOs.csproj" />
</ItemGroup>

But also we see the dependency in the interfaces of the services in the Application project. For example, in the IBrandService.cs interface

public interface IBrandService : ITransientService
{
    Task<PaginatedResult<BrandDto>> SearchAsync(BrandListFilter filter);
    // ...
}

the argument and template type in the returned object are from the shared project.

I feel this is important for new comers to know and understand why this dependency exists. For instance, I found it a little confusing as to why services in the application layer are returning DTO types, and not Domain types.

Updating the documentation to reflect the current state of the template and extending the rationale for these choices would be super helpful and appreciated!!!

[Documentation] Application project does not depend on any other project

on the project structure page it is stated that

Note that the Application project does not depend on any other project.
...
Note that the Domain project does not depend on any other project.

I would assume that to be true for the domain but maybe not so much for the application project

Checking the actual source code for the application.csproj seems to imply that the application actually depends on domain as expected

    <ItemGroup>
        <ProjectReference Include="..\Domain\Domain.csproj" />
        <ProjectReference Include="..\Shared\Shared.csproj" />
    </ItemGroup>

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.