mirror of https://github.com/Memo-2023/mana-monorepo.git synced 2026-05-15 01:21:09 +02:00

Till-JS f4c2663122 ✨ feat(devlog): add activity grid page and extended stats

Add GitHub-style activity grid showing development contributions:
- Activity grid with color-coded commit intensity
- Total stats: commits, files changed, lines added/removed
- Contributors section with commit counts
- Recent activity list

Extended devlog schema with:
- stats: filesChanged, linesAdded, linesRemoved
- contributors: name, handle, commits per contributor
- workingHours: start/end timestamps

Updated all 9 devlogs with accurate git stats.
Added link to activity page from devlog index.

2026-02-13 12:07:23 +01:00

3.3 KiB

Raw Blame History

Devlog Guidelines

Zeitraum-Konvention

Arbeitstage werden wie folgt definiert:

Ein "Arbeitstag" beginnt um 11:00 Uhr und endet um 11:00 Uhr des Folgetages
Beispiel: Der Devlog für "2026-01-30" umfasst alle Commits von 30.01. 11:00 bis 31.01. 10:59

Diese Konvention ermöglicht es, Nachtarbeit dem richtigen Tag zuzuordnen.

Dateistruktur

Devlogs werden im Verzeichnis apps/manacore/apps/landing/src/content/devlog/ gespeichert.

Dateiname-Format: YYYY-MM-DD-kurze-beschreibung.md

Beispiel: 2026-01-30-matrix-bots-llm-playground.md

Frontmatter Schema

---
title: 'Titel des Devlogs'
description: 'Kurze Beschreibung der wichtigsten Änderungen (max. 2 Sätze)'
date: YYYY-MM-DD
author: 'Till Schneider'
category: 'feature' # release | infrastructure | feature | bugfix | update
tags:
  [
    'tag1',
    'tag2',
    'tag3',
  ]
featured: true # oder false
commits: 42 # Anzahl der Commits an diesem Tag
readTime: 15 # Geschätzte Lesezeit in Minuten

# Extended Stats für Aktivitätsgrid
stats:
  filesChanged: 289
  linesAdded: 17857
  linesRemoved: 2113

# Contributors (wer hat an diesem Tag gearbeitet)
contributors:
  - name: 'Till Schneider'
    handle: 'Till-JS'
    commits: 42

# Working Hours (für Aktivitätsgrid)
workingHours:
  start: '2026-01-30T11:00'
  end: '2026-01-31T11:00'
---

Kategorien

Kategorie	Verwendung
`release`	Neue Versionen, Production Deployments
`infrastructure`	Server-Setup, DevOps, Docker, CI/CD
`feature`	Neue Features, Apps, Services
`bugfix`	Fehlerbehebungen
`update`	Allgemeine Updates, Refactoring, Dependencies

Inhalt-Struktur

Einleitung - Kurze Zusammenfassung mit Bullet Points der Hauptthemen
Hauptsektionen - Detaillierte Beschreibung der Features/Änderungen
Bugfixes (optional) - Tabelle der behobenen Fehler
Zusammenfassung - Tabelle mit Bereichen, Commit-Anzahl und Highlights
Nächste Schritte - Was als nächstes geplant ist

Git-Stats abrufen

# Commits für einen Arbeitstag zählen (11:00 - 11:00 des Folgetages)
git log --since="YYYY-MM-DD 11:00" --until="YYYY-MM-DD+1 11:00" --oneline | wc -l

# Detaillierte Stats (files, insertions, deletions)
git log --since="YYYY-MM-DD 11:00" --until="YYYY-MM-DD+1 11:00" --shortstat --format="" | \
  awk '{files+=$1; ins+=$4; del+=$6} END {print "files:", files, "insertions:", ins, "deletions:", del}'

Aktivitätsgrid

Die Aktivitätsgrid-Seite ist unter /devlog/activity erreichbar und zeigt:

GitHub-Style Contribution Grid - Aktivität der letzten 365 Tage
Gesamt-Statistiken - Commits, Dateien, Lines Added/Removed
Contributors - Wer hat wie viel beigetragen
Letzte Aktivität - Die 5 neuesten Devlogs

Best Practices

Technische Details mit Code-Beispielen und Architektur-Diagrammen illustrieren
Tabellen für Feature-Listen und API-Endpunkte verwenden
ASCII-Diagramme für Architektur-Übersichten
Deutsche Sprache für den Content (technische Begriffe auf Englisch)
Tags sollten alle relevanten Technologien und Features abdecken

3.3 KiB Raw Blame History