DEV Community

Michael Ilerioluwa Adeniyi
Michael Ilerioluwa Adeniyi

Posted on

AWS AIdeas Global Competition

🛂 Building an AI Immigration Compliance Copilot with AWS Serverless + Amazon Bedrock

Navigating U.S. immigration compliance as an F-1 OPT/STEM OPT student is stressful.

Deadlines, unemployment limits, and reporting rules can feel overwhelming—and small mistakes can have serious consequences.

So I built an AI-powered system to help simulate scenarios, analyze risk, and provide real-time guidance.

This project was built for the AWS 10,000 AIdeas Competition, and it reached the Top 300 semi-finalists.

💡 What I Built

AI Immigration Compliance Copilot is an interactive system that helps students:

📅 Generate OPT/STEM OPT timelines
⚠️ Analyze compliance risk (Low / Medium / High)
🔄 Simulate “what-if” scenarios (job loss, unemployment changes, etc.)
🤖 Ask AI questions about their situation in real time
📘 Receive structured recommendations based on USCIS-style rules
🧠 Why I Built It

Most immigration resources are:

static
confusing
or hard to interpret in real-world scenarios

I wanted to build something that could:

Turn complex immigration rules into interactive decision-making support.

Not just information—but simulation + reasoning.

🏗️ System Architecture

The system is fully serverless on AWS:

🔹 Frontend
Amazon S3 Static Website Hosting
TypeScript-based UI
Real-time updates via API calls
🔹 Backend
AWS Lambda (Node.js 20.x)
Handles:
timeline calculations
unemployment tracking
risk classification
scenario simulation logic
🔹 API Layer
Amazon API Gateway (REST API)
7 endpoints:
POST /timeline → Generate OPT timeline
POST /scenarios → Risk analysis
POST /simulator → Run simulations
GET /sessions/{id} → Retrieve saved state
POST /ai/explain → AI explanations
POST /ai/chat → Q&A assistant
POST /ai/assist → General guidance
🔹 Data Layer
Amazon DynamoDB
Stores:
session state
user inputs
calculated results
30-day TTL for automatic cleanup
🔹 AI Layer
Amazon Bedrock (Claude 3 Haiku)

Used for:

natural language explanations of compliance risk
conversational “what-if” questions
contextual guidance based on user scenario
🔹 Orchestration
Kiro (AI development assistant)
Used for:
structured prompting
refining AI responses
enforcing consistency in outputs
🔄 How It Works
User enters OPT/STEM OPT details
Frontend sends request to API Gateway
Lambda processes compliance logic
DynamoDB stores session state
Bedrock generates AI explanations
UI updates in real time
🧪 Example Scenario

A student inputs:

OPT start date: June 1
70 days of unemployment used
Recently lost job

The system:

recalculates remaining unemployment allowance
flags HIGH compliance risk
generates AI explanation of consequences
suggests next actions (e.g., secure employment within X days, contact DSO)
⚖️ Hybrid Design: Rules + AI

One of the key design decisions was combining:

Deterministic logic (backend)
ensures accuracy for timelines and calculations
AI reasoning (Bedrock)
explains outcomes in human language
helps interpret complex edge cases

This hybrid approach ensures:

✔ accuracy
✔ clarity
✔ flexibility
🧩 Key Learnings
Serverless architecture makes scaling this kind of tool simple and cost-efficient
AI is most powerful when paired with deterministic logic
Real-world problems often require simulation, not just answers
Clear UX is just as important as backend logic
🏆 Competition Outcome

This project was built for the AWS 10,000 AIdeas Competition and was selected as a:

🥉 Top 300 semi-finalist out of thousands of global submissions

🚀 What’s Next

Planned improvements include:

Amazon EventBridge for compliance reminders
SNS/SES for email alerts
Multi-language support
Deeper multi-turn AI memory
Mobile app via AWS Amplify
⚠️ Disclaimer

This tool is for educational purposes only and does not constitute legal advice.

Users should consult their Designated School Official (DSO) or immigration attorney for official guidance.

🙏 Closing Thoughts

This was a great exercise in combining:

cloud architecture
AI reasoning systems
real-world compliance logic

Still building. Still learning.

If you’re building with AWS or working on AI systems, I’d love to connect and exchange ideas.

Link to the my Build Article here:

AWS Builder Center

Connect with builders who understand your journey. Share solutions, influence AWS product development, and access useful content that accelerates your growth. Your community starts here.

favicon builder.aws.com

Top comments (0)