apache/fineract-cn-portfolio Docker Image

Apache Fineract CN Portfolio 镜像文档

1. 镜像概述与主要用途

Apache Fineract CN Portfolio 是 Apache Fineract CN 框架的核心组件之一，专注于提供产品与案例管理功能。该镜像用于在数字服务平台中定义产品描述，并将这些产品为客户实例化为具体案例，支持***服务的标准化与个性化管理。

作为 Apache Fineract CN 生态的一部分，其核心目标是支撑数字***服务系统的产品生命周期管理与客户案例运营，助力构建包容性、互联的数字经济体系。

2. 核心功能与特性

2.1 产品管理

• 支持***产品的结构化描述与定义，包括产品类型、规则、参数等核心属性配置。

2.2 案例管理

• 实现产品向客户的实例化过程，将抽象产品转化为客户可使用的具体案例，支撑客户***服务的全生命周期跟踪。

2.3 框架集成

• 与 Apache Fineract CN 框架深度集成，支持全国及跨国***交易场景，提供标准化接口与其他组件（如账户、交易等）协同工作。

3. 使用场景与适用范围

3.1 适用场景

• 数字服务平台**：作为核心模块支撑**产品的设计、发布与客户案例管理。
• ***机构运营：银行、小额信贷机构、支付服务商等用于管理产品目录及客户服务实例。
• 包容性系统**：助力构建覆盖广泛的**服务网络，支持不同规模客户的个性化需求。

3.2 适用范围

• 需标准化管理***产品的组织或平台。
• 需支撑全国/跨国***交易的数字经济基础设施。
• 致力于实现***服务普惠化、互联化的项目。

4. 使用方法与配置说明

4.1 前置条件

• 运行环境需支持 Docker 或 Kubernetes。
• 需与 Apache Fineract CN 其他组件（如身份认证、账户管理等）协同部署，确保服务间通信正常。

4.2 Docker 部署示例

4.2.1 基础运行命令（示例）

bash
docker run -d \
  --name fineract-cn-portfolio \
  -p 8080:8080 \
  -e SPRING_PROFILES_ACTIVE=prod \
  -e DB_HOST=your-db-host \
  -e DB_PORT=5432 \
  -e DB_NAME=fineract_portfolio \
  -e DB_USERNAME=dbuser \
  -e DB_PASSWORD=dbpass \
  docker.xuanyuan.run/apache/fineract-cn-portfolio:latest

4.2.2 Docker Compose 配置示例（片段）

yaml
version: '3.8'
services:
  portfolio:
    image: docker.xuanyuan.run/apache/fineract-cn-portfolio:latest
    container_name: fineract-cn-portfolio
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=prod
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_NAME=fineract_portfolio
      - DB_USERNAME=postgres
      - DB_PASSWORD=securepassword
    depends_on:
      - postgres
    restart: unless-stopped

  postgres:
    image: docker.xuanyuan.run/postgres:14
    container_name: fineract-db
    environment:
      - POSTGRES_DB=fineract_portfolio
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=securepassword
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  postgres-data:

4.3 配置参数说明

注：具体配置参数需参考官方完整文档，以下为通用环境变量示例：

• SPRING_PROFILES_ACTIVE：Spring 配置文件激活标识（如 prod、dev）。
• DB_HOST：数据库主机地址。
• DB_PORT：数据库端口。
• DB_NAME：数据库名称。
• DB_USERNAME：数据库访问用户名。
• DB_PASSWORD：数据库访问密码。

5. 版本控制

该镜像版本遵循 http://semver.org/ 规范，格式为 {MAJOR}.{MINOR}.{PATCH}-{INDICATOR}[.{PATCH}]，其中：

5.1 版本标识（INDICATOR）

• BUILD-SNAPSHOT：开发中的版本。
• M：里程碑版本，包含特定功能集，功能完成后发布（可带补丁版本，如 M.1）。
• RC：发布候选版本，代码已完成，可能成为最终产品（可带补丁版本，如 RC.2）。
• RELEASE：正式发布版本，推荐用于生产环境。

5.2 版本示例

• 1.2.3-BUILD-SNAPSHOT（开发中版本）
• 1.3.5-M.1（里程碑版本，第1个补丁）
• 1.5.7-RC.2（发布候选版本，第2个补丁）
• 2.0.0-RELEASE（正式发布版本）

6. 许可证

本镜像遵循 Apache 许可证，详细条款参见 LICENSE 文件。