Getting Started

This is a project for collecting personal data. For sensitive data, there is a password, and it is encrypted in storage and decrypted on the fly.The current password is alshoja. when u want to open in front end on form

This is a hobby project I created during my relocation to Berlin from India using Vue 3, Vuetify, and NestJS. The main use of this app will be aimed at POSTMAN in India, allowing them to store information about their area. It serves as a record-keeping tool for each person they interact with, functioning as an India Post record collector.

🔥 Key Features:

• 🔍 Smart Search – Find contacts easily using names, emails, or phone numbers.
• 📌 Location-Aware – Store and retrieve address data with geo-tagging.
• 📊 Data Export/Import – Easily transfer records in multiple formats (CSV, JSON, Excel). [PR WELCOMED]
• 🔐 Secure & Scalable – Role-based access and cloud-ready. [PR WELCOMED]

Prerequisites

Make sure you have the following installed:

• Docker
• Docker Compose

1. Clone the Repository

git clone https://github.com/your-username/posta-cloud.git
cd posta-cloud

2. Start the Application

Run the following command to start all services for windows use git bash as terminal to run this:

./setup.sh
 

This will:

• Start a PostgreSQL database container (posta_cloud_db)
• Start the backend service (posta-cloud-be)
• Start the frontend service (posta-cloud-fe)

3. Access the Application

• Frontend: http://localhost:3000

• Backend API: http://localhost:5000

• pgAdmin: http://localhost:8080

  Default pgAdmin credentials:

  • Email: admin@localhost
  • Password: admin123
  • if u asked for db password type ´posta_cloud123´

Services

PostgreSQL (posta_cloud_db)

• Uses the Bitnami PostgreSQL image.
• Stores persistent data in a Docker volume db-data.
• Initializes the database using scripts from ./database/ (if provided).

Frontend (posta-cloud-fe)

• Built with Vue 3 and Vuetify.
• Runs in development mode with npm run dev.

Backend (posta-cloud-be)

• A NestJS-based API service.
• Connects to the PostgreSQL database.
• Runs in development mode with npm run start:dev.

Stopping the Application

To stop and remove the containers, run:

docker compose down

Logs and Debugging

To view logs for a specific service, use:

docker compose logs -f <service_name>

Example:

docker compose logs -f backend

Technologies Used

• Vue 3
• Vuetify
• Pinia
• NestJS
• PostgreSQL
• Docker
• Docker Compose

Notes

• The database uses a volume (db-data) to persist data across restarts.
• Ensure that environment variables are correctly set in the .env file.

💡 Contribute Today

Help improve address management for field workers! If you're interested in contributing, feel free to fork this repo and submit your pull requests.