Source code running locally-backend ​

Download the source code and. NET environment ​

• Use git tool to pull the latest code from open source address:https://gitee.com/ITdos/microi.net
• Download and install. NET 9 SDK:https://dotnet.microsoft.com/zh-cn/download

Configure required parameters ​

• To make the project run, at least [database Redis] two environments are needed, one is indispensable.

Open a solution using Visual Studio Code (Mac recommend) ​

• Download and install vs code:https://code.visualstudio.com/
• Open vs code and install plugins: C#, C# Dev Kit,. NET Install Tool three components
• On the welcome page, open the root directory folder of Microi code open source version. after a few seconds, [solution explorer] will appear automatically, and wait for vs code to automatically restore nuget library.
• The [/Microi.net.Api/appsettings.json] file must be configured

"AppSettings": {
    "OsClient": "iTdos",//【必须】自定义SaaS引擎Key，与数据库【sys_osclient】表的【OsClient】字段值对应
    "OsClientType": "Product",//【必须】自定义程序运行环境，如：Product（正式环境）、Dev（测试环境）等
    "OsClientNetwork": "Internet",//【必须】自定义网络类型，如：Internet（公网）、Internal（内网）等
    "OsClientDbConn": "",//【必须】数据库连接字符串，建议使用源码提供的MySql。SqlServer、Oracle也支持，后期整理后提供数据库demo
    "IS4SigningCredential": "",//【必须】可以直接使用源码中的默认签名
    //Tips：若【OsClient + OsClientType + OsClientNetwork】在【sys_osclient】表中能匹配到数据，且数据中有Redis相关配置，则可以省略以下Redis配置
    "OsClientRedisHost" : "",//Redis Host，如：119.31.116.88
    "OsClientRedisPort" : "",//Redis端口，如：6379
    "OsClientRedisPwd" : "",//Redis密码，如：123456
    "OsClientRedisDataBase" : ""//Redis库，如：0、5
    //其余配置分布式存储（如阿里云OSS、MinIO）、MQ消息队列、ES搜索引擎等，均在平台【SaaS引擎】中动态配置
  },

• Right-click the [Microi.net.Api] project, debug --> start a new instance
• Access Address:https://localhost:7266(Ports are configured in/Microi.net.Api/Properties/launchSettings.json)

Using Visual Studio 2022 to open a solution (Windows recommend) ​

• Download and install vs2022:https://visualstudio.microsoft.com/zh-hans/
• Double-click directly to open the [/Microi.net.sln] file, and wait a moment after opening it. Right-click the [Microi.net.Api] project to regenerate it.
• If the nuget package fails to be restored, please close vs2022 and reopen the Microi.net.sln file to continue trying. Generally, it is a network problem. You can also try to use the mobile phone hotspot.
• The [/Microi.net.Api/appsettings.json] file must be configured, as described above.

Environment Configuration Considerations ​

• Unable to use system log function without MongoDB environment
• If you do not have a distributed storage environment such as MinIO or Alibaba Cloud OSS, you cannot use the file/image upload function.
• Message Queuing cannot be used without a RabbitMQ environment
• Search engine functionality is not available without an ES environment