Full Build - React + Flask API - do not merge

README.md

@@ -1,28 +1,124 @@
-# Build with Me + GitHub Copilot 🚀
+# Planventure API Server 🚀
 
-You can build along with me in this [Youtube video]() or read this [blog post]().
+A Flask backend API that powers the Planventure travel planning application. This guide will help you quickly get the server running so you can focus on building the client application.
 
-![Build with Me + GitHub Copilot on Youtube](link-to-image)
-![Build with Me + GitHub Copilot on the Blog](link-to-image)
+## Quick Start
 
-# Planventure API 🚁
-A Flask-based REST API backend for the Planventure application.
+1. Fork and clone the repository:
+```sh
+git clone https://github.com/yourusername/planventure.git
+cd planventure/planventure-api
+```
+
+2. Set up Python environment and install dependencies:
+```sh
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+pip install -r requirements.txt
+```
+
+3. Start the development server:
+```sh
+flask run
+```
+
+The API server will be running at `http://localhost:5000`
+
+That's it! You can now proceed to set up and work on the client application.
+
+## API Health Check
+
+Verify the server is running:
+```sh
+curl http://localhost:5000/health
+```
+
+Expected response: `{"status": "healthy"}`
+
+# Planventure Client ✈️
+
+[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/github-samples/planventure)
+
+A React-based travel planning application that helps you organize your trips, manage itineraries, and keep track of travel details.
+
+## Features
+
+- 🗺️ Trip Planning & Management
+- 📅 Interactive Itinerary Builder
+- 🏨 Accommodation Tracking
+- 🚗 Transportation Management
+- 📱 Responsive Design
+- 🔐 Secure Authentication
 
 ## Prerequisites
-Before you begin, ensure you have the following:
 
-- A GitHub account - [sign up for FREE](https://github.com)
+Before you begin, ensure you have the following:
+- Node.js (v16 or higher)
+- npm or yarn
+- A GitHub account
 - Access to GitHub Copilot - [sign up for FREE](https://gh.io/gfb-copilot)!
-- A Code Editor - [VS Code](https://code.visualstudio.com/download) is recommended
-- API Client (like [Bruno](https://github.com/usebruno/bruno))
 - Git - [Download & Install Git](https://git-scm.com/downloads)
 
 ## 🚀 Getting Started
 
-1. Fork this repository to your GitHub account.
-2. Switch to the `api-start` branch.
-3. Clone the repository to your local machine.
+### Quick Start with Codespaces
+
+1. Click the "Open in GitHub Codespaces" button above
+2. Wait for the environment to build
+3. Run `npm install` and `npm run dev`
+
+### Local Development Setup
+
+1. Open a new terminal window and cd into the `planventure-client` directory:
+```sh
+cd planventure/planventure-client
+```
+
+2. Install dependencies:
+```sh
+npm install
+```
+
+3. Create a `.env` file:
+```sh
+VITE_API_URL=http://localhost:5000
+```
+
+4. Start the development server:
+```sh
+npm run dev
+```
+
+Visit `http://localhost:5173` to see the application.
+
+## 🏗️ Tech Stack
+
+- React
+- Material-UI
+- React Router
+- Day.js
+- Vite
+
+## 📱 Features Overview
+
+### Trip Management
+- Create and manage trips
+- Set destinations and dates
+- Track accommodations and transportation
+
+### Itinerary Planning
+- Day-by-day planning
+- Activity scheduling
+- Time management
+
+## 🤝 Contributing
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
 
-You can find next steps in the README on the `api-start` branch.
+## 📝 License
 
-Happy Coding!  🎉
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

planventure-api/.env.example

@@ -0,0 +1,8 @@
+# CORS Settings
+CORS_ORIGINS=http://localhost:3000,http://localhost:5173
+
+# JWT Settings
+JWT_SECRET_KEY=your-secret-key-here
+
+# Database Settings
+DATABASE_URL=sqlite:///planventure.db

planventure-api/.gitignore

@@ -0,0 +1,4 @@
+venv/
+.env
+__pycache__/
+*.pyc

planventure-api/README.md

@@ -0,0 +1,62 @@
+# Planventure API 🌍✈️
+
+A Flask-based REST API for managing travel itineraries and trip planning.
+
+## Features
+
+- 🔐 User Authentication (JWT-based)
+- 🗺️ Trip Management
+- 📅 Itinerary Planning
+- 🔒 Secure Password Hashing
+- ⚡ CORS Support
+
+## Tech Stack
+
+- Python 3.x
+- Flask
+- SQLAlchemy
+- Flask-JWT-Extended
+- SQLite Database
+- BCrypt for password hashing
+
+## API Endpoints
+
+### Authentication
+
+- `POST /auth/register` - Register a new user
+  ```json
+  {
+    "email": "[email protected]",
+    "password": "secure_password"
+  }
+  ```
+
+- `POST /auth/login` - Login and get JWT token
+  ```json
+  \{
+  "email": "[email protected]",
+  "password": "secure_password"
+}
+  ```
+
+### Trips
+
+- `GET /trips` - Get all trips
+- `POST /trips` - Create a new trip
+  ```json
+  {
+    "destination": "Paris, France",
+    "start_date": "2024-06-15T00:00:00Z",
+    "end_date": "2024-06-22T00:00:00Z",
+    "latitude": 48.8566,
+    "longitude": 2.3522,
+    "itinerary": {}
+  }
+  ```
+- `GET /trips/<trip_id>` - Get a single trip
+- `PUT /trips/<trip_id>` - Update a trip
+- `DELETE /trips/<trip_id>` - Delete a trip
+
+
+
+

planventure-api/app.py

@@ -0,0 +1,80 @@
+from flask import Flask, jsonify
+from flask_cors import CORS
+from flask_sqlalchemy import SQLAlchemy
+from flask_jwt_extended import JWTManager
+from os import environ
+from dotenv import load_dotenv
+from datetime import timedelta
+from config import Config
+
+# Load environment variables
+load_dotenv()
+
+# Initialize SQLAlchemy
+db = SQLAlchemy()
+
+def create_app():
+    app = Flask(__name__)
+
+    # Configure CORS
+    CORS(app, 
+         resources={r"/*": {
+             "origins": Config.CORS_ORIGINS,
+             "methods": Config.CORS_METHODS,
+             "allow_headers": Config.CORS_HEADERS,
+             "supports_credentials": Config.CORS_SUPPORTS_CREDENTIALS
+         }})
+
+    # JWT Configuration
+    app.config['JWT_SECRET_KEY'] = environ.get('JWT_SECRET_KEY', 'your-secret-key')
+    app.config['JWT_ACCESS_TOKEN_EXPIRES'] = timedelta(hours=1)
+    jwt = JWTManager(app)
+
+    @jwt.expired_token_loader
+    def expired_token_callback(jwt_header, jwt_data):
+        return jsonify({
+            'error': 'Token has expired',
+            'code': 'token_expired'
+        }), 401
+
+    @jwt.invalid_token_loader
+    def invalid_token_callback(error):
+        return jsonify({
+            'error': 'Invalid token',
+            'code': 'invalid_token'
+        }), 401
+
+    @jwt.unauthorized_loader
+    def missing_token_callback(error):
+        return jsonify({
+            'error': 'Authorization token is missing',
+            'code': 'authorization_required'
+        }), 401
+
+    # Database configuration
+    app.config['SQLALCHEMY_DATABASE_URI'] = environ.get('DATABASE_URL', 'sqlite:///planventure.db')
+    app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False
+
+    # Initialize extensions
+    db.init_app(app)
+
+    # Register blueprints
+    from routes.auth import auth_bp
+    from routes.trips import trips_bp
+    app.register_blueprint(auth_bp, url_prefix='/auth')
+    app.register_blueprint(trips_bp, url_prefix='/api')
+
+    # Register routes
+    @app.route('/')
+    def home():
+        return jsonify({"message": "Welcome to PlanVenture API"})
+
+    @app.route('/health')
+    def health_check():
+        return jsonify({"status": "healthy"})
+
+    return app
+
+if __name__ == '__main__':
+    app = create_app()
+    app.run(debug=True)

planventure-api/config.py

@@ -0,0 +1,28 @@
+from os import environ
+from dotenv import load_dotenv
+
+load_dotenv()
+
+class Config:
+    # CORS Settings
+    CORS_ORIGINS = environ.get(
+        'CORS_ORIGINS',
+        'http://localhost:3000,http://localhost:5173'
+    ).split(',')
+
+    CORS_HEADERS = [
+        'Content-Type',
+        'Authorization',
+        'Access-Control-Allow-Credentials'
+    ]
+
+    CORS_METHODS = [
+        'GET',
+        'POST',
+        'PUT',
+        'DELETE',
+        'OPTIONS'
+    ]
+
+    # Cookie Settings
+    CORS_SUPPORTS_CREDENTIALS = True

planventure-api/init_db.py

@@ -0,0 +1,12 @@
+from app import create_app, db
+from models import User
+
+def init_db():
+    app = create_app()
+    with app.app_context():
+        # Create all database tables
+        db.create_all()
+        print("Database tables created successfully!")
+
+if __name__ == '__main__':
+    init_db()

planventure-api/middleware/auth.py

@@ -0,0 +1,21 @@
+from functools import wraps
+from flask import jsonify
+from flask_jwt_extended import verify_jwt_in_request, get_jwt_identity
+from models import User
+
+def auth_middleware(f):
+    @wraps(f)
+    def decorated(*args, **kwargs):
+        try:
+            verify_jwt_in_request()
+            current_user_id = get_jwt_identity()
+
+            # Check if user still exists in database
+            user = User.query.get(current_user_id)
+            if not user:
+                return jsonify({"error": "User not found"}), 401
+
+            return f(*args, **kwargs)
+        except Exception as e:
+            return jsonify({"error": "Invalid or expired token"}), 401
+    return decorated

planventure-api/models/__init__.py

@@ -0,0 +1,4 @@
+from .user import User
+from .trip import Trip
+
+__all__ = ['User', 'Trip']

planventure-api/models/trip.py

@@ -0,0 +1,22 @@
+from datetime import datetime, timezone
+from app import db
+
+class Trip(db.Model):
+    __tablename__ = 'trips'
+
+    id = db.Column(db.Integer, primary_key=True)
+    user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=False)
+    destination = db.Column(db.String(200), nullable=False)
+    start_date = db.Column(db.DateTime, nullable=False)
+    end_date = db.Column(db.DateTime, nullable=False)
+    latitude = db.Column(db.Float)
+    longitude = db.Column(db.Float)
+    itinerary = db.Column(db.JSON)
+    created_at = db.Column(db.DateTime, default=lambda: datetime.now(timezone.utc))
+    updated_at = db.Column(db.DateTime, default=lambda: datetime.now(timezone.utc), onupdate=lambda: datetime.now(timezone.utc))
+
+    # Relationship
+    user = db.relationship('User', back_populates='trips')
+
+    def __repr__(self):
+        return f'<Trip {self.destination} ({self.start_date} - {self.end_date})>'