Mifos X Web应用

Mifos X Web应用是Mifos X社区应用的改进版本，是一个有效的金融包容性解决方案，也是为Mifos用户社区基于Mifos X平台构建的默认Web应用。

它是一个使用标准Web技术HTML5、SCSS和TypeScript编写的单页应用(SPA)。它利用了流行的Angular框架和Angular Material来实现材料设计组件。

开始使用

最新代码会在每次PR合并到master分支时持续部署到https://openmf.github.io/web-app/。

开始开发

1. 确保您的系统中已安装以下内容：

   git

   npm

2. 全局安装angular-cli。

npm install -g @angular/cli@14.2.12

3. 将项目克隆到本地系统。

git clone https://github.com/openMF/web-app.git

4. cd进入项目根目录，确保您在master分支上。

5. 安装依赖项。

npm install

6. 要预览应用，运行以下命令并导航到http://localhost:4200/。

ng serve

该应用默认使用带有基本身份验证的开发服务器。凭据如下：

用户名 - mifos
密码 - password

重要提示： 请勿对这些凭据进行任何更改。

开发服务器

运行ng serve启动开发服务器。导航到http://localhost:4200/。如果您更改任何源文件，应用将自动重新加载。

代码脚手架

运行ng generate component component-name生成新组件。您还可以使用 ng generate directive|pipe|service|class|guard|interface|enum|module。

构建

运行ng build构建项目。构建产物将存储在dist/目录中。使用--configuration production标志进行生产构建。

或者运行npm run build:prod来构建生产产物。

更多帮助

要获取有关Angular CLI的更多帮助，请使用ng help或查看 Angular-CLI README。

设置本地服务器

按照您的操作系统的说明设置Mifos X平台的本地服务器。

Windows

Ubuntu

要连接到其他地方运行的服务器，请在environments/environment.ts文件和environments/environment.prod.ts文件中更新基本API URL和/或租户标识符属性，分别用于开发和生产环境。

默认情况下，OAuth2被禁用。要启用它，请在environments/environment.ts文件和environments/environment.prod.ts文件中将oauth.enabled属性的值更改为true，分别用于开发和生产环境。

Docker

要从源代码本地构建此Docker镜像（在git clone此仓库之后），运行：

docker build -t openmf/web-app:latest .

然后，您可以像这样从上面的镜像运行Docker容器：

docker run -d -p 4200:80 openmf/web-app:latest

在浏览器中访问http://localhost:4200以使用Web应用。

Docker compose

可以使用容器（也称为"Docker"）进行Mifos X Web应用的"一键式"安装。 Fineract现在在其docker部署中打包了Mifos社区应用Web UI。

作为先决条件，您必须在机器上安装docker和docker-compose；请参阅 Docker安装和 Docker Compose安装。

现在要运行一个新的MifosX Web应用实例，您只需：

1. git clone https://github.com/openMF/web-app.git ; cd web-app
2. 对于Windows，使用git clone https://github.com/openMF/web-app.git --config core.autocrlf=input ; cd web-app
3. docker-compose up -d
4. 在浏览器中访问http://localhost:4200以使用Web应用。

您还可以使用环境变量为MifosX Web应用设置不同的配置：

1. 使用环境变量（如果您使用Docker Compose运行，这是最佳选择）：

Fineract后端设置

FINERACT_API_URLS

设置要使用的Fineract服务器列表（环境），默认值：

https://dev.mifos.io,https://demo.mifos.io,https://qa.mifos.io,https://staging.mifos.io,https://mobile.mifos.io,https://demo.fineract.dev,https://localhost:8443

FINERACT_API_URL

从Fineract服务器列表使用的默认值。默认值：

https://localhost:8443

FINERACT_PLATFORM_TENANT_IDENTIFIER

默认使用的Fineract租户标识符，必须与Fineract tenants表对齐。默认值：

default

FINERACT_PLATFORM_TENANTS_IDENTIFIER

要使用的Fineract租户标识符列表，必须与Fineract tenants表对齐。

语言（i18n）设置（仍在开发中）

MIFOS_DEFAULT_LANGUAGE=en-US

MIFOS_SUPPORTED_LANGUAGES=cs-CS,de-DE,en-US,es-MX,fr-FR,it-IT,ko-KO,lt-LT,lv-LV,ne-NE,pt-PT,sw-SW

这些是目前可用的语言：

MIFOS_SESSION_IDLE_TIMEOUT=300000

会话空闲超时时间（毫秒），默认300000秒

语言	代码	文件
捷克语	cs	cs-CS.json
德语	de	de-DE.json
英语	en	en-US.json
西班牙语	es	es-MX.json
法语	fr	fr-FR.json
意大利语	it	it-IT.json
韩语	ko	ko-KO.json
立陶宛语	li	li-LI.json
拉脱维亚语	lv	lv-LV.json
尼泊尔语	ne	ne-NE.json
葡萄牙语	pt	pt-PT.json
斯瓦希里语	sw	sw-SW.json

在客户视图中应用客户预加载的设置，默认为true

MIFOS_PRELOAD_CLIENTS=false

使用此字段分隔符将报表表导出为CSV文件的设置

MIFOS_DEFAULT_CHAR_DELIMITER=,

读取用户通知的等待时间（秒）设置，默认60秒

MIFOS_WAIT_TIME_FOR_NOTIFICATIONS=60

读取COB追赶状态的等待时间（秒）设置，默认30秒

MIFOS_WAIT_TIME_FOR_CATCHUP=30

在登录视图中显示或隐藏租户选择器的设置（主要用于生产环境和出于安全原因），默认为true

MIFOS_DISPLAY_TENANT_SELECTOR=false

在页脚部分显示或隐藏后端信息（url）的设置（主要出于安全原因），默认为true

MIFOS_DISPLAY_BACKEND_INFO=false

有关更多信息，请查看项目根目录中的env.sample文件

想要帮忙吗？

想要报告bug、请求功能、贡献一些代码或改进文档吗？太好了！请阅读我们的贡献指南，然后查看我们的issues之一。请确保在发送贡献之前遵循指南！