{"id":28911494,"url":"https://github.com/deepak748030/savana","last_synced_at":"2026-04-05T22:35:27.728Z","repository":{"id":300214991,"uuid":"1003913005","full_name":"deepak748030/savana","owner":"deepak748030","description":"Scalable and modular ecommerce backend built with Node.js, Express, MongoDB, Swagger, Docker, and Kubernetes — designed for performance, security, and maintainability.","archived":false,"fork":false,"pushed_at":"2025-11-22T05:45:33.000Z","size":2582,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-05T22:35:25.501Z","etag":null,"topics":["api-documentation","backend","docker","ecommerce","express","grafana","jwt-authentication","kubernetes","microservices","mongodb","multer","nginx","nodejs","prometheus","rest-api","swagger"],"latest_commit_sha":null,"homepage":"https://savana-server.vercel.app","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/deepak748030.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-06-17T20:37:41.000Z","updated_at":"2025-11-22T06:39:24.000Z","dependencies_parsed_at":"2025-06-20T13:24:26.564Z","dependency_job_id":"83ec410c-f422-4c56-b1e0-7518b5901be2","html_url":"https://github.com/deepak748030/savana","commit_stats":null,"previous_names":["deepak748030/savana"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/deepak748030/savana","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deepak748030%2Fsavana","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deepak748030%2Fsavana/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deepak748030%2Fsavana/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deepak748030%2Fsavana/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/deepak748030","download_url":"https://codeload.github.com/deepak748030/savana/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deepak748030%2Fsavana/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31452899,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T21:22:52.476Z","status":"ssl_error","status_checked_at":"2026-04-05T21:22:51.943Z","response_time":75,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-documentation","backend","docker","ecommerce","express","grafana","jwt-authentication","kubernetes","microservices","mongodb","multer","nginx","nodejs","prometheus","rest-api","swagger"],"created_at":"2025-06-21T19:08:38.376Z","updated_at":"2026-04-05T22:35:27.702Z","avatar_url":"https://github.com/deepak748030.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 Savana Ecommerce Backend\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n  \u003cimg src=\"https://img.shields.io/badge/Node.js-339933?style=for-the-badge\u0026logo=node.js\u0026logoColor=white\" alt=\"Node.js\" /\u003e\r\n  \u003cimg src=\"https://img.shields.io/badge/Express.js-000000?style=for-the-badge\u0026logo=express\u0026logoColor=white\" alt=\"Express.js\" /\u003e\r\n  \u003cimg src=\"https://img.shields.io/badge/MongoDB-4EA94B?style=for-the-badge\u0026logo=mongodb\u0026logoColor=white\" alt=\"MongoDB\" /\u003e\r\n  \u003cimg src=\"https://img.shields.io/badge/Docker-2496ED?style=for-the-badge\u0026logo=docker\u0026logoColor=white\" alt=\"Docker\" /\u003e\r\n  \u003cimg src=\"https://img.shields.io/badge/Kubernetes-326CE5?style=for-the-badge\u0026logo=kubernetes\u0026logoColor=white\" alt=\"Kubernetes\" /\u003e\r\n\u003c/div\u003e\r\n\r\n\u003cdiv align=\"center\"\u003e\r\n  \u003ch3\u003e🛒 Full Production-Ready Backend with Kubernetes Support and Swagger\u003c/h3\u003e\r\n  \u003cp\u003e\u003cstrong\u003eLive Swagger API:\u003c/strong\u003e \u003ca href=\"http://your-domain.com/api-docs\"\u003ehttp://your-domain.com/api-docs\u003c/a\u003e\u003c/p\u003e\r\n\u003c/div\u003e\r\n\r\n---\r\n\r\n## 📖 Table of Contents\r\n\r\n- [🌟 Features](#-features)\r\n- [🛠️ Technology Stack](#️-technology-stack)\r\n- [🚀 Getting Started](#-getting-started)\r\n- [⚙️ Kubernetes Setup](#%EF%B8%8F-kubernetes-setup)\r\n- [📁 Project Structure](#-project-structure)\r\n- [🌐 Deployment](#-deployment)\r\n- [🧪 API Testing](#-api-testing)\r\n- [📄 License](#-license)\r\n- [👨‍💻 Author](#-author)\r\n\r\n---\r\n\r\n## 🌟 Features\r\n\r\n- ⚙️ Modular Express Backend (routes, controllers, services)\r\n- 🧩 Category \u0026 Product CRUD APIs\r\n- 📤 Image Upload via Multer\r\n- 🔍 Product Search and Filter by Category\r\n- 🌍 MongoDB Integration (external URI)\r\n- 📚 Swagger API Docs (`/api-docs`)\r\n- 📦 Prometheus Metrics Ready (for Grafana)\r\n- 🧱 Dockerized with Node 22 Alpine\r\n- ☸️ Kubernetes with Ingress \u0026 NGINX\r\n- 📂 Public static file support via `/uploads`\r\n---\r\n\r\n## 🛠️ Technology Stack\r\n\r\n- **Node.js \u0026 Express.js** – Backend framework\r\n- **MongoDB** – No internal DB pod, external URI-based\r\n- **Multer** – File handling\r\n- **Swagger** – Auto API documentation\r\n- **Docker** – Containerization\r\n- **Kubernetes** – Orchestration \u0026 scaling\r\n- **NGINX + Ingress** – Domain + SSL route config\r\n\r\n---\r\n\r\n## 🚀 Getting Started\r\n\r\n### 📦 Prerequisites\r\n\r\n- Node.js \u003e= 16\r\n- Docker \u0026 Kubernetes (Minikube or cluster)\r\n- MongoDB Atlas URI\r\n\r\n### 🔧 Setup Locally\r\n\r\n```bash\r\ngit clone https://github.com/deepak748030/savana.git\r\ncd savana\r\n\r\nnpm install\r\ncp .env.exports.js .env     # Rename and fill your Mongo URI\r\n\r\nnpm run dev\r\n````\r\n\r\nVisit Swagger: [http://localhost:5000/api-docs](http://localhost:5000/api-docs)\r\n\r\n---\r\n\r\n## ⚙️ Kubernetes Setup\r\n\r\n### ✅ Files\r\n\r\n* `k8s/deployment.yaml`\r\n* `k8s/service.yaml`\r\n* `k8s/ingress.yaml`\r\n* `k8s/nginx-ingress.yaml`\r\n\r\n### 🧠 Commands\r\n\r\n```bash\r\nkubectl apply -f k8s/deployment.yaml\r\nkubectl apply -f k8s/service.yaml\r\nkubectl apply -f k8s/nginx-ingress.yaml\r\nkubectl apply -f k8s/ingress.yaml\r\n```\r\n\r\n\u003e Ensure `Ingress` is enabled in Minikube:\r\n\r\n```bash\r\nminikube addons enable ingress\r\n```\r\n\r\n---\r\n\r\n## 📁 Project Structure\r\n\r\n```\r\n.\r\n├── src/\r\n│   ├── config/             # DB and env setup\r\n│   ├── controllers/        # Logic for API endpoints\r\n│   ├── models/             # Mongoose models\r\n│   ├── routes/             # API routes\r\n│   ├── uploads/            # Image uploads\r\n│   ├── utils/              # Helpers\r\n│   ├── swagger/            # Swagger config\r\n│   └── app.js              # Express app config\r\n├── server.js               # Server entry point\r\n├── k8s/                    # Kubernetes manifests\r\n├── Dockerfile              # Docker container config\r\n├── .env.exports.js         # Sample env file\r\n├── package.json\r\n└── README.md\r\n```\r\n\r\n---\r\n\r\n## 🌐 Deployment\r\n\r\n### 🐳 Docker Build \u0026 Push\r\n\r\n```bash\r\ndocker build -t yourdockerhub/savana-backend .\r\ndocker push yourdockerhub/savana-backend\r\n```\r\n\r\n### ☸️ Deploy to Kubernetes\r\n\r\n```bash\r\nkubectl apply -f k8s/\r\n```\r\n\r\nAccess via: `http://\u003cyour-minikube-ip\u003e/api-docs` after setting ingress.\r\n\r\n---\r\n\r\n## 🧪 API Testing\r\n\r\n* **Docs:** `GET /api-docs`\r\n* **File Uploads:** `POST /api/upload`\r\n* **Protected Routes:** Use `Authorization: Bearer \u003ctoken\u003e`\r\n* **Metrics (for Prometheus):** `GET /metrics`\r\n\r\n---\r\n\r\n## 📄 License\r\n\r\nMIT License\r\n\r\n```\r\n© 2025 Deepak Kushwah\r\n\r\nPermission is hereby granted, free of charge, to any person obtaining a copy\r\nof this software and associated documentation files (the \"Software\"), to deal\r\nin the Software without restriction...\r\n```\r\n\r\n---\r\n\r\n## 👨‍💻 Author\r\n\r\n**Deepak Kushwah**\r\nFull Stack Developer (MERN + DevOps)\r\n\r\n* 📧 [deepak748930@gmail.com](mailto:deepak748930@gmail.com)\r\n* 🔗 [LinkedIn](https://linkedin.com/in/deepak-kushwah)\r\n* 💻 [GitHub](https://github.com/deepak748030)\r\n\r\n\u003e ⭐ Star this repo if you found it useful!\r\n\u003e 🔗 [https://github.com/deepak748030/savana](https://github.com/deepak748030/savana)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeepak748030%2Fsavana","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeepak748030%2Fsavana","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeepak748030%2Fsavana/lists"}