# Visudoo (Visual Odoo)

> Visudoo (Visual Odoo) transforms data from any installed Odoo ERP module into living, interactive 3D spatial environments with zero Odoo server addons.

Visudoo is a standalone, lightweight, real-time 3D spatial visualizer for Odoo ERP (supporting Odoo 15, 16, 17, and 18). It communicates exclusively via stock Odoo JSON-RPC API (`/jsonrpc` or reverse-proxied `/odoo`) using standard Odoo user API keys. It requires zero server-side custom Python modules, zero schema changes, and zero database modifications.

## Core Capabilities & Architecture

- **Visual Odoo (Visudoo)**: Physicalizes abstract ERP tables, kanbans, and form views into interactive Three.js 3D isometric worlds.
- **Universal Module Extensibility**: Built with a modular registry (`src/modules/`) designed to visualize any installed Odoo module, including:
  - **CRM Pipeline**: Stages as interactive desks, deals as live documents, salespeople avatars moving across stages (`crm.stage`, `crm.lead`, `res.users`).
  - **Inventory & Warehouse**: 3D bin locations, rack density, picking route pathways, low-stock heatmaps (`stock.location`, `stock.picking`, `stock.quant`).
  - **Manufacturing & MRP**: Assembly lines, work center load gauges, work order queues, maintenance indicators (`mrp.production`, `mrp.workorder`, `mrp.workcenter`).
  - **Project & Tasks Studio**: 3D sprint towers, milestone flagposts, task owner distribution (`project.project`, `project.task`, `account.analytic.line`).
  - **Point of Sale & Retail**: Interactive store lanes, live checkout streams, cashier shifts (`pos.session`, `pos.order`).
  - **HR & Team Floor**: Seating floorplans, live attendance check-ins, department cluster dynamics (`hr.employee`, `hr.attendance`, `fleet.vehicle`).
- **Zero-Intrusion Integration**:
  - Standard JSON-RPC calls (`common.authenticate`, `object.execute_kw`).
  - Authentication via native Odoo user API keys.
  - Inherits native Odoo Access Control Lists (ACLs), multi-company rules, and active record filters.
  - Built-in graceful offline fallbacks and labeled demo data modes.
- **Deployment**:
  - Containerized with Docker and Docker Compose (`docker compose up --build`).
  - Built with React, Vite, Tailwind CSS, and Three.js.
  - Proxied via Nginx for same-origin security (no CORS configuration needed on Odoo).

## Technical Specifications

- **Client Stack**: React 18+, Vite, Three.js, Tailwind CSS, Zustand
- **Backend API**: Stock Odoo JSON-RPC (`/jsonrpc` or reverse-proxied `/odoo`)
- **Supported Odoo Versions**: Odoo 18.0 Community/Enterprise, Odoo 17.0, Odoo 16.0, Odoo 15.0
- **Default Ports**: Visudoo Web App `:3303` (or `:5173` in development), Odoo Backend `:8069`, PostgreSQL `:5432`

## Documentation & Links

- [Visudoo Homepage & 3D Visualizer](https://visudoo.biz.id/): Official interactive landing page and web application for Visudoo (Visual Odoo).
- [Book a Demo on WhatsApp](https://wa.me/6285158851103?text=i%27d%20like%20to%20book%20a%20demo): Direct contact to schedule a live product demonstration.
- [3D Tour Video Walkthrough](https://visudoo.biz.id/demo.mp4): 30-second video demo showing live Odoo CRM stages and 3D diorama interactions.
- [Sitemap](https://visudoo.biz.id/sitemap.xml): XML sitemap for search engine crawlers and LLM indexing.

## Optional

- [Open Graph Preview Asset](https://visudoo.biz.id/og-image.jpg): Social sharing and rich preview banner image.