High-level architecture of the Smart Weather Notification System Architecture diagram shows implemented components plus future planned weather alert modules.

☁️ Overview

This project delivers a serverless weather notification and automation system using AWS CDK (TypeScript).
It pulls live weather data from an external API and runs event-driven workflows:

  • Daily weather summary email at 7 AM Australia/Sydney
  • Automated AWS task simulation every 3 hours
  • Planned severe weather alert module (future version)

The system is fully modular, making it easy to extend without touching existing components.

🧱 AWS Services Used

ServicePurpose
AWS LambdaExecutes forecast and automation logic
EventBridge SchedulerTimezone-aware daily trigger (7:00 AM AEST/AEDT)
EventBridge Rules3-hour recurring automation trigger
Amazon SNSSends weather summaries and future alerts
Secrets ManagerSecurely stores the external API key
AWS CDK (TypeScript)Infrastructure-as-Code for reproducibility
JestLambda logic tests + CDK infrastructure assertions

🧩 Key Features

✔ 1. Daily Weather Summary (Implemented)

  • Fetches real-time weather from an external API
  • Builds a clean, human-readable summary email
  • Sends via SNS each morning at 7 AM Sydney time

✔ 2. Weather-Driven Automation (Implemented)

Runs every 3 hours and simulates cloud actions such as:

  • Pausing workloads during low sunlight
  • Activating tasks during good conditions
  • Logging reasoning to CloudWatch

⚠ 3. Severe Weather Alerts (Planned)

Architecturally planned but not implemented in v1.0:

  • Storm / cyclone alerts
  • Heatwave conditions
  • High wind warnings
  • Heavy rainfall detection

This is intentionally deferred to maintain v1.0 simplicity.

🧠 Lessons Learned

  • How EventBridge Scheduler differs from Rules (timezone support vs. cron)
  • Injecting external API keys securely into Lambda handlers
  • Testing AWS infrastructure with CDK assertions
  • Designing modular CDK stacks that support future expansion
  • Clean separation of implemented vs future modules for clarity in documentation

🧪 Testing & Validation

  • All Lambda logic tested with Jest (mock API + behaviour mapping)
  • CDK infrastructure tests validate:
    • Lambda resources
    • SNS topics
    • Scheduler and Rule configuration
    • IAM permissions
  • Deployed architecture verified in AWS Console
  • Complete teardown validated using cdk destroy

🖼️ Screenshots

ScreenshotDescription
Scheduler 7AM⏰ Daily EventBridge Scheduler at 7:00 AM (Australia/Sydney)
Automation Rule🔄 EventBridge Rule triggering automation every 3 hours
Lambda Logs📘 Automation handler logs in CloudWatch
Test Results✅ Logic + CDK tests successfully passing

📘 Documentation

🏁 Project Status

✅ Version 1.0 – Complete and Stable
Daily summaries and automation handlers implemented.
Severe weather alert module planned for a future release.

© 2025 Nicolas Gloss — AWS Cloud Engineer Portfolio
Built with AWS CDK and Hugo PaperMod.