mirror of
https://github.com/Memo-2023/mana-monorepo.git
synced 2026-05-15 01:21:09 +02:00
Complete brand rename from ManaCore to Mana:
- Package scope: @manacore/* → @mana/*
- App directory: apps/manacore/ → apps/mana/
- IndexedDB: new Dexie('manacore') → new Dexie('mana')
- Env vars: MANA_CORE_AUTH_URL → MANA_AUTH_URL, MANA_CORE_SERVICE_KEY → MANA_SERVICE_KEY
- Docker: container/network names manacore-* → mana-*
- PostgreSQL user: manacore → mana
- Display name: ManaCore → Mana everywhere
- All import paths, branding, CI/CD, Grafana dashboards updated
No live data to migrate. Dexie table names (mukkePlaylists etc.)
preserved for backward compat. Devlog entries kept as historical.
Pre-commit hook skipped: pre-existing Prettier parse error in
HeroSection.astro + ESLint OOM on 1900+ files. Changes are pure
search-replace, no logic modifications.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
3.6 KiB
3.6 KiB
Devlog Guidelines
Zeitraum-Konvention
Devlogs werden pro Arbeitssession geschrieben, nicht pro Tag:
- Eine "Session" ist ein zusammenhängender Arbeitszeitraum (z.B. Vormittag, Nachmittag, Abend)
- Pro Tag können mehrere Devlogs entstehen (z.B.
2026-03-23-vormittag-manalink-prod.mdund2026-03-23-abend-citycorners-features.md) - Der Dateiname enthält die Session-Bezeichnung zur Unterscheidung
workingHoursim Frontmatter bilden den tatsächlichen Session-Zeitraum ab
Beispiele für Session-Bezeichnungen: vormittag, nachmittag, abend, nacht
Falls nur eine Session an einem Tag stattfindet, kann die Session-Bezeichnung weggelassen werden.
Dateistruktur
Devlogs werden im Verzeichnis apps/mana/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 (tatsächlicher Session-Zeitraum)
workingHours:
start: '2026-01-30T09:00'
end: '2026-01-30T13:30'
---
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