@enerlence/suntropy-cli 0.11.8 → 0.11.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@enerlence/suntropy-cli",
3
- "version": "0.11.8",
3
+ "version": "0.11.9",
4
4
  "description": "Agent-first CLI for Suntropy solar platform",
5
5
  "type": "module",
6
6
  "bin": {
@@ -37,7 +37,7 @@ Campos disponibles: name, peakPower, efficiency, panelDegradation, technology, w
37
37
  ```bash
38
38
  suntropy inventory kits inverters create --data '{
39
39
  "name": "Inversor Kit 5kW",
40
- "nominalPower": 5000,
40
+ "nominalPower": 5,
41
41
  "efficiency": 98.4,
42
42
  "isMicroinverter": false,
43
43
  "costPerUnit": 800,
@@ -4,6 +4,25 @@ Crea elementos en el inventario de Suntropy usando la CLI. El inventario incluye
4
4
 
5
5
  Pregunta al usuario qué tipo de elemento quiere crear. Si no especifica, pregunta.
6
6
 
7
+ ## Unidades de potencia — léelo antes de crear nada
8
+
9
+ Suntropy guarda **todas las potencias de equipo en kW**, con una única excepción: el
10
+ `peakPower` de los paneles, que va en **Wp**. Las fichas técnicas dan casi siempre
11
+ vatios, así que hay que convertir antes de escribir:
12
+
13
+ | Campo | Elemento | Unidad | Ficha dice 5000 W → escribe |
14
+ |-------|----------|--------|------------------------------|
15
+ | `peakPower` | paneles (y paneles de kit) | **Wp** | `5000` |
16
+ | `nominalPower` | inversores (y inversores de kit) | **kW** | `5` |
17
+ | `maxPower` | cargadores VE | **kW** | `5` |
18
+ | `lowerPower` / `upperPower` | aerotermias | **kW** | `5` |
19
+ | `capacity` | baterías | **kWh** | — |
20
+ | `maxCapacityOfBattery` | inversores | **kWh** | — |
21
+
22
+ Un inversor creado con `nominalPower: 5000` queda registrado como **5000 kW = 5 MW**:
23
+ no aparecerá nunca en la recomendación de inversores (que compara `nominalPower`
24
+ contra la potencia pico en kWp) y en el inventario se leerá como megavatios.
25
+
7
26
  ## Tipos de elementos y sus campos
8
27
 
9
28
  ### Paneles solares (`suntropy inventory panels create`)
@@ -29,7 +48,7 @@ suntropy inventory panels create --data '{"name":"JA Solar 450W","peakPower":450
29
48
  | Campo | Tipo | Obligatorio | Ejemplo |
30
49
  |-------|------|-------------|---------|
31
50
  | name | string | Sí | "Huawei SUN2000-5KTL" |
32
- | nominalPower | number | Sí | 5000 (W) |
51
+ | nominalPower | number | Sí | 5 (**kW**, no W) |
33
52
  | efficiency | number | No | 98.4 (%) |
34
53
  | manufacturer | object | No | {"idManufacturer": N} |
35
54
  | phaseNumber | string | No | "single_phase" o "three_phase" |
@@ -40,7 +59,7 @@ suntropy inventory panels create --data '{"name":"JA Solar 450W","peakPower":450
40
59
  | active | boolean | No | true |
41
60
 
42
61
  ```bash
43
- suntropy inventory inverters create --data '{"name":"Huawei SUN2000-5KTL","nominalPower":5000,"efficiency":98.4,"phaseNumber":"single_phase","costPerUnit":800}'
62
+ suntropy inventory inverters create --data '{"name":"Huawei SUN2000-5KTL","nominalPower":5,"efficiency":98.4,"phaseNumber":"single_phase","costPerUnit":800}'
44
63
  ```
45
64
 
46
65
  ### Baterías (`suntropy inventory batteries create`)
@@ -64,7 +83,7 @@ suntropy inventory batteries create --data '{"name":"Huawei LUNA2000-5","capacit
64
83
  | Campo | Tipo | Obligatorio | Ejemplo |
65
84
  |-------|------|-------------|---------|
66
85
  | name | string | Sí | "Wallbox Pulsar Plus" |
67
- | maxPower | number | Sí | 7400 (W) |
86
+ | maxPower | number | Sí | 7.4 (**kW**, no W) |
68
87
  | connectorType | string | No | TYPE_1, TYPE_2, CCS1, CCS2, GBT, CHAdeMO |
69
88
  | phaseNumber | number | No | 1 |
70
89
  | includedPlug | boolean | No | true |
@@ -73,15 +92,15 @@ suntropy inventory batteries create --data '{"name":"Huawei LUNA2000-5","capacit
73
92
  | active | boolean | No | true |
74
93
 
75
94
  ```bash
76
- suntropy inventory chargers create --data '{"name":"Wallbox Pulsar Plus","maxPower":7400,"connectorType":"TYPE_2","costPerUnit":650}'
95
+ suntropy inventory chargers create --data '{"name":"Wallbox Pulsar Plus","maxPower":7.4,"connectorType":"TYPE_2","costPerUnit":650}'
77
96
  ```
78
97
 
79
98
  ### Aerotermias (`suntropy inventory heatpumps create`)
80
99
  | Campo | Tipo | Obligatorio | Ejemplo |
81
100
  |-------|------|-------------|---------|
82
101
  | identifier | string | Sí | "Daikin Altherma 3 8kW" |
83
- | lowerPower | number | No | 4000 (W) |
84
- | upperPower | number | No | 8000 (W) |
102
+ | lowerPower | number | No | 4 (**kW**, no W) |
103
+ | upperPower | number | No | 8 (**kW**, no W) |
85
104
  | scop | number | No | 4.5 |
86
105
  | phases_number | number | No | 1 |
87
106
  | manufacturer | object | No | {"idManufacturer": N} |
@@ -90,7 +109,7 @@ suntropy inventory chargers create --data '{"name":"Wallbox Pulsar Plus","maxPow
90
109
  | active | boolean | No | true |
91
110
 
92
111
  ```bash
93
- suntropy inventory heatpumps create --data '{"identifier":"Daikin Altherma 3 8kW","lowerPower":4000,"upperPower":8000,"scop":4.5,"costPerUnit":4500}'
112
+ suntropy inventory heatpumps create --data '{"identifier":"Daikin Altherma 3 8kW","lowerPower":4,"upperPower":8,"scop":4.5,"costPerUnit":4500}'
94
113
  ```
95
114
 
96
115
  ### Equipos personalizados (Custom Assets)
@@ -190,7 +209,7 @@ Resumen rápido de un kit solar básico:
190
209
  ```bash
191
210
  # 1. Crear panel y inversor del kit
192
211
  suntropy inventory kits panels create --data '{"name":"Panel Kit","peakPower":450,"efficiency":21}'
193
- suntropy inventory kits inverters create --data '{"name":"Inversor Kit","nominalPower":5000}'
212
+ suntropy inventory kits inverters create --data '{"name":"Inversor Kit","nominalPower":5}'
194
213
 
195
214
  # 2. Ensamblar el kit (método recomendado)
196
215
  suntropy inventory kits assemble \