docs: add Week 4 integration roadmap and next session guide
Comprehensive guide for Week 4 - External Integrations: **Phase 1: Register Webhook (15 min)** - Run webhook registration script - Verify Jira webhook is active - Test webhook delivery **Phase 2: n8n Workflows (90 min)** - Create 4 n8n workflows per integration guide - Slack integration workflow - Email integration workflow - BigBlueButton integration workflow **Phase 3: End-to-End Testing (30 min)** - Test Jira → Slack notifications - Test Email → Jira issue creation - Test BBB meeting link generation Total estimated time: ~2 hours Includes: - Quick reference commands - Known issues and workarounds - Success criteria - Progress tracking - File locations and credentials management Status: Ready for Week 4 execution Overall Progress: 60% complete (3 of 5 weeks) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
SamoilenkoVadym
parent
f1944fb98d
commit
af3ac04605
1 changed files with 256 additions and 0 deletions
256
opt/00-infrastructure/atlassian/NEXT-SESSION-WEEK4.md
Normal file
256
opt/00-infrastructure/atlassian/NEXT-SESSION-WEEK4.md
Normal file
|
|
@ -0,0 +1,256 @@
|
|||
# NEXT SESSION - Week 4 Integration Setup
|
||||
|
||||
**Date:** December 4, 2025 - Session End
|
||||
**Next Session Focus:** Week 4 - External Integrations
|
||||
**Status:** Ready to proceed
|
||||
|
||||
---
|
||||
|
||||
## Session Summary (Completed)
|
||||
|
||||
✅ **Week 1-3 Automation:** COMPLETE
|
||||
- 4 Jira projects with full configuration
|
||||
- 23 custom fields across all projects
|
||||
- 6 components in PROD project
|
||||
- 20+ saved filters
|
||||
- 4 Confluence spaces
|
||||
- 5 Jira dashboards
|
||||
|
||||
✅ **Week 4 Preparation:** COMPLETE
|
||||
- n8n webhook integration guide created
|
||||
- Webhook registration script ready
|
||||
- Integration architecture documented
|
||||
- All prerequisites verified
|
||||
|
||||
---
|
||||
|
||||
## Week 4 Roadmap - What to Do Next
|
||||
|
||||
### Phase 1: Register Webhook (15 minutes)
|
||||
|
||||
**Command:**
|
||||
```bash
|
||||
ssh ubuntu@51.89.231.46
|
||||
cd /opt/00-infrastructure/atlassian
|
||||
bash ./scripts/11-register-n8n-webhook.sh
|
||||
```
|
||||
|
||||
**Expected output:**
|
||||
```
|
||||
✓ Webhook registered successfully!
|
||||
Webhook IDs: [10000]
|
||||
```
|
||||
|
||||
**Verify webhook:**
|
||||
```bash
|
||||
curl -s -X GET \
|
||||
"https://ai-impress.atlassian.net/rest/api/3/webhook" \
|
||||
-H "Authorization: Basic di5zYW1vaWxlbmtvQGFpLWltcHJlc3MuY29tOkFUQVRUM3hGZkdGMEFCbEppNE1PUkoxTWx5YjZaaFItSTk4NFRZQ3JVaG9HSDN5SGYwYmpoWktrSl9wazI3czZtcmItR1ZvVnRyMGJYbVhXdFlEeVF0MUFFMMFV0NkJOcG1mcnoxQVRKbklicUFzV1Z1V2VLSHhxeUtKOGdaVkFwc2k4T0JjLWpDMkJWb0c5VFVFQkRQRE1XbUdfMEpHM3pGVTZidjhqVG1HZWN3ZTJ4bFp6VGlKbz1FMDA5MzE0MA==" | python3 -m json.tool
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Phase 2: n8n Workflows (90 minutes)
|
||||
|
||||
**Follow guide:** `/opt/00-infrastructure/atlassian/scripts/11-n8n-jira-integration-guide.md`
|
||||
|
||||
**Create 4 workflows in n8n:**
|
||||
|
||||
1. **Jira Event Handler** (Main webhook receiver)
|
||||
- Webhook endpoint: `/webhook/jira/events`
|
||||
- Receives all issue events
|
||||
- Routes to appropriate handlers
|
||||
|
||||
2. **Slack Integration** (Send notifications)
|
||||
- Node 1: Webhook receiver
|
||||
- Node 2: Switch (route by event type)
|
||||
- Node 3: Format message
|
||||
- Node 4: Send to Slack
|
||||
|
||||
3. **Email Integration** (Create issues from email)
|
||||
- Node 1: Email trigger (IMAP)
|
||||
- Node 2: Extract data
|
||||
- Node 3: Create Jira issue
|
||||
|
||||
4. **BigBlueButton** (Generate meeting links)
|
||||
- Node 1: BBB create meeting
|
||||
- Node 2: Store in Jira custom field
|
||||
- Node 3: Notify Slack with link
|
||||
|
||||
**n8n Access:**
|
||||
- URL: `https://n8n.ai-impress.com`
|
||||
- Auth: Authentik SSO (same credentials as Jira)
|
||||
|
||||
---
|
||||
|
||||
### Phase 3: Testing (30 minutes)
|
||||
|
||||
**Test webhook:**
|
||||
```bash
|
||||
# Create test issue
|
||||
curl -X POST \
|
||||
"https://ai-impress.atlassian.net/rest/api/3/issues" \
|
||||
-H "Authorization: Basic di5zYW1vaWxlbmtvQGFpLWltcHJlc3MuY29tOkFUQVRUM3hGZkdGMEFCbEppNE1PUkoxTWx5YjZaaFItSTk4NFRZQ3JVaG9HSDN5SGYwYmpoWktrSl9wazI3czZtcmItR1ZvVnRyMGJYbVhXdFlEeVF0MUFFMMFV0NkJOcG1mcnoxQVRKbklicUFzV1Z1V2VLSHhxeUtKOGdaVkFwc2k4T0JjLWpDMkJWb0c5VFVFQkRQRE1XbUdfMEpHM3pGVTZidjhqVG1HZWN3ZTJ4bFp6VGlKbz1FMDA5MzE0MA==" \
|
||||
-H "Content-Type: application/json" \
|
||||
-d '{
|
||||
"fields": {
|
||||
"project": {"key": "PROD"},
|
||||
"summary": "Test n8n integration",
|
||||
"issuetype": {"name": "Task"}
|
||||
}
|
||||
}'
|
||||
```
|
||||
|
||||
**Verify in n8n:**
|
||||
- Check execution logs for webhook event
|
||||
- Verify data is being received correctly
|
||||
- Check for any error messages
|
||||
|
||||
**Verify in Slack:**
|
||||
- Create issue in Jira
|
||||
- Wait 5 seconds
|
||||
- Check if notification appears in `#prod-jira`
|
||||
|
||||
---
|
||||
|
||||
## File Locations
|
||||
|
||||
**Automation Scripts:**
|
||||
- `/opt/00-infrastructure/atlassian/scripts/01-10-*.sh` - Completed
|
||||
- `/opt/00-infrastructure/atlassian/scripts/11-register-n8n-webhook.sh` - Ready to run
|
||||
|
||||
**Documentation:**
|
||||
- `/opt/00-infrastructure/atlassian/COMPLETE-STATUS.md` - Current status
|
||||
- `/opt/00-infrastructure/atlassian/WEEK-4-INTEGRATION-PLAN.md` - Architecture
|
||||
- `/opt/00-infrastructure/atlassian/scripts/11-n8n-jira-integration-guide.md` - Detailed guide
|
||||
|
||||
**Credentials:**
|
||||
- `/opt/00-infrastructure/atlassian/.env.atlassian` - API tokens (already configured)
|
||||
|
||||
---
|
||||
|
||||
## Quick Reference Commands
|
||||
|
||||
**Check Jira projects:**
|
||||
```bash
|
||||
source /opt/00-infrastructure/atlassian/.env.atlassian
|
||||
curl -s "https://ai-impress.atlassian.net/rest/api/3/project/search" \
|
||||
-H "Authorization: Basic $JIRA_AUTH" | python3 -m json.tool | head -50
|
||||
```
|
||||
|
||||
**Check existing webhooks:**
|
||||
```bash
|
||||
curl -s "https://ai-impress.atlassian.net/rest/api/3/webhook" \
|
||||
-H "Authorization: Basic $JIRA_AUTH" | python3 -m json.tool
|
||||
```
|
||||
|
||||
**Check webhook failures:**
|
||||
```bash
|
||||
curl -s "https://ai-impress.atlassian.net/rest/api/3/webhook/failed" \
|
||||
-H "Authorization: Basic $JIRA_AUTH" | python3 -m json.tool
|
||||
```
|
||||
|
||||
**Check Confluence spaces:**
|
||||
```bash
|
||||
curl -s "https://ai-impress.atlassian.net/wiki/api/v2/spaces?limit=50" \
|
||||
-H "Authorization: Basic $CONFLUENCE_AUTH" | python3 -m json.tool
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Known Issues & Workarounds
|
||||
|
||||
1. **Webhook not firing**
|
||||
- Issue: Events not reaching n8n
|
||||
- Solution: Check JQL filter in Jira webhook, verify n8n webhook URL is accessible
|
||||
|
||||
2. **Slack message not sending**
|
||||
- Issue: Bot token invalid or channel doesn't exist
|
||||
- Solution: Verify Slack bot token, create channels if needed
|
||||
|
||||
3. **Email integration not working**
|
||||
- Issue: IMAP credentials invalid
|
||||
- Solution: Check email server configuration in n8n
|
||||
|
||||
---
|
||||
|
||||
## Next Steps After This Session
|
||||
|
||||
### If Phase 1-3 completed successfully:
|
||||
1. ✅ Proceed to Week 5: Customer Portal & Training
|
||||
2. Mark Week 4 as COMPLETE
|
||||
|
||||
### If issues encountered:
|
||||
1. Check troubleshooting guide in week 4 integration plan
|
||||
2. Review webhook/API logs
|
||||
3. Verify all credentials are correct
|
||||
4. Retry with corrected configuration
|
||||
|
||||
---
|
||||
|
||||
## Success Criteria for Week 4
|
||||
|
||||
✅ Jira webhook registered and active
|
||||
✅ n8n receives Jira events (test in logs)
|
||||
✅ Slack messages appear within 5 seconds of issue creation
|
||||
✅ Email handler creates issues automatically
|
||||
✅ BBB meeting links generated and stored
|
||||
✅ No API rate limit errors
|
||||
✅ All workflows handle errors gracefully
|
||||
|
||||
---
|
||||
|
||||
## Estimated Time
|
||||
|
||||
- **Phase 1 (Webhook):** 15 minutes
|
||||
- **Phase 2 (n8n Workflows):** 90 minutes
|
||||
- **Phase 3 (Testing):** 30 minutes
|
||||
- **Total:** ~2 hours for full Week 4 completion
|
||||
|
||||
---
|
||||
|
||||
## Progress Tracking
|
||||
|
||||
**Weeks Completed:**
|
||||
- ✅ Week 1: Projects, Fields, Components, Filters
|
||||
- ✅ Week 2: Confluence Spaces
|
||||
- ✅ Week 3: Dashboards
|
||||
- 🔄 Week 4: Integrations (START HERE NEXT SESSION)
|
||||
- ⏳ Week 5: Portal & Training
|
||||
|
||||
**Overall Progress:** 60% Complete (3 of 5 weeks)
|
||||
|
||||
---
|
||||
|
||||
## Contact & Support
|
||||
|
||||
**If API documentation needed:**
|
||||
- Check: `/Volumes/SSD/Aimpress_Cloud_Prod/Jira Cloud API Postman.json`
|
||||
- Or search Atlassian API docs: https://developer.atlassian.com/cloud/jira/platform/
|
||||
|
||||
**For n8n support:**
|
||||
- Docs: https://docs.n8n.io
|
||||
- Access UI: https://n8n.ai-impress.com
|
||||
|
||||
**For Confluence support:**
|
||||
- Docs: https://confluence.atlassian.com
|
||||
|
||||
---
|
||||
|
||||
## Summary
|
||||
|
||||
✅ **Week 1-3:** Fully automated and complete
|
||||
✅ **Week 4:** Ready to begin - webhook registration script ready, n8n workflows documented
|
||||
✅ **Week 5:** Planned after Week 4 completion
|
||||
|
||||
**Status:** All infrastructure production-ready. Ready for external integrations.
|
||||
|
||||
**Next Session:** Register webhook and create n8n workflows per Phase 1-3 above.
|
||||
|
||||
---
|
||||
|
||||
Generated: December 4, 2025
|
||||
Session Status: COMPLETE & READY FOR WEEK 4
|
||||
Production Readiness: 100% (for Jira/Confluence setup)
|
||||
Integration Readiness: Ready to begin
|
||||
|
||||
Loading…
Add table
Reference in a new issue