https://github.com/srijitpatra99/invoice-management-app
**Invoice-App** is a Node.js and Express API for creating, storing, and managing invoices with automated email alerts for due dates and status updates. Data is securely stored in MongoDB. 🚀
https://github.com/srijitpatra99/invoice-management-app
expressjs mongodb node-cron nodejs
Last synced: 3 months ago
JSON representation
**Invoice-App** is a Node.js and Express API for creating, storing, and managing invoices with automated email alerts for due dates and status updates. Data is securely stored in MongoDB. 🚀
- Host: GitHub
- URL: https://github.com/srijitpatra99/invoice-management-app
- Owner: srijitpatra99
- Created: 2022-02-19T15:51:29.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2025-02-23T08:30:32.000Z (4 months ago)
- Last Synced: 2025-02-23T09:23:52.834Z (4 months ago)
- Topics: expressjs, mongodb, node-cron, nodejs
- Language: JavaScript
- Homepage:
- Size: 30.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🧾 Invoice-App
An API that allows users to **create, store, and manage invoices** efficiently. It supports email notifications upon invoice creation and alerts users a day before the due date. Users can also **update invoice statuses (Paid/Late), triggering automatic email notifications** about the status change.
📄 **[API Documentation](https://documenter.getpostman.com/view/19569751/UVkgxJsK) (Postman)**
---
## 🚀 Features
✅ Create multiple invoices with required details
✅ Store invoices in MongoDB database
✅ Email notification upon successful invoice creation
✅ Automatic reminder email **one day before** the due date
✅ Update invoice status (Paid/Late) with email confirmation
✅ Secure authentication using **Google API Credentials**
---
## 🛠️ Setup & Installation
### 1️⃣ Clone the Repository
```sh
git clone https://github.com/your-username/Invoice-App.git
cd Invoice-App
```
### 2️⃣ Install Dependencies
```sh
npm install
```
### 3️⃣ Set Up Environment Variables
Create a `.env` file in the root directory and add the following:
```
MONGO_URI=your_mongodb_connection_url
GOOGLE_API_CREDENTIALS=your_google_api_credentials
```
### 4️⃣ Start the Server
```sh
npm start
```
### 5️⃣ Test the API with Postman
- Open **Postman**
- Use the endpoints as documented in the **[API Documentation](https://documenter.getpostman.com/view/19569751/UVkgxJsK)**
- Upload invoices with the required fields
- Verify that invoices are stored in MongoDB
### 6️⃣ Stop the Server
Press `CTRL + C` in the terminal
---
## 📌 Tech Stack
- **Backend:** Node.js, Express.js
- **Database:** MongoDB
- **Authentication:** Google API Credentials
- **Email Notifications:** Nodemailer
---
### 📬 Contributions & Issues
Feel free to **fork** the repo and submit a **pull request**! For any issues, open a ticket in the **Issues** section.
🔹 **Happy Coding!** 🚀