# Odoo Metatroncube — Project Context

## Live Instance

| Field    | Value                                      |
|----------|--------------------------------------------|
| URL      | https://workplace.metatroncube.in/         |
| Database | `metatroncube_db`                          |
| User     | `info@metatroncubesolutions.com`           |
| Version  | Odoo 17.0 (Community)                      |

## MCP Connection

The `.mcp.json` in this folder connects Claude to the live Odoo instance via `odoo-mcp`.  
To connect at the start of a session run:

```
connect to metatroncube Odoo — url https://workplace.metatroncube.in/, db metatroncube_db, user info@metatroncubesolutions.com
```

Or use the `mcp__odoo-mcp__connect_database` tool with `instance_name: metatroncube`.

## Local Docker Environment

File: `docker-compose.yml`

- Odoo 17.0 container → port `10001` (http://localhost:10001)
- PostgreSQL 15
- Addons mounted at `./addons:/mnt/extra-addons`
- External volumes:
  - `odoo-testing-addons_metatroncube_pgdata`
  - `odoo-testing-addons_metatroncube_odoo_data`

Start locally:
```bash
docker compose up -d
```

## Custom Addons

All addons live in `./addons/`. Author: **Metatroncube Software Solutions**.

| Module                       | Version       | Purpose                                                  | Depends On            |
|------------------------------|---------------|----------------------------------------------------------|-----------------------|
| `accounting_community`       | 17.0.1.0.0    | Unlocks full accounting menus on Community Edition       | `account`             |
| `employee_documents`         | —             | Document management for employees                        | —                     |
| `mcs_appointment_booking`    | 17.0.1.0.0    | Website appointment booking with calendar integration    | `calendar`, `website` |
| `mcs_invoice_currency_display` | —           | Currency display on invoices                             | —                     |
| `mcs_payroll_localization`   | 17.0.1.0.0    | India & Canada payroll structures (OCA Payroll)          | `payroll_account`     |
| `payroll`                    | —             | OCA Payroll base module                                  | —                     |
| `payroll_account`            | —             | OCA Payroll + Accounting integration                     | `payroll`             |

## Key Custom Modules Detail

### `mcs_appointment_booking`
- Full module: models, views, controllers, security
- Website-facing booking forms + backend calendar views
- License: AGPL-3

### `mcs_payroll_localization`
- India and Canada payroll structures
- Has a `post_init_hook` in `hooks.py`
- License: LGPL-3

### `accounting_community`
- By Antigravity (third-party, included in repo)
- Adds Journal Entries, Items, General Ledger, Partner Ledger to Community
- License: LGPL-3

## Snapshots

Odoo MCP snapshots are stored in `./snapshots/` — used for rollback via `mcp__odoo-mcp__rollback_snapshot`.