91 lines
3.8 KiB
Markdown
91 lines
3.8 KiB
Markdown
# 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.
|