openmf/community-app

MifosX Community App 镜像文档

镜像概述

MifosX Community App是构建在MifosX平台之上的默认Web应用，面向Mifos用户社区。它是一个单页应用(SPA)，采用JavaScript、CSS和HTML5等Web标准技术开发，并集成了AngularJS、Bootstrap和Font Awesome等流行框架/库。该应用通过CI/CD流程持续部署，最新版本可通过在线演示访问，同时提供Docker化部署方式以便快速使用。

核心功能和特性

• 单页应用架构：提供流畅的用户体验，无需页面刷新即可完成交互
• Web标准技术栈：基于JavaScript、CSS和HTML5开发，兼容现代浏览器
• 主流框架集成：使用AngularJS实现前端逻辑，Bootstrap提供响应式布局，Font Awesome提供图标支持
• 灵活的后端连接：可通过URL参数指定后端API地址和租户标识符，支持连接不同环境的MifosX平台
• OAuth2认证支持：可配置为使用OAuth2协议连接MifosX平台
• Docker化部署：提供官方Docker镜像，支持快速部署和运行

使用场景和适用范围

• MifosX平台用户的默认前端界面
• ***服务管理系统的Web客户端
• MifosX平台的开发和测试环境
• 需要快速部署MifosX前端的场景

使用方法和配置说明

在线演示

最新版本的UI通过CI/CD持续部署，可直接通过以下链接访问（需指定后端API）：

https://openmf.github.io/community-app?baseApiUrl=https://demo.fineract.dev&tenantIdentifier=default

其中baseApiUrl指定后端API地址，tenantIdentifier指定租户标识符。

Docker部署

从Docker Hub拉取并运行

官方镜像托管在Docker Hub，可直接拉取并运行：

bash
docker run --name community-app -it -p 9090:80 docker.xuanyuan.run/openmf/community-app

运行后，通过http://localhost:9090在浏览器中访问应用。

本地构建镜像

1. 克隆代码仓库：

   bash
   git clone https://github.com/openMF/community-app.git
   cd community-app
   

2. 构建Docker镜像：

   bash
   docker build -t mifos-community-app .
   

3. 运行本地构建的镜像：

   bash
   docker run --name mifos-ui -it -d -p 80:80 docker.xuanyuan.run/mifos-community-app
   

   访问http://localhost即可使用应用。

连接到不同后端

默认情况下，应用连接到演示环境后端。如需连接其他MifosX/Finereact后端，可通过URL参数指定：

• 连接本地后端（假设后端运行在https://localhost:8443）：

  http://localhost:9090/?baseApiUrl=https://localhost:8443&tenantIdentifier=default
  

  注意：首次访问时需接受自签名SSL证书，可先访问https://localhost:8443/fineract-provider/api/v1并接受安全警告

• 连接最新演示后端：

  http://localhost:9090/?baseApiUrl=https://demo.fineract.dev&tenantIdentifier=default
  

OAuth2认证配置

如需使用OAuth2认证连接MifosX平台，需修改配置文件app/scripts/modules/configurations.js中的security属性为"oauth"。

默认登录凭据

使用以下默认凭据登录应用：

• 用户名：mifos
• 密码：password

构建和开发（可选）

如需从源码构建应用，需安装以下依赖：

• Node.js (包含npm)
• Ruby
• Bower
• Grunt CLI

详细构建步骤可参考https://github.com/openMF/community-app的说明文档。