| Build server | Platform | Status |
|---|---|---|
| AppVeyor | Windows | |
| Travis | Linux / MacOS |  |
- First run the database:
docker run --name simpldb -d postgres - Then run the app:
docker run --name simplsite -d -p 5000:5000 --link simpldb:simpldb simplcommerce/nightly-build
- SQL Server
- Visual Studio 2017 with .NET Core Tools
- Create a database in SQL Server
- Update the connection string in appsettings.json in SimplCommerce.WebHost
- Build whole solution.
- In the Task Runner Explorer, right click on the "copy-modules" task and Run.
- Open Package Manager Console Window and type "Update-Database" then press Enter. This action will create database schema
- Execute src/Database/StaticData.sql on the created database to create seeding data
- In Visual Studio Press Control + F5
- The back-office can access via /Admin using the pre-created account: admin@simplcommerce.com, 1qazZAQ!
- PostgreSQL
- NodeJS
- .NET Core SDK RC4
- Create a database in PostgreSQL
- Update the connection string in appsettings.json in SimplCommerce.WebHost
- Run file "simpl-build.sh"
- Execute src/Database/StaticData_Postgres.sql on the created database to create seeding data
- In the terminal, navigate to the "src/SimplCommerce.WebHost" type "dotnet run" and hit enter
- Open browser, open http://localhost:5000. The back-office can access via /Admin using the pre-created account: admin@simplcommerce.com, 1qazZAQ!
- ASP.NET MVC Core 1.1.0 on .NET Core 1.1.0
- Entity Framework Core 1.1.0
- ASP.NET Identity Core 1.1.0
- Autofac 4.0.0
- Angular 1.5
- MediatR for domain event
The application is divided into modules. Each module contains all the stuff for itself to run including Controllers, Services, Views and even static files. If a module is no longer need, you can simply just delete it by a single click.
The SimplCommerce.WebHost is the ASP.NET Core project and act as the host. It will bootstrap the app and load all the modules it found in it's Modules folder. In the gulpfile.js, there is a "copy-modules" that is bound to 'AfterBuild' event of Visual Studio to copy /bin, /Views, /wwwroot in each module to the Modules folder in the WebHost.
During the application startup, the host will scan for all the *.dll in the Modules folder and load it up using AssemblyLoadContext. These assemblies then be registered to MVC Core by ApplicationPart
A ModuleViewLocationExpander is implemented to help the ViewEngine can find the right location for views in modules.
Static files (wwwroot) in each module is served by configuring the static files middleware as follows
// Serving static file for modules
foreach (var module in modules)
{
var wwwrootDir = new DirectoryInfo(Path.Combine(module.Path, "wwwroot"));
if (!wwwrootDir.Exists)
{
continue;
}
app.UseStaticFiles(new StaticFileOptions()
{
FileProvider = new PhysicalFileProvider(wwwrootDir.FullName),
RequestPath = new PathString("/" + module.ShortName)
});
}Every domain entities need to inherit from Entity, then on the "OnModelCreating" method, we find them and register them to DbContext
private static void RegisterEntities(ModelBuilder modelBuilder, IEnumerable<Type> typeToRegisters)
{
var entityTypes = typeToRegisters.Where(x => x.GetTypeInfo().IsSubclassOf(typeof(Entity)) && !x.GetTypeInfo().IsAbstract);
foreach (var type in entityTypes)
{
modelBuilder.Entity(type);
}
}By default domain entities is mapped by convention. In case you need to some special mapping for your model. You can create a class that implement the ICustomModelBuilder for example
public class CatalogCustomModelBuilder : ICustomModelBuilder
{
public void Build(ModelBuilder modelBuilder)
{
modelBuilder.Entity<ProductLink>()
.HasOne(x => x.Product)
.WithMany(p => p.ProductLinks)
.HasForeignKey(x => x.ProductId)
.OnDelete(DeleteBehavior.Restrict);
}
}https://github.com/simplcommerce/SimplCommerce/wiki/Roadmap
- Report bugs or suggest features by create new issues or add comments to issues
- Submit pull requests
SimplCommerce is licensed under the Apache 2.0 license.