# Tada to Odoo 19 Migration Portal

A lightweight, modern web application built with Python (Flask) that streamlines the process of migrating member/customer data from a PostgreSQL database (`tada_member`) directly into an Odoo 19 instance via XML-RPC.

## 🚀 Features

- **Direct Odoo Integration:** Seamlessly creates `res.partner` and `loyalty.card` records in Odoo 19.
- **Data Mapping Automation:** Automatically maps database fields (including custom fields like `gender`, `birth_date`, and `total_spend`) and dynamically links the appropriate `loyalty.program` based on the user's membership level.
- **High-Performance DataTables:** Uses Server-Side Processing for pagination, sorting, and debounced searching. This ensures the UI remains lightning-fast, even with hundreds of thousands of records.
- **Beautiful & Modern UI:** Features a clean, responsive "Glassmorphism" light theme optimized for both Desktop and Mobile environments.
- **Secure Sessions:** Employee logins are secured with an 8-hour session lifetime mechanism.
- **Interactive Prompts:** Integrated with SweetAlert2 to prevent accidental migrations and to provide clean success/error feedback.

## 🛠️ Tech Stack

- **Backend:** Python 3, Flask, Flask-Session
- **Database Connection:** `psycopg2-binary` (PostgreSQL)
- **Odoo Integration:** `xmlrpc.client` (Odoo XML-RPC API)
- **Frontend:** HTML5, CSS3, Vanilla JavaScript, jQuery, DataTables, SweetAlert2

## 📦 Installation & Setup

1. **Clone or Extract the Repository**
   Ensure you are in the project root directory.

2. **Create a Virtual Environment (Optional but Recommended)**
   ```bash
   python -m venv venv
   # On Windows:
   venv\Scripts\activate
   # On macOS/Linux:
   source venv/bin/activate
   ```

3. **Install Dependencies**
   Install the required Python packages using pip:
   ```bash
   pip install -r requirements.txt
   ```

4. **Configure Credentials**
   Open `app.py` in your text editor and locate the **Configurations** section at the top of the file. Update the placeholders with your actual PostgreSQL and Odoo 19 credentials:
   
   ```python
   # PostgreSQL
   DB_HOST = "localhost"
   DB_PORT = "5432"
   DB_NAME = "your_postgres_db"
   DB_USER = "your_postgres_user"
   DB_PASS = "your_postgres_password"

   # Odoo 19
   ODOO_URL = "localhost"
   ODOO_DB = "odoo19"
   ODOO_USER = "admin"
   ODOO_PASS = "admin"
   ```

5. **Run the Application**
   ```bash
   python app.py
   ```
   The application will start a local development server. Open your web browser and navigate to: `http://localhost:5000`

## 🔄 Data Mapping Reference

When a migration is triggered, the following mapping occurs:

### 1. `res.partner` (Customer Profile)
| PostgreSQL (`tada_member`) | Odoo 19 (`res.partner`) | Notes |
| :--- | :--- | :--- |
| `name` | `name` | |
| `phone_number` | `phone` | |
| `email` | `email` | |
| `gender` | `gender` | Capitalized automatically (e.g., `female` -> `Female`) |
| `birthday` | `birth_date` | Converted to string format |
| `city` | `city` | |
| `total_spending` | `total_spend` | Converted to Float |
| `level` | `membership_level_id` | Linked via `loyalty.program` search (Many2one) |

### 2. `loyalty.card` (Membership Card)
| PostgreSQL (`tada_member`) | Odoo 19 (`loyalty.card`) | Notes |
| :--- | :--- | :--- |
| `point_amount` | `points` | Converted to Float |
| (Generated) | `partner_id` | Linked to the newly created `res.partner` ID |
| (Generated) | `program_id` | Linked to the matched `loyalty.program` ID |

## 🛡️ Important Notes
- **Data Validation:** The script automatically handles `NULL`/`None` values from PostgreSQL, safely converting them to `False` to prevent XML-RPC marshal errors when writing to Odoo.
- **Debounce Optimization:** The search bar waits 400ms after you stop typing and requires a minimum of 3 characters before querying the database, drastically reducing server load.