Full Build - React + Flask API - do not merge

.gitignore

@@ -1 +1,4 @@
-# Replace the .gitignore with the appropriate one from https://github.com/github/gitignore
+.vscode
+# Bruno adds a dir to your vscode workspace
+Planventure
+venv/

README.md

@@ -1,13 +1,62 @@
-# Walkthrough Template
+# Planventure API 🚁
 
-This repository serves as a template for creating a walkthrough. Follow the steps below to get started.
+[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/github-samples/planventure)
 
-## Getting Started
+A Flask-based REST API backend for the Planventure application.
 
-1. Clone this repository.
-2. Update the documentation in the `docs` folder (including the `README.md` folder).
-3. Customize the code and other content as needed.
-4. Update the `SUPPORT.md` file with the appropriate information.
-5. Review the default LICENSE (MIT), CODE_OF_CONDUCT, and CONTRIBUTING files to ensure they meet your needs. These use the samples provided as part of the OSPO release process.
-6. Update the `README.md` file in the repository root with the appropriate information. You can find an example at [github-samples/game-of-life-walkthrough](https://github.com/github-samples/game-of-life-walkthrough).
-7. When you are ready to publish the repository, please make sure that the Git history is clean. Then, raise an issue for a 'sample release' at [https://github.com/github/open-source-releases](https://github.com/github/open-source-releases).
+## Prerequisites
+Before you begin, ensure you have the following:
+
+- A GitHub account
+- Access to GitHub Copilot - [sign up for FREE](https://gh.io/gfb-copilot)!
+- A Code Editor
+- API Client (like [Bruno](https://github.com/usebruno/bruno))
+- Git - [Download & Install Git](https://git-scm.com/downloads)
+
+## 🚀 Getting Started
+
+## Build along in a Codespace
+
+1. Click the "Open in GitHub Codespaces" button above to start developing in a GitHub Codespace.
+
+### Local Development Setup
+
+If you prefer to develop locally, follow the steps below:
+
+1. Clone the repository and navigate to the [planventue-api](/planventure-api/) directory:
+```sh
+cd planventure-api
+```
+
+2. Create a virtual environment and activate it:
+```sh
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+```
+
+3. Install the required dependencies:
+```sh
+pip install -r requirements.txt
+```
+
+4. Create an `.env` file based on [.sample.env](/planventure-api/.sample.env):
+```sh
+cp .sample.env .env
+```
+
+5. Start the Flask development server:
+```sh
+flask run
+```
+
+## Docker Setup
+
+If bulding locally, follow the Docker setup steps in the [DockerSetup](DockerSetup) file.
+
+## 📚 API Endpoints
+- GET / - Welcome message
+- GET /health - Health check endpoint
+
+## 📝 License
+
+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": "user@example.com",
+    "password": "secure_password"
+  }
+  ```
+
+- `POST /auth/login` - Login and get JWT token
+  ```json
+  \{
+  "email": "user@example.com",
+  "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})>'