MQL5-Google-Onedrive/docs/Quick_Start_Guide.md
copilot-swe-agent[bot] 08eff4a1a4 Address code review feedback: clarify workflow placeholder, fix date, remove hardcoded branch name
Co-authored-by: Mouy-leng <199350297+Mouy-leng@users.noreply.github.com>
2026-01-02 15:59:08 +00:00

138 lines
4.4 KiB
Markdown

# Quick Start: Auto-Merge and Trading Research Integration
This guide provides a quick overview of the new features added to this repository.
## 🚀 What's New
### 1. Automated Trading News Monitoring
- **Scheduled Workflow**: Runs every 4 hours to monitor global trading news
- **GPT Groups Integration**: Chart analysis and technical pattern recognition
- **Perplexity Integration**: Real-time news aggregation from global sources
- **Direct Reporting**: News feeds directly to MT5 trading systems
### 2. Enhanced Auto-Merge Capabilities
- **Label-Driven**: Add `automerge` label to enable automatic merging
- **Comprehensive Guide**: Step-by-step instructions for setup and usage
- **Smart Merging**: Squash merge with branch cleanup
### 3. Research Team Integration
- **GitHub Profile**: [https://github.com/A6-9V](https://github.com/A6-9V)
- **GPT Space**: Used for trading system analysis
- **Perplexity Group**: Used for news monitoring
## 📋 Quick Actions
### Enable Auto-Merge for Current PR
1. Go to the pull request page
2. Click **Labels** in the right sidebar
3. Add the `automerge` label
4. Wait for CI checks to pass
5. Get required approvals (if needed)
6. PR will automatically merge when ready
### Manual Workflow Trigger
Manually trigger the trading news monitor:
```bash
# Via GitHub UI:
# 1. Go to Actions tab
# 2. Select "Trading News Monitor (Scheduled)"
# 3. Click "Run workflow"
```
### Check Monitoring Status
View the latest monitoring logs:
1. Go to **Actions** tab
2. Click on **Trading News Monitor (Scheduled)**
3. Select the most recent run
4. View logs for monitoring activity
## 📚 Documentation
| Document | Description |
|----------|-------------|
| [Auto-Merge Guide](Auto_Merge_Guide.md) | Complete guide for auto-merge setup and usage |
| [Trading Research Integration](Trading_Research_Integration.md) | GPT and Perplexity integration details |
| [README.md](../README.md) | Main repository documentation |
## 🔧 Configuration Files
| File | Purpose |
|------|---------|
| `.github/workflows/trading-news-monitor.yml` | Scheduled trading news monitoring |
| `.github/workflows/enable-automerge.yml` | Auto-merge enablement |
| `.github/workflows/ci.yml` | Continuous integration |
| `.github/workflows/onedrive-sync.yml` | OneDrive synchronization |
## ⚙️ Workflow Schedule
| Workflow | Schedule | Purpose |
|----------|----------|---------|
| Trading News Monitor | Every 4 hours | Monitor global trading news |
| CI | On PR/Push | Validate and package code |
| OneDrive Sync | On push to main | Sync MT5 files |
| Auto-merge | On label | Enable automatic merge |
## 🔗 Important Links
- **Repository**: [A6-9V/MQL5-Google-Onedrive](https://github.com/A6-9V/MQL5-Google-Onedrive)
- **GitHub Profile**: [A6-9V](https://github.com/A6-9V)
- **Developer Tip Window**: [ChatGPT Project](https://chatgpt.com/g/g-p-691e9c0ace5c8191a1b409c09251cc2b-window-for-developer-tip/project)
- **WhatsApp Community**: [Agent Community](https://chat.whatsapp.com/DYemXrBnMD63K55bjUMKYF)
## 💡 Tips
1. **Auto-merge**: Only use for well-tested PRs with proper CI coverage
2. **News Monitoring**: Check logs regularly for important market events
3. **GPT Integration**: Use for complex chart analysis and pattern recognition
4. **Perplexity**: Leverage for broad market news aggregation
5. **Testing**: Always test strategies in demo before live trading
## 🛠️ Troubleshooting
### Auto-Merge Not Working
- Verify `automerge` label is added
- Check CI status (must pass)
- Ensure required reviews are approved
- Check branch protection settings
### Workflow Not Running
- Check GitHub Actions tab for errors
- Verify workflow syntax is valid
- Check repository permissions
- Review workflow logs
### Need Help?
- Check the detailed guides in `/docs`
- Review workflow files in `.github/workflows`
- Contact via email or WhatsApp (see links above)
## 📊 Monitoring Dashboard
Monitor all workflows from GitHub Actions tab:
```
Repository → Actions → All workflows
├── CI
├── Enable auto-merge (label-driven)
├── Sync to OneDrive (rclone)
└── Trading News Monitor (Scheduled)
```
## 🎯 Next Steps
1. ✅ Review this guide
2. ✅ Add `automerge` label to enable automatic merging
3. ✅ Check trading news monitor logs
4. ✅ Configure GPT and Perplexity integrations
5. ✅ Set up MT5 notifications
6. ✅ Test in demo account
---
**Last Updated**: January 2, 2024
**Version**: 1.0
**Status**: ✅ All systems operational