vietnam-devs / Crmcore

The project is not maintaining at the moment so please very careful if you get the code and run it (there are some crashes when building the source codes). Based on the ideas of this project, I am working on another project named modular-starter-kits, if you like the ideas of this project and want to learn more about it, you can also take a look at it too. Thank you.

CRM-Core makes it easy to create and manage a Lightweight-CRM Web Application efficiently.

Table of contents

• Quick start
• What's included
• Bugs and feature requests
• Dependencies
• Community
• Development
• Contributors
• Copyright and license

Quick start

Real world demo

You can access to the application on Azure as following links:

Coming soon...

Docker

Linux / Unix

docker run -p 80:5000 --name crmcore  crmcore/crm-linux

Windows

docker run -p 80:5000 --name crmcore  crmcore/crm-window

For more information, you can check out CRM Core on Docker Hub

Manual

• Download the latest .NET SDK (2.x) & NodeJS
• Clone the repo: git clone https://github.com/crm-core/crmcore.git
• Change location to \crmcore\src\Hosts\CRMCore.WebApp
• Run following commands
  • dotnet restore
  • dotnet build
  • dotnet run

What's included

Coming soon...

Bugs and feature requests

Have a bug or a feature request? Please first read the issue guidelines and search for existing and closed issues. If your problem or idea is not addressed yet, please open a new issue.

Dependencies

• .NET Core SDK 2.0
• Create-React-App
• React CoreUI

Community

Get updates on CRMCore' development and chat with the project maintainers and community members:

• Follow Phuong Le on GitHub
• Follow @thangchung on Twitter

Development

Get code

git clone [email protected]:crm-core/crmcore.git
cd crmcore

Back-end Development environment

You’ll need to have .NET SDK 2.x on your machine.

It will be organize the initial project structure and install the transitive dependencies:

crm-core
├── README.md
├── LICENSE
├── .gitignore
├── global.json
├── Dockerfile
├── .travis.yml
├── appveyor.yml
├── crmcore.sln
├── art
└── src
    └── crm
        └── CRMCore.Module.Common
        └── CRMCore.Module.Contact
        └── CRMCore.Module.Setup
        └── CRMCore.Module.Spa
        └── Directory.Build.props
    └── framework
        └── CRMCore.Framework.CqrsLite
        └── CRMCore.Framework.Entities
        └── CRMCore.Framework.MvcCore
    └── hosts
        └── CRMCore.ClientApp
        └── CRMCore.WebApp
    └── modules
        └── CRMCore.Module.Communication
        └── CRMCore.Module.Data
        └── CRMCore.Module.Identity
    └── targets
        └── CRMCore.Application.Crm.targets
        └── CRMCore.Application.Targets
        └── CRMCore.Module.Targets
        └── CRMCore.Theme.Targets
    └── themes
        └── CRMCore.Theme
└── ClientApp
    ├── node_modules
    ├── package.json
    ├── yarn.lock
    ├── .gitignore
    ├── public
    │   └── favicon.ico
    │   └── index.html
    │   └── manifest.json
    └── src
        └── components
        └── configs
        └── containers
        └── redux
            └── middlewares
            └── modules
        └── styles
            └── bootstrap
            └── core
            └── vendors
            └── images
            └── style.scss
        └── index.js
        └── logo.svg
        └── registerServiceWorker.js

cd <your path>crmcore\src\hosts\CRMCore.WebApp
dotnet restore
dotnet build
dotnet run

Front-end Development environment

You’ll need to have Node >= 6 on your machine.

It will organize the initial project structure and install the transitive dependencies:

crm-core\src\hosts\CRMCore.WebApp
├── ClientApp
    ├── node_modules
    ├── package.json
    ├── yarn.lock
    ├── .gitignore
    ├── public
    │   └── favicon.ico
    │   └── index.html
    │   └── manifest.json
    └── src
        └── components
        └── configs
        └── containers
        └── redux
            └── middlewares
            └── modules
        └── styles
            └── bootstrap
            └── core
            └── vendors
            └── images
            └── style.scss
        └── index.js
        └── logo.svg
        └── registerServiceWorker.js

We need several packages that were installed in global scope as following commands

npm i react-scripts npm-run-all cpx node-sass-chokidar -g

Then, we can run following commands

cd <your path>crmcore\src\hosts\CRMCore.ClientApp
yarn install
yarn start

When you build CRMCore.WebApp, then it will call MSBuild script inside to automatically build the assets for the front-end. You need to remove the index.html inside wwwroot folder to make it happen.

Database Development environment

Setup connection string

dotnet user-secrets ConnectionStrings:Default <connection string>

Init database

cd <your path>crmcore\src\hosts\CRMCore.DBMigration.Console
ASPNETCORE_ENVIRONMENT=Development dotnet run

Add New Changes via Migration

cd <your path>crmcore\src\hosts\CRMCore.DBMigration.Console
dotnet ef migrations add <message>  -c ApplicationDbContext  -o Data/Migrations/CRMCore

Notes

In case we want to re-generate the schema for ID4, follow steps as below

dotnet ef migrations add InitialIdentityServerConfigurationDbMigration -c ConfigurationDbContext -o Data/Migrations/IdentityServer/ConfigurationDb

dotnet ef migrations add InitialIdentityServerPersistedGrantDbMigration -c PersistedGrantDbContext -o Data/Migrations/IdentityServer/PersistedGrantDb

Contributors

N/A

Copyright and license

Code and documentation copyright 2017 CRMCore. Code released under the MIT License.