BillNova

Repositorio oficial: https://github.com/WilkinsFiguereo/BillNova

Descripcion

BillNova es un sistema ERP con:

• frontend web en Next.js
• app mobile en Expo / React Native
• backend en Odoo 19
• base de datos en PostgreSQL 15

El backend Odoo de este proyecto esta configurado para trabajar solamente con la base de datos wilkins.

Estructura del proyecto

ProyectRijo/
|-- FrontendReactWeb/
|   `-- mi-app/
|-- FrontendReactApp/
|   `-- App-Mobile/
|-- odooBackend/
|   |-- addons/
|   |   `-- Proyect/
|   |-- config/
|   |   `-- odoo.conf
|   `-- docker-compose.yml
`-- README.md

Requisitos

• Node.js 20+
• npm 10+
• Docker
• Docker Compose
• Git

Configuracion importante del backend

La configuracion actual de Odoo ya fija la base de datos del proyecto:

• odooBackend/config/odoo.conf

Valores clave:

db_name = wilkins
dbfilter = ^wilkins$
db_user = odoo
db_password = odoo

Eso significa:

• Odoo trabajara con la base wilkins
• el proyecto no debe quedarse usando otra base como billnova
• si en algun momento creaste otra base para pruebas, la base final a usar en este proyecto debe ser wilkins

Paso a paso para levantar el proyecto

1. Clonar el repositorio

git clone https://github.com/WilkinsFiguereo/BillNova.git
cd BillNova

Si ya tienes este proyecto abierto localmente, puedes continuar directamente.

2. Instalar dependencias del frontend web

cd FrontendReactWeb/mi-app
npm install

3. Instalar dependencias del frontend mobile

cd FrontendReactApp/App-Mobile
npm install

4. Correr Docker Compose para Odoo y PostgreSQL

Archivo usado:

• odooBackend/docker-compose.yml

Desde la carpeta odooBackend ejecuta:

docker compose up -d

Si tu Docker aun usa el comando anterior, tambien funciona:

docker-compose up -d

Credenciales de PostgreSQL dentro de Docker:

• POSTGRES_DB=postgres
• POSTGRES_USER=odoo
• POSTGRES_PASSWORD=odoo

Contenedores esperados:

• odoo-db
• odoo-web

URL local de Odoo:

• http://localhost:8079

5. Crear la base de datos en Odoo

Si es la primera vez que levantas el proyecto:

1. abre http://localhost:8079
2. entra a la pantalla de creacion de base de datos
3. crea la base con el nombre billnova si necesitas completar la instalacion inicial de Odoo
4. despues ajusta el entorno para que el proyecto quede usando solo la base wilkins

Importante:

• la configuracion del proyecto en odooBackend/config/odoo.conf deja fijo db_name = wilkins
• por lo tanto, para el uso normal del proyecto la base que debe existir y quedar operativa es wilkins
• si todavia no existe wilkins, creala y usala como base definitiva del proyecto

En resumen: para este proyecto deja Odoo trabajando solamente con la base wilkins.

6. Instalar el modulo custom en Odoo

Modulo:

• odooBackend/addons/Proyect

Manifest:

• odooBackend/addons/Proyect/manifest.py

Paso a paso:

1. entra a Odoo con la base wilkins
2. activa el modo desarrollador
3. ve a Apps
4. pulsa Update Apps List
5. busca el modulo BillNova o Proyect
6. instala el modulo

Si el modulo ya estaba instalado y cambiaste codigo:

1. reinicia Odoo:

docker restart odoo-web

2. vuelve a Odoo
3. actualiza la lista de apps si hace falta
4. actualiza el modulo BillNova / Proyect

7. Configurar el correo en Odoo

El proyecto envia correos de:

• verificacion de cuenta
• recuperacion de contrasena
• invitaciones a empleados

Eso se usa desde el modelo:

• odooBackend/addons/Proyect/models/users.py

7.1. Preparar una cuenta de Google para enviar correos

Si vas a usar Gmail para enviar correos desde Odoo, primero debes preparar tu cuenta de Google.

Paso a paso:

1. entra a tu cuenta de Google
2. ve a Administrar tu cuenta de Google
3. entra a Seguridad
4. activa la verificacion en dos pasos
5. busca la opcion Contrasenas de aplicaciones
6. crea una nueva contrasena de aplicacion para Odoo
7. guarda esa contrasena porque la vas a usar en Odoo

Importante:

• no uses tu contrasena normal de Gmail
• para Odoo debes usar una contrasena de aplicacion
• ese correo sera el que enviara verificacion de cuenta, recuperacion de contrasena e invitaciones

7.2. Configurar servidor saliente SMTP

En Odoo:

1. entra con un usuario administrador
2. ve a Settings
3. activa modo desarrollador si aun no esta activo
4. entra a Technical -> Email -> Outgoing Mail Servers
5. crea o edita un servidor SMTP

Campos recomendados:

• Description: nombre libre, por ejemplo SMTP BillNova
• SMTP Server: smtp.gmail.com si usas Gmail
• SMTP Port: 587 para TLS/STARTTLS o 465 para SSL/TLS
• Connection Security: TLS/STARTTLS o SSL/TLS
• Username: tu correo de Google completo
• Password: la contrasena de aplicacion que generaste en tu cuenta de Google
• From Filtering: opcional

Luego:

1. guarda
2. pulsa Test Connection
3. confirma que el test responda correctamente

7.3. Configurar correo remitente por defecto

En Odoo entra a:

• Settings -> Technical -> Parameters -> System Parameters

Crea o revisa este parametro:

mail.default.from=tu-correo@tudominio.com

El modulo usa ese valor como remitente. Si no existe, intenta usar el correo de la compania en Odoo y, como ultimo fallback, usa no-reply@billnova.local.

7.4. Probar verificacion y recuperacion

Endpoints relacionados:

• POST /api/auth/forgot-password
• POST /api/auth/verify-email
• POST /api/auth/resend-code
• POST /api/auth/reset-password

Controlador:

• odooBackend/addons/Proyect/controllers/auth_controller.py

8. Configurar auth en Odoo

El proyecto maneja dos tipos de autenticacion:

• login normal con correo y contrasena
• Google OAuth

Controlador principal:

• odooBackend/addons/Proyect/controllers/auth_controller.py

8.1. Auth normal

No requiere una configuracion externa especial aparte de:

• tener la base wilkins
• tener el modulo BillNova / Proyect instalado
• tener usuarios creados en billnova.user y res.users
• tener el correo configurado si quieres verificacion y reset de contrasena

Endpoints principales:

• POST /api/auth/login
• POST /api/auth/register
• GET /api/auth/session
• POST /api/auth/logout

8.2. Configurar Google OAuth

El modulo depende de auth_oauth, segun el manifest del modulo.

Antes de configurar los parametros en Odoo, tienes que instalar el modulo necesario y crear las credenciales en Google Cloud.

8.2.1. Instalar el modulo necesario

Paso a paso:

1. entra a Odoo con la base wilkins
2. activa el modo desarrollador
3. ve a Apps
4. pulsa Update Apps List
5. busca e instala el modulo OAuth Authentication o auth_oauth si no esta instalado
6. busca e instala o actualiza el modulo BillNova / Proyect

8.2.2. Crear credenciales en Google Cloud

Tienes que sacar las credenciales desde Google Cloud Console.

Paso a paso:

1. entra a Google Cloud Console
2. crea un proyecto nuevo o selecciona uno existente
3. entra a APIs & Services
4. configura la pantalla de consentimiento OAuth
5. completa los datos basicos de la aplicacion
6. agrega usuarios de prueba si Google te lo pide
7. entra a Credentials
8. pulsa Create Credentials
9. selecciona OAuth client ID
10. elige el tipo de aplicacion correspondiente
11. registra la URL de callback autorizada
12. crea la credencial

Debes copiar estos datos:

• Client ID
• Client Secret

Para este proyecto local, la URL de callback que debes registrar en Google Cloud es:

http://localhost:8079/api/auth/google/mobile/callback

Si usas otro dominio o servidor, registra esa URL real.

8.2.3. Configurar los parametros obligatorios en Odoo

Despues, en Odoo:

1. entra a Settings -> Technical -> Parameters -> System Parameters
2. crea o revisa estos parametros obligatorios:

web.base.url=http://localhost:8079
billnova.google_oauth_client_id=TU_CLIENT_ID
billnova.google_oauth_client_secret=TU_CLIENT_SECRET
billnova.google_oauth_token_endpoint=https://oauth2.googleapis.com/token
billnova.google_oauth_userinfo_endpoint=https://openidconnect.googleapis.com/v1/userinfo

En este proyecto esos parametros no son opcionales si vas a usar Google OAuth.

Ademas, revisa que el proveedor OAuth de Google exista en Odoo si lo vas a manejar por interfaz:

1. Settings -> Technical -> Authentication -> OAuth Providers
2. crea o valida un proveedor de Google
3. verifica que tenga client_id, client_secret y endpoint de autorizacion

Las credenciales que pongas en Odoo tienen que salir de Google Cloud Console.

8.2.4. Callback usado por el backend

El callback que construye el proyecto es:

http://localhost:8079/api/auth/google/mobile/callback

Si publicas Odoo en otra URL, cambia web.base.url para que el callback generado sea correcto.

8.2.5. Endpoints Google OAuth

• GET /api/auth/google/mobile/authorize-url
• GET /api/auth/google/mobile/callback

9. Configurar frontend web

Archivo recomendado:

• FrontendReactWeb/mi-app/.env.local

Contenido:

NEXT_PUBLIC_ODOO_URL=http://localhost:8079

Luego ejecuta:

cd FrontendReactWeb/mi-app
npm run dev

Abre:

http://localhost:3000

10. Configurar frontend mobile

Archivo recomendado:

• FrontendReactApp/App-Mobile/.env

Contenido:

EXPO_PUBLIC_ODOO_URL=http://localhost:8079

Luego ejecuta:

cd FrontendReactApp/App-Mobile
npx expo start

Si pruebas desde un telefono fisico, no uses localhost; usa una IP local accesible o un tunel.

Resumen rapido del flujo correcto

1. instalar dependencias web y mobile
2. correr docker compose up -d en odooBackend
3. entrar a Odoo en http://localhost:8079
4. dejar operativa la base wilkins
5. instalar el modulo BillNova / Proyect
6. configurar SMTP en Odoo
7. configurar mail.default.from
8. configurar web.base.url
9. configurar Google OAuth si se usara login con Google
10. correr frontend web y/o mobile

Archivos clave

• README.md
• odooBackend/docker-compose.yml
• odooBackend/config/odoo.conf
• odooBackend/addons/Proyect/manifest.py
• odooBackend/addons/Proyect/controllers/auth_controller.py
• odooBackend/addons/Proyect/models/users.py

Nota final sobre la base de datos

Aunque durante una instalacion inicial puedas llegar a crear una base billnova, la configuracion final del proyecto debe quedar usando solamente la base de Odoo wilkins.