---

Mirabile

Transform your dream career into a structured roadmap with intelligent, personalized resources.
Explore the docs »

🎥 View Demo · Report Bug · Request Feature

📖 About The Project

Mirabile is an intelligent career roadmap platform that converts user-defined career goals into structured learning paths with context-aware resources.

Users can input goals such as:

• “Software Engineer at Google”
• “AI Engineer focusing on machine learning”

Mirabile will:

• Generate a multi-phase roadmap
• Adapt based on role, domain, and company
• Recommend targeted resources
• Enable progress tracking and note-taking

---

🎥 Demo

📌 Replace the link below with your actual demo video (YouTube / Drive)

🔗 Demo Video: https://your-demo-link.com

What the demo should showcase:

• Pipeline execution (Jenkins stages)
• Roadmap generation
• Resource recommendations
• Deployment to staging/production
• Monitoring/logging output

---

🏗️ Architecture

Frontend (React)
        ↓
Backend API (Node.js / Express)
        ↓
Business Logic Layer
- Input Parser
- Roadmap Generator
- Company Intelligence Engine
- Resource Recommender
        ↓
Database (MongoDB / PostgreSQL)

---

🛠️ Built With

• React (Frontend)
• Node.js / Express (Backend)
• MongoDB / PostgreSQL (Database)
• Docker (Containerization)
• Jenkins (CI/CD Pipeline)
• SonarQube (Code Quality)
• Snyk / npm audit (Security Scanning)
• Prometheus / Grafana (Monitoring)

---

🚀 Getting Started

Prerequisites

• Node.js (v18+)
• npm
• Docker (optional)

npm install npm@latest -g

---

Installation

git clone https://github.com/Stewie-pixel/mirabile.git
cd mirabile
npm install

Create a .env file:

PORT=5000
DB_URI=your_database_connection

Run the app:

npm run dev

---

💡 Usage

1. Enter a career goal
2. System processes input
3. Generates roadmap + resources
4. Track progress and add notes

---

🧪 Testing

• Unit Tests:

  • Input parsing
  • Roadmap generation
  • Resource recommendation

• Integration Tests:

  • API endpoints

Run tests:

npm test

---

🔄 DevOps Pipeline

This project implements a full 7-stage CI/CD pipeline:

1. Build – Compile and package application
2. Test – Run automated tests
3. Code Quality – SonarQube analysis
4. Security – Vulnerability scanning
5. Deploy – Staging deployment
6. Release – Production promotion
7. Monitoring – Performance tracking

---

🗺️ Roadmap (Features)

• Career input parsing
• Dynamic roadmap generation
• Company-aware recommendations
• Resource engine
• Notes & progress tracking
• Authentication system
• Adaptive roadmap (AI refinement)
• Gamification

---

🤝 Contributing

1. Fork the Project
2. Create a branch (feature/your-amazing-feature)
3. Commit changes
4. Push and open PR

---

📄 License

Distributed under the Apache 2.0 License.

---

📬 Contact

Chi Vi Han – hanchivi39@gmail.com

GitHub: https://github.com/Stewie-pixel/mirabile

---