apache/fineract-cn-fims-web-app

Apache Fineract Fims Web App 镜像文档

镜像概述

Apache Fineract Fims Web App是Apache Fineract-CN平台的前端Web应用，提供用户与Fineract-CN服务的交互界面。支持开发环境调试、生产资产构建、自动化测试，并可通过Docker容器部署，适用于Fineract-CN生态系统的前端开发与运行。

核心功能与特性

• 多环境支持：开发环境实时调试、生产环境构建与测试
• 自动化测试：集成Karma测试，遵循Angular测试最佳实践
• 版本控制：采用语义化版本（Semantic Versioning），含开发状态标识（snapshot、m、rc、ga）
• Docker部署：支持与Fineract-CN其他服务通过Docker Compose协同部署

使用场景

• Fineract-CN平台前端界面开发与调试
• 前端功能单元测试与集成测试
• 生产环境前端资产构建与部署
• Fineract-CN全服务Docker化部署

使用方法与配置说明

环境准备

• 依赖要求：Node.js 6.10.0+ 及 NPM 3+
• 安装依赖包：npm i

开发环境设置

1. 启动Fineract-CN demo服务：参考https://github.com/apache/fineract-cn-demo-server
2. 运行本地开发环境：npm run dev
3. 访问应用：打开浏览器访问 http://localhost:4200

生产构建

1. 许可证检查：npm run checkLicenses
2. AOT测试（仅用于验证，不建议生产环境直接使用）：npm run runProd
3. 构建生产资产：npm run build，生成文件存放于 /dist 目录

测试

• 遵循https://angular.io/docs/ts/latest/guide/testing.html
• 运行Karma测试：npm run test

Docker容器部署

通过Docker Compose部署Fineract-CN所有服务，参考https://github.com/apache/fineract-cn-docker-compose%E9%A1%B9%E7%9B%AE%E3%80%82

版本控制

版本号遵循http://semver.org/%E8%A7%84%E8%8C%83%EF%BC%8C%E6%A0%BC%E5%BC%8F%E4%B8%BA%60%7BMAJOR%7D.%7BMINOR%7D.%7BPATCH%7D-%7BINDICATOR%7D%5B.%7BPATCH%7D%5D%60%EF%BC%8C%E5%85%B6%E4%B8%AD%EF%BC%9A

• 标识后缀：
  • snapshot：开发中的版本
  • m：里程碑版本，包含特定功能集
  • rc：发布候选版本，代码已完成
  • ga：正式发布版本，推荐生产使用
• 示例：1.2.3-snapshot、1.3.5-m.1、1.5.7-rc.2、2.0.0-ga

贡献指南

详见CONTRIBUTING文件。

许可协议

详见LICENSE文件。