juancwu/budgit
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

feat: transaction activity audit and account activity audit

Browse source
This commit is contained in:
juancwu 2026-05-03 23:50:39 +00:00
commit c96595d41e
19 changed files with 1259 additions and 20 deletions
Download patch file Download diff file Expand all files Collapse all files

238
internal/ui/pages/space_account_activity.templ Normal file
View file

@ -0,0 +1,238 @@
package pages
import "encoding/json"
import "fmt"
import "strings"
import "git.juancwu.dev/juancwu/budgit/internal/model"
import "git.juancwu.dev/juancwu/budgit/internal/routeurl"
import "git.juancwu.dev/juancwu/budgit/internal/ui/components/button"
import "git.juancwu.dev/juancwu/budgit/internal/ui/components/card"
import "git.juancwu.dev/juancwu/budgit/internal/ui/components/icon"
import "git.juancwu.dev/juancwu/budgit/internal/ui/components/pagination"
import "git.juancwu.dev/juancwu/budgit/internal/ui/layouts"
type SpaceAccountActivityPageProps struct {
SpaceID string
SpaceName string
AccountID string
AccountName string
Rows []model.AccountActivityRow
CurrentPage int
TotalPages int
TotalCount int
PerPage int
}
templ SpaceAccountActivityPage(props SpaceAccountActivityPageProps) {
@layouts.AppWithBreadcrumb(
"Account Activity",
accountChildBreadcrumb(props.SpaceID, props.SpaceName, props.AccountID, props.AccountName, "Activity"),
spaceOverviewSidebarContent(),
spaceSpecificSidebarContent(props.SpaceID),
spaceAccountSidebarContent(props.SpaceID, props.AccountID),
) {
<div class="container max-w-3xl px-6 py-8 mx-auto space-y-6">
<div class="flex items-center gap-2">
@button.Button(button.Props{
Variant: button.VariantGhost,
Size: button.SizeSm,
Href: routeurl.URL("page.app.spaces.space.accounts.account.overview", "spaceID", props.SpaceID, "accountID", props.AccountID),
Class: "flex items-center gap-1 -ml-2",
}) {
@icon.ChevronLeft(icon.Props{Class: "size-4"})
Back to account
}
</div>
<div>
<h1 class="text-3xl font-bold">Activity</h1>
<p class="text-muted-foreground mt-2">
Account changes and transaction history for { props.AccountName }.
</p>
</div>
@card.Card(card.Props{Class: "rounded-sm"}) {
@card.Content(card.ContentProps{Class: "p-0"}) {
if len(props.Rows) == 0 {
<p class="px-6 py-10 text-sm text-muted-foreground text-center">
No activity yet.
</p>
} else {
<ol class="divide-y">
for _, row := range props.Rows {
@accountActivityRow(props.SpaceID, props.AccountID, row)
}
</ol>
}
}
}
if props.TotalPages > 1 {
@accountActivityPagination(props)
}
</div>
}
}
templ accountActivityRow(spaceID, accountID string, row model.AccountActivityRow) {
if row.SpaceLog != nil {
<li class="flex gap-3 px-6 py-4">
<div class="w-9 h-9 shrink-0 rounded-full bg-muted flex items-center justify-center">
@activityIcon(row.SpaceLog.Action)
</div>
<div class="flex-1 min-w-0">
<p class="text-sm">
@templ.Raw(activityMessage(row.SpaceLog))
</p>
<p class="text-xs text-muted-foreground mt-1">
{ row.SpaceLog.CreatedAt.Format("Jan 2, 2006 · 3:04 PM") }
</p>
</div>
</li>
} else if row.TxLog != nil {
<li class="flex gap-3 px-6 py-4">
<div class="w-9 h-9 shrink-0 rounded-full bg-muted flex items-center justify-center">
@accountActivityTxIcon(row.TxLog.Action)
</div>
<div class="flex-1 min-w-0 space-y-1">
<p class="text-sm">
@templ.Raw(accountActivityTxMessage(spaceID, accountID, row.TxLog))
</p>
{{ changes := transactionActivityChanges(row.TxLog) }}
if len(changes) > 0 {
<ul class="text-xs text-muted-foreground space-y-0.5 mt-1">
for _, c := range changes {
<li>
@templ.Raw(c)
</li>
}
</ul>
}
<p class="text-xs text-muted-foreground">
{ row.TxLog.CreatedAt.Format("Jan 2, 2006 · 3:04 PM") }
</p>
</div>
</li>
}
}
templ accountActivityTxIcon(action model.TransactionAuditAction) {
switch action {
case model.TransactionAuditActionCreated:
@icon.Plus(icon.Props{Class: "size-4 text-muted-foreground"})
case model.TransactionAuditActionEdited:
@icon.Pencil(icon.Props{Class: "size-4 text-muted-foreground"})
case model.TransactionAuditActionDeleted:
@icon.Trash2(icon.Props{Class: "size-4 text-destructive"})
default:
@icon.History(icon.Props{Class: "size-4 text-muted-foreground"})
}
}
func transactionTypeLabel(t string) string {
switch t {
case string(model.TransactionTypeDeposit):
return "deposit"
case string(model.TransactionTypeWithdrawal):
return "bill"
default:
return "transaction"
}
}
// accountActivityTxMessage formats a transaction-level audit entry for the account
// activity feed. For created/deleted, it includes the transaction type and title.
// For created/edited entries (where the transaction still exists), the title links
// to the transaction detail page.
func accountActivityTxMessage(spaceID, accountID string, log *model.TransactionAuditLogWithActor) string {
actor := bold(txActorLabel(log))
switch log.Action {
case model.TransactionAuditActionCreated:
var meta struct {
TransactionType string `json:"transaction_type"`
Title string `json:"title"`
Amount string `json:"amount"`
}
_ = json.Unmarshal(log.Metadata, &meta)
title := meta.Title
if title == "" {
title = "a transaction"
}
titleHTML := transactionTitleLink(spaceID, accountID, log.TransactionID, title)
amountSuffix := ""
if meta.Amount != "" {
amountSuffix = fmt.Sprintf(" for $%s", templEscape(meta.Amount))
}
return fmt.Sprintf("%s added a %s %s%s.",
actor, templEscape(transactionTypeLabel(meta.TransactionType)), titleHTML, amountSuffix)
case model.TransactionAuditActionEdited:
var meta struct {
Changes map[string]any `json:"changes"`
}
_ = json.Unmarshal(log.Metadata, &meta)
titleHTML := transactionTitleLink(spaceID, accountID, log.TransactionID, "a transaction")
return fmt.Sprintf("%s edited %s.", actor, titleHTML)
case model.TransactionAuditActionDeleted:
var meta struct {
TransactionType string `json:"transaction_type"`
Title string `json:"title"`
}
_ = json.Unmarshal(log.Metadata, &meta)
title := meta.Title
if title == "" {
title = "a transaction"
}
return fmt.Sprintf("%s deleted the %s %s.",
actor, templEscape(transactionTypeLabel(meta.TransactionType)), bold(title))
default:
return fmt.Sprintf("%s performed %s.", actor, bold(string(log.Action)))
}
}
func transactionTitleLink(spaceID, accountID, transactionID, title string) string {
href := routeurl.URL("page.app.spaces.space.accounts.account.transactions.transaction",
"spaceID", spaceID, "accountID", accountID, "transactionID", transactionID)
var b strings.Builder
b.WriteString(`<a class="font-semibold underline-offset-2 hover:underline" href="`)
b.WriteString(templEscape(href))
b.WriteString(`">`)
b.WriteString(templEscape(title))
b.WriteString(`</a>`)
return b.String()
}
func accountActivityPageURL(spaceID, accountID string, page int) string {
return fmt.Sprintf("%s?page=%d",
routeurl.URL("page.app.spaces.space.accounts.account.activity",
"spaceID", spaceID, "accountID", accountID), page)
}
templ accountActivityPagination(props SpaceAccountActivityPageProps) {
{{ p := pagination.CreatePagination(props.CurrentPage, props.TotalPages, 5) }}
@pagination.Pagination() {
@pagination.Content() {
@pagination.Item() {
@pagination.Previous(pagination.PreviousProps{
Href: accountActivityPageURL(props.SpaceID, props.AccountID, p.CurrentPage-1),
Disabled: !p.HasPrevious,
Label: "Previous",
})
}
for _, page := range p.Pages {
@pagination.Item() {
@pagination.Link(pagination.LinkProps{
Href: accountActivityPageURL(props.SpaceID, props.AccountID, page),
IsActive: page == p.CurrentPage,
}) {
{ fmt.Sprintf("%d", page) }
}
}
}
@pagination.Item() {
@pagination.Next(pagination.NextProps{
Href: accountActivityPageURL(props.SpaceID, props.AccountID, p.CurrentPage+1),
Disabled: !p.HasNext,
Label: "Next",
})
}
}
}
}

34
internal/ui/pages/space_activity.templ
View file

@ -87,6 +87,12 @@ templ activityIcon(action model.SpaceAuditAction) {
@icon.UserMinus(icon.Props{Class: "size-4 text-muted-foreground"})
case model.SpaceAuditActionInviteCancelled:
@icon.X(icon.Props{Class: "size-4 text-muted-foreground"})
case model.SpaceAuditActionAccountCreated:
@icon.Plus(icon.Props{Class: "size-4 text-muted-foreground"})
case model.SpaceAuditActionAccountRenamed:
@icon.Pencil(icon.Props{Class: "size-4 text-muted-foreground"})
case model.SpaceAuditActionAccountDeleted:
@icon.Trash2(icon.Props{Class: "size-4 text-destructive"})
default:
@icon.History(icon.Props{Class: "size-4 text-muted-foreground"})
}
@ -148,6 +154,34 @@ func activityMessage(log *model.SpaceAuditLogWithActor) string {
return fmt.Sprintf("%s removed %s from the space.", actor, target)
case model.SpaceAuditActionInviteCancelled:
return fmt.Sprintf("%s cancelled the invitation for %s.", actor, target)
case model.SpaceAuditActionAccountCreated:
var meta struct {
AccountName string `json:"account_name"`
}
_ = json.Unmarshal(log.Metadata, &meta)
name := meta.AccountName
if name == "" {
name = "an account"
}
return fmt.Sprintf("%s created the account %s.", actor, bold(name))
case model.SpaceAuditActionAccountRenamed:
var meta struct {
OldName string `json:"old_name"`
NewName string `json:"new_name"`
}
_ = json.Unmarshal(log.Metadata, &meta)
return fmt.Sprintf("%s renamed account %s to %s.",
actor, bold(meta.OldName), bold(meta.NewName))
case model.SpaceAuditActionAccountDeleted:
var meta struct {
AccountName string `json:"account_name"`
}
_ = json.Unmarshal(log.Metadata, &meta)
name := meta.AccountName
if name == "" {
name = "an account"
}
return fmt.Sprintf("%s deleted the account %s.", actor, bold(name))
default:
return fmt.Sprintf("%s performed %s.", actor, bold(string(log.Action)))
}

10
internal/ui/pages/space_overview.templ
View file

@ -144,6 +144,16 @@ templ spaceAccountSidebarContent(spaceID, accountID string) {
<span>Deposit Funds</span>
}
}
@sidebar.MenuItem() {
@sidebar.MenuButton(sidebar.MenuButtonProps{
Href: routeurl.URL("page.app.spaces.space.accounts.account.activity", "spaceID", spaceID, "accountID", accountID),
IsActive: ctxkeys.URLPath(ctx) == routeurl.URL("page.app.spaces.space.accounts.account.activity", "spaceID", spaceID, "accountID", accountID),
Tooltip: "Account Activity",
}) {
@icon.History()
<span>Activity</span>
}
}
@sidebar.MenuItem() {
@sidebar.MenuButton(sidebar.MenuButtonProps{
Href: routeurl.URL("page.app.spaces.space.accounts.account.settings", "spaceID", spaceID, "accountID", accountID),

43
internal/ui/pages/space_transaction.templ
View file

@ -9,12 +9,14 @@ import "git.juancwu.dev/juancwu/budgit/internal/ui/layouts"
import "git.juancwu.dev/juancwu/budgit/internal/ui/utils"
type SpaceTransactionPageProps struct {
SpaceID string
SpaceName string
AccountID string
AccountName string
Transaction *model.Transaction
CategoryName string
SpaceID string
SpaceName string
AccountID string
AccountName string
Transaction *model.Transaction
CategoryName string
RecentAuditLogs []*model.TransactionAuditLogWithActor
AuditLogCount int
}
templ SpaceTransactionPage(props SpaceTransactionPageProps) {
@ -100,6 +102,35 @@ templ SpaceTransactionPage(props SpaceTransactionPageProps) {
}
}
}
@card.Card() {
@card.Header() {
<div class="flex items-center justify-between">
<h2 class="text-lg font-semibold">Recent activity</h2>
if props.AuditLogCount > 0 {
@button.Button(button.Props{
Variant: button.VariantLink,
Size: button.SizeSm,
Href: routeurl.URL("page.app.spaces.space.accounts.account.transactions.transaction.activity", "spaceID", props.SpaceID, "accountID", props.AccountID, "transactionID", props.Transaction.ID),
}) {
View all activity
}
}
</div>
}
@card.Content(card.ContentProps{Class: "p-0"}) {
if len(props.RecentAuditLogs) == 0 {
<p class="px-6 py-8 text-sm text-muted-foreground text-center">
No edits yet.
</p>
} else {
<ol class="divide-y">
for _, log := range props.RecentAuditLogs {
@transactionActivityRow(log)
}
</ol>
}
}
}
</div>
}
}

235
internal/ui/pages/space_transaction_activity.templ Normal file
View file

@ -0,0 +1,235 @@
package pages
import "encoding/json"
import "fmt"
import "git.juancwu.dev/juancwu/budgit/internal/model"
import "git.juancwu.dev/juancwu/budgit/internal/routeurl"
import "git.juancwu.dev/juancwu/budgit/internal/ui/components/button"
import "git.juancwu.dev/juancwu/budgit/internal/ui/components/card"
import "git.juancwu.dev/juancwu/budgit/internal/ui/components/icon"
import "git.juancwu.dev/juancwu/budgit/internal/ui/components/pagination"
import "git.juancwu.dev/juancwu/budgit/internal/ui/layouts"
type SpaceTransactionActivityPageProps struct {
SpaceID string
SpaceName string
AccountID string
AccountName string
TransactionID string
TransactionName string
Logs []*model.TransactionAuditLogWithActor
CurrentPage int
TotalPages int
TotalCount int
PerPage int
}
templ SpaceTransactionActivityPage(props SpaceTransactionActivityPageProps) {
@layouts.AppWithBreadcrumb(
"Transaction Activity",
accountChildBreadcrumb(props.SpaceID, props.SpaceName, props.AccountID, props.AccountName, props.TransactionName+" · Activity"),
spaceOverviewSidebarContent(),
spaceSpecificSidebarContent(props.SpaceID),
spaceAccountSidebarContent(props.SpaceID, props.AccountID),
) {
<div class="container max-w-3xl px-6 py-8 mx-auto space-y-6">
<div class="flex items-center gap-2">
@button.Button(button.Props{
Variant: button.VariantGhost,
Size: button.SizeSm,
Href: routeurl.URL("page.app.spaces.space.accounts.account.transactions.transaction", "spaceID", props.SpaceID, "accountID", props.AccountID, "transactionID", props.TransactionID),
Class: "flex items-center gap-1 -ml-2",
}) {
@icon.ChevronLeft(icon.Props{Class: "size-4"})
Back to transaction
}
</div>
<div>
<h1 class="text-3xl font-bold">Activity</h1>
<p class="text-muted-foreground mt-2">
An audit log of edits to { props.TransactionName }.
</p>
</div>
@card.Card(card.Props{Class: "rounded-sm"}) {
@card.Content(card.ContentProps{Class: "p-0"}) {
if len(props.Logs) == 0 {
<p class="px-6 py-10 text-sm text-muted-foreground text-center">
No activity yet.
</p>
} else {
<ol class="divide-y">
for _, log := range props.Logs {
@transactionActivityRow(log)
}
</ol>
}
}
}
if props.TotalPages > 1 {
@transactionActivityPagination(props)
}
</div>
}
}
templ transactionActivityRow(log *model.TransactionAuditLogWithActor) {
<li class="flex gap-3 px-6 py-4">
<div class="w-9 h-9 shrink-0 rounded-full bg-muted flex items-center justify-center">
@transactionActivityIcon(log.Action)
</div>
<div class="flex-1 min-w-0 space-y-1">
<p class="text-sm">
@templ.Raw(transactionActivityMessage(log))
</p>
{{ changes := transactionActivityChanges(log) }}
if len(changes) > 0 {
<ul class="text-xs text-muted-foreground space-y-0.5 mt-1">
for _, c := range changes {
<li>
@templ.Raw(c)
</li>
}
</ul>
}
<p class="text-xs text-muted-foreground">
{ log.CreatedAt.Format("Jan 2, 2006 · 3:04 PM") }
</p>
</div>
</li>
}
templ transactionActivityIcon(action model.TransactionAuditAction) {
switch action {
case model.TransactionAuditActionEdited:
@icon.Pencil(icon.Props{Class: "size-4 text-muted-foreground"})
default:
@icon.History(icon.Props{Class: "size-4 text-muted-foreground"})
}
}
func txActorLabel(log *model.TransactionAuditLogWithActor) string {
if log.ActorName != nil && *log.ActorName != "" {
return *log.ActorName
}
if log.ActorEmail != nil && *log.ActorEmail != "" {
return *log.ActorEmail
}
return "Someone"
}
func transactionActivityMessage(log *model.TransactionAuditLogWithActor) string {
actor := bold(txActorLabel(log))
switch log.Action {
case model.TransactionAuditActionEdited:
return fmt.Sprintf("%s edited the transaction.", actor)
default:
return fmt.Sprintf("%s performed %s.", actor, bold(string(log.Action)))
}
}
// transactionActivityChanges parses the metadata for a transaction edit and returns
// a list of pre-escaped HTML fragments describing each changed field.
func transactionActivityChanges(log *model.TransactionAuditLogWithActor) []string {
if log.Action != model.TransactionAuditActionEdited || len(log.Metadata) == 0 {
return nil
}
var meta struct {
Changes map[string]struct {
Old any `json:"old"`
New any `json:"new"`
} `json:"changes"`
}
if err := json.Unmarshal(log.Metadata, &meta); err != nil {
return nil
}
if len(meta.Changes) == 0 {
return nil
}
order := []string{"title", "amount", "occurred_at", "description", "category_id"}
labels := map[string]string{
"title": "Title",
"amount": "Amount",
"occurred_at": "Date",
"description": "Description",
"category_id": "Category",
}
var out []string
emit := func(field string) {
change, ok := meta.Changes[field]
if !ok {
return
}
if field == "category_id" {
out = append(out, fmt.Sprintf("%s changed.", templEscape(labels[field])))
return
}
oldStr := fmt.Sprintf("%v", change.Old)
newStr := fmt.Sprintf("%v", change.New)
if oldStr == "" {
oldStr = "(empty)"
}
if newStr == "" {
newStr = "(empty)"
}
out = append(out, fmt.Sprintf("%s: %s → %s",
templEscape(labels[field]), bold(oldStr), bold(newStr)))
}
seen := map[string]bool{}
for _, f := range order {
emit(f)
seen[f] = true
}
for f := range meta.Changes {
if !seen[f] {
label := f
if l, ok := labels[f]; ok {
label = l
}
change := meta.Changes[f]
out = append(out, fmt.Sprintf("%s: %s → %s",
templEscape(label),
bold(fmt.Sprintf("%v", change.Old)),
bold(fmt.Sprintf("%v", change.New))))
}
}
return out
}
func transactionActivityPageURL(spaceID, accountID, transactionID string, page int) string {
return fmt.Sprintf("%s?page=%d",
routeurl.URL("page.app.spaces.space.accounts.account.transactions.transaction.activity",
"spaceID", spaceID, "accountID", accountID, "transactionID", transactionID), page)
}
templ transactionActivityPagination(props SpaceTransactionActivityPageProps) {
{{ p := pagination.CreatePagination(props.CurrentPage, props.TotalPages, 5) }}
@pagination.Pagination() {
@pagination.Content() {
@pagination.Item() {
@pagination.Previous(pagination.PreviousProps{
Href: transactionActivityPageURL(props.SpaceID, props.AccountID, props.TransactionID, p.CurrentPage-1),
Disabled: !p.HasPrevious,
Label: "Previous",
})
}
for _, page := range p.Pages {
@pagination.Item() {
@pagination.Link(pagination.LinkProps{
Href: transactionActivityPageURL(props.SpaceID, props.AccountID, props.TransactionID, page),
IsActive: page == p.CurrentPage,
}) {
{ fmt.Sprintf("%d", page) }
}
}
}
@pagination.Item() {
@pagination.Next(pagination.NextProps{
Href: transactionActivityPageURL(props.SpaceID, props.AccountID, props.TransactionID, p.CurrentPage+1),
Disabled: !p.HasNext,
Label: "Next",
})
}
}
}
}