Vision: Empowering Bangladeshi SMEs with AI-driven trade intelligence tools to navigate complex international trade requirements with confidence.
TrdrHub is a comprehensive trade intelligence platform designed specifically for small and medium enterprises (SMEs) in Bangladesh. Our mission is to democratize access to sophisticated trade finance tools and knowledge, enabling SMEs to compete effectively in international markets.
Phase 4.5 Complete: Security-hardened backend with comprehensive regression testing. Frontend development begins Q4 2024.
Letter of Credit Validation Engine - Our flagship product that revolutionizes LC document validation for Bangladeshi SMEs.
Key Features:
- 🔍 Intelligent Document Analysis: Advanced OCR with AWS Textract fallback
- 🏦 Bank Profile Integration: Sonali Bank, Dutch Bangla Bank, HSBC Bangladesh
- ⚡ Async Processing: Scalable job queue with real-time status tracking
- 🛡️ Security Hardened: AWS credentials, Redis TLS, file upload validation, S3 KMS encryption
- 📊 Comprehensive Testing: 150+ regression tests ensuring production readiness
- 💰 Tier-based Pricing: Free, Pro, and Enterprise plans
Business Impact:
- Reduces LC processing time from days to minutes
- Prevents costly document rejections (avg. $2,500 per rejection)
- 95% accuracy in compliance validation
- Supports 3 major Bangladeshi banks with standardized workflows
- HS Code Intelligence: Automated classification and duty calculation
- Container Tracking Hub: Real-time shipment visibility across carriers
- Trade Document Generator: Smart templates for export documentation
- Compliance Assistant: Real-time regulatory updates and guidance
- Language: Python 3.9+
- Framework: Flask with async processing
- Database: PostgreSQL with Redis caching
- Cloud: AWS (Lambda, SQS, S3, Textract, CloudWatch)
- Infrastructure: Terraform/CDK for deployment
- Security: KMS encryption, TLS, environment-based secrets
- Testing: Pytest with 85%+ coverage, comprehensive regression suite
- Framework: React 18+ with TypeScript
- Styling: Tailwind CSS with mobile-first design
- State Management: Zustand/Redux Toolkit
- API Integration: React Query for data fetching
- Authentication: JWT with refresh tokens
- Deployment: Vercel/Netlify with CDN
- CI/CD: GitHub Actions with automated testing
- Monitoring: CloudWatch, custom dashboards, alerting
- Deployment: Multi-environment (dev/staging/prod)
- Security: Automated vulnerability scanning, dependency updates
- Cost Management: Usage monitoring with spending alerts
# System requirements
python >= 3.9
postgresql >= 12
redis >= 6.0# Clone the repository
git clone <repo-url>
cd trdrhub/lcopilot
# Install dependencies
pip install -r requirements.txt
# Set environment variables
export AWS_ACCESS_KEY_ID="your-key"
export AWS_SECRET_ACCESS_KEY="your-secret"
export REDIS_PASSWORD="your-redis-password"
export KMS_KEY_ID="your-kms-key-id"
export DATABASE_URL="postgresql://user:pass@localhost:5432/lcopilot"
# Run database migrations
alembic upgrade head
# Start the development server
python main.py# Run regression test suite
make test-regression
# Run security tests
make test-regression-security
# Generate HTML test report
make test-regression-html- Health Check:
GET /health - LC Validation:
POST /validate(upload LC document) - Job Status:
GET /job/{job_id} - Bank Profiles:
GET /banks - User Dashboard:
GET /dashboard
┌─────────────────────┐ ┌─────────────────────┐ ┌─────────────────────┐
│ SME Portal UI │ │ Admin Dashboard │ │ Bank Integration │
│ (React + TS) │ │ (Flask + Jinja) │ │ (APIs) │
└─────────┬───────────┘ └─────────┬───────────┘ └─────────┬───────────┘
│ │ │
┌─────────▼──────────────────────────▼──────────────────────────▼───────────┐
│ Flask API Gateway │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Rate │ │ Auth & │ │ Document │ │ Job Status │ │
│ │ Limiting │ │ Session │ │ Processing │ │ Tracking │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
└─────────┬──────────────────────────────────────────────────────┬────────┘
│ │
┌─────────▼───────────┐ ┌──────────▼──────────┐
│ Async Pipeline │ │ Data Layer │
│ ┌─────┐ ┌─────┐ │ │ ┌──────┐ ┌──────┐ │
│ │ SQS │ │λLambda│ │ │ │ PgSQL│ │ Redis│ │
│ └─────┘ └─────┘ │ │ └──────┘ └──────┘ │
└─────────┬───────────┘ └──────────┬──────────┘
│ │
┌─────────▼───────────────────────────────────────────────────────▼────────┐
│ AWS Services │
│ S3 Storage │ Textract OCR │ CloudWatch │ KMS │
└──────────────────────────────────────────────────────────────────────────┘
- Primary: Bangladeshi SME exporters (apparel, jute, tea, leather)
- Secondary: Import-dependent SMEs in manufacturing
- Tertiary: Trade finance consultants and freight forwarders
- SaaS Subscriptions: Tiered pricing model
- Transaction Fees: Per-document processing
- Enterprise Licensing: Custom deployments for large organizations
- Integration Partnerships: Revenue sharing with banks and logistics providers
- Local Expertise: Built specifically for Bangladesh trade ecosystem
- Bank Partnerships: Direct integration with major local banks
- Regulatory Compliance: Aligned with Bangladesh Bank guidelines
- Cultural Understanding: Bengali language support, local business practices
- Core LC validation engine
- Basic web interface
- Single bank integration (Sonali Bank)
- MVP deployment to AWS
- Multi-tier pricing model
- Pilot customer program
- Advanced error handling
- Performance optimization
- Dutch Bangla Bank & HSBC integration
- Email notification system
- Enhanced document templates
- User management system
- AWS Textract fallback OCR
- Async processing pipeline (SQS/Lambda)
- Security hardening (Phase 4.5)
- Comprehensive regression testing
- Production monitoring & alerting
- Complete React frontend rewrite
- Mobile-responsive design
- Real-time job status updates
- Enhanced user experience
- Progressive Web App (PWA)
- HS Code Intelligence tool
- Container tracking integration
- Trade document generator
- Compliance assistant bot
- Multi-tool unified platform
- Shared authentication & billing
- Cross-tool data insights
- Enterprise dashboard
- API marketplace
We welcome contributions from the developer community! Please see our contributing guidelines in the docs folder.
- Fork the repository
- Create a feature branch
- Write tests for new functionality
- Ensure all regression tests pass
- Submit a pull request with detailed description
- Python: PEP 8 compliance, type hints, docstrings
- Frontend: ESLint, Prettier, TypeScript strict mode
- Testing: Minimum 85% coverage, comprehensive regression suite
- Security: Regular dependency updates, vulnerability scanning
- Technical Documentation:
/docsfolder - API Documentation: Available at
/docs/apiwhen running locally - Video Tutorials: Coming in Phase 5
- Community Support: GitHub Discussions
- Enterprise Support: Contact sales@trdrhub.com
MIT License - see LICENSE file for details.
TrdrHub Team
- Email: hello@trdrhub.com
- LinkedIn: TrdrHub
- Website: https://trdrhub.com (launching Q1 2025)
Empowering Bangladesh's SME exporters, one intelligent tool at a time. 🇧🇩