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)

   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:

   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:

   # 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

   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.