ÁREA RESTRINGIDA
Esta documentación NO se comparte con el equipo operativo. Contiene decisiones arquitecturales, scripts internos, credenciales setup, y roadmap técnico. Si un empleado pide acceso, redirigílo a manual.brandacare.com.
Esta documentación NO se comparte con el equipo operativo. Contiene decisiones arquitecturales, scripts internos, credenciales setup, y roadmap técnico. Si un empleado pide acceso, redirigílo a manual.brandacare.com.
Arquitectura y estrategia
| ID | Documento | ES | EN |
|---|---|---|---|
TRN-IT-001 | Arquitectura Híbrida — Google Apps Script (PHI) + Netlify (UX) · cómo separamos HIPAA | ES | EN |
Setup técnico
| ID | Procedimiento | ES | EN |
|---|---|---|---|
SOP-IT-001 | Manual Auth Gate Setup — Google OAuth para los dos manuales | ES | EN |
SOP-IT-002 | Cómo agregar un new hire — workflow completo (email, role, deploy) | ES | EN |
SOP-IT-003 | BrandaCare Metrics & Dashboards v3.0 — sistema multi-cliente: 3 tiers (billing+insurance / billing+ar / verifications), Solstice cortesía, modelo A+ verif-only, no-shows Unscheduled List, widget modular, deploy GitHub Actions + Cloudways | ES | EN |
SOP-IT-004 | Onboarding Técnico Cliente Nuevo — checklist 9 pasos (OD, Sheets, Stripe, Jotform, GScript, WhatsApp) | ES | EN |
SOP-IT-005 | Migración Insurance Plans OD — scripts Python (extract, push, import_proc_codes, hide, debug). Incluye código fuente embebido en sección 9 | ES | EN |
SOP-IT-006 | BCBOT — Verificación Elegibilidad (Dentrix) v2.0 — robot 100% autónomo con AutoHotkey (login + descarga + procesamiento + 2 emails a las 6pm). Roster + crosswalk de payers + convención "-BC" + checklist onboarding | ES | EN |
SOP-IT-007 | AutoVerify y Billing-Ins — Guía de Tiers — los 2 productos de verificación automática (Open Dental + Stedi): comparación, flujos, calendario, triggers Cloud Scheduler, kill switch B1, Office Registry | ES | EN |
Cómo se arma un doc nuevo
1 · En cualquier chat de Cowork
Trabajás un problema real y al final pedís:
Dame un resumen SOP en markdown para pasar al Manual BrandaCare. Estructura: título, propósito, tiempo, requisitos, pasos numerados, troubleshooting. Idioma: español.
2 · Pegás el resumen acá (chat del Manual)
Compartís el markdown crudo con Claude del proyecto Manual.
3 · Claude genera 2 HTMLs branded
ES + EN con icon system, sin emojis, mismo branding. Decide si va a manual público o tecnico según el contenido.
4 · Re-inyecta auth gate + index
python docs/inject_auth.py python docs/build_search_index.py
(o lo mismo en docs-tecnico/ si es del tecnico)
5 · Re-deploy a Netlify
Drag-drop la carpeta correspondiente. Live en 30 seg.
Scripts internos del manual
| Script | Función |
|---|---|
docs/inject_auth.py | Inyecta auth.js + manual.js en todos los HTMLs. Idempotente. |
docs/build_search_index.py | Genera search-index.json con todos los docs (titles + content + lang). |
docs/build_pdfs.py | Convierte HTMLs a PDFs en batch (requiere weasyprint). |
docs/parse_pdf_fee_schedule.py | Parsea PDFs de fee schedules de clientes a CSV. |
Brand kit
Logo + CSS + iconos (21 icons custom) + templates viven en brand/ de ambos sites.
Para arrancar el sistema en otro proyecto BrandaCare → leer
brand/BRAND-INSTRUCTIONS.md.
Bajar a PDF
- Una SOP: Chrome → Cmd+P → Save as PDF (activar Background graphics)
- Todas en batch:
pip install weasyprint && python docs/build_pdfs.py
Roadmap técnico
| Iniciativa | Status | Timing |
|---|---|---|
| Manual público estático + auth gate | ✓ Live | Junio 2026 |
| Manual técnico (este) + allowlist | ✓ Live | Junio 2026 |
| Embeber primer Apps Script form en el manual | Pendiente | Q3 2026 |
| Migrar primer form de Jotform a Apps Script | Pendiente | Q3 2026 |
| Migrar todos los forms PHI → cancelar Jotform | Pendiente | Q3-Q4 2026 |
| Migrar Python scripts (audit, AR audit) a Windows server | Pendiente | Q3 2026 |
| OPS Dashboard V1 (shell Netlify + widgets Apps Script) | Pendiente | Q4 2026 |
| Productivity Tracker en portal nuevo | Pendiente | Q4 2026 |
Allowlist actual
Estas son las únicas cuentas que pueden entrar acá. Para agregar/sacar gente, editar
docs-tecnico/brand/auth.js línea con ALLOWED_EMAILS.
| Persona | Rol | |
|---|---|---|
hello@brandacare.com | Yami B. | Founder & CEO |
pabloc@brandacare.com | Pablo C. | Director of Operations |
it@brandacare.com | Quasar | IT Lead (generic) |
vpn@brandacare.com | Robert Hazard | Quasar (personal) |
manuelgv@brandacare.com | Manuel VG | Developer |
ferrerpetitsantiago@brandacare.com | Santi FP | Developer |
Para agregar/sacar admins:
Editá
docs-tecnico/brand/auth.js en la línea de ALLOWED_EMAILS, re-deploy a Netlify.