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)