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/。
开始开发
-
确保您的系统中已安装以下内容:
-
全局安装angular-cli。
npm install -g @angular/cli@14.2.12
- 将项目克隆到本地系统。
git clone https://github.com/openMF/web-app.git
-
cd
进入项目根目录,确保您在master分支上。 -
安装依赖项。
npm install
- 要预览应用,运行以下命令并导航到
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平台的本地服务器。
要连接到其他地方运行的服务器,请在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应用实例,您只需:
git clone https://github.com/openMF/web-app.git ; cd web-app
- 对于Windows,使用
git clone https://github.com/openMF/web-app.git --config core.autocrlf=input ; cd web-app
docker-compose up -d
- 在浏览器中访问http://localhost:4200以使用Web应用。
您还可以使用环境变量为MifosX Web应用设置不同的配置:
- 使用环境变量(如果您使用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之一。请确保在发送贡献之前遵循指南!