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 基础运行命令（示例）

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 \
  apache/fineract-cn-portfolio:latest

4.2.2 Docker Compose 配置示例（片段）

version: '3.8'
services:
  portfolio:
    image: 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: 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. 版本控制

该镜像版本遵循 语义化版本 规范，格式为 {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 文件。