[add]: eco models

.env.local.example

@@ -7,17 +7,26 @@ SWAGGER_URL="/documentation"
 API_URL="/swagger.json"
 
 # Database Configuration
-DATABASE_USER=firstadvance
-DATABASE_PASSWORD=FirstAdvance!
-DATABASE_HOST=dev-data.simbrellang.net
-DATABASE_PORT=10532
-DATABASE_NAME=firstadvancedev
-
-# DATABASE_HOST=10.20.30.60
 # DATABASE_USER=firstadvance
-# DATABASE_PASSWORD=firstadvance
+# DATABASE_PASSWORD=FirstAdvance!
+# DATABASE_HOST=dev-data.simbrellang.net
+# DATABASE_PORT=10532
 # DATABASE_NAME=firstadvancedev
-# DATABASE_PORT=5432
+
+
+# ECO_DATABASE_USER=username
+# ECO_DATABASE_PASSWORD=password
+# ECO_DATABASE_HOST=localhost
+# ECO_DATABASE_PORT=5432
+# ECO_DATABASE_NAME=eco_db
+
+
+DATABASE_USER=system
+DATABASE_PASSWORD=FIRSTADV_PASS
+DATABASE_HOST=209.195.2.27 
+# DATABASE_HOST=10.10.33.65
+DATABASE_PORT=1521
+DATABASE_SID=FREE
 
 # Flask Configuration
 FLASK_APP=wsgi.py

JUNK/send_report.py

@@ -0,0 +1,15 @@
+from flask import Flask
+from app.extensions import mail
+from app.utils.mail import send_report_email, get_report_data
+from app.config import settings
+
+app = Flask(__name__)
+app.config.from_object(settings)
+
+mail.init_app(app)
+
+with app.app_context():
+    report_data = get_report_data()
+    recipients = ["vdagbue@gmail.com"]
+    result = send_report_email(report_data, recipients)
+    print(result)

README.md

@@ -70,6 +70,7 @@ You can check if the Flask application is running by accessing the `/health` end
 
 ```bash
 curl http://localhost:4500/health
+curl http://localhost:4500/eco/health
 ```
 
 If the application is running properly, you should receive a response similar to this:
@@ -87,6 +88,7 @@ You can check the Swagger Doc by accessing the `/documentation` endpoint. Run th
 
 ```bash
 curl http://localhost:4500/documentation
+curl http://localhost:4500/eco/documentation
 ```
 
 

app/__init__.py

@@ -1,13 +1,16 @@
+from re import U
 from flask import Flask
+from flask_mail import Mail
 import os
 from flask_swagger_ui import get_swaggerui_blueprint
 from flask_cors import CORS
 from app.config import Config
 from app.api.routes import api
+from app.eco.routes import eco
 from app.errors import register_error_handlers
 from flask_sqlalchemy import SQLAlchemy
 from flask_migrate import Migrate
-from app.extensions import db, migrate
+from app.extensions import db, migrate, mail
 from flask_jwt_extended import (
     JWTManager,
     jwt_required,
@@ -38,15 +41,26 @@ def create_app():
 
     # Register blueprints
     app.register_blueprint(api)
+    app.register_blueprint(eco, url_prefix="/eco")
 
     swagger_ui_blueprint = get_swaggerui_blueprint(SWAGGER_URL, API_URL)
     app.register_blueprint(swagger_ui_blueprint, url_prefix=SWAGGER_URL)
 
+    # Second UI (ECO)
+    eco_docs = "/eco" + SWAGGER_URL
+    eco_api = "/eco" + API_URL
+    swagger_ui_eco = get_swaggerui_blueprint(eco_docs, eco_api)
+    swagger_ui_eco.name = 'swagger_ui_eco'  # Rename blueprint
+    app.register_blueprint(swagger_ui_eco, url_prefix=eco_docs)
+
     # Error Handlers
     register_error_handlers(app)
 
     from . import models
 
+    # Initialize Flask-Mail
+    mail.init_app(app)
+
     # Database and Migrations
     db.init_app(app)
 

app/api/services/base_service.py

@@ -4,6 +4,7 @@ from flask import jsonify
 from marshmallow import ValidationError
 import logging
 from app.api.integrations import KafkaIntegration
+from app.utils.mail import send_report_email, get_report_data
 
 logger = logging.getLogger(__name__)
 
@@ -173,3 +174,6 @@ class BaseService:
        # return {"rate": 0, "fee": 0, "due_days": 0}
 
 
+    @classmethod
+    def send_mail(cls, report_data, recipients):
+            send_report_email(report_data, recipients)

app/config.py

@@ -1,6 +1,7 @@
 import os
 from datetime import timedelta
 
+
 class Config:
     """Base configuration for Flask app"""
 
@@ -21,14 +22,26 @@ class Config:
     DNS = f"(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST={DATABASE_HOST})(PORT={DATABASE_PORT}))(CONNECT_DATA=(SID={DATABASE_SID})))"
 
 
+    # ECO Database Configuration
+    ECO_DATABASE_USER = os.environ.get("ECO_DATABASE_USER", "eco_user")
+    ECO_DATABASE_PASSWORD = os.environ.get("ECO_DATABASE_PASSWORD", "eco_pass")
+    ECO_DATABASE_HOST = os.environ.get("ECO_DATABASE_HOST", "localhost")
+    ECO_DATABASE_PORT = os.environ.get("ECO_DATABASE_PORT", 5432)
+    ECO_DATABASE_NAME = os.environ.get("ECO_DATABASE_NAME", "eco_db")
+
     # Database Connection
     # SQLALCHEMY_DATABASE_URI = f"postgresql+psycopg2://{DATABASE_USER}:{DATABASE_PASSWORD}@{DATABASE_HOST}:{DATABASE_PORT}/{DATABASE_NAME}"
 
-    SQLALCHEMY_DATABASE_URI = (f"oracle+oracledb://{DATABASE_USER}:{DATABASE_PASSWORD}@{DNS}")
+    SQLALCHEMY_DATABASE_URI = (
+        f"oracle+oracledb://{DATABASE_USER}:{DATABASE_PASSWORD}@{DNS}"
+    )
+
+    SQLALCHEMY_BINDS = {
+        "eco": f"postgresql+psycopg2://{ECO_DATABASE_USER}:{ECO_DATABASE_PASSWORD}@{ECO_DATABASE_HOST}:{ECO_DATABASE_PORT}/{ECO_DATABASE_NAME}"
+    }
 
     SQLALCHEMY_TRACK_MODIFICATIONS = False
 
-
     JWT_SECRET_KEY = os.getenv("JWT_SECRET_KEY", "secret-key")
     JWT_ACCESS_TOKEN_EXPIRES = os.getenv("JWT_ACCESS_TOKEN_EXPIRES", timedelta(hours=1))
     JWT_REFRESH_TOKEN_EXPIRES = os.getenv(
@@ -38,15 +51,19 @@ class Config:
     # KAFKA_BROKER = 'dev-events.simbrellang.net:9085'
     KAFKA_BROKER = os.getenv("KAFKA_BROKER", "dev-events.simbrellang.net:9085")
 
-   # SIMBRELLA_ENDPOINT_RAC_CHECKS = os.getenv("SIMBRELLA_ENDPOINT_RAC_CHECKS", "RACCheck")
+    # SIMBRELLA_ENDPOINT_RAC_CHECKS = os.getenv("SIMBRELLA_ENDPOINT_RAC_CHECKS", "RACCheck")
     VALID_APP_ID = os.getenv("SIMBRELLA_APP_ID", "app1")
     VALID_API_KEY = os.getenv("SIMBRELLA_API_KEY", "test-api-key-12345")
     SIMBRELLA_BASE_URL = os.getenv("SIMBRELLA_BASE_URL", "http://127.0.0.1:6337")
-    SIMBRELLA_ENDPOINT_RAC_CHECKS = os.getenv("SIMBRELLA_ENDPOINT_RAC_CHECKS","api/rac-check")
+    SIMBRELLA_ENDPOINT_RAC_CHECKS = os.getenv(
+        "SIMBRELLA_ENDPOINT_RAC_CHECKS", "api/rac-check"
+    )
 
     RAC_RESULT_accountStatus = os.environ.get("RAC_RESULT_accountStatus", "true")
     RAC_RESULT_bvnValidated = os.environ.get("RAC_RESULT_bvnValidated", "true")
-    RAC_RESULT_creditBureauCheck = os.environ.get("RAC_RESULT_creditBureauCheck", "false")
+    RAC_RESULT_creditBureauCheck = os.environ.get(
+        "RAC_RESULT_creditBureauCheck", "false"
+    )
     RAC_RESULT_crmsCheck = os.environ.get("RAC_RESULT_crmsCheck", "true")
     RAC_RESULT_hasLien = os.environ.get("RAC_RESULT_hasLien", "false")
     RAC_RESULT_hasPastDueLoan = os.environ.get("RAC_RESULT_hasPastDueLoan", "false")
@@ -69,12 +86,10 @@ class Config:
         "rule12_CRMS_no_delinquency",
         "rule13_BVN_ignore",
         "rule14_no_lien",
-        "rule15_null_ignore"
+        "rule15_null_ignore",
     ]
-    
-    rac_false_rules = [
 
-    ]
+    rac_false_rules = []
 
     rac_salary_payments = [
         "salarypaymenT_1",
@@ -82,10 +97,17 @@ class Config:
         "salarypaymenT_3",
         "salarypaymenT_4",
         "salarypaymenT_5",
-        "salarypaymenT_6"
+        "salarypaymenT_6",
     ]
 
-
+    MAIL_SERVER = os.getenv("MAIL_SERVER", "smtp.zoho.com")
+    MAIL_PORT = 587
+    MAIL_USERNAME = os.getenv("MAIL_USERNAME", "firstadvance@dynamikservices.tech")
+    MAIL_PASSWORD = os.getenv("MAIL_PASSWORD")
+    MAIL_USE_TLS = True
+    MAIL_USE_SSL = False
+    MAIL_DEFAULT_SENDER = ("FirstAdvance", "firstadvance@dynamikservices.tech")
+    MAIL_RECEIVER = os.getenv("MAIL_RECEIVER", "vdagbue@gmail.com")
 
 
 settings = Config()

app/eco/enums/__init__.py

@@ -0,0 +1 @@
+from .transaction_type import TransactionType

app/eco/enums/installment_status.py

@@ -0,0 +1,7 @@
+from enum import Enum
+
+class InstallmentStatus(str, Enum):
+    PENDING = 'PENDING'
+    PAID = 'PAID'
+    OVERDUE = 'OVERDUE'
+    PARTIALLY_PAID = 'PARTIALLY_PAID'

app/eco/enums/loan_status.py

@@ -0,0 +1,8 @@
+from enum import Enum
+
+class LoanStatus(str, Enum):
+    PENDING = 'PENDING'
+    ACTIVE = 'ACTIVE'
+    PAID = 'PAID'
+    DEFAULTED = 'DEFAULTED'
+    CLOSED = 'CLOSED'

app/eco/enums/transaction_type.py

@@ -0,0 +1,10 @@
+from enum import Enum
+
+class TransactionType(str, Enum):
+    ELIGIBILITY_CHECK = "eligibility_check"
+    GET_OFFERS = "get_offers"
+    LOAN_INFORMATION = "loan_information"
+    INFLOW_NOTIFICATION = "inflow_notification"
+    LOW_BALANCE_NOTIFICATION = "low_balance_notification"
+    PROVIDE_LOAN = "provide_loan"
+    REPAYMENT = "repayment"

app/eco/helpers/response_helper.py

@@ -0,0 +1,112 @@
+from flask import jsonify
+from typing import Optional, Union, Dict, List, Any
+
+
+class ResponseHelper:
+    """
+    A helper class for building standardized JSON responses using resultCode and resultDescription.
+    """
+
+    @staticmethod
+    def build_response(
+        result_code: str,
+        result_description: str,
+        data: Optional[Union[Dict, List, str]] = None
+    ) -> Dict[str, Any]:
+        response = {
+            "resultCode": result_code,
+            "resultDescription": result_description
+        }
+
+        if isinstance(data, dict):
+            response.update(data)
+
+        return jsonify(response)
+
+    @staticmethod
+    def success(
+        result_description: str = "Successful",
+        result_code: str = "00",
+        data: Optional[Dict[str, Any]] = None
+    ) -> Dict[str, Any]:
+        return ResponseHelper.build_response(result_code, result_description, data)
+
+    @staticmethod
+    def error(
+        result_description: str = "An error occurred",
+        result_code: str = "01",
+        data: Optional[Dict[str, Any]] = None
+    ) -> Dict[str, Any]:
+        return ResponseHelper.build_response(result_code, result_description, data)
+
+    @staticmethod
+    def created(
+        result_description: str = "Resource created successfully",
+        result_code: str = "00",
+        data: Optional[Dict[str, Any]] = None
+    ) -> Dict[str, Any]:
+        return ResponseHelper.build_response(result_code, result_description, data)
+
+    @staticmethod
+    def updated(
+        result_description: str = "Resource updated successfully",
+        result_code: str = "00",
+        data: Optional[Dict[str, Any]] = None
+    ) -> Dict[str, Any]:
+        return ResponseHelper.build_response(result_code, result_description, data)
+
+    @staticmethod
+    def internal_server_error(
+        result_description: str = "Internal Server Error",
+        result_code: str = "500",
+        data: Optional[Dict[str, Any]] = None
+    ) -> Dict[str, Any]:
+        return ResponseHelper.build_response(result_code, result_description, data)
+
+    @staticmethod
+    def unauthorized(
+        result_description: str = "Unauthorized",
+        result_code: str = "401",
+        data: Optional[Dict[str, Any]] = None
+    ) -> Dict[str, Any]:
+        return ResponseHelper.build_response(result_code, result_description, data)
+
+    @staticmethod
+    def forbidden(
+        result_description: str = "Forbidden",
+        result_code: str = "403",
+        data: Optional[Dict[str, Any]] = None
+    ) -> Dict[str, Any]:
+        return ResponseHelper.build_response(result_code, result_description, data)
+
+    @staticmethod
+    def not_found(
+        result_description: str = "Resource not found",
+        result_code: str = "404",
+        data: Optional[Dict[str, Any]] = None
+    ) -> Dict[str, Any]:
+        return ResponseHelper.build_response(result_code, result_description, data)
+
+    @staticmethod
+    def unprocessable_entity(
+        result_description: str = "Unprocessable entity",
+        result_code: str = "422",
+        data: Optional[Dict[str, Any]] = None
+    ) -> Dict[str, Any]:
+        return ResponseHelper.build_response(result_code, result_description, data)
+
+    @staticmethod
+    def method_not_allowed(
+        result_description: str = "Method Not Allowed",
+        result_code: str = "405",
+        data: Optional[Dict[str, Any]] = None
+    ) -> Dict[str, Any]:
+        return ResponseHelper.build_response(result_code, result_description, data)
+
+    @staticmethod
+    def bad_request(
+        result_description: str = "Bad Request",
+        result_code: str = "400",
+        data: Optional[Dict[str, Any]] = None
+    ) -> Dict[str, Any]:
+        return ResponseHelper.build_response(result_code, result_description, data)

app/eco/routes/__init__.py

@@ -0,0 +1 @@
+from .routes import eco 

app/eco/routes/routes.py

@@ -0,0 +1,109 @@
+from flask import Blueprint, request, jsonify, send_from_directory
+from app.eco.services import (
+    AuthorizationService,
+    EligibilityCheckService,
+    GetOfferService,
+    ProvideLoanService,
+    LoanInformationService,
+    RepaymentService,
+    InflowNotificationService,
+    LowBalanceNotificationService
+)
+from app.utils.logger import logger
+from flask_jwt_extended import jwt_required
+import os
+
+eco = Blueprint("eco", __name__)
+
+# Swagger JSON file
+@eco.route("/swagger.json", methods=["GET"])
+def swagger_json():
+    swagger_dir = os.path.join("swagger")
+    return send_from_directory(swagger_dir, "digifi_swagger.json")
+
+@eco.route("/swagger/<path:filename>")
+def serve_paths(filename):
+    swagger_dir = os.path.join("swagger")
+    return send_from_directory(swagger_dir, filename)
+
+
+
+
+# Simbrella Request API Endpoints
+@eco.route("/EligibilityCheck", methods=["POST"])
+@jwt_required()
+def eligibility_check():
+    data = request.get_json()
+    response = EligibilityCheckService.process_request(data)
+    return jsonify(response)
+
+@eco.route("/GetOffers", methods=["POST"])
+@jwt_required()
+def get_offers():
+    data = request.get_json()
+    response = GetOfferService.process_request(data)
+    return jsonify(response)
+
+@eco.route("/ProvideLoan", methods=["POST"])
+@jwt_required()
+def provide_loan():
+    data = request.get_json()
+    response = ProvideLoanService.process_request(data)
+    return jsonify(response)
+
+@eco.route("/LoanInformation", methods=["POST"])
+@jwt_required()
+def loan_information():
+    data = request.get_json()
+    response = LoanInformationService.process_request(data)
+    return jsonify(response)
+
+@eco.route("/Repayment", methods=["POST"])
+@jwt_required()
+def repayment():
+    data = request.get_json()
+    response = RepaymentService.process_request(data)
+    return jsonify(response)
+
+@eco.route("/InflowNotification", methods=["POST"])
+@jwt_required()
+def inflow_notification():
+    data = request.get_json()
+    response = InflowNotificationService.process_request(data)
+    return jsonify(response)
+
+@eco.route("/LowBalanceNotification", methods=["POST"])
+@jwt_required()
+def low_balance_notification():
+    data = request.get_json()
+    response = LowBalanceNotificationService.process_request(data)
+    return jsonify(response)
+
+
+
+
+
+
+# Health Check
+@eco.route("/health", methods=["GET"])
+def health_check():
+    return jsonify({"status": "ok"}), 200
+
+
+
+
+
+# Authorize endpoint
+@eco.route("/Authorize", methods=["POST"])
+def authorize():
+    data = request.get_json()
+    response = AuthorizationService.process_request(data)
+    return response
+
+
+# Authorize refresh endpoint
+@eco.route("/AuthorizeRefresh", methods=["POST"])
+@jwt_required(refresh=True)
+def refresh():
+    response = AuthorizationService.process_refresh_request()
+    return response

app/eco/schemas/__init__.py

@@ -0,0 +1,8 @@
+from .authorization import AuthorizeRequestSchema
+from .eligibility_check import EligibilityCheckSchema
+from .get_offer import GetOfferSchema
+from .provide_loan import ProvideLoanSchema
+from .loan_information import LoanInformationSchema
+from .repayment import RepaymentSchema
+from .inflow_notification import InflowNotificationSchema
+from .low_balance_notification import LowBalanceNotificationSchema

app/eco/schemas/authorization.py

@@ -0,0 +1,6 @@
+from marshmallow import Schema, fields
+
+
+class AuthorizeRequestSchema(Schema):
+    username = fields.Str(required=True)
+    password = fields.Str(required=True)

app/eco/schemas/eligibility_check.py

@@ -0,0 +1,14 @@
+from marshmallow import Schema, fields, EXCLUDE
+
+
+class EligibilityCheckSchema(Schema):
+    requestId = fields.Str(required=True)
+    sessionId = fields.Str(required=True)
+    affiliateCode = fields.Str(required=True)
+    customerId = fields.Str(required=True)
+    accountId = fields.Str(required=True)
+    msisdn = fields.Str(required=True)
+    lienAmount = fields.Str(required=True)
+
+    class Meta:
+        unknown = EXCLUDE 

app/eco/schemas/get_offer.py

@@ -0,0 +1,17 @@
+from marshmallow import Schema, fields, validate, validates_schema, EXCLUDE
+from marshmallow.validate import OneOf
+from datetime import datetime
+
+class GetOfferSchema(Schema):
+    requestId = fields.Str(required=True)
+    sessionId = fields.Str(required=True)
+    affiliateCode = fields.Str(required=True)
+    customerId = fields.Str(required=True)
+    accountId = fields.Str(required=True)
+    msisdn = fields.Str(required=True)
+    lienAmount = fields.Decimal(required=True)
+    requestedAmount = fields.Decimal(required=True)
+    channel = fields.Str(required=True)
+
+    class Meta:
+        unknown = EXCLUDE 

app/eco/schemas/inflow_notification.py

@@ -0,0 +1,18 @@
+from marshmallow import Schema, fields, EXCLUDE
+from datetime import datetime
+
+class InflowItemSchema(Schema):
+    customerId = fields.Str(required=True)
+    accountId = fields.Str(required=True)
+    amount = fields.Decimal(required=True, places=2)
+    transactionId = fields.Str(required=True)
+    transactionDate = fields.Str(required=True)
+
+
+class InflowNotificationSchema(Schema):
+    batchTime = fields.Str(required=True)
+    affiliateCode = fields.Str(required=True)
+    inflows = fields.List(fields.Nested(InflowItemSchema), required=True)
+
+    class Meta:
+        unknown = EXCLUDE 

app/eco/schemas/loan_information.py

@@ -0,0 +1,13 @@
+from marshmallow import Schema, fields, validate, EXCLUDE
+from marshmallow.validate import OneOf, Range
+
+class LoanInformationSchema(Schema):
+    requestId = fields.Str(required=True)
+    sessionId = fields.Str(required=True)
+    affiliateCode = fields.Str(required=True)
+    customerId = fields.Str(required=True)
+    msisdn = fields.Str(required=True)
+    channel = fields.Str(required=True)
+
+    class Meta:
+        unknown = EXCLUDE 

app/eco/schemas/low_balance_notification.py

@@ -0,0 +1,16 @@
+from marshmallow import Schema, fields, validate, EXCLUDE
+
+class LowBalanceItemSchema(Schema):
+    customerId = fields.Str(required=True)
+    accountId = fields.Str(required=True)
+    balance = fields.Decimal(required=True, places=2)
+    transactionId = fields.Str(required=True)
+    transactionDate = fields.Str(required=True)
+
+class LowBalanceNotificationSchema(Schema):
+    batchTime = fields.Str(required=True)
+    affiliateCode = fields.Str(required=True)
+    lbns = fields.List(fields.Nested(LowBalanceItemSchema), required=True)
+
+    class Meta:
+        unknown = EXCLUDE 

app/eco/schemas/provide_loan.py

@@ -0,0 +1,20 @@
+from marshmallow import Schema, fields, validate, EXCLUDE
+from marshmallow.validate import OneOf, Range
+
+class ProvideLoanSchema(Schema):
+    requestId = fields.Str(required=True)
+    sessionId = fields.Str(required=True)
+    affiliateCode = fields.Str(required=True)
+    customerId = fields.Str(required=True)
+    accountId = fields.Str(required=True)
+    msisdn = fields.Str(required=True)
+    offerId = fields.Int(required=True, validate=Range(min=1))
+    upfrontPayment = fields.Decimal(required=True)
+    interestRate = fields.Decimal(required=True)
+    requestedAmount = fields.Decimal(required=True)
+    lienAmount = fields.Decimal(required=True)
+    productId = fields.Str( required=True)
+    channel = fields.Str(required=True)
+
+    class Meta:
+        unknown = EXCLUDE 

app/eco/schemas/repayment.py

@@ -0,0 +1,16 @@
+from marshmallow import Schema, fields, validate, EXCLUDE
+from marshmallow.validate import OneOf, Range
+
+class RepaymentSchema(Schema):
+    requestId = fields.Str(required=True)
+    sessionId = fields.Str(required=True)
+    affiliateCode = fields.Str(required=True)
+    customerId = fields.Str(required=True)
+    msisdn = fields.Str(required=True)
+    debtId = fields.Int(required=True, validate=Range(min=1))
+    repaymentAmount = fields.Decimal(required=False) # Optional, required for "Manual" repaymentType
+    repaymentType = fields.Str(required=True) # "Full", "Due", "Manual", "Overdue"
+    channel = fields.Str(required=True)
+
+    class Meta:
+        unknown = EXCLUDE 

app/eco/services/__init__.py

@@ -0,0 +1,8 @@
+from app.eco.services.authorization import AuthorizationService
+from app.eco.services.eligibility_check import EligibilityCheckService
+from app.eco.services.get_offer import GetOfferService
+from app.eco.services.provide_loan import ProvideLoanService
+from app.eco.services.loan_information import LoanInformationService
+from app.eco.services.repayment import RepaymentService
+from app.eco.services.inflow_notification import InflowNotificationService
+from app.eco.services.low_balance_notification import LowBalanceNotificationService

app/eco/services/authorization.py

@@ -0,0 +1,102 @@
+from flask import request, jsonify
+from marshmallow import ValidationError
+from app.eco.services.base_service import BaseService
+from app.utils.logger import logger
+from app.eco.schemas.authorization import AuthorizeRequestSchema
+from app.eco.helpers.response_helper import ResponseHelper
+from flask_jwt_extended import (
+    JWTManager,
+    jwt_required,
+    create_access_token,
+    create_refresh_token,
+    get_jwt_identity,
+)
+from app.config import Config
+
+USERNAME = Config.BASIC_AUTH_USERNAME
+PASSWORD = Config.BASIC_AUTH_PASSWORD
+
+
+class AuthorizationService(BaseService):
+
+    @staticmethod
+    def process_request(data):
+        """
+        Process the Authorization request.
+
+        Args:
+            data (dict): The request data.
+
+        Returns:
+            dict: A standardized response.
+        """
+        try:
+            logger.info("Processing Authorization request")
+
+            if not data:
+                return ResponseHelper.bad_request(result_description="Missing JSON in request")
+
+            # Validate input data using the Authorization schema
+            schema = AuthorizeRequestSchema()
+            validated_data = schema.load(data)  # Raises ValidationError if invalid
+
+            if (
+                validated_data["username"] != USERNAME
+                or validated_data["password"] != PASSWORD
+            ):
+                return ResponseHelper.unauthorized(result_description="Invalid credentials")
+
+            access_token = create_access_token(identity=validated_data["username"])
+            refresh_token = create_refresh_token(identity=validated_data["username"])
+
+            # Simulated processing logic
+            response_data = {
+                "access_token": access_token,
+                "refresh_token": refresh_token,
+            }
+
+            return ResponseHelper.success(
+                data={"data": response_data}, result_description="Authorization processed successfully"
+            )
+
+        except ValidationError as e:
+            logger.error(f"Validation error: {e}")
+            return ResponseHelper.bad_request(result_description=f"Validation error: {e}")
+
+        except Exception as e:
+            logger.error(f"Error processing Authorization request: {e}")
+            return ResponseHelper.internal_server_error(
+                result_description=f"Error processing Authorization request: {e}"
+            )
+
+    @staticmethod
+    def process_refresh_request():
+        """
+        Process the RefreshToken request.
+
+        Args:
+            data (dict): The request data.
+
+        Returns:
+            dict: A standardized response.
+        """
+        try:
+            logger.info("Processing RefreshToken request")
+
+            identity = get_jwt_identity()
+            access_token = create_access_token(identity=identity)
+
+            # Simulated processing logic
+            response_data = {
+                "access_token": access_token,
+            }
+
+            return ResponseHelper.success(
+                data={"data": response_data}, result_description="RefreshToken processed successfully"
+            )
+
+        except Exception as e:
+            logger.error(f"Error processing RefreshToken request: {e}")
+            return ResponseHelper.internal_server_error(
+                result_description=f"Error processing RefreshToken request: {e}"
+            )

app/eco/services/base_service.py

@@ -0,0 +1,37 @@
+from app.eco.enums import TransactionType
+from flask import jsonify
+from marshmallow import ValidationError
+import logging
+from app.utils.mail import send_report_email, get_report_data
+
+logger = logging.getLogger(__name__)
+
+class BaseService:
+    TRANSACTION_TYPE = None
+
+    @classmethod
+    def validate_data(cls, data, schema):
+        """
+        Validate input data based on the provided schema.
+        """
+        logger.info(f"Processing {cls.TRANSACTION_TYPE} request")
+        return schema.load(data)
+
+    @classmethod
+    def send_mail(cls, report_data, recipients):
+            send_report_email(report_data, recipients)
+
+    # @classmethod
+    # def log_session(cls, validated_data):
+    #     """
+    #     Create a new session.
+    #     """
+    #     channel = "USSD" if validated_data.get("channel") is None else validated_data.get("channel")
+
+    #     return Session.create_session(
+    #         session_id = validated_data.get("transactionId"),
+    #         customer_id =  validated_data.get('customerId', None),
+    #         account_id = validated_data.get("accountId", None),  
+    #         type = cls.TRANSACTION_TYPE,
+    #         channel = channel,
+    #     )

app/eco/services/eligibility_check.py

@@ -0,0 +1,63 @@
+from flask import session, jsonify
+from app.utils.logger import logger
+from app.eco.services.base_service import BaseService
+from app.eco.schemas.eligibility_check import EligibilityCheckSchema
+from marshmallow import ValidationError
+from app.eco.enums import TransactionType
+from app.eco.helpers.response_helper import ResponseHelper
+
+import random
+
+
+class EligibilityCheckService(BaseService):
+    TRANSACTION_TYPE = TransactionType.ELIGIBILITY_CHECK
+
+    @staticmethod
+    def process_request(data):
+        """
+        Process the EligibilityCheck request.
+
+        Args:
+            data (dict): The request data.
+
+        Returns:
+            dict: A standardized response.
+        """
+        try:
+            # with db.session.begin():
+
+            validated_data = EligibilityCheckService.validate_data(
+                data, EligibilityCheckSchema()
+            )
+
+            account_id = validated_data.get("accountId")
+            customer_id = validated_data.get("customerId")
+            sessionId = validated_data.get("sessionId")
+            msisdn = validated_data.get("msisdn")
+
+            # Simulate processing
+            response_data = {
+                "minEligibleAmount": 1000.0,
+                "maxEligibleAmount": 50000.0,
+                "outstandingDebtAmount": 1000.0,
+            }
+
+            return ResponseHelper.success(data=response_data)
+
+        except ValidationError as err:
+
+            logger.error(f"Validation Error: {getattr(err, 'messages', str(err))}")
+            # db.session.rollback()
+            return ResponseHelper.unprocessable_entity(
+                result_description="Validation exception"
+            )
+
+        except ValueError as err:
+            logger.error(f"{getattr(err, 'messages', str(err))}")
+            # db.session.rollback()
+            return ResponseHelper.error(result_description=str(err))
+
+        except Exception as e:
+            logger.error(f"An error occurred: {str(e)}", exc_info=True)
+            # db.session.rollback()
+            return ResponseHelper.internal_server_error()

app/eco/services/get_offer.py

@@ -0,0 +1,67 @@
+from urllib import response
+from app.utils.logger import logger
+from app.eco.services.base_service import BaseService
+from app.eco.schemas.get_offer import GetOfferSchema
+from marshmallow import ValidationError
+from app.eco.enums import TransactionType
+from app.eco.helpers.response_helper import ResponseHelper
+
+import random
+
+class GetOfferService(BaseService):
+    TRANSACTION_TYPE = TransactionType.GET_OFFERS
+
+    @staticmethod
+    def process_request(data):
+        """
+        Process the GetOffer request.
+
+        Args:
+            data (dict): The request data.
+
+        Returns:
+            dict: A standardized response.
+        """
+        try:
+            validated_data = GetOfferService.validate_data(
+                data, GetOfferSchema()
+            )
+
+            # Simulate processing
+            offers = [
+                {
+                    "offerId": 14451,
+                    "productId": "2030",
+                    "amount": 10000.0,
+                    "upfrontPayment": 1000.0,
+                    "interestRate": 10.0,
+                    "recommendedRepaymentDates": ["2022-11-30"],
+                    "installmentAmount": 11000.0,
+                    "totalRepaymentAmount": 11000.0
+                },
+                {
+                    "offerId": 16645,
+                    "productId": "2060",
+                    "amount": 10000.0,
+                    "upfrontPayment": 0.0,
+                    "interestRate": 10.0,
+                    "recommendedRepaymentDates": ["2022-11-30", "2023-12-30"],
+                    "installmentAmount": 5761.9,
+                    "totalRepaymentAmount": 11523.8
+                }
+            ]
+
+            response_data = {
+                "outstandingDebtAmount": 0,
+                "offers": offers
+            }
+
+            return ResponseHelper.success(data=response_data)
+
+        except ValidationError as err:
+            logger.error(f"Validation Error: {getattr(err, 'messages', str(err))}")
+            return ResponseHelper.unprocessable_entity(result_description="Validation exception")
+
+        except Exception as e:
+            logger.error(f"An error occurred: {str(e)}", exc_info=True)
+            return ResponseHelper.internal_server_error()

app/eco/services/inflow_notification.py

@@ -0,0 +1,38 @@
+from urllib import response
+from app.utils.logger import logger
+from app.eco.services.base_service import BaseService
+from app.eco.schemas.inflow_notification import InflowNotificationSchema
+from marshmallow import ValidationError
+from app.eco.enums import TransactionType
+from app.eco.helpers.response_helper import ResponseHelper
+
+import random
+
+class InflowNotificationService(BaseService):
+    TRANSACTION_TYPE = TransactionType.INFLOW_NOTIFICATION
+
+    @staticmethod
+    def process_request(data):
+        """
+        Process the InflowNotification request.
+
+        Args:
+            data (dict): The request data.
+
+        Returns:
+            dict: A standardized response.
+        """
+        try:
+            validated_data = InflowNotificationService.validate_data(
+                data, InflowNotificationSchema()
+            )
+
+            return ResponseHelper.success()
+
+        except ValidationError as err:
+            logger.error(f"Validation Error: {getattr(err, 'messages', str(err))}")
+            return ResponseHelper.unprocessable_entity(result_description="Validation exception")
+
+        except Exception as e:
+            logger.error(f"An error occurred: {str(e)}", exc_info=True)
+            return ResponseHelper.internal_server_error()

app/eco/services/loan_information.py

@@ -0,0 +1,50 @@
+from app.utils.logger import logger
+from app.eco.services.base_service import BaseService
+from app.eco.schemas.loan_information import LoanInformationSchema
+from marshmallow import ValidationError
+from app.eco.enums import TransactionType
+from app.eco.helpers.response_helper import ResponseHelper
+
+class LoanInformationService(BaseService):
+    TRANSACTION_TYPE = TransactionType.LOAN_INFORMATION
+
+    
+    @staticmethod
+    def process_request(data):
+        """
+        Process the LoanInformation request.
+
+        Args:
+            data (dict): The request data.
+
+        Returns:
+            dict: A standardized response.
+        """
+        try:
+            # Validate the input data
+            validated_data = LoanInformationService.validate_data(
+                data, LoanInformationSchema()
+            )
+
+            logger.info(f"Fetching loan information for customer {validated_data['customerId']}")
+
+            # Simulate fetching loan information
+            debts = LoanInformationService._generate_sample_debts(validated_data['customerId'])
+            
+            response_data = {
+                "debts": debts,
+                "totalCurrentPayment": sum(debt['currentPaymentAmount'] for debt in debts),
+                "totalDebtAmount": sum(debt['totalRepaymentAmount'] for debt in debts),
+                "resultCode": "00",
+                "resultDescription": "Successful"
+            }
+
+            return ResponseHelper.success(result=loan_data)
+
+        except ValidationError as err:
+            logger.error(f"Validation Error: {getattr(err, 'messages', str(err))}")
+            return ResponseHelper.unprocessable_entity(result_description="Validation exception")
+
+        except Exception as e:
+            logger.error(f"An error occurred: {str(e)}", exc_info=True)
+            return ResponseHelper.internal_server_error()

app/eco/services/low_balance_notification.py

@@ -0,0 +1,38 @@
+from urllib import response
+from app.utils.logger import logger
+from app.eco.services.base_service import BaseService
+from app.eco.schemas.low_balance_notification import LowBalanceNotificationSchema
+from marshmallow import ValidationError
+from app.eco.enums import TransactionType
+from app.eco.helpers.response_helper import ResponseHelper
+
+import random
+
+class LowBalanceNotificationService(BaseService):
+    TRANSACTION_TYPE = TransactionType.LOW_BALANCE_NOTIFICATION
+
+    @staticmethod
+    def process_request(data):
+        """
+        Process the LowBalanceNotification request.
+
+        Args:
+            data (dict): The request data.
+
+        Returns:
+            dict: A standardized response.
+        """
+        try:
+            validated_data = LowBalanceNotificationService.validate_data(
+                data, LowBalanceNotificationSchema()
+            )
+
+            return ResponseHelper.success()
+
+        except ValidationError as err:
+            logger.error(f"Validation Error: {getattr(err, 'messages', str(err))}")
+            return ResponseHelper.unprocessable_entity(result_description="Validation exception")
+
+        except Exception as e:
+            logger.error(f"An error occurred: {str(e)}", exc_info=True)
+            return ResponseHelper.internal_server_error()

app/eco/services/provide_loan.py

@@ -0,0 +1,38 @@
+from urllib import response
+from app.utils.logger import logger
+from app.eco.services.base_service import BaseService
+from app.eco.schemas.provide_loan import ProvideLoanSchema
+from marshmallow import ValidationError
+from app.eco.enums import TransactionType
+from app.eco.helpers.response_helper import ResponseHelper
+
+import random
+
+class ProvideLoanService(BaseService):
+    TRANSACTION_TYPE = TransactionType.PROVIDE_LOAN
+
+    @staticmethod
+    def process_request(data):
+        """
+        Process the ProvideLoan request.
+
+        Args:
+            data (dict): The request data.
+
+        Returns:
+            dict: A standardized response.
+        """
+        try:
+            validated_data = ProvideLoanService.validate_data(
+                data, ProvideLoanSchema()
+            )
+
+            return ResponseHelper.success()
+
+        except ValidationError as err:
+            logger.error(f"Validation Error: {getattr(err, 'messages', str(err))}")
+            return ResponseHelper.unprocessable_entity(result_description="Validation exception")
+
+        except Exception as e:
+            logger.error(f"An error occurred: {str(e)}", exc_info=True)
+            return ResponseHelper.internal_server_error()

app/eco/services/repayment.py

@@ -0,0 +1,38 @@
+from urllib import response
+from app.utils.logger import logger
+from app.eco.services.base_service import BaseService
+from app.eco.schemas.repayment import RepaymentSchema
+from marshmallow import ValidationError
+from app.eco.enums import TransactionType
+from app.eco.helpers.response_helper import ResponseHelper
+
+import random
+
+class RepaymentService(BaseService):
+    TRANSACTION_TYPE = TransactionType.REPAYMENT
+
+    @staticmethod
+    def process_request(data):
+        """
+        Process the Repayment request.
+
+        Args:
+            data (dict): The request data.
+
+        Returns:
+            dict: A standardized response.
+        """
+        try:
+            validated_data = RepaymentService.validate_data(
+                data, RepaymentSchema()
+            )
+
+            return ResponseHelper.success()
+
+        except ValidationError as err:
+            logger.error(f"Validation Error: {getattr(err, 'messages', str(err))}")
+            return ResponseHelper.unprocessable_entity(result_description="Validation exception")
+
+        except Exception as e:
+            logger.error(f"An error occurred: {str(e)}", exc_info=True)
+            return ResponseHelper.internal_server_error()

app/extensions.py

@@ -1,5 +1,7 @@
 from flask_sqlalchemy import SQLAlchemy
 from flask_migrate import Migrate
+from flask_mail import Mail
 
+mail = Mail()
 db = SQLAlchemy()
 migrate = Migrate()

app/models/__init__.py

@@ -11,6 +11,13 @@ from .loan_repayment_schedule import LoanRepaymentSchedule
 from .transaction_offers import TransactionOffer
 from .repayments_data import RepaymentsData
 from .salary import Salary
+from .eco.account import EcoAccount
+from .eco.customer import EcoCustomer
+from .eco.loan import EcoLoan
+from .eco.session import EcoSession
+from .eco.installment import EcoInstallment
+from .eco.offer import EcoOffer
+
 
 
 __all__ = ['Customer', 'Account', 'Loan', 'Transaction', 'Repayment', 'LoanCharge', 'Offer', 'Charge', 'RACCheck', 'LoanRepaymentSchedule', 'TransactionOffer', 'RepaymentsData', 'Salary']

app/models/eco/account.py

@@ -0,0 +1,17 @@
+from sqlalchemy import Column, String, Date, Boolean, Integer
+from app.extensions import db
+
+class Account(db.Model):
+    __tablename__ = 'accounts'
+    __bind_key__ = 'eco'
+
+    id = Column(Integer, primary_key=True)
+    affiliate_code = Column(String(3), nullable=False)
+    customer_id = Column(String(9), nullable=False)
+    account_id = Column(String(10), unique=True, nullable=False)
+    registration_date = Column(Date, nullable=False)
+    account_currency_code = Column(String(3), nullable=False)
+    plastic_card_attached = Column(Boolean, default=False)
+    
+    def __repr__(self):
+        return f"<Account(id={self.id}, account_id={self.account_id}, customer_id={self.customer_id})>"

app/models/eco/customer.py

@@ -0,0 +1,18 @@
+from sqlalchemy import Column, String, Date, Integer
+from sqlalchemy.orm import relationship
+from app.extensions import db
+
+
+class Customer(db.Model):
+    __tablename__ = 'customers'
+    __bind_key__ = 'eco'
+
+    id = Column(Integer, primary_key=True)
+    affiliate_code = Column(String(3), nullable=False)
+    customer_id = Column(String(9), unique=True, nullable=False)
+    msisdn = Column(String(15), nullable=True)
+    created_at = Column(Date, nullable=False)
+
+
+    def __repr__(self):
+        return f"<Customer(id={self.id}, customer_id={self.customer_id}, msisdn={self.msisdn})>"

app/models/eco/installment.py

@@ -0,0 +1,21 @@
+from app.eco.enums.installment_status import InstallmentStatus
+from sqlalchemy import Column, String, Date, Numeric, ForeignKey, Enum, Integer, DateTime
+from app.extensions import db
+import enum
+
+class Installment(db.Model):
+    __tablename__ = 'installments'
+    __bind_key__ = 'eco'
+
+
+    id = Column(Integer, primary_key=True)
+    loan_id = Column(Integer, nullable=False)
+    installment_number = Column(Integer, nullable=False)
+    due_date = Column(Date, nullable=False)
+    amount = Column(Numeric(12, 2), nullable=False)
+    paid_amount = Column(Numeric(12, 2), default=0.00)
+    status = Column(Enum(InstallmentStatus), default=InstallmentStatus.PENDING)
+    penalty_amount = Column(Numeric(12, 2), default=0.00)
+    
+    def __repr__(self):
+        return f"<Installment(id={self.id}, loan_id={self.loan_id}, status={self.status})>"

app/models/eco/loan.py

@@ -0,0 +1,26 @@
+from app.eco.enums.loan_status import LoanStatus
+from sqlalchemy import Column, String, Date, Numeric, Enum
+from app.extensions import db
+import enum
+
+class Loan(db.Model):
+    __tablename__ = 'loans'
+    __bind_key__ = 'eco'
+
+    id = Column(Integer, primary_key=True)
+    request_id = Column(String(50), unique=True, nullable=False)
+    affiliate_code = Column(String(3), nullable=False)
+    customer_id = Column(String(9), nullable=False)
+    account_id = Column(String(10), nullable=False)
+    product_id = Column(String(4), nullable=False)
+    debt_id = Column(String(20), unique=True, nullable=False)
+    initial_credit_amount = Column(Numeric(12, 2), nullable=False)
+    current_balance = Column(Numeric(12, 2), nullable=False)
+    interest_rate = Column(Numeric(5, 2), nullable=False)
+    status = Column(Enum(LoanStatus), default=LoanStatus.PENDING)
+    disbursement_date = Column(Date, nullable=False)
+    due_date = Column(Date, nullable=False)
+    lien_amount = Column(Numeric(12, 2), default=0.00)
+    
+    def __repr__(self):
+        return f"<Loan(id={self.id}, debt_id={self.debt_id}, status={self.status})>"

app/models/eco/offer.py

@@ -0,0 +1,22 @@
+from sqlalchemy import Column, String, Numeric, Date, Integer
+from app.extensions import db
+
+class Offer(db.Model):
+    __tablename__ = 'offers'
+    __bind_key__ = 'eco'
+
+    id = Column(Integer, primary_key=True)
+    offer_id = Column(String(50), unique=True, nullable=False)
+    session_id = Column(String(50), nullable=False)
+    customer_id = Column(String(9), nullable=False)
+    product_id = Column(String(4), nullable=False)  
+    amount = Column(Numeric(12, 2), nullable=False)
+    upfront_payment = Column(Numeric(12, 2), nullable=False)
+    interest_rate = Column(Numeric(5, 2), nullable=False)
+    installment_amount = Column(Numeric(12, 2), nullable=False)
+    total_repayment_amount = Column(Numeric(12, 2), nullable=False)
+    expiration_date = Column(Date, nullable=False)
+    status = Column(String(20), default='AVAILABLE') 
+    
+    def __repr__(self):
+        return f"<Offer(id={self.id}, offer_id={self.offer_id}, status={self.status})>"

app/models/eco/session.py

@@ -0,0 +1,18 @@
+from sqlalchemy import Column, String, DateTime, Integer
+from app.extensions import db
+
+class Session(db.Model):
+    __tablename__ = 'sessions'
+    __bind_key__ = 'eco'
+
+    id = Column(Integer, primary_key=True)
+    session_id = Column(String(50), unique=True, nullable=False)
+    customer_id = Column(String(9), nullable=True)
+    account_id = Column(String(10), nullable=True)
+    msisdn = Column(String(15), nullable=False)
+    channel = Column(String(10), nullable=False) 
+    expires_at = Column(DateTime, nullable=False)
+    status = Column(String(20), default='ACTIVE') 
+    
+    def __repr__(self):
+        return f"<Session(id={self.id}, session_id={self.session_id}, status={self.status})>"

app/swagger/eco_digifi_swagger.json

@@ -0,0 +1,180 @@
+{
+  "openapi": "3.0.3",
+  "info": {
+    "title": "Swagger Bank Channel to Simbrella FirstAdvance - OpenAPI 3.0",
+    "description": "This is a Simbrella FirstAdvance Backend Server with the OpenAPI 3.0 specification.  \n\n\nSome useful links:\n- [Web Simulated Demo Page](https://digifi-salaryloan.chiefsoft.net/)\n- [Web Management Support Portal](https://digifi-office.chiefsoft.net/auth/login)",
+    "termsOfService": "http://swagger.io/terms/",
+    "contact": {
+      "email": "support@chiefsoft.com"
+    },
+    "license": {
+      "name": "Apache 2.0",
+      "url": "http://www.apache.org/licenses/LICENSE-2.0.html"
+    },
+    "version": "1.0.11"
+  },
+  "servers": [
+    {
+      "url": "http://localhost:4500"
+    },
+    {
+      "url": "http://api.dev.simbrellang.net:4500"
+    },
+        {
+      "url": "https://api.dev.simbrellang.net"
+    }
+  ],
+  "tags": [
+      {
+      "name": "Authorize",
+      "description": "This feature will be used for authorizing customers.",
+      "externalDocs": {
+        "description": "Find out more",
+        "url": "https://www.simbrellang.net"
+      }
+    },
+    {
+      "name": "AuthorizeRefresh",
+      "description": "This feature will be used for refreshing authorized customers.",
+      "externalDocs": {
+        "description": "Find out more",
+        "url": "https://www.simbrellang.net"
+      }
+    },
+    {
+      "name": "EligibilityCheck",
+      "description": "Eligibility Check Request",
+      "externalDocs": {
+        "description": "Find out more",
+        "url": "https://www.simbrellang.net"
+      }
+    },
+    {
+      "name": "SelectOffer",
+      "description": "This method is used the send the offer the customer selected to Simbrella.",
+      "externalDocs": {
+        "description": "Find out more",
+        "url": "https://www.simbrellang.net"
+      }
+    },
+    {
+      "name": "ProvideLoan",
+      "description": "Provide Loan Request.",
+      "externalDocs": {
+        "description": "Find out more",
+        "url": "https://www.simbrellang.net"
+      }
+    },
+    {
+      "name": "LoanStatus",
+      "description": "Loan Information Request.",
+      "externalDocs": {
+        "description": "Find out more",
+        "url": "https://www.simbrellang.net"
+      }
+    },
+    {
+      "name": "Repayment",
+      "description": "Repayment Request.",
+      "externalDocs": {
+        "description": "Find out more",
+        "url": "https://www.simbrellang.net"
+      }
+    }
+  ],
+  "paths": {
+    "/Authorize": {
+      "$ref": "swagger/paths/Authorize.json"
+    },
+    "/AuthorizeRefresh": {
+      "$ref": "swagger/paths/AuthorizeRefresh.json"
+    },
+    "/EligibilityCheck": {
+      "$ref": "swagger/paths/EligibilityCheck.json"
+    },
+    "/SelectOffer": {
+      "$ref": "swagger/paths/SelectOffer.json"
+    },
+    "/ProvideLoan": {
+      "$ref": "swagger/paths/ProvideLoan.json"
+    },
+    "/LoanStatus": {
+      "$ref": "swagger/paths/LoanStatus.json"
+    },
+    "/Repayment": {
+      "$ref": "swagger/paths/Repayment.json"
+    }
+  },
+  "components": {
+    "schemas": {
+      "EligibilityCheckRequest": {
+        "$ref": "swagger/schemas/EligibilityCheckRequest.json"
+      },
+      "EligibilityCheckResponse": {
+        "$ref": "swagger/schemas/EligibilityCheckResponse.json"
+      },
+      "SelectOfferRequest": {
+        "$ref": "swagger/schemas/SelectOfferRequest.json"
+      },
+      "SelectOfferResponse": {
+        "$ref": "swagger/schemas/SelectOfferResponse.json"
+      },
+      "LoanStatusRequest": {
+        "$ref": "swagger/schemas/LoanStatusRequest.json"
+      },
+      "LoanStatusResponse": {
+        "$ref": "swagger/schemas/LoanStatusResponse.json"
+      },
+      "RepaymentRequest": {
+        "$ref": "swagger/schemas/RepaymentRequest.json"
+      },
+      "RepaymentResponse": {
+        "$ref": "swagger/schemas/RepaymentResponse.json"
+      },
+      "CustomerConsentRequest": {
+        "$ref": "swagger/schemas/CustomerConsentRequest.json"
+      },
+      "CustomerConsentResponse": {
+        "$ref": "swagger/schemas/CustomerConsentResponse.json"
+      },
+      "NotificationCallbackRequest": {
+        "$ref": "swagger/schemas/NotificationCallbackRequest.json"
+      },
+      "NotificationCallbackResponse": {
+        "$ref": "swagger/schemas/NotificationCallbackResponse.json"
+      },
+      "ApiResponse": {
+        "$ref": "swagger/schemas/ApiResponse.json"
+      },
+      "AuthorizeResponse": {
+        "$ref": "swagger/schemas/AuthorizeResponse.json"
+      },
+      "AuthorizeRequest": {
+        "$ref": "swagger/schemas/AuthorizeRequest.json"
+      },
+      "AuthorizeRefreshResponse": {
+        "$ref": "swagger/schemas/AuthorizeRefreshResponse.json"
+      },
+      "AuthorizeRefreshRequest": {
+        "$ref": "swagger/schemas/AuthorizeRefreshRequest.json"
+      }
+    },
+    "securitySchemes": {
+      "basicAuth": {
+        "type": "http",
+        "scheme": "basic"
+      },
+      "bearerAuth": {
+        "type": "http",
+        "scheme": "bearer",
+        "bearerFormat": "JWT"
+      }
+    }
+  },
+  "security": [
+    {
+      "basicAuth": [],
+      "bearerAuth": []
+    }
+  ]
+}

app/utils/mail.py

@@ -0,0 +1,40 @@
+from flask_mail import Message
+from flask import current_app
+from app.extensions import mail
+import pandas as pd
+from io import BytesIO
+
+def get_report_data():
+    """
+    Fetch and return loan summary data.
+    """
+    return [
+        {"Type": "Disbursement", "Count": 45},
+        {"Type": "Repayment", "Count": 32},
+    ]
+def send_report_email(report_data: list, recipients: list):
+    """
+    Sends an HTML + Excel report to the given email recipients.
+    """
+    df = pd.DataFrame(report_data)
+    output = BytesIO()
+    df.to_excel(output, index=False)
+    output.seek(0)
+
+    html_table = df.to_html(index=False, border=1)
+
+    msg = Message(
+        subject="Loan Report Summary",
+        recipients=recipients,
+        html=f"<h3>Loan Report Summary</h3>{html_table}",
+    )
+    msg.attach(
+        "loan_report.xlsx",
+        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+        output.read()
+    )
+
+    with current_app.app_context():
+        mail.send(msg)
+
+    return "Report email sent"

requirements.txt

@@ -40,3 +40,6 @@ confluent-kafka==1.9.2
 
 python-dateutil
 
+Flask-Mail==0.10.0
+pandas==2.1.3
+openpyxl==3.1.5