@jjlmoya/utils-drones 1.35.0 → 1.37.0

package/src/tool/drone-mission-battery-reserve-planner/drone-mission-battery-reserve-planner.css

@@ -0,0 +1,392 @@
+.drone-mission-battery-reserve-planner {
+  box-sizing: border-box;
+  display: flex;
+  flex-direction: column;
+  gap: 24px;
+  width: 100%;
+  max-width: 1100px;
+  margin: 0 auto;
+  padding: 24px;
+  border-radius: 16px;
+  background: var(--n-surface-card, #0d1322);
+  border: 1px solid var(--n-border, #1e293b);
+  color: var(--n-text-primary, #f8fafc);
+}
+
+.drone-mission-battery-reserve-planner * {
+  box-sizing: border-box;
+}
+
+.planner-top-bar {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  justify-content: space-between;
+  gap: 16px;
+  padding-bottom: 20px;
+  border-bottom: 1px solid var(--n-border, #1e293b);
+}
+
+.presets-section {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+}
+
+.presets-label {
+  font-size: 11px;
+  font-weight: 700;
+  letter-spacing: 0.05em;
+  text-transform: uppercase;
+  color: var(--n-text-secondary, #94a3b8);
+}
+
+.presets-flex {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+}
+
+.preset-pill {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  padding: 8px 14px;
+  border-radius: 8px;
+  background: var(--n-surface-subtle, #151d30);
+  border: 1px solid var(--n-border, #2e3d5c);
+  color: var(--n-text-primary, #f8fafc);
+  cursor: pointer;
+  transition: all 0.2s ease;
+}
+
+.preset-pill:hover {
+  background: var(--n-surface-hover, #1e2942);
+  border-color: var(--n-brand, #3b82f6);
+}
+
+.preset-name {
+  font-size: 12px;
+  font-weight: 600;
+}
+
+.preset-meta {
+  font-size: 10px;
+  color: var(--n-text-secondary, #94a3b8);
+}
+
+.unit-switch-group {
+  display: flex;
+  background: var(--n-surface-subtle, #151d30);
+  padding: 3px;
+  border-radius: 8px;
+  border: 1px solid var(--n-border, #2e3d5c);
+}
+
+.unit-btn {
+  padding: 6px 16px;
+  border-radius: 6px;
+  border: none;
+  background: transparent;
+  color: var(--n-text-secondary, #94a3b8);
+  font-size: 12px;
+  font-weight: 600;
+  cursor: pointer;
+  transition: all 0.2s ease;
+}
+
+.unit-btn.active {
+  background: var(--n-brand, #3b82f6);
+  color: #fff;
+}
+
+.planner-main-grid {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 24px;
+}
+
+@media (max-width: 860px) {
+  .planner-main-grid {
+    grid-template-columns: 1fr;
+  }
+}
+
+.planner-controls-panel {
+  display: flex;
+  flex-direction: column;
+  gap: 18px;
+}
+
+.panel-heading {
+  margin: 0;
+  font-size: 13px;
+  font-weight: 700;
+  letter-spacing: 0.05em;
+  text-transform: uppercase;
+  color: var(--n-brand-light, #60a5fa);
+}
+
+.control-row {
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+
+.control-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+}
+
+.control-header label {
+  font-size: 13px;
+  font-weight: 600;
+}
+
+.control-val-display {
+  font-size: 13px;
+  font-weight: 700;
+  color: var(--n-brand, #3b82f6);
+}
+
+.slider-with-number {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+}
+
+.tactile-slider {
+  flex: 1;
+  accent-color: var(--n-brand, #3b82f6);
+  cursor: pointer;
+}
+
+.tactile-number {
+  width: 72px;
+  padding: 6px 8px;
+  border-radius: 6px;
+  background: var(--n-surface-subtle, #151d30);
+  border: 1px solid var(--n-border, #2e3d5c);
+  color: var(--n-text-primary, #f8fafc);
+  font-size: 13px;
+  font-weight: 600;
+  text-anchor: end;
+}
+
+.voltage-chips-row {
+  display: flex;
+  gap: 8px;
+}
+
+.voltage-chip {
+  flex: 1;
+  padding: 6px;
+  border-radius: 6px;
+  background: var(--n-surface-subtle, #151d30);
+  border: 1px solid var(--n-border, #2e3d5c);
+  color: var(--n-text-secondary, #94a3b8);
+  font-size: 11px;
+  font-weight: 600;
+  cursor: pointer;
+}
+
+.voltage-chip.active {
+  background: var(--n-brand, #3b82f6);
+  border-color: var(--n-brand, #3b82f6);
+  color: #fff;
+}
+
+.wind-dir-segmented {
+  display: flex;
+  gap: 8px;
+}
+
+.wind-seg-btn {
+  flex: 1;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  padding: 8px;
+  border-radius: 8px;
+  background: var(--n-surface-subtle, #151d30);
+  border: 1px solid var(--n-border, #2e3d5c);
+  color: var(--n-text-secondary, #94a3b8);
+  font-size: 11px;
+  font-weight: 600;
+  cursor: pointer;
+}
+
+.wind-seg-btn.active {
+  border-color: var(--n-brand, #3b82f6);
+  color: var(--n-text-primary, #f8fafc);
+  background: var(--n-surface-hover, #1e2942);
+}
+
+.wind-tag {
+  font-size: 10px;
+  font-weight: 800;
+  color: var(--n-brand, #3b82f6);
+}
+
+.planner-telemetry-panel {
+  display: flex;
+  flex-direction: column;
+  gap: 16px;
+}
+
+.status-banner {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  padding: 14px 16px;
+  border-radius: 12px;
+  border: 1px solid var(--n-border, #2e3d5c);
+}
+
+.status-banner-optimal {
+  background: rgba(16, 185, 129, 0.1);
+  border-color: rgba(16, 185, 129, 0.3);
+}
+
+.status-banner-tight {
+  background: rgba(245, 158, 11, 0.1);
+  border-color: rgba(245, 158, 11, 0.3);
+}
+
+.status-banner-critical {
+  background: rgba(239, 68, 68, 0.1);
+  border-color: rgba(239, 68, 68, 0.3);
+}
+
+.status-banner-exceeded {
+  background: rgba(239, 68, 68, 0.15);
+  border-color: rgba(239, 68, 68, 0.5);
+}
+
+.status-icon-dot {
+  width: 10px;
+  height: 10px;
+  border-radius: 50%;
+  background: currentcolor;
+}
+
+.status-banner-optimal .status-icon-dot {
+  background: #10b981;
+}
+
+.status-banner-tight .status-icon-dot {
+  background: #f59e0b;
+}
+
+.status-banner-critical .status-icon-dot,
+.status-banner-exceeded .status-icon-dot {
+  background: #ef4444;
+}
+
+.status-banner-text {
+  display: flex;
+  flex-direction: column;
+}
+
+.status-banner-title {
+  font-size: 13px;
+  font-weight: 800;
+  letter-spacing: 0.02em;
+}
+
+.status-banner-subtitle {
+  font-size: 11px;
+  color: var(--n-text-secondary, #94a3b8);
+}
+
+.telemetry-artwork-box {
+  width: 100%;
+  border-radius: 12px;
+  overflow: hidden;
+}
+
+.mission-telemetry-svg {
+  width: 100%;
+  height: auto;
+  display: block;
+}
+
+.metrics-grid {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 12px;
+}
+
+.metric-card {
+  display: flex;
+  flex-direction: column;
+  padding: 12px 14px;
+  border-radius: 10px;
+  background: var(--n-surface-subtle, #151d30);
+  border: 1px solid var(--n-border, #1e293b);
+}
+
+.highlight-card {
+  border-color: var(--n-brand, #3b82f6);
+  background: rgba(59, 130, 246, 0.06);
+}
+
+.metric-label {
+  font-size: 11px;
+  font-weight: 600;
+  color: var(--n-text-secondary, #94a3b8);
+}
+
+.metric-value {
+  font-size: 18px;
+  font-weight: 800;
+  margin: 4px 0 2px;
+  color: var(--n-text-primary, #f8fafc);
+}
+
+.metric-sub {
+  font-size: 10px;
+  color: var(--n-text-secondary, #94a3b8);
+}
+
+.touchdown-energy-card {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  padding: 14px;
+  border-radius: 10px;
+  background: var(--n-surface-subtle, #151d30);
+  border: 1px solid var(--n-border, #1e293b);
+}
+
+.touchdown-info {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+}
+
+.touchdown-title {
+  font-size: 12px;
+  font-weight: 600;
+}
+
+.touchdown-value {
+  font-size: 13px;
+  font-weight: 800;
+  color: var(--n-brand-light, #60a5fa);
+}
+
+.touchdown-progress-track {
+  width: 100%;
+  height: 8px;
+  border-radius: 4px;
+  background: #0f172a;
+  overflow: hidden;
+}
+
+.touchdown-progress-bar {
+  height: 100%;
+  border-radius: 4px;
+  transition: width 0.3s ease;
+}

package/src/tool/drone-mission-battery-reserve-planner/entry.ts

@@ -0,0 +1,27 @@
+import type { DronesToolEntry, ToolLocaleContent } from '../../types';
+import type { DroneMissionBatteryReservePlannerUI } from './ui';
+
+export type { DroneMissionBatteryReservePlannerUI };
+export type DroneMissionBatteryReservePlannerLocaleContent = ToolLocaleContent<DroneMissionBatteryReservePlannerUI>;
+
+export const droneMissionBatteryReservePlanner: DronesToolEntry<DroneMissionBatteryReservePlannerUI> = {
+  id: 'drone-mission-battery-reserve-planner',
+  icons: { bg: 'mdi:drone', fg: 'mdi:battery-clock' },
+  i18n: {
+    de: () => import('./i18n/de').then((m) => m.content),
+    en: () => import('./i18n/en').then((m) => m.content),
+    es: () => import('./i18n/es').then((m) => m.content),
+    fr: () => import('./i18n/fr').then((m) => m.content),
+    id: () => import('./i18n/id').then((m) => m.content),
+    it: () => import('./i18n/it').then((m) => m.content),
+    ja: () => import('./i18n/ja').then((m) => m.content),
+    ko: () => import('./i18n/ko').then((m) => m.content),
+    nl: () => import('./i18n/nl').then((m) => m.content),
+    pl: () => import('./i18n/pl').then((m) => m.content),
+    pt: () => import('./i18n/pt').then((m) => m.content),
+    ru: () => import('./i18n/ru').then((m) => m.content),
+    sv: () => import('./i18n/sv').then((m) => m.content),
+    tr: () => import('./i18n/tr').then((m) => m.content),
+    zh: () => import('./i18n/zh').then((m) => m.content),
+  },
+};

package/src/tool/drone-mission-battery-reserve-planner/evaluator.ts

@@ -0,0 +1,23 @@
+import type { MissionResults } from './logic';
+import type { DroneMissionBatteryReservePlannerUI } from './ui';
+
+export interface EvaluatorBadge {
+  label: string;
+  className: string;
+}
+
+export function evaluateMissionStatus(
+  results: MissionResults,
+  uiBadges: DroneMissionBatteryReservePlannerUI['statusBadges']
+): EvaluatorBadge {
+  switch (results.statusKey) {
+    case 'optimal':
+      return { label: uiBadges.optimal, className: 'status-badge--optimal' };
+    case 'tight':
+      return { label: uiBadges.tight, className: 'status-badge--tight' };
+    case 'critical':
+      return { label: uiBadges.critical, className: 'status-badge--critical' };
+    case 'exceeded':
+      return { label: uiBadges.exceeded, className: 'status-badge--exceeded' };
+  }
+}

package/src/tool/drone-mission-battery-reserve-planner/i18n/de.ts

@@ -0,0 +1,223 @@
+import type { DroneMissionBatteryReservePlannerLocaleContent } from '../entry';
+import type { WithContext, SoftwareApplication, FAQPage, HowTo } from 'schema-dts';
+import { bibliography } from '../bibliography';
+
+const slug = 'drohnen-missions-akku-reserve-planer';
+const title = 'Drohnen Missions Akku Reserve Planer';
+const description = 'Berechnen Sie sichere Akku-Rückkehrreserven, Gegenwind-Leistungsverluste und maximale Einsatzradien für UAV-Flüge.';
+
+const faqItems = [
+  {
+    question: 'Warum verbraucht das Fliegen gegen Gegenwind überproportional viel Energie?',
+    answer: 'Gegenwind erfordert einen steileren Neigungswinkel zur Überwindung des Luftwiderstands, was den Motorstromverbrauch exponenziell ansteigen lässt.',
+  },
+  {
+    question: 'Wie fließt die Verweilzeit am Zielort in den Point of No Return ein?',
+    answer: 'Die Einsatzzeit am Ziel zieht direkt Energie aus der nutzbaren Akkukapazität ab, bevor der verbleibende Transitradius berechnet wird.',
+  },
+  {
+    question: 'Was verursacht den Spannungsabfall unter Last bei LiPo-Akkus?',
+    answer: 'Hohe Stromstärken erhöhen die Verluste am Innenwiderstand der Lithiumzellen und verringern die effektiv nutzbare Energie.',
+  },
+];
+
+const howToSteps = [
+  {
+    name: 'Akku- und Antriebsdaten eingeben',
+    text: 'Geben Sie Akkukapazität in Milliampere-Stunden, Nennspannung und durchschnittlichen Stromverbrauch ein.',
+  },
+  {
+    name: 'Flugdistanz und Zielzeit festlegen',
+    text: 'Bestimmen Sie die Einfachdistanz und die geplante Verweildauer über dem Zielgebiet.',
+  },
+  {
+    name: 'Windgeschwindigkeit und Richtung konfigurieren',
+    text: 'Wählen Sie Windgeschwindigkeit und Windrichtung bezogen auf den Hinflug.',
+  },
+  {
+    name: 'Sicherheitsradius und Telemetrie prüfen',
+    text: 'Analysieren Sie den berechneten Point of No Return, den Verbrauch pro Flugphase und den verbleibenden Akkustand.',
+  },
+];
+
+const schemas: DroneMissionBatteryReservePlannerLocaleContent['schemas'] = [
+  {
+    '@context': 'https://schema.org',
+    '@type': 'FAQPage',
+    mainEntity: faqItems.map((item) => ({
+      '@type': 'Question',
+      name: item.question,
+      acceptedAnswer: { '@type': 'Answer', text: item.answer },
+    })),
+  } as WithContext<FAQPage>,
+  {
+    '@context': 'https://schema.org',
+    '@type': 'HowTo',
+    name: title,
+    description: description,
+    step: howToSteps.map((step, i) => ({
+      '@type': 'HowToStep',
+      position: i + 1,
+      name: step.name,
+      text: step.text,
+    })),
+  } as WithContext<HowTo>,
+  {
+    '@context': 'https://schema.org',
+    '@type': 'SoftwareApplication',
+    name: title,
+    description: description,
+    applicationCategory: 'UtilityApplication',
+    operatingSystem: 'Web',
+    offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  } as WithContext<SoftwareApplication>,
+];
+
+export const content: DroneMissionBatteryReservePlannerLocaleContent = {
+  slug,
+  title,
+  description,
+  ui: {
+    title: 'Drohnen Missions Akku Reserve Planer',
+    subtitle: 'Berechnen Sie Sicherheitsreserven für die Rückkehr, Windeinflüsse und Flugradien',
+    description: 'Präzise Berechnung der Akkureserve für Drohnenflüge mit Gegenwindanpassung und Point of No Return Schwellenwerten.',
+    sections: {
+      batteryPropulsion: '1. Akku & Antrieb',
+      flightAtmosphere: '2. Flugprofil & Atmosphäre',
+    },
+    inputs: {
+      unitSystemLabel: 'Einheitensystem',
+      metricLabel: 'Metrisch',
+      imperialLabel: 'Imperial',
+      presetLabel: 'Schnellkonfigurationen',
+      batteryCapacityLabel: 'Akkukapazität',
+      batteryVoltageLabel: 'Nennspannung',
+      averageCurrentLabel: 'Durchschnittlicher Reisestrom',
+      cruiseSpeedLabel: 'Eigengeschwindigkeit in der Luft',
+      oneWayDistanceLabel: 'Einfache Zielentfernung',
+      targetHoverTimeLabel: 'Einsatzdauer am Zielort',
+      windSpeedLabel: 'Windgeschwindigkeit',
+      windDirectionLabel: 'Windrichtung relativ zum Hinflug',
+      windHeadwindLabel: 'Gegenwind auf Hinflug',
+      windTailwindLabel: 'Rückenwind auf Hinflug',
+      windCrosswindLabel: 'Seitenwind',
+      reservePolicyLabel: 'Sicherheits-Reservepuffer',
+    },
+    presets: {
+      mappingSurvey: 'Fotogrammetrie & Vermessung',
+      fpvRecon: 'FPV Langstrecken-Erkundung',
+      cinematicInspection: 'Kineastische Bauwerksinspektion',
+      microRecon: 'Mikro-Drohnen-Erkundung',
+      surveyMeta: 'Vermessung',
+      scoutMeta: 'Erkundung',
+      hoverMeta: 'Schwebeflug',
+    },
+    results: {
+      totalCapacityEnergy: 'Gesamtkapazität Energie',
+      usableEnergy: 'Nutzbare Missionsenergie',
+      reserveEnergyBuffer: 'Reserve-Energiepuffer',
+      totalAutonomyTime: 'Gesamte Flugautonomie',
+      maxSafeMissionRadius: 'Point of No Return Radius',
+      outboundLegTime: 'Dauer Hinflug',
+      targetHoverTime: 'Dauer Zielverweilung',
+      returnLegTime: 'Dauer Rückflug',
+      totalMissionTime: 'Gesamte Transitdauer',
+      remainingEnergyLanding: 'Geschätzter Akkustand bei Landung',
+      feasibilityStatus: 'Bewertung der Einsatzdurchführbarkeit',
+      voltageSagSubLabel: 'Spannungsabfall',
+      maxRadiusSubLabel: 'Maximaler Sicherheitsradius mit Schwebeflug',
+      powerSubLabel: 'Leistung',
+    },
+    statusBadges: {
+      optimalTitle: 'OPTIMALER ENERGIERESERVE PUFFER',
+      optimalSubtitle: 'Sicheres Flugprofil mit ausreichender Landereserve',
+      tightTitle: 'KNAPPE AKKURESERVE WARNUNG',
+      tightSubtitle: 'Geringe Landereserve, überwachen Sie die Akkuspannung genau',
+      criticalTitle: 'KRITISCHE ENERGIEWARNUNG',
+      criticalSubtitle: 'Reserve unterschritten, leiten Sie sofort die Rückkehr ein',
+      exceededTitle: 'EINSATZ ÜBERSCHREITET SICHERE KAPAZITÄT',
+      exceededSubtitle: 'Unzureichende Energie für sichere Fertigstellung und Landung',
+    },
+    chart: {
+      batteryProfileTitle: 'NICHTLINEARES ENERGIE-VERTEILUNGSPROFIL',
+      modelTitle: 'AERODYNAMISCHES LEISTUNGS- UND WINDMODELL',
+      windLabel: 'Wind',
+      homeNode: 'START',
+      targetNode: 'ZIEL',
+      landNode: 'LANDUNG',
+      launchPadLabel: 'Startplatz',
+      surveyHoverLabel: 'Ziel-Schwebeflug',
+      safeRadiusLabel: 'Sicherheitsradius',
+      outboundSegment: 'Hinflug',
+      targetSegment: 'Schwebeflug',
+      returnSegment: 'Rückflug',
+      reserveSegment: 'Reserve',
+    },
+  },
+  seo: [
+    {
+      type: 'title',
+      text: 'Aerodynamische Leistungsverluste bei Gegenwind',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Die Flugsicherheit unbemannter Luftfahrzeuge basiert auf nichtlinearen physikalischen Gesetzen. Das Fliegen gegen den Wind erfordert eine stärkere Neigung, um den Luftwiderstand zu überwinden und die Bodengeschwindigkeit zu halten. Dies erhöht die erforderliche Schubleistung der Motoren und den Stromverbrauch exponentiell.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Unser Planer berechnet dynamisch die Leistungsunterschiede für jeden Streckenabschnitt unter Berücksichtigung der Windverhältnisse.',
+    },
+    {
+      type: 'title',
+      text: 'Berücksichtigung der Verweilzeit im Zielgebiet',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Inspektions- und Vermessungsdrohnen verbringen viel Zeit im Schwebeflug über dem Ziel. Diese Phase verbraucht kontinuierlich Energie vor dem Rückflug. Die Point of No Return Formel zieht diese Energie vorab ab.',
+    },
+    {
+      type: 'list',
+      items: [
+        'Geben Sie die geplante Verweildauer ein, bevor Sie Einsatzgrenzen berechnen.',
+        'Berücksichtigen Sie Leistungsspitzen beim Hinflug gegen Gegenwind.',
+        'Überwachen Sie den Spannungsabfall unter Last bei LiPo-Zellen.',
+        'Leiten Sie die Rückkehr sofort bei Erreichen des Reservepuffers ein.',
+      ],
+    },
+    {
+      type: 'tip',
+      title: 'Warnung vor Spannungsabfall bei LiPo Akkus',
+      html: 'Hohe Entladeströme verursachen durch den Innenwiderstand von Lithium-Polymer-Zellen einen Spannungsabfall unter Last, was die nutzbare Energie verringert.',
+    },
+    {
+      type: 'title',
+      text: 'Formeln zur Berechnung der Akkureserve',
+      level: 2,
+    },
+    {
+      type: 'table',
+      headers: ['Parameter', 'Formel / Modell', 'Einheit'],
+      rows: [
+        ['Brutto-Energie', 'Kapazität (mAh) x Spannung (V) / 1000', 'Wattstunden (Wh)'],
+        ['Spannungsabfall-Verlust', 'Brutto-Energie x Sag-Faktor', 'Wattstunden (Wh)'],
+        ['Gegenwind-Leistung', 'Basis-Leistung x (1 + 0.65 x WindRatio)^1.3', 'Watt (W)'],
+        ['Maximaler Sicherheitsradius', '(Nutzbare Energie - Schwebe-Energie) / Verbrauch pro Km', 'Kilometer (km)'],
+      ],
+    },
+    {
+      type: 'title',
+      text: 'Bewährte Verfahren für die Flugplanung von Drohnen',
+      level: 2,
+    },
+    {
+      type: 'paragraph',
+      html: 'Vergleichen Sie stets automatische Telemetriedaten mit Vorflugberechnungen, um höchste Sicherheit bei allen gewerblichen UAV-Flügen zu gewährleisten.',
+    },
+  ],
+  faq: faqItems,
+  bibliography,
+  howTo: howToSteps,
+  schemas,
+};