develpaz/api-server-devel

API Server Devel镜像说明

镜像概述

本镜像用于开发集成MongoDB的API Server，基于其他项目基础修改而来，适配内部测试及电子发票处理场景（对接厄瓜多尔税务系统SRI）。

核心功能

• 提供开发环境下的API Server服务
• 集成MongoDB数据库支持
• 支持电子发票相关操作（对接SRI系统的测试与生产环境）
• 可配置JWT认证、加密密钥、允许的RUC列表等参数

使用场景

• 内部开发团队进行API Server功能测试
• 电子发票流程的开发与验证（对接SRI系统）
• 本地或测试环境快速部署API服务与MongoDB数据库

配置说明

通过环境变量配置关键参数，主要包括：

• JWT_SECRET: JWT认证密钥
• NODE_ENV: 运行环境（如development）
• MONGODB_URI: MongoDB连接地址
• SRI_ENVIRONMENT: SRI环境标识（1=测试，2=生产）
• ENCRYPTION_KEY: 数据加密密钥（需32字符）
• ALLOWED_RUCS: 允许访问的RUC列表（逗号分隔）

Docker Compose部署示例

以下配置文件将启动API Server和MongoDB服务：

yaml
version: '3'
services:
  app:
    image: develpaz/api-server-devel:latest
    container_name: mi-app-docker
    ports:
      - "3000:3000"
    restart: always
    environment:
      JWT_SECRET: ***DAS
      NODE_ENV: development
      MONGODB_URI: "mongodb://root:facturacion@db:27017/f-devel?authSource=admin"
      SRI_ENVIRONMENT: 1  # 1=测试环境，2=生产环境
      SRI_RECEPCION_URL_PRUEBAS: "[***]"
      SRI_RECEPCION_URL_PRODUCCION: "[***]"
      ENCRYPTION_KEY: clave_encriptacion_32_caracteres!!
      MASTER_REGISTRATION_KEY: clave_maestra_super_secreta
      INVITATION_CODES: devel
      ALLOWED_RUCS: 1316037470001,1316037488001
    depends_on:
      - db
  db:
    image: mongo:latest
    container_name: mi-mongo-docker
    restart: always
    environment:
      MONGO_INITDB_ROOT_USERNAME: root
      MONGO_INITDB_ROOT_PASSWORD: facturacion
    ports:
      - "27017:27017"
    volumes:
      - /DATA/localMongo:/data/db