https://github.com/t2ne/piggytrack
Mini Projeto de Tracking de Finanças usando Python, Flask, Next.js e Docker. DBeaver para DB GUI, Google Cloud Run implementada no futuro.
https://github.com/t2ne/piggytrack
cloudrun docker flask nextjs python react
Last synced: 11 months ago
JSON representation
Mini Projeto de Tracking de Finanças usando Python, Flask, Next.js e Docker. DBeaver para DB GUI, Google Cloud Run implementada no futuro.
- Host: GitHub
- URL: https://github.com/t2ne/piggytrack
- Owner: t2ne
- Created: 2025-07-29T14:42:14.000Z (11 months ago)
- Default Branch: master
- Last Pushed: 2025-08-07T15:20:08.000Z (11 months ago)
- Last Synced: 2025-08-07T17:32:11.710Z (11 months ago)
- Topics: cloudrun, docker, flask, nextjs, python, react
- Language: TypeScript
- Homepage:
- Size: 111 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# PiggyTrack 🐷📊
A simple expense management app with:
- 🖥️ **Frontend**: Next.js
- 🐍 **Backend**: Flask
- 🛢️ **Database**: MariaDB
---
## 🚀 How to Use
### Requirements
- Docker
- Docker Compose
---
### 🔧 Setup Instructions
1. Clone the repository:
```bash
git clone https://github.com/t2ne/piggytrack.git
```
2. Navigate to the project folder:
```bash
cd piggytrack
```
3. Build and start the containers:
```bash
docker-compose up --build
```
---
### 🌐 Access
- **Frontend**: [http://localhost:3000](http://localhost:3000)
- **Backend API**: [http://localhost:8000](http://localhost:8000)
- **MariaDB**: Running on port `3306`
- Credentials are defined in the `.env` file or directly in the `docker-compose.yml`
---
### 📝 Notes
- The database container runs an init script (`init.sql`) to pre-fill the database.
- The backend exposes a test route at `/stats` that returns dummy data.
- The frontend connects to the backend and displays the received data.
---
## 🙋♂️ Author
[@t2ne](https://github.com/t2ne)