A robust and scalable expense tracking microservice built with FastAPI and MongoDB, with nginx as a reverse proxy and integration with an external authentication service.
- 🔐 Secure authentication integration with external auth service
- 💾 MongoDB-based data persistence
- 🐳 Docker containerization for easy deployment
- 📊 Comprehensive testing (E2E, integration, and load testing with Locust)
- 🔄 Asynchronous operations
- 📝 Clean architecture and code organization
- 🔐 Reverse proxy with nginx for unified access and security
- 🔀 Microservices architecture with separate auth service
- Framework: FastAPI
- Database: MongoDB (for expense tracker), PostgreSQL (for auth service)
- ORM: Beanie (MongoDB ODM)
- Authentication: External Auth Service
- Containerization: Docker & Docker Compose
- Reverse Proxy: Nginx
- Testing: pytest, Locust (load testing)
- Package Management: uv
- Python 3.8+
- Docker and Docker Compose
- MongoDB
- Access to Auth Service (auth-service)
-
Clone the repository
git clone https://github.com/yourusername/expense-tracker.git cd expense-tracker -
Environment Setup
- Create a
.envfile for the expense tracker service configuration - Create a
.auth-service.envfile for the auth service configuration - Configure your MongoDB and PostgreSQL connection details
- Create a
-
Run with Docker
docker-compose up --build
-
Access Services
- Expense Tracker API: http://localhost/expense-tracker
- Auth Service API: http://localhost/auth-service
Once the service is running, access the interactive API documentation at:
- Expense Tracker API:
http://localhost/expense-tracker/docs - Auth Service API:
http://localhost/auth-service/docs
Both services are proxied through nginx on port 80:
- The expense tracker service is available at the
/expense-tracker/path - The authentication service is available at the
/auth-service/path
pytest# Web UI (http://localhost:8089)
locust -f app/tests/load/locustfile.py --host=http://localhost/expense-tracker
# Headless mode
locust -f app/tests/load/locustfile.py --headless -u 100 -r 10 --host=http://localhost/expense-trackerexpense-tracker/
├── app/
│ ├── api/ # API routes and endpoints
│ ├── core/ # Core configurations
│ ├── crud/ # Database operations
│ ├── models/ # Data models
│ ├── tests/ # Test suite
│ └── main.py # Application entry point
├── docker-compose.yml
├── Dockerfile
└── pyproject.toml
This service relies on an external authentication service. You can either:
- Use the provided auth-service
- Implement your own authentication system
Contributions are welcome! Please feel free to submit a Pull Request.
This project is licensed under the MIT License - see the LICENSE file for details.
Copyright (c) 2025 Seyed Ali Hashemi