Canal Ăşnico de sincronizaciĂłn y trabajo en equipo entre Kev y todas las computadoras del proyecto (LAP-1, PC1, PC2, laptops, apps). LĂ©elo completo antes de empezar. No hace falta que Kev vuelva a explicar esto en cada chat — está todo aquĂ.
Asher es un restaurante de brunch en Tuxtla GutiĂ©rrez (Laureles), dueño Memo Cruz. Usa Soft Restaurant (POS genĂ©rico) que no calcula costo real de platillos ni rentabilidad — el negocio venĂa perdiendo dinero sin que nadie supiera exactamente por quĂ©.
Estamos construyendo ASHER RESTO: sistema propio de Kev que calcula costo (COGS), inventario y rentabilidad por platillo automáticamente, más un sitio web pĂşblico para clientes. Es el primer restaurante piloto — si funciona bien aquĂ, se replica a otros negocios de Kev.
⚠️ El dueño reporta que casi no hay archivos bien estructurados. Es normal encontrar datos incompletos, viejos o contradictorios — captúralos igual y anótalo, algo parcial es mejor que nada.
| Pieza | URL | Para quién / qué hace |
|---|---|---|
| Sitio pĂşblico | asher.mx | Clientes ven menĂş con fotos reales, arman pedido (va por WhatsApp), reservan mesa |
| App interna | resto.nomadazdigitalez.com | Solo Kev por ahora. Después: login para el dueño y empleados |
| Contexto (esta página) | asher-context.nomadazdigitalez.com | Todas las computadoras leen instrucciones y reportan hallazgos aquà |
1. Al activarte, revisa la sección "Órdenes activas" abajo — son instrucciones de Kev, ordenadas por fecha. Si hay algo dirigido a ti o a "todas", ejecútalo.
2. Escanea tu equipo (Soft Restaurant, Excels, PDFs, lo que sea) buscando: platillos, precios, ingredientes, recetas, proveedores, ventas histĂłricas.
3. No subas archivos ni se los des a Kev/JARVIS para que ellos lo suban. Analiza el contenido tú mismo y inserta los datos ya estructurados directo en la base de datos, en la tabla que corresponda (tabla de abajo). Esto evita pérdida de datos y depender de que alguien más lo traspase.
4. Después de insertar, registra un renglón en el "Log de hallazgos" contando en palabras normales qué encontraste y dónde lo guardaste — asà Kev y las demás computadoras lo ven sin tener que revisar la base de datos directamente.
Esta seccion es texto FIJO (no depende de JavaScript), para que cualquier chat que lea este archivo como texto plano la vea sin problema.
Si eres LAP-1: analiza todo el contenido relevante de esta laptop (documentos, Excels, PDFs, fotos de Asher Resto: menus, facturas, recetas, contabilidad, nomina, proveedores). PRIORIDAD: inserta los datos ya estructurados directo en las tablas de la base de datos via POST a https://asher-context.nomadazdigitalez.com/api/<tabla> (menu_items, ingredients, recipes, recipe_items, suppliers, segun corresponda). Solo sube a Google Drive (carpeta DOCUMENTOS ASHER MX, cuenta nomadazdigitalez [en] gmail punto com) lo que NO encaje en ninguna tabla (fotos sueltas, PDFs sin estructura clara).
Para escribir en la base de datos necesitas un codigo de seguridad en el header HTTP x-asher-code (pidelo a Kev o jarvis-resto si no lo tienes, no esta escrito aqui por seguridad).
Cuando termines cada sesion de trabajo, reporta que hiciste insertando un renglon en discovery_log (POST a /api/discovery_log con source_device, data_type, summary, raw_note) -- esto es tu forma de comunicarte con jarvis-resto (el chat que coordina esto desde el servidor) sin necesitar acceso directo a tu disco.
Cuenta: nomadazdigitalez [en] gmail punto com. Carpeta destino: "DOCUMENTOS ASHER MX", id 1DsGLZumBqV2_k-z4ykx_FePQlclNHXcI.
Si eres una sesion de Claude Code / agente de IA (no un humano con navegador): el metodo tecnico real es la API de Google Drive v3 (https://www.googleapis.com/drive/v3/files) usando OAuth2 con la cuenta indicada. Hay un gateway ya construido (jarvis-google-gateway) pero SOLO es accesible desde dentro de VPS2 (127.0.0.1:3190) -- si tu (LAP-1) corres en la laptop fisica del restaurante, NO vas a poder llegar a ese gateway directo por red. En ese caso: (a) pide a Kev que te comparta credenciales OAuth propias para subir tu directo a la API de Google, o (b) si puedes copiar los archivos a una carpeta donde SI llegue una sesion en VPS2, avisa por discovery_log y jarvis-resto puede subirlos por ti usando el gateway.
Si eres un humano usando el navegador de la laptop: el metodo simple es entrar a drive.google.com con la cuenta indicada arriba, abrir la carpeta "DOCUMENTOS ASHER MX", y arrastrar/soltar los archivos ahi directo (o usar el boton "Nuevo" > "Subir archivo"). Organiza en subcarpetas (Fotos, Facturas, Contabilidad, Menus) si subes muchos archivos de golpe.
Sea cual sea el metodo, cuando termines reporta cuantos archivos subiste y donde en discovery_log (ver seccion 3.5 arriba de como hacerlo).
PC1 / PC2 (cajas del restaurante, tienen Soft Restaurant)
Abre Soft Restaurant y revisa el historial de ventas (reportes de ventas por fecha, por platillo, corte de caja). Por cada platillo distinto que veas: si ya existe en menu_items no lo dupliques, si no existe crĂ©alo con su precio. Si el reporte te da cantidad vendida, anĂłtalo en el raw_note de un discovery_log (no hay tabla de "histĂłrico de ventas por Soft" todavĂa — repĂłrtalo en texto y Kev decide si vale la pena migrarlo). Al terminar cada sesiĂłn de escaneo, deja un renglĂłn en el log resumiendo quĂ© periodo de fechas revisaste, para que la siguiente activaciĂłn continĂşe desde ahĂ y no repita trabajo.
Además, identifica la arquitectura tĂ©cnica de Soft Restaurant (importante para integrarlo, NO reemplazarlo — es un piloto gratuito, no vamos a reconstruir el POS): revisa los Servicios de Windows (`services.msc`) en cada caja. Si ves un servicio tipo MSSQL$SOFTRESTAURANT usa SQL Server; si ves firebird/fbserver usa Firebird. Identifica tambiĂ©n cuál de las 2 PCs es la "servidora" (la que tiene la base de datos fĂsica — Soft Restaurant es servidor-cliente, ambas cajas comparten UNA sola base central). Reporta esto en discovery_log — con ese dato se decide si se pide acceso a la API oficial de National Soft o se conecta de solo lectura directo a la base.
LAP-1 (laptop de la ex-encargada/contadora) — TRABAJO CONTINUO, no una tarea de una sola vez
Esta es tu rutina PERMANENTE, cada vez que te actives — no algo que se hace una vez y se termina:
1. PRIORIDAD: analiza e INSERTA los datos directo en la base de datos (ver punto 2 de esta misma seccion). Google Drive es SOLO para lo que no encaje en ninguna tabla. Carpeta: "DOCUMENTOS ASHER MX" en la cuenta [email protected] (id de carpeta: 1DsGLZumBqV2_k-z4ykx_FePQlclNHXcI). Sube ahà Excels, Word, PDFs, capturas de pantalla de Soft Restaurant, fotos de facturas — todo, sin filtrar de más. Es más eficiente subir en bloque para que Kev/JARVIS lo analice todo junto desde la carpeta, que ir interpretando archivo por archivo. Si tienes acceso a la cuenta de Google directamente (login normal en drive.google.com), úsalo. Si no, pregunta a Kev cómo acceder.
2. Además, cuando puedas identificar datos con confianza, cárgalos también estructurados directo en la tabla que corresponda: platillos/precios (→ menu_items), ingredientes/insumos con costos (→ ingredients), proveedores o facturas (→ suppliers), o recetas/cantidades (→ recipes + recipe_items). El dueño avisó que probablemente no hay mucho bien estructurado — está bien, captura lo que sà haya aunque sea parcial.
3. Repite esto en cada activaciĂłn, indefinidamente. Esta laptop se mantiene conectada de forma permanente por dos razones: (a) seguir alimentando de datos histĂłricos al sistema mientras se van encontrando, y (b) servir de monitoreo/auditorĂa continua de quien use esta laptop en el futuro (la prĂłxima persona que la use tras la ex-contadora que llevĂł al negocio a nĂşmeros rojos) — reporta cualquier actividad que te parezca fuera de lo normal en discovery_log.
Si un archivo no encaja en ninguna tabla pero parece importante, descrĂbelo en discovery_log con el nombre del archivo en raw_note para que Kev lo revise manualmente.
Cualquier chat nuevo que no sepa qué es
PregĂşntale a Kev (o revisa la secciĂłn 6 de abajo) quĂ© computadora eres o quĂ© tarea te toca — no asumas ni inventes un rol. Una vez confirmado, sĂguelo consistentemente cada vez que te actives.
Objetivo: que al encender esta computadora e iniciar sesión en Windows, VS Code se abra solo y este chat retome el trabajo automáticamente — sin que nadie tenga que abrir VS Code, abrir el chat, ni escribir nada.
Cómo se logra (ya está resuelto, es simple): un script .bat + el Programador de Tareas de Windows (Task Scheduler), que ya vienen incluidos en Windows — no requiere instalar nada nuevo ni programar una app.
Instalador listo para descargar y ejecutar (una sola vez, con doble clic):
https://asher-context.nomadazdigitalez.com/descargas/ASHER-INSTALAR-AUTOARRANQUE.bat
El instalador pregunta qué computadora es (PC1, PC2 o LAP-1), crea una carpeta ASHER-RESTO en el usuario de Windows con instrucciones, y registra una tarea automática que arranca VS Code + este chat cada vez que se inicia sesión.
Si eres tĂş, chat de LAP-1, leyendo esto: dile a Kev o a quien tengas al lado fĂsicamente que descargue y ejecute ese archivo una sola vez en cada computadora (PC1, PC2, LAP-1). Requiere tener Node.js y Claude Code (npm install -g @anthropic-ai/claude-code) y VS Code ya instalados primero — si no están, instálalos antes de correr el .bat.
Base: https://asher-context.nomadazdigitalez.com/api/ — JSON simple. Métodos: GET leer, POST crear, PATCH actualizar.
| Si encuentras... | Va en la tabla |
|---|---|
| Platillo/producto del menĂş, con o sin precio | menu_items |
| CategorĂa de menĂş (Desayunos, Bebidas...) | menu_categories |
| Ingrediente/insumo, con o sin costo | ingredients |
| Receta: qué ingredientes lleva un platillo | recipes + recipe_items |
| Proveedor (factura, ticket, nombre de negocio) | suppliers |
| Precio de un ingrediente segĂşn proveedor | supplier_ingredients |
| Venta histĂłrica (de Soft Restaurant) | orders + order_items |
| Cualquier cosa que no calce arriba | discovery_log con detalle en raw_note, Kev lo revisa manual |
Kev escribe aquà directo (o se lo dicta a JARVIS y él lo publica). Ordenadas de la más nueva a la más vieja.
BD PostgreSQL asher en VPS1, 17 tablas, 6 vistas de reportes calculando rentabilidad automática.
Recetas: cargando…
Sitio asher.mx ya lee el menú de la base de datos real y guarda cada pedido/reserva como venta real (además de mandarlo por WhatsApp).
Cocina Panel en vivo de pedidos en mesa: resto.nomadazdigitalez.com/cocina — se actualiza solo cada 8 segundos, botón para marcar listo.
GestiĂłn Panel completo (menĂş, recetas, inventario, compras, proveedores, promociones, personal): resto.nomadazdigitalez.com
Meta final: que el sitio asher.mx se convierta en el punto de venta real del restaurante — clientes y meseros ordenan directamente ahà (incluso estando dentro del restaurante), con todo conectado a esta misma base de datos.
Sobre Soft Restaurant — decisiĂłn importante de Kev: NO se va a reconstruir Soft Restaurant desde cero (este es un proyecto piloto gratuito, no tiene sentido gastar esfuerzo duplicando un POS que ya funciona). El plan es integrarlo: leer sus datos (vĂa su API oficial de National Soft, o conexiĂłn de solo lectura a su base de datos si no se consigue la API) y usar este sistema (ASHER RESTO) como la capa de costos/rentabilidad/inventario que Soft Restaurant no tiene. Soft Restaurant se mantiene funcionando en las cajas mientras tanto.
Sobre cĂłmo te activas tĂş (esta computadora): ya está resuelto de forma simple (ver secciĂłn 5 arriba) — VS Code + Claude Code arrancan solos vĂa el Programador de Tareas de Windows, sin necesitar una app nueva instalada ni programaciĂłn compleja. No se va a construir una app tipo Electron para esto; la soluciĂłn simple con herramientas nativas de Windows ya es suficiente.