Skip to content

Commit 70a9fd7

Browse files
changed docs completely
1 parent 72422d1 commit 70a9fd7

34 files changed

Lines changed: 731 additions & 1967 deletions

File tree

‎.github/workflows/label-issues.yml‎

Lines changed: 10 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -34,14 +34,19 @@ jobs:
3434
with:
3535
node-version: "20"
3636

37-
- run: npm ci
38-
3937
- name: Setup Go
4038
uses: actions/setup-go@v5
4139
with:
42-
go-version: "1.21"
40+
go-version: "1.22"
41+
42+
- name: Install Node dependencies
43+
run: npm ci
44+
45+
- name: Install Hugo modules
46+
run: hugo mod get
4347

44-
- run: >-
48+
- name: Build site
49+
run: >-
4550
hugo --baseURL https://${REPO_OWNER}.github.io/${REPO_NAME}
4651
--minify
4752
@@ -50,4 +55,4 @@ jobs:
5055
if: ${{ github.ref == 'refs/heads/main' }}
5156
with:
5257
github_token: ${{ secrets.GITHUB_TOKEN }}
53-
publish_dir: docs/public
58+
publish_dir: docs/public

‎docs/.github/workflows/deploy-github-pages.yml‎

Lines changed: 0 additions & 56 deletions
This file was deleted.

‎docs/.gitignore‎

Lines changed: 0 additions & 21 deletions
This file was deleted.

‎docs/.hugo_build.lock‎

Whitespace-only changes.

‎docs/Gemfile‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
source "https://rubygems.org"
2+
3+
gem "jekyll-remote-theme"
4+
gem "just-the-docs"

‎docs/README.md‎

Lines changed: 0 additions & 69 deletions
This file was deleted.

‎docs/_config.yml‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
title: Tecovolt
2+
description: Un nodo inteligente que protege tu hogar antes de que llegue el apagón — Qualcomm Sustainable Power Cities · Talent Land 2025
3+
remote_theme: just-the-docs/just-the-docs@v0.10.1
4+
5+
url: "https://JocelynVelarde.github.io"
6+
baseurl: "/Talent-Land-Slop-as-a-Service"
7+
8+
color_scheme: dark
9+
10+
aux_links:
11+
"GitHub":
12+
- "https://github.com/JocelynVelarde/Talent-Land-Slop-as-a-Service"
13+
14+
aux_links_new_tab: true
15+
16+
heading_anchors: true
17+
18+
nav_enabled: true
19+
20+
back_to_top: true
21+
back_to_top_text: "Subir"
22+
23+
footer_content: '<b>Slop as a Service (SAAS)</b> — Tecovolt · Qualcomm Sustainable Power Cities · Talent Land 2025<br>Bini Vázquez · Diego Pérez Rossi · Jocelyn Velarde Barrón · Armando Mac Beath'
24+
25+
callouts:
26+
warning:
27+
title: Pendiente
28+
color: yellow
29+
info:
30+
title: Nota
31+
color: blue
32+
progress:
33+
title: En curso
34+
color: green

docs/content/en/docs/architecture/_index.md renamed to docs/architecture/index.md

Lines changed: 26 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,21 @@
11
---
2-
title: "Arquitectura Técnica"
3-
linkTitle: "Arquitectura"
4-
weight: 3
5-
description: >
6-
Diseño dual MCU + MPU, pipeline de datos, stack de software y flujo de operación del sistema Tecovolt.
2+
title: Arquitectura Técnica
3+
nav_order: 4
74
---
85

9-
## Visión general
6+
# Arquitectura Técnica
7+
{: .fs-8 }
108

11-
Tecovolt es técnicamente complejo por una razón central: **un sistema de protección eléctrica no puede depender de la nube ni tolerar latencias de red.** Cada decisión de diseño parte de ese principio. El dispositivo se instala junto al tablero eléctrico del hogar y opera de forma completamente autónoma, incluso cuando el internet cae junto con la luz.
9+
Diseño dual MCU + MPU, pipeline de datos, stack de software y flujo de operación.
10+
{: .fs-5 .fw-300 }
11+
12+
---
13+
14+
## Principio de diseño
15+
16+
Un sistema de protección eléctrica **no puede depender de la nube ni tolerar latencias de red.** Cada decisión de diseño parte de ese principio. El dispositivo se instala junto al tablero eléctrico del hogar y opera de forma completamente autónoma, incluso cuando el internet cae junto con la luz.
17+
18+
---
1219

1320
## Arquitectura dual MCU + MPU
1421

@@ -32,18 +39,23 @@ El microprocesador gestiona todo lo que requiere sistema operativo:
3239
- Dashboard **Flask** + alertas **Twilio WhatsApp**
3340
- OTA model updates vía **Foundries.io**
3441

42+
{: .note }
3543
> Esta separación garantiza que, pase lo que pase en la red, **la respuesta física nunca se bloquee.**
3644
45+
---
46+
3747
## Stack de software e IA
3848

3949
| Herramienta | Propósito |
40-
|-------------|-----------|
50+
|:------------|:----------|
4151
| **Edge Impulse Studio** | Entrenamiento de los 3 modelos. Custom DSP blocks (`tecovolt_block`, `tecotemp_block`) en Python vía Docker |
4252
| **Qualcomm AI Hub** | Cuantización INT8 y perfilado energético. Reducción de ~200 KB a ~50 KB por modelo |
4353
| **Arduino App Lab + Foundries.io** | Entorno oficial de desarrollo para Uno Q. OTA updates en campo |
4454
| **Flask + SQLite** | Dashboard web histórico en el MPU. Logger de eventos a 1 Hz |
4555
| **Twilio WhatsApp API** | Canal de alertas bidireccional. Notificaciones de riesgo + comandos de relay |
4656

57+
---
58+
4759
## Flujo de operación
4860

4961
```
@@ -57,8 +69,7 @@ El microprocesador gestiona todo lo que requiere sistema operativo:
5769
│ · Export C++/Py │ │ potencia │ │ · Entorno Uno Q │
5870
└─────────────────┘ │ · Validación en │ └──────────┬──────────┘
5971
│ Dragonwing │ │
60-
└──────────────────┘ │
61-
▼
72+
└──────────────────┘ ▼
6273
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────────┐
6374
│ 5. Notificación │ │ 4. Actualización │ │ Nodo desplegado │
6475
│ Twilio WhatsApp │◀───│ Foundries.io OTA │◀───│ │
@@ -70,14 +81,18 @@ El microprocesador gestiona todo lo que requiere sistema operativo:
7081
└──────────────────┘
7182
```
7283

84+
---
85+
7386
## Seguridad y robustez
7487

7588
| Especificación | Detalle |
76-
|---------------|---------|
89+
|:--------------|:--------|
7790
| **Grado IP55** | Caja sellada apta para instalación exterior junto al tablero eléctrico |
7891
| **127V aislados** | Zona de alto voltaje físicamente separada del procesador mediante transformadores y optoacopladores |
7992
| **Enclosure CAD** | Diseñado con todos los componentes posicionados, listo para impresión 3D |
8093

94+
---
95+
8196
## Comunicación serial MCU ↔ MPU
8297

8398
La comunicación entre procesadores ocurre vía **UART serial** con un protocolo JSON ligero. El MCU envía lecturas y predicciones al MPU, que las procesa para logging y alertas. Esta separación asegura que un crash en el MPU nunca afecte la capacidad del MCU de activar el relay.

‎docs/assets/scss/_styles_project.scss‎

Lines changed: 0 additions & 29 deletions
This file was deleted.

‎docs/assets/scss/_variables_project.scss‎

Lines changed: 0 additions & 10 deletions
This file was deleted.

0 commit comments

Comments
 (0)