English | 中文 | Русский | Français | Deutsch | 日本語 | 한국어 | Español | Italiano | العربية
Tariflux is a tariff policy dynamic monitoring system for international trade enterprises, providing multi-country tariff data aggregation, real-time policy change early warning and basic impact analysis capabilities.
In today's increasingly volatile international trade environment, Tariflux aims to empower trade professionals with tools to mitigate risks and discover opportunities. We believe that accessible, timely information about tariff policies can help create a more equitable global trade ecosystem and support businesses of all sizes in navigating complex regulatory landscapes.
- Multi-country Tariff Data Aggregation: Collect and organize tariff policy data from China, US, and EU
- LLM-Enhanced Data Collection: Utilize advanced language models to improve data accuracy and coverage
- Real-time Policy Change Alerts: Monitor tariff policy changes and send alerts via email
- Basic Impact Analysis: Assess the impact of tariff changes on specific products and industries
- Customizable Alert Preferences: Set personalized notification preferences for specific products or regions
The project uses a microservice architecture, mainly including the following modules:
- API Gateway: Unified access layer, responsible for request routing and load balancing
- Data Collection Service: Use Python+Scrapy with LLM enhancement to crawl and intelligently process tariff data from various countries
- Policy Processing Service: Use Java+Spring Boot to process and analyze tariff policies
- Alert Engine Service: Monitor policy changes and send customizable alert notifications
- User Service: Manage user information, preferences, and subscription settings
- Frontend: Vue3 + Element Plus
- Backend:
- API Gateway: Spring Cloud Gateway
- Data Collection: Python + Scrapy + LLM Integration
- Policy Processing: Java + Spring Boot
- Message Queue: RabbitMQ
- Alert Engine: Spring Boot + Rule Engine
- Database: PostgreSQL + TimescaleDB
- AI Integration:
- LLM Providers: OpenAI, Google, Anthropic, Ollama
- Web Search: Tavily API integration
- Docker and Docker Compose
- JDK 11+
- Python 3.9+
- Node.js 14+
- Clone the repository
git clone https://github.com/XucroYuri/Tariflux.git
cd tariflux- Start backend services
docker-compose up -d- Start frontend application
# Navigate to frontend directory
cd frontend
# Install dependencies (if package.json exists)
npm install
# Start development server
npm run dev
# or use a simple HTTP server if no build system is configured
npx serve -s src- Access the system
# Backend API documentation
http://localhost:8080/docs
# Frontend application (depending on your setup)
http://localhost:3000 or http://localhost:5000
# Stop backend services
docker-compose down
# Stop frontend development server
# Press Ctrl+C in the terminal where the frontend server is running├── gateway/ # API Gateway Service
├── collector/ # Data Collection Service
├── policy-processor/ # Policy Processing Service
├── alert-engine/ # Alert Engine Service
├── user-service/ # User Service
├── frontend/ # Frontend Application
├── scripts/ # Deployment and Initialization Scripts
└── docker-compose.yml # Docker Orchestration Configuration
We welcome all forms of contributions, whether it's new features, documentation improvements, or issue reports! Tariflux is built with the belief that collaborative efforts can create better tools for navigating the complexities of international trade.
- Fork this repository
- Create your feature branch
git checkout -b feature/amazing-feature - Commit your changes
git commit -m 'Add some amazing feature' - Push to the branch
git push origin feature/amazing-feature - Open a Pull Request
We are looking for contributors to help implement the following features:
- Multi-language support
- Tariff data from more countries and regions
- Advanced data analysis and visualization
- API interface optimization
This system follows the AGPLv3 license, with the following exception clauses:
- Core data parsers allow commercial authorization
- Patent authorization for alert algorithms needs to be negotiated separately
- Data storage format follows OASIS open standards
Tariflux is developed by XucroYuri with the mission of making international trade more transparent and accessible for all participants in the global marketplace.