Ich programmiere Vibe-Codierung, um Web sites und IOS-Apps zu erstellen. Ich habe bereits zwei Apps dwell im App Retailer.

Meine erste App warfare Pinsel-Trackerdas Ihnen hilft, Ihre täglichen Putzgewohnheiten zu verfolgen, konsistent zu bleiben und Ihre Zähne durch kleine Motivationsschübe sauber zu halten. Ich habe auch eine geschrieben Artikel über den gesamten Prozess der Erstellung der App und deren Versand an den App Retailer.

Kürzlich habe ich beschlossen, dem Brush Tracker eine neue Funktion hinzuzufügen: ein kalenderähnliches Raster, das die monatliche Putzkonsistenz des Benutzers anzeigt. In diesem Artikel erkläre ich Ihnen, wie ich diese Funktion mithilfe von Cursor und einigen manuellen Anpassungen implementiert habe.

Erste Aufforderung

Was ich im Sinn hatte, ähnelte den Rastern, die man in Apps zur Gewohnheitsverfolgung sieht, oder dem Beitragsdiagramm auf GitHub.

Ich habe mit dem Planmodus des Cursors begonnen, der meiner Meinung nach äußerst effizient ist, wenn ich eine neue Funktion hinzufüge oder eine große Änderung vornehme. Sie definieren die Funktion oder erläutern die Aufgabe und Cursor generiert einen detaillierten Implementierungsplan.

Hier ist die genaue Eingabeaufforderung, die ich im Planmodus verwendet habe, um zu beginnen:

Ich möchte ein kalenderähnliches Raster hinzufügen, um die Tage zu verfolgen, an denen der Benutzer die Zähne putzt. Erstellen Sie das Raster aus Quadraten, wobei jedes Quadrat einen Tag in einem Monat darstellt. Der Ausgangszustand der Quadrate im Raster ist schwarz. Malen Sie das Quadrat mit Grün, wenn der Benutzer alle Bürstenarbeiten abgeschlossen hat, und mit Hellgrün, wenn der Benutzer die Bürstenarbeiten nur teilweise abgeschlossen hat. Beispielsweise legt der Benutzer die Anzahl der täglichen Putzvorgänge auf 2 fest. Wenn er einmal professional Tag putzt, sollte das Quadrat hellgrün sein. Wenn sie am Tag zwei Zähneputzen durchführen, sollte das Quadrat für diesen Tag grün sein. Das Raster sollte durch Drücken eines Kalendersymbols oben hyperlinks auf dem Bildschirm zugänglich sein.

Cursor stellte mir zwei Fragen, um einige Particulars zu klären, bevor der Implementierungsplan fertiggestellt wurde. Dieser Schritt hat mir sehr intestine gefallen, weil es beruhigend ist, zu sehen, wie Cursor um Klärung bittet, anstatt eigene Annahmen zu treffen.

Die beiden Fragen, die Cursor stellte:

• Sollte das Kalenderraster nur den aktuellen Monat anzeigen oder die Navigation zwischen Monaten ermöglichen?
• Sollten wir ab heute mit der Verfolgung beginnen oder auch vergangene Tage anzeigen (was schwarz wäre)?

Ich habe Cursor angewiesen, die Navigation zwischen Monaten zu ermöglichen und die vorherigen Tage des Monats schwarz anzuzeigen. Anschließend erstellte Cursor eine Markdown-Datei mit einem detaillierten Implementierungsplan.

Der Plan erläutert ausführlich, wie die Funktion implementiert wird, und enthält außerdem eine Liste umsetzbarer Aufgaben.

TODO-Elemente des Cursors:

• Erweitern Sie BrushModel, um historische tägliche Putzdaten dauerhaft zu verfolgen

• Erstellen Sie eine CalendarGridView-Komponente mit Monatsraster und farbcodierten Quadraten

• Schaltfläche „Kalendersymbol hinzufügen“ oben hyperlinks in ContentView

• Integrieren Sie CalendarGridView mithilfe der Blattpräsentation in ContentView

Als nächstes bat ich Cursor, den Plan umzusetzen. Es ermöglicht auch, den Plan vor der Ausführung zu ändern, aber ich wollte die ursprüngliche Gliederung von Cursor so beibehalten, wie sie ist.

Die Implementierung funktionierte gleich beim ersten Versuch und ich konnte das Function direkt im Xcode-Simulator testen. Allerdings warfare das Design schrecklich:

Hinweis: Alle in diesem Artikel verwendeten Bilder enthalten Screenshots meiner App Brush Tracker.

Der Xcode-Simulator enthält keine Datums- und Uhrzeiteinstellungen mehr, daher habe ich das Systemdatum auf meinem Mac geändert, um zu testen, wie sich die Rasterfarben über verschiedene Tage hinweg aktualisiert haben.

Dieser Stil gefiel mir überhaupt nicht. Deshalb habe ich Cursor gebeten, das Raster mithilfe der folgenden Eingabeaufforderung neu zu gestalten:

Wir müssen das Design des Gitters ändern. Was ich im Sinn habe, ist so etwas wie ein Github-Beitragsraster. Zeigen Sie außerdem nicht die Tageswerte in den Quadraten an, die Tage darstellen.

Diese Eingabeaufforderung funktionierte nicht wie erhofft. Die einzige Änderung bestand darin, die Tageszahlen zu entfernen:

Als nächstes habe ich ein Beispielbild des gewünschten Rasterstils geteilt und Cursor gebeten, ein ähnliches Design zu erstellen.

Das neue Design kam meinen Vorstellungen näher, hatte aber strukturelle Probleme. Die Quadrate waren zu klein und passten nicht intestine in das Format:

Es gibt additionally zwei Hauptprobleme bei diesem Design:

1. Jeder Monat enthält 42 Quadrate (die nicht die Tage eines Monats darstellen).
2. Quadrate sind zu klein.

Ich habe Cursor gebeten, das erste Downside mit dieser Eingabeaufforderung zu beheben:

In der aktuellen Umsetzung gibt es im November und Dezember 42 Plätze. Die Quadrate im Raster stellen die Tage in einem Monat dar, daher muss die Anzahl der Quadrate der Anzahl der Tage in diesem Monat entsprechen.

Das andere Downside warfare einfacher und ich konnte es lösen, indem ich einige Parameterwerte anpasste. Beispielsweise kann die Größe der Quadrate im Raster durch geändert werden squareSize Parameter:

struct DaySquare: View {
    let isToday: Bool
    let isCurrentMonth: Bool
    let brushCount: Int
    let brushesPerDay: Int
    
    personal let squareSize: CGFloat = 8 // change this parameter

So sieht das Raster aus, nachdem ich die Quadratgröße auf 32 geändert habe:

Das andere Downside, das durch Anpassen der Parameterwerte gelöst werden könnte, ist der Abstand zwischen Zeilen.

Im Screenshot oben scheint zwischen den Zeilen kein Leerzeichen zu sein. Dies kann durch Erhöhen des Abstands zwischen den Zeilen geändert werden.

Ich möchte auch 8 Quadrate (dh Tage) in einer Reihe haben und den Abstand zwischen den Reihen ändern.

All dies kann im folgenden Codeausschnitt erfolgen:

            // Calendar grid - smaller GitHub type
            LazyVGrid(columns: Array(repeating: GridItem(.versatile(), spacing: 0.2), rely: 8), spacing: 0) {
                ForEach(Array(calendarDays.enumerated()), id: .offset) { index, dayInfo in
                    DaySquare(
                        isToday: dayInfo.isToday,
                        isCurrentMonth: dayInfo.isCurrentMonth,
                        brushCount: dayInfo.brushCount,
                        brushesPerDay: mannequin.brushesPerDay,
                        measurement: 32
                    )
                    .padding(.backside, 3)
                }
            }

• spacing steuert den Abstand zwischen Quadraten in einer Reihe
• padding steuert den Abstand zwischen den Zeilen
• rely steuert die Anzahl der Quadrate in einer Reihe

Nachdem ich mit diesen Parameterwerten im obigen Codeausschnitt herumgespielt habe, habe ich das folgende Raster erhalten:

Wenn die Benutzerin an einem Tag alle Zähne putzt, erhält sie ein leuchtendes Grün. Im Falle einer teilweisen Fertigstellung wird das Quadrat für diesen Tag hellgrün eingefärbt. Die anderen Tage werden schwarz dargestellt und der aktuelle Tag wird mit einem weißen Rahmen angezeigt.

Nach der Implementierung der Funktion zur Verfolgung vergangener Tage schien es naheliegend, Benachrichtigungen für Streaks hinzuzufügen. Ich habe Cursor mithilfe der folgenden Eingabeaufforderung gebeten, dies zu tun:

Fügen Sie Benachrichtigungen hinzu, wenn der Benutzer alle Zähneputzen für 10, 20 und 30 Tage abgeschlossen hat. Fügen Sie außerdem eine Monatsbenachrichtigung hinzu, wenn der Benutzer alle Tage eines Monats abschließt. Benachrichtigungen sollten ermutigend und motivierend sein.

Das von mir erstellte Raster ist nicht das beste Design, aber es ist intestine genug, um die Botschaft zu vermitteln. Betrachtet ein Nutzer dieses Raster, bekommt er sofort einen Eindruck von der Häufigkeit seines Zähneputzens.

Mit Hilfe von Cursor und einigen manuellen Optimierungen konnte ich diese Funktion in wenigen Stunden implementieren und ausliefern. Zum Zeitpunkt der Erstellung dieses Artikels befindet sich diese Model noch im App Retailer-Check. Wenn Sie den Artikel lesen, wird er möglicherweise bereits verteilt. Hier ist der App Retailer-Hyperlink zu Pinsel-Tracker Wenn Sie einen Blick darauf werfen oder die App ausprobieren möchten.

Vielen Dank fürs Lesen! Wenn Sie Suggestions zum Artikel oder zur App haben, freue ich mich über Ihre Meinung.

Definieren wir zunächst den Umfang der Herausforderung: Stellen Sie sich vor, wir möchten das Wachstum Ihres Kundenstamms im Laufe der Zeit verfolgen.

Wir erstellen eine Maßnahme, um Kunden basierend auf ihrer ersten Bestellung zu zählen und neue Kunden für jeden Monat zu identifizieren.

Aber jetzt möchten wir eine Visualisierung dieses Maßes mit einem Wasserfall -visuell erstellen, und wir bekommen so etwas:

Aber wir brauchen etwas mehr.

Wir benötigen den Anfangswert, der zum Ende des Vorjahres die Kundenzahl ist, und fügen Sie dann die Anzahl der neuen Kunden für jeden Monat bis zum Ende des Berichtszeitraums zur Gesamtzahl der Kunden hinzu.

So etwas:

Leider können wir keine Spalte als Startsumme in Energy BI festlegen.

Wenn Sie daher die Messung zu einem Wasserfall in Energy BI hinzufügen, ähnelt das Ergebnis dem im ersten Beispiel in Excel:

Selbst wenn ein kommerzielles, benutzerdefiniertes Visible wie Zebra BI verwendet wird, ist das Ergebnis nicht nach Bedarf:

In diesem Fall habe ich die Maßnahme des Vorjahres hinzugefügt, um den Startwert festzulegen. Das visuelle berechnet jedoch die Abweichung von der PY für jeden Monat und zeigt die Gesamtsumme anhand dieser Abweichungen an.

Das Ergebnis 141 für das Vorjahr wird berechnet, da Zebra BI feststellt, dass es für das laufende Jahr nur 7 Monate Daten gibt, und es berechnet die Summe im Vorjahr nur für diese 7 Monate.

In diesem speziellen Fall ist es nicht das, was wir brauchen, da wir nicht an der Abweichung vom Vorjahr interessiert sind, sondern am Ende des letzten Jahres am Wachstum.

Obwohl dieses benutzerdefinierte Visible extrem leistungsfähig ist, ist es in unserem Fall nicht hilfreich.

Erweitern Sie das Datenmodell

Was wir jetzt brauchen, ist eine Methode, die nicht nur berechnet, sondern auch den letzten Monat des Vorjahres bei der Auswahl eines Jahres, beispielsweise 2025, zeigen kann.

Ich habe dieses Drawback bereits gelöst, indem ich eine zweite Datumstabelle hinzugefügt und die entsprechende Maßnahme geschrieben habe.

Sie können die vollständige Beschreibung dieser Lösung und eine Erläuterung finden, wie sie im Abschnitt Referenzen unten funktioniert.

Das modifizierte Datenmodell sieht Folgendes aus:

Mit dieser neuen Datumstabelle können wir mit dem in der Tabelle „Auswahldatum“ ausgewählten Factor arbeiten und Berechnungen mit der Datumstabelle durchführen.

Um dies zu unterstützen, habe ich beide Tabellen als „Datumstabelle“ festgelegt. Ich kann die Tabelle „Datum“ wie gewohnt ohne Einschränkungen verwenden.

Entwicklung der Maßnahmen (en)

Der nächste Schritt ist das Schreiben der Maßnahmen.

Zunächst muss ich den Startwert berechnen, der die Anzahl der Kunden bis zum Ende des (vorherigen) Jahres ist.

Um dieses Ziel zu erreichen, muss ich die Summe aller Zeilen für das Vorjahr berechnen, jedoch für alle Monate:

New Clients (YE) =

    VAR SelYearPY = SELECTEDVALUE('Date'(Yr))

    VAR Consequence = CALCULATE((New Clients)

                            ,REMOVEFILTERS('Date')

                            ,'Date'(Yr) = SelYearPY

                            )

RETURN

    Consequence

Das Ergebnis ist 280 für 2024.

Sie fragen sich vielleicht, warum ich die Summe über das ausgewählte Jahr anstelle des Vorjahres berechnet habe.
Der Grund dafür ist, dass wir das Ergebnis dieser Maßnahme für Dezember 2024 zeigen möchten (wenn 2025 ausgewählt ist). Bitte warten Sie einen Second, bis Sie die Ergebnisse sehen. Diese werden Ihnen helfen, es zu verstehen.

Jetzt müssen wir eine Maßnahme entwickeln, die je nach Monat der X-Achse die richtigen Werte zurückgibt.

Dies sollte der Jahresendwert des Vorjahres für Dezember 2024 oder die Anzahl neuer Kunden für jeden Monat des aktuellen (ausgewählten) Jahres sein. Siehe die vorherige Maßnahme.

Die Maßnahme, die wir benötigen, muss die folgenden Schritte ausführen:

1. Holen Sie sich das ausgewählte Jahr aus der Datums Tabelle.
2. Berechnen Sie die ersten und letzten Monate, um im Bericht angezeigt zu werden.
3. Berechnen Sie das Ergebnis, indem Sie den Filter aus der Datumstabelle entfernen, die im Slicer verwendet wird (der Tabelle „Auswahldatum“).
4. Entscheiden Sie, welches Ergebnis für welchen Monat angezeigt werden muss.

Der letzte Schritt ist entscheidend.

Wenn wir den Filter für das ausgewählte Jahr aus beiden Datumstabellen entfernen, müssen wir steuern, ob ein Ergebnis für jeden Monat angezeigt werden soll. Sie finden diesen Schritt in der SCHALTEN() Teil der folgenden Maßnahme.

Dies ist die volle Maßnahme:

Retail Gross sales Waterfall =

    VAR SelYear = SELECTEDVALUE('Choice Date'(Yr))

    VAR MinYearMonth = SelYear * 100 + 1

    VAR MaxYearMonth = SelYear * 100 + 12

    VAR LastPYYearMonth = (SelYear - 1) * 100 + 12

    VAR ActualMK = CALCULATE(

                    MAX('Date'(MonthKey))

                    ,CROSSFILTER('Choice Date'(DateKey)

                                ,'Date'(DateKey)

                                ,None)

                                )

RETURN

SWITCH(TRUE()

    ,ActualMK = LastPYYearMonth

        ,CALCULATE((New Clients (YE))

                    ,CROSSFILTER('Choice Date'(DateKey)

                                ,'Date'(DateKey)

                                ,None)

                    ,REMOVEFILTERS('Date')

                    ,'Date'(MonthKey) = (SelYear - 1) * 100 + 12

                    )

    ,ActualMK >= MinYearMonth

        && ActualMK <= MaxYearMonth

        ,CALCULATE((New Clients)

                            ,CROSSFILTER('Choice Date'(DateKey)

                                        ,'Date'(DateKey)

                                        ,None)

                                )

        ,BLANK()

    )

Dies ist das Ergebnis:

Über dem Wasserfalldiagramm sehen Sie die von der Maßnahme zurückgegebenen Zahlen.

Wie oben erwähnt, verwendet der Slicer in der oberen linken Ecke die Spalte des Jahres nicht aus der Tabelle „Datum“, sondern aus der Tabelle „Auswahldatum“. Das ist wichtig. Die Lösung funktioniert nicht, wenn die Spalte aus der Tabelle „Datum“ verwendet wird.

Abschluss

Das Visualwasserfall ist hervorragend, um die Änderung der Werte von einem Factor zum anderen zu zeigen. Ein Factor kann ein Monat oder etwas anderes sein. Sie können beispielsweise einen weiteren Artikel im Abschnitt Referenzen finden, in dem ich nachdecke, wie ein Datenmodell geändert wird, um einen Geschäftsprozess mit einem Wasserfall -Visible in Energy BI anzuzeigen.

Die hier gezeigte Lösung ist ein typisches Beispiel dafür, wo ich einen zuvor entwickelten Ansatz wiederverwendet habe, um eine neue Herausforderung anzugehen.

Das Schöne an diesem Ansatz ist, dass ich alle Maßnahmen mithilfe der „regulären“ Datums Tabelle ohne Einschränkung fortsetzen und die Tabelle „Auswahldatum“ verwenden kann, um dem Bericht mehr Funktionen hinzuzufügen.

In diesem Fall habe ich dem Wasserfalldiagramm eine Funktion hinzugefügt, die zuvor nicht verfügbar battle.

Ich werde nicht sagen, dass Sie immer zwei Date -Tabellen benötigen. Fügen Sie sie nur bei Bedarf hinzu. Es macht keinen Sinn, einem Datenmodell Tabellen nur zu fügen, um sie zu haben.

Referenzen

Hier ist mein Stück, in dem ich zeige, wie ich mein Datenmodell erweitert habe, um mehr Daten anzeigen als ausgewählt zu werden:

Hier, mein Stück, in dem ich erkläre, wie ich die Daten ändern kann, um einen Geschäftsprozess mit einem Wasserfalldiagramm anzuzeigen:

Wie in meinen vorherigen Artikeln verwende ich den Contoso -Beispiel -Datensatz. Sie können den ContoSoretailDW -Datensatz kostenlos von Microsoft herunterladen Hier.

Die Contoso -Daten können unter der MIT -Lizenz frei verwendet werden, wie beschrieben in diesem Dokument. Ich habe den Datensatz geändert, um die Daten auf zeitgenössische Daten zu verschieben.