A comprehensive cloud-based platform for automating Merchant Cash Advance (MCA) application processing, designed to streamline operations and improve efficiency through advanced OCR, document classification, and automated data extraction.
The Dollar Funding MCA Application Processing System automates the processing of Merchant Cash Advance applications, reducing manual data entry requirements by 93% while improving accuracy and processing speed. The system handles email submissions, document classification, data extraction, and application workflow management.
- Automated email monitoring and processing
- AI-powered document classification and OCR
- Secure document storage with field-level encryption
- RESTful API integration with webhook support
- Web-based user interface for application management
- Real-time status tracking and notifications
- Comprehensive audit logging and compliance reporting
- Frontend: React 18.x with TypeScript and Material-UI 5.x
- Backend Services:
- Java 17 (Spring Boot 3.1.x) for core services
- Node.js 18.x (NestJS) for email processing
- Python 3.11 (FastAPI) for document processing
- Infrastructure:
- AWS Cloud Platform
- Kubernetes 1.27.x for orchestration
- Docker 24.x for containerization
- Data Storage:
- PostgreSQL 14.x (AWS Aurora)
- Redis 7.0 for caching
- AWS S3 for document storage
The system implements a microservices architecture with the following key components:
- API Gateway (Kong) for request routing and security
- Email Service for processing submissions
- Document Service for classification and OCR
- Core Service for business logic
- Notification Service for webhooks and alerts
- Web UI for user interaction
-
Development Tools:
- Docker 24.x
- Kubernetes 1.27.x
- Node.js 18.x LTS
- Python 3.11
- Java 17 LTS
- Git 2.40+
-
Cloud Access:
- AWS account with appropriate permissions
- Auth0 account for authentication
- SendGrid account for email notifications
- Clone the repository:
git clone https://github.com/dollarfunding/mca-processing.git
cd mca-processing- Install dependencies:
# Core service
cd core-service
./mvnw install
# Document service
cd ../document-service
pip install -r requirements.txt
# Email service
cd ../email-service
npm install
# Web UI
cd ../web
npm install- Configure environment variables:
cp .env.example .env
# Edit .env with your configuration-
Infrastructure Setup:
- Configure AWS credentials
- Set up Auth0 application
- Configure SendGrid API keys
-
Application Configuration:
- Database connection strings
- API endpoints and keys
- Storage bucket configuration
- Email processing settings
- Start local services:
docker-compose up -d- Run database migrations:
./scripts/run-migrations.sh- Start development servers:
# Core service
./mvnw spring-boot:run
# Document service
uvicorn app.main:app --reload
# Email service
npm run start:dev
# Web UI
npm start- Request routing and load balancing
- Authentication and authorization
- Rate limiting and throttling
- API documentation (OpenAPI 3.0)
- Business logic implementation
- Data persistence and validation
- Transaction management
- Security and compliance enforcement
- Document classification
- OCR processing
- Data extraction
- Document storage management
- Email monitoring and processing
- Attachment handling
- Initial data extraction
- Queue management
- Webhook delivery
- Email notifications
- Status updates
- Event broadcasting
- Application management interface
- Document viewer
- Status tracking
- Configuration management
-
Development:
- Single region deployment
- Reduced redundancy
- Development tools enabled
-
Staging:
- Multi-AZ deployment
- Production-like configuration
- Test data only
-
Production:
- Multi-region active-active setup
- Full redundancy
- High availability configuration
- Create required AWS resources:
cd terraform
terraform init
terraform plan
terraform apply- Configure DNS and SSL:
./scripts/setup-dns.sh
./scripts/setup-ssl.sh- Build and push containers:
./scripts/build-containers.sh
./scripts/push-containers.sh- Deploy services:
kubectl apply -f k8s/-
Configure monitoring tools:
- Prometheus for metrics
- Grafana for visualization
- Datadog for APM
- CloudWatch for logs
-
Set up alerts:
- System health
- Performance metrics
- Security events
- Business KPIs
mca-processing/
├── core-service/ # Java Spring Boot service
├── document-service/ # Python document processing
├── email-service/ # Node.js email handling
├── notification-service/ # Node.js notifications
├── web/ # React frontend
├── k8s/ # Kubernetes configs
├── terraform/ # Infrastructure as code
└── scripts/ # Utility scripts
- Create feature branch
- Implement changes
- Write tests
- Submit pull request
- Code review
- Merge to main
-
Unit Tests:
- 80% minimum coverage
- Mock external dependencies
- Test business logic
-
Integration Tests:
- API contract testing
- Service interaction testing
- Database operation testing
-
End-to-End Tests:
- Critical user flows
- Performance testing
- Security testing
-
Authentication:
- JWT with OAuth 2.0
- Role-based access control
- Multi-factor authentication
-
Data Protection:
- Field-level encryption
- Data masking
- Audit logging
-
Compliance:
- SOC 2 Type II
- PCI DSS
- GDPR
- State Privacy Laws
This software is proprietary and confidential. Unauthorized copying, transfer, or reproduction of the contents of this system is strictly prohibited. See the LICENSE file for details.
Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.
Last Updated: 2024-01-01 Version: 1.0.0 Maintainers: System Architects, Lead Developers, DevOps Engineers