feat(kanban): stickers feature + dashboard null guards (#0063)

- backend: Sticker type, idempotent stickers column, PUT /api/cards/:id/stickers, 4 tests
- frontend: emoji-mart picker, toolbar button + ESC, draggable overlay with right-click delete, % coords for resize survival
- dashboard: null guards on metrics arrays

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-05-08 21:00:30 +02:00
parent 2a727eb7c1
commit 656516f219
12 changed files with 552 additions and 46 deletions
+76 -20
View File
@@ -27,23 +27,30 @@ type Column struct {
CreatedAt string `json:"created_at"`
}
type Sticker struct {
Emoji string `json:"emoji"`
X float64 `json:"x"`
Y float64 `json:"y"`
}
type Card struct {
ID string `json:"id"`
Requester string `json:"requester"`
Title string `json:"title"`
Description string `json:"description"`
Color string `json:"color"`
ColumnID string `json:"column_id"`
Position int `json:"position"`
Locked bool `json:"locked"`
AssigneeID *string `json:"assignee_id"`
CompletedAt *string `json:"completed_at"`
DeletedAt *string `json:"deleted_at"`
Tags []string `json:"tags"`
CreatedAt string `json:"created_at"`
UpdatedAt string `json:"updated_at"`
EnteredAt string `json:"entered_at"`
TimeInColumn int64 `json:"time_in_column_ms"`
ID string `json:"id"`
Requester string `json:"requester"`
Title string `json:"title"`
Description string `json:"description"`
Color string `json:"color"`
ColumnID string `json:"column_id"`
Position int `json:"position"`
Locked bool `json:"locked"`
AssigneeID *string `json:"assignee_id"`
CompletedAt *string `json:"completed_at"`
DeletedAt *string `json:"deleted_at"`
Tags []string `json:"tags"`
Stickers []Sticker `json:"stickers"`
CreatedAt string `json:"created_at"`
UpdatedAt string `json:"updated_at"`
EnteredAt string `json:"entered_at"`
TimeInColumn int64 `json:"time_in_column_ms"`
}
type HistoryEntry struct {
@@ -106,6 +113,7 @@ func ensureColumns(conn *sql.DB) error {
{"cards", "completed_at", "TEXT"},
{"cards", "deleted_at", "TEXT"},
{"cards", "tags", "TEXT NOT NULL DEFAULT '[]'"},
{"cards", "stickers", "TEXT NOT NULL DEFAULT '[]'"},
{"card_column_history", "actor_id", "TEXT"},
{"card_lock_history", "actor_id", "TEXT"},
}
@@ -195,6 +203,49 @@ func encodeTags(in []string) string {
return string(b)
}
func parseStickers(s string) []Sticker {
out := []Sticker{}
if s == "" {
return out
}
if err := json.Unmarshal([]byte(s), &out); err != nil {
return []Sticker{}
}
return out
}
func clamp01(v float64) float64 {
if v < 0 {
return 0
}
if v > 1 {
return 1
}
return v
}
func normalizeStickers(in []Sticker) []Sticker {
out := make([]Sticker, 0, len(in))
for _, s := range in {
emoji := strings.TrimSpace(s.Emoji)
if emoji == "" {
continue
}
out = append(out, Sticker{Emoji: emoji, X: clamp01(s.X), Y: clamp01(s.Y)})
}
return out
}
func encodeStickers(in []Sticker) string {
b, _ := json.Marshal(normalizeStickers(in))
return string(b)
}
func (db *DB) UpdateStickers(id string, stickers []Sticker) error {
_, err := db.conn.Exec(`UPDATE cards SET stickers=?, updated_at=? WHERE id=?`, encodeStickers(stickers), nowRFC3339(), id)
return err
}
func (db *DB) ListAllTags() ([]string, error) {
rows, err := db.conn.Query(`SELECT DISTINCT tags FROM cards WHERE deleted_at IS NULL`)
if err != nil {
@@ -378,7 +429,7 @@ func (db *DB) ReorderColumns(ids []string) error {
func (db *DB) ListCardsWithTime() ([]Card, error) {
rows, err := db.conn.Query(`
SELECT c.id, c.requester, c.title, c.description, c.color, c.column_id, c.position, c.locked, c.assignee_id, c.completed_at, c.deleted_at, c.tags, c.created_at, c.updated_at,
SELECT c.id, c.requester, c.title, c.description, c.color, c.column_id, c.position, c.locked, c.assignee_id, c.completed_at, c.deleted_at, c.tags, c.stickers, c.created_at, c.updated_at,
h.entered_at
FROM cards c
LEFT JOIN card_column_history h
@@ -399,10 +450,12 @@ func (db *DB) ListCardsWithTime() ([]Card, error) {
var completed sql.NullString
var deleted sql.NullString
var tagsJSON string
var stickersJSON string
var locked int
if err := rows.Scan(&c.ID, &c.Requester, &c.Title, &c.Description, &c.Color, &c.ColumnID, &c.Position, &locked, &assignee, &completed, &deleted, &tagsJSON, &c.CreatedAt, &c.UpdatedAt, &entered); err != nil {
if err := rows.Scan(&c.ID, &c.Requester, &c.Title, &c.Description, &c.Color, &c.ColumnID, &c.Position, &locked, &assignee, &completed, &deleted, &tagsJSON, &stickersJSON, &c.CreatedAt, &c.UpdatedAt, &entered); err != nil {
return nil, err
}
c.Stickers = parseStickers(stickersJSON)
c.Locked = locked != 0
if assignee.Valid && assignee.String != "" {
s := assignee.String
@@ -441,6 +494,7 @@ func (db *DB) CreateCard(columnID, requester, title, description, actorID string
c := Card{
ID: newID(), Requester: requester, Title: title, Description: description, ColumnID: columnID, Position: pos,
Tags: []string{},
Stickers: []Sticker{},
CreatedAt: now, UpdatedAt: now, EnteredAt: now,
}
tx, err := db.conn.Begin()
@@ -589,7 +643,7 @@ func (db *DB) PurgeCard(id string) error {
// ListDeletedCards returns cards in the trash, newest first.
func (db *DB) ListDeletedCards() ([]Card, error) {
rows, err := db.conn.Query(`
SELECT c.id, c.requester, c.title, c.description, c.color, c.column_id, c.position, c.locked, c.assignee_id, c.completed_at, c.deleted_at, c.tags, c.created_at, c.updated_at
SELECT c.id, c.requester, c.title, c.description, c.color, c.column_id, c.position, c.locked, c.assignee_id, c.completed_at, c.deleted_at, c.tags, c.stickers, c.created_at, c.updated_at
FROM cards c
WHERE c.deleted_at IS NOT NULL
ORDER BY c.deleted_at DESC
@@ -605,10 +659,12 @@ func (db *DB) ListDeletedCards() ([]Card, error) {
var completed sql.NullString
var deleted sql.NullString
var tagsJSON string
var stickersJSON string
var locked int
if err := rows.Scan(&c.ID, &c.Requester, &c.Title, &c.Description, &c.Color, &c.ColumnID, &c.Position, &locked, &assignee, &completed, &deleted, &tagsJSON, &c.CreatedAt, &c.UpdatedAt); err != nil {
if err := rows.Scan(&c.ID, &c.Requester, &c.Title, &c.Description, &c.Color, &c.ColumnID, &c.Position, &locked, &assignee, &completed, &deleted, &tagsJSON, &stickersJSON, &c.CreatedAt, &c.UpdatedAt); err != nil {
return nil, err
}
c.Stickers = parseStickers(stickersJSON)
c.Locked = locked != 0
if assignee.Valid && assignee.String != "" {
s := assignee.String
+3
View File
@@ -12,6 +12,8 @@
"@dnd-kit/core": "^6.3.1",
"@dnd-kit/sortable": "^10.0.0",
"@dnd-kit/utilities": "^3.2.2",
"@emoji-mart/data": "^1.2.1",
"@emoji-mart/react": "^1.1.1",
"@mantine/charts": "^9.1.1",
"@mantine/core": "^9.0.2",
"@mantine/dates": "^9.1.1",
@@ -20,6 +22,7 @@
"@mantine/notifications": "^9.0.2",
"@tabler/icons-react": "^3.31.0",
"dayjs": "^1.11.20",
"emoji-mart": "^5.6.0",
"react": "^19.1.0",
"react-dom": "^19.1.0",
"react-markdown": "^10.1.0",
+30
View File
@@ -17,6 +17,12 @@ importers:
'@dnd-kit/utilities':
specifier: ^3.2.2
version: 3.2.2(react@19.2.5)
'@emoji-mart/data':
specifier: ^1.2.1
version: 1.2.1
'@emoji-mart/react':
specifier: ^1.1.1
version: 1.1.1(emoji-mart@5.6.0)(react@19.2.5)
'@mantine/charts':
specifier: ^9.1.1
version: 9.1.1(@mantine/core@9.1.1(@mantine/hooks@9.1.1(react@19.2.5))(@types/react@19.2.14)(react-dom@19.2.5(react@19.2.5))(react@19.2.5))(@mantine/hooks@9.1.1(react@19.2.5))(react-dom@19.2.5(react@19.2.5))(react@19.2.5)(recharts@2.15.4(react-dom@19.2.5(react@19.2.5))(react@19.2.5))
@@ -41,6 +47,9 @@ importers:
dayjs:
specifier: ^1.11.20
version: 1.11.20
emoji-mart:
specifier: ^5.6.0
version: 5.6.0
react:
specifier: ^19.1.0
version: 19.2.5
@@ -190,6 +199,15 @@ packages:
peerDependencies:
react: '>=16.8.0'
'@emoji-mart/data@1.2.1':
resolution: {integrity: sha512-no2pQMWiBy6gpBEiqGeU77/bFejDqUTRY7KX+0+iur13op3bqUsXdnwoZs6Xb1zbv0gAj5VvS1PWoUUckSr5Dw==}
'@emoji-mart/react@1.1.1':
resolution: {integrity: sha512-NMlFNeWgv1//uPsvLxvGQoIerPuVdXwK/EUek8OOkJ6wVOWPUizRBJU0hDqWZCOROVpfBgCemaC3m6jDOXi03g==}
peerDependencies:
emoji-mart: ^5.2
react: ^16.8 || ^17 || ^18
'@esbuild/aix-ppc64@0.25.12':
resolution: {integrity: sha512-Hhmwd6CInZ3dwpuGTF8fJG6yoWmsToE+vYgD4nytZVxcu1ulHpUQRAB1UJ8+N1Am3Mz4+xOByoQoSZf4D+CpkA==}
engines: {node: '>=18'}
@@ -781,6 +799,9 @@ packages:
electron-to-chromium@1.5.351:
resolution: {integrity: sha512-9D7Iqx8RImSvCnOsj86rCH6eQjZFQoM04Jn6HnZVM0Nu/G58/gmKYQ1d12MZTbjQbQSTGI8nwEy07ErsA2slLA==}
emoji-mart@5.6.0:
resolution: {integrity: sha512-eJp3QRe79pjwa+duv+n7+5YsNhRcMl812EcFVwrnRvYKoNPoQb5qxU8DG6Bgwji0akHdp6D4Ln6tYLG58MFSow==}
esbuild@0.25.12:
resolution: {integrity: sha512-bbPBYYrtZbkt6Os6FiTLCTFxvq4tt3JKall1vRwshA3fdVztsLAatFaZobhkBC8/BrPetoa0oksYoKXoG4ryJg==}
engines: {node: '>=18'}
@@ -1491,6 +1512,13 @@ snapshots:
react: 19.2.5
tslib: 2.8.1
'@emoji-mart/data@1.2.1': {}
'@emoji-mart/react@1.1.1(emoji-mart@5.6.0)(react@19.2.5)':
dependencies:
emoji-mart: 5.6.0
react: 19.2.5
'@esbuild/aix-ppc64@0.25.12':
optional: true
@@ -1943,6 +1971,8 @@ snapshots:
electron-to-chromium@1.5.351: {}
emoji-mart@5.6.0: {}
esbuild@0.25.12:
optionalDependencies:
'@esbuild/aix-ppc64': 0.25.12
+117
View File
@@ -56,6 +56,7 @@ import {
IconLogout,
IconMenu2,
IconMessageChatbot,
IconMoodSmile,
IconPlus,
IconRefresh,
IconSearch,
@@ -73,6 +74,7 @@ import { Dashboard } from "./components/Dashboard";
import { HistoryModal } from "./components/HistoryModal";
import { KanbanCard } from "./components/KanbanCard";
import { KanbanColumn } from "./components/KanbanColumn";
import { StickerPicker } from "./components/StickerPicker";
import { colorBg, colorBorder } from "./components/colors";
import type { Board, Card, CardColor, Column, ColumnLocation, User } from "./types";
@@ -122,6 +124,8 @@ export function App() {
const [filterUnassigned, setFilterUnassigned] = useState(false);
const [filterDateFrom, setFilterDateFrom] = useState<Date | null>(null);
const [filterDateTo, setFilterDateTo] = useState<Date | null>(null);
const [stickerPickerOpen, setStickerPickerOpen] = useState(false);
const [activeSticker, setActiveSticker] = useState<string | null>(null);
const [navOpen, setNavOpen] = useState(false);
const [navWidth, setNavWidth] = useState<number>(() => {
const stored = localStorage.getItem("kanban_nav_width");
@@ -227,6 +231,15 @@ export function App() {
return () => clearInterval(t);
}, []);
useEffect(() => {
if (!activeSticker) return;
const onKey = (e: KeyboardEvent) => {
if (e.key === "Escape") setActiveSticker(null);
};
window.addEventListener("keydown", onKey);
return () => window.removeEventListener("keydown", onKey);
}, [activeSticker]);
const usersById = useMemo(() => {
const m = new Map<string, User>();
for (const u of users) m.set(u.id, u);
@@ -638,6 +651,73 @@ export function App() {
}
}, [reload]);
const persistStickers = useCallback(async (id: string, stickers: Card["stickers"]) => {
setBoard((prev) => {
if (!prev) return prev;
return { ...prev, cards: prev.cards.map((c) => (c.id === id ? { ...c, stickers } : c)) };
});
try {
await api.updateCardStickers(id, stickers);
} catch (e) {
notifications.show({ color: "red", message: (e as Error).message });
reload();
}
}, [reload]);
const handleAddSticker = useCallback((cardId: string, x: number, y: number) => {
if (!activeSticker) return;
setBoard((prev) => {
if (!prev) return prev;
const cards = prev.cards.map((c) => {
if (c.id !== cardId) return c;
const stickers = [...(c.stickers || []), { emoji: activeSticker, x, y }];
api.updateCardStickers(cardId, stickers).catch((e) => {
notifications.show({ color: "red", message: (e as Error).message });
reload();
});
return { ...c, stickers };
});
return { ...prev, cards };
});
}, [activeSticker, reload]);
const handleRemoveSticker = useCallback((cardId: string, index: number) => {
setBoard((prev) => {
if (!prev) return prev;
const cards = prev.cards.map((c) => {
if (c.id !== cardId) return c;
const stickers = (c.stickers || []).filter((_, i) => i !== index);
api.updateCardStickers(cardId, stickers).catch((e) => {
notifications.show({ color: "red", message: (e as Error).message });
reload();
});
return { ...c, stickers };
});
return { ...prev, cards };
});
}, [reload]);
const handleMoveSticker = useCallback((cardId: string, index: number, x: number, y: number) => {
setBoard((prev) => {
if (!prev) return prev;
const cards = prev.cards.map((c) => {
if (c.id !== cardId) return c;
const stickers = (c.stickers || []).map((s, i) => (i === index ? { ...s, x, y } : s));
return { ...c, stickers };
});
return { ...prev, cards };
});
}, []);
const handleCommitSticker = useCallback((cardId: string) => {
setBoard((prev) => {
if (!prev) return prev;
const card = prev.cards.find((c) => c.id === cardId);
if (card) persistStickers(cardId, card.stickers || []);
return prev;
});
}, [persistStickers]);
const handleShowHistory = useCallback((card: Card) => {
modals.open({
title: card.title,
@@ -843,6 +923,11 @@ export function App() {
onShowHistory={handleShowHistory}
onToggleCardLock={handleToggleCardLock}
onAssignCard={handleAssignCard}
activeSticker={activeSticker}
onAddSticker={handleAddSticker}
onRemoveSticker={handleRemoveSticker}
onMoveSticker={handleMoveSticker}
onCommitSticker={handleCommitSticker}
users={users}
usersById={usersById}
/>
@@ -1013,6 +1098,33 @@ export function App() {
setFilterDateTo(t);
}}>30d</Button>
</Group>
<StickerPicker
opened={stickerPickerOpen}
onClose={() => setStickerPickerOpen(false)}
onSelect={(emoji) => setActiveSticker(emoji)}
target={
<Button
size="xs"
variant={activeSticker ? "filled" : "default"}
color={activeSticker ? "yellow" : undefined}
leftSection={<IconMoodSmile size={14} />}
onClick={() => setStickerPickerOpen((v) => !v)}
>
{activeSticker ? `Modo sticker: ${activeSticker}` : "Stickers"}
</Button>
}
/>
{activeSticker && (
<Button
size="xs"
variant="subtle"
color="gray"
leftSection={<IconX size={12} />}
onClick={() => setActiveSticker(null)}
>
ESC
</Button>
)}
{filtersActive && (
<Button
size="xs"
@@ -1060,6 +1172,11 @@ export function App() {
onShowHistory={handleShowHistory}
onToggleCardLock={handleToggleCardLock}
onAssignCard={handleAssignCard}
activeSticker={activeSticker}
onAddSticker={handleAddSticker}
onRemoveSticker={handleRemoveSticker}
onMoveSticker={handleMoveSticker}
onCommitSticker={handleCommitSticker}
users={users}
usersById={usersById}
/>
+8
View File
@@ -5,6 +5,7 @@ import type {
Column,
Metrics,
MetricsFilter,
Sticker,
User,
} from "./types";
@@ -93,6 +94,13 @@ export function deleteCard(id: string): Promise<void> {
return fetchJSON(`/cards/${id}`, { method: "DELETE" });
}
export function updateCardStickers(id: string, stickers: Sticker[]): Promise<void> {
return fetchJSON(`/cards/${id}/stickers`, {
method: "PUT",
body: JSON.stringify({ stickers }),
});
}
export function listTrash(): Promise<Card[]> {
return fetchJSON("/trash");
}
+26 -21
View File
@@ -108,7 +108,7 @@ export function Dashboard({ users }: Props) {
setData(m);
setRequesterOptions((prev) => {
const set = new Set(prev);
for (const r of m.top_requesters) set.add(r.requester);
for (const r of m.top_requesters ?? []) set.add(r.requester);
return Array.from(set).sort();
});
})
@@ -128,7 +128,7 @@ export function Dashboard({ users }: Props) {
const cumulativeFlow = useMemo(() => {
if (!data) return [];
const arr = data.cumulative_flow;
const arr = data.cumulative_flow ?? [];
const firstIdx = arr.findIndex((p) => p.total > 0 || p.done > 0);
const sliced = firstIdx <= 0 ? arr : arr.slice(Math.max(0, firstIdx - 1));
return sliced.map((p) => ({
@@ -142,10 +142,10 @@ export function Dashboard({ users }: Props) {
const throughputSeries = useMemo(() => {
if (!data) return [];
const map = new Map<string, { date: string; completed: number; created: number }>();
for (const d of data.throughput_daily) {
for (const d of data.throughput_daily ?? []) {
map.set(d.date, { date: d.date, completed: d.count, created: 0 });
}
for (const d of data.created_daily) {
for (const d of data.created_daily ?? []) {
const cur = map.get(d.date) ?? { date: d.date, completed: 0, created: 0 };
cur.created = d.count;
map.set(d.date, cur);
@@ -155,7 +155,7 @@ export function Dashboard({ users }: Props) {
const byColumnSeries = useMemo(() => {
if (!data) return [];
return data.by_column.map((c) => ({
return (data.by_column ?? []).map((c) => ({
column: c.name + (c.is_done ? " ✓" : ""),
tarjetas: c.count,
}));
@@ -163,7 +163,7 @@ export function Dashboard({ users }: Props) {
const topAssigneeSeries = useMemo(() => {
if (!data) return [];
return data.top_assignees
return (data.top_assignees ?? [])
.slice()
.sort((a, b) => b.completed_in_range + b.active - (a.completed_in_range + a.active))
.slice(0, 8)
@@ -176,7 +176,7 @@ export function Dashboard({ users }: Props) {
const topRequesterSeries = useMemo(() => {
if (!data) return [];
return data.top_requesters.map((r) => ({
return (data.top_requesters ?? []).map((r) => ({
solicitante: r.requester,
activas: r.active,
completadas: r.completed_in_range,
@@ -185,7 +185,7 @@ export function Dashboard({ users }: Props) {
const movementsSeries = useMemo(() => {
if (!data) return [];
return data.movements_by_user
return (data.movements_by_user ?? [])
.filter((m) => m.moves > 0)
.slice(0, 8)
.map((m) => ({
@@ -249,41 +249,45 @@ export function Dashboard({ users }: Props) {
</Center>
)}
{data && (
{data && (() => {
const totals = data.totals ?? ({} as Metrics["totals"]);
const lead = data.lead_time ?? ({ n: 0, avg_ms: 0, p50_ms: 0, p90_ms: 0, p99_ms: 0 } as Metrics["lead_time"]);
const t = (k: keyof typeof totals) => totals[k] ?? 0;
return (
<>
<SimpleGrid cols={{ base: 2, md: 5 }} spacing="md">
<KPI
icon={<IconClipboardList size={14} />}
label="Totales"
value={data.totals.cards}
hint={`${data.totals.columns} columnas, ${data.totals.users} usuarios`}
value={t("cards")}
hint={`${t("columns")} columnas, ${t("users")} usuarios`}
/>
<KPI
icon={<IconClipboardList size={14} />}
label="Activas"
value={data.totals.cards_active}
value={t("cards_active")}
hint={`Sin completar`}
color="blue"
/>
<KPI
icon={<IconCheckbox size={14} />}
label="Completadas (rango)"
value={data.totals.cards_completed_in_range}
hint={`${data.totals.cards_done} completadas total · ${data.totals.cards_created_in_range} creadas rango`}
value={t("cards_completed_in_range")}
hint={`${t("cards_done")} completadas total · ${t("cards_created_in_range")} creadas rango`}
color="green"
/>
<KPI
icon={<IconClockHour4 size={14} />}
label="Lead time p50"
value={formatDuration(data.lead_time.p50_ms)}
hint={`p90 ${formatDuration(data.lead_time.p90_ms)} · n=${data.lead_time.n}`}
value={lead.n > 0 ? formatDuration(lead.p50_ms) : 0}
hint={`p90 ${lead.n > 0 ? formatDuration(lead.p90_ms) : 0} · n=${lead.n}`}
/>
<KPI
icon={<IconLock size={14} />}
label="Bloqueos activos"
value={data.totals.active_locks}
hint={`Total bloqueado: ${formatDuration(data.lock_total_ms)}`}
color={data.totals.active_locks > 0 ? "yellow" : undefined}
value={t("active_locks")}
hint={`Total bloqueado: ${formatDuration(data.lock_total_ms ?? 0)}`}
color={t("active_locks") > 0 ? "yellow" : undefined}
/>
</SimpleGrid>
@@ -489,7 +493,7 @@ export function Dashboard({ users }: Props) {
</Table.Tr>
</Table.Thead>
<Table.Tbody>
{data.cycle_time_per_column.map((c) => (
{(data.cycle_time_per_column ?? []).map((c) => (
<Table.Tr key={c.column_id}>
<Table.Td>
<Group gap={6} wrap="nowrap">
@@ -515,7 +519,8 @@ export function Dashboard({ users }: Props) {
</Grid.Col>
</Grid>
</>
)}
);
})()}
</Stack>
</Box>
);
+106 -5
View File
@@ -26,7 +26,7 @@ import {
IconUser,
IconUserCircle,
} from "@tabler/icons-react";
import { memo, useState } from "react";
import { memo, useCallback, useRef, useState } from "react";
import type { Card, CardColor, User } from "../types";
import { CARD_COLORS, colorBg, colorBorder, colorSwatch } from "./colors";
import { formatDuration } from "./format";
@@ -40,6 +40,11 @@ interface Props {
onShowHistory: (card: Card) => void;
onToggleLock: (id: string, locked: boolean) => void;
onAssign: (id: string, assignee_id: string | null) => void;
activeSticker?: string | null;
onAddSticker?: (cardId: string, x: number, y: number) => void;
onRemoveSticker?: (cardId: string, index: number) => void;
onMoveSticker?: (cardId: string, index: number, x: number, y: number) => void;
onCommitSticker?: (cardId: string) => void;
users: User[];
assignee?: User;
inDoneColumn?: boolean;
@@ -55,6 +60,11 @@ function KanbanCardImpl({
onShowHistory,
onToggleLock,
onAssign,
activeSticker,
onAddSticker,
onRemoveSticker,
onMoveSticker,
onCommitSticker,
users,
assignee,
inDoneColumn,
@@ -64,12 +74,66 @@ function KanbanCardImpl({
const [colorPopOpen, setColorPopOpen] = useState(false);
const [assigneePopOpen, setAssigneePopOpen] = useState(false);
const [menuOpen, setMenuOpen] = useState(false);
const cardElRef = useRef<HTMLElement | null>(null);
const draggingStickerRef = useRef<number | null>(null);
const stickerMode = !!activeSticker;
const { attributes, listeners, setNodeRef, transform, transition, isDragging } = useSortable({
id: card.id,
data: { type: "card", columnId: card.column_id },
disabled: card.locked,
disabled: card.locked || stickerMode,
});
const setCardRef = useCallback((el: HTMLElement | null) => {
cardElRef.current = el;
setNodeRef(el);
}, [setNodeRef]);
const onCardClickAddSticker = (e: React.MouseEvent<HTMLDivElement>) => {
if (!stickerMode || !onAddSticker || isOverlay) return;
if ((e.target as HTMLElement).closest("[data-sticker-overlay]")) return;
const rect = e.currentTarget.getBoundingClientRect();
const x = (e.clientX - rect.left) / rect.width;
const y = (e.clientY - rect.top) / rect.height;
onAddSticker(card.id, Math.max(0, Math.min(1, x)), Math.max(0, Math.min(1, y)));
};
const startStickerDrag = (index: number) => (e: React.PointerEvent<HTMLSpanElement>) => {
if (stickerMode || isOverlay || !onMoveSticker) return;
if (e.button !== 0) return;
e.stopPropagation();
e.preventDefault();
const rect = cardElRef.current?.getBoundingClientRect();
if (!rect) return;
draggingStickerRef.current = index;
const target = e.currentTarget;
target.setPointerCapture(e.pointerId);
const onMove = (ev: PointerEvent) => {
const idx = draggingStickerRef.current;
if (idx === null) return;
const x = (ev.clientX - rect.left) / rect.width;
const y = (ev.clientY - rect.top) / rect.height;
onMoveSticker(card.id, idx, Math.max(0, Math.min(1, x)), Math.max(0, Math.min(1, y)));
};
const onUp = (ev: PointerEvent) => {
target.releasePointerCapture?.(ev.pointerId);
target.removeEventListener("pointermove", onMove);
target.removeEventListener("pointerup", onUp);
target.removeEventListener("pointercancel", onUp);
draggingStickerRef.current = null;
onCommitSticker?.(card.id);
};
target.addEventListener("pointermove", onMove);
target.addEventListener("pointerup", onUp);
target.addEventListener("pointercancel", onUp);
};
const onStickerContextMenu = (index: number) => (e: React.MouseEvent) => {
if (isOverlay) return;
e.preventDefault();
e.stopPropagation();
onRemoveSticker?.(card.id, index);
};
const style: React.CSSProperties = {
transform: CSS.Transform.toString(transform),
transition,
@@ -216,19 +280,20 @@ function KanbanCardImpl({
return (
<Paper
ref={setNodeRef}
style={{ ...style, cursor: card.locked ? "default" : "grab", touchAction: "none" }}
ref={setCardRef}
style={{ ...style, position: "relative", cursor: stickerMode ? "copy" : card.locked ? "default" : "grab", touchAction: "none" }}
withBorder
p="xs"
shadow={isOverlay ? "lg" : "xs"}
radius="md"
onContextMenu={onContextMenu}
onClick={onCardClickAddSticker}
onDoubleClick={(e) => {
e.stopPropagation();
onEdit(card);
}}
{...attributes}
{...(card.locked ? {} : listeners)}
{...(card.locked || stickerMode ? {} : listeners)}
>
<Stack gap={6}>
<Group justify="space-between" gap={4} wrap="nowrap" align="flex-start">
@@ -315,6 +380,42 @@ function KanbanCardImpl({
</Badge>
</Group>
</Stack>
{card.stickers && card.stickers.length > 0 && (
<div
data-sticker-overlay
style={{
position: "absolute",
inset: 0,
pointerEvents: "none",
overflow: "hidden",
borderRadius: "inherit",
}}
>
{card.stickers.map((s, i) => (
<span
key={i}
onPointerDown={startStickerDrag(i)}
onContextMenu={onStickerContextMenu(i)}
title="Arrastra para mover. Click derecho para borrar."
style={{
position: "absolute",
left: `${s.x * 100}%`,
top: `${s.y * 100}%`,
transform: "translate(-50%, -50%)",
fontSize: 48,
lineHeight: 1,
opacity: 0.6,
userSelect: "none",
cursor: stickerMode || isOverlay ? "default" : "grab",
pointerEvents: stickerMode || isOverlay ? "none" : "auto",
touchAction: "none",
}}
>
{s.emoji}
</span>
))}
</div>
)}
</Paper>
);
}
+15
View File
@@ -54,6 +54,11 @@ interface Props {
onShowHistory: (card: Card) => void;
onToggleCardLock: (id: string, locked: boolean) => void;
onAssignCard: (id: string, assignee_id: string | null) => void;
activeSticker?: string | null;
onAddSticker?: (cardId: string, x: number, y: number) => void;
onRemoveSticker?: (cardId: string, index: number) => void;
onMoveSticker?: (cardId: string, index: number, x: number, y: number) => void;
onCommitSticker?: (cardId: string) => void;
users: User[];
usersById: Map<string, User>;
}
@@ -76,6 +81,11 @@ function KanbanColumnImpl({
onShowHistory,
onToggleCardLock,
onAssignCard,
activeSticker,
onAddSticker,
onRemoveSticker,
onMoveSticker,
onCommitSticker,
users,
usersById,
}: Props) {
@@ -408,6 +418,11 @@ function KanbanColumnImpl({
users={users}
assignee={c.assignee_id ? usersById.get(c.assignee_id) : undefined}
inDoneColumn={column.is_done}
activeSticker={activeSticker}
onAddSticker={onAddSticker}
onRemoveSticker={onRemoveSticker}
onMoveSticker={onMoveSticker}
onCommitSticker={onCommitSticker}
/>
))}
</Stack>
+50
View File
@@ -0,0 +1,50 @@
import { Popover } from "@mantine/core";
import { useEffect, useRef } from "react";
import data from "@emoji-mart/data";
import { Picker } from "emoji-mart";
interface Props {
opened: boolean;
onClose: () => void;
onSelect: (emoji: string) => void;
target: React.ReactNode;
}
export function StickerPicker({ opened, onClose, onSelect, target }: Props) {
return (
<Popover opened={opened} onClose={onClose} position="bottom-start" withArrow shadow="md" withinPortal>
<Popover.Target>{target}</Popover.Target>
<Popover.Dropdown p={0} style={{ background: "transparent", border: "none" }}>
<PickerInner onSelect={(emoji) => { onSelect(emoji); onClose(); }} />
</Popover.Dropdown>
</Popover>
);
}
function PickerInner({ onSelect }: { onSelect: (emoji: string) => void }) {
const ref = useRef<HTMLDivElement | null>(null);
const instanceRef = useRef<unknown>(null);
useEffect(() => {
if (!ref.current) return;
instanceRef.current = new Picker({
data,
onEmojiSelect: (e: { native?: string; shortcodes?: string }) => {
if (e.native) onSelect(e.native);
else if (e.shortcodes) onSelect(e.shortcodes);
},
theme: "dark",
previewPosition: "none",
skinTonePosition: "search",
autoFocus: true,
maxFrequentRows: 2,
ref,
});
return () => {
if (ref.current) ref.current.innerHTML = "";
instanceRef.current = null;
};
}, [onSelect]);
return <div ref={ref} />;
}
+7
View File
@@ -13,6 +13,12 @@ export interface Column {
export type CardColor = "" | "blue" | "teal" | "green" | "yellow" | "orange" | "red" | "pink" | "violet" | "indigo";
export interface Sticker {
emoji: string;
x: number;
y: number;
}
export interface Card {
id: string;
requester: string;
@@ -26,6 +32,7 @@ export interface Card {
completed_at: string | null;
deleted_at: string | null;
tags: string[];
stickers: Sticker[];
created_at: string;
updated_at: string;
entered_at: string;
+20
View File
@@ -210,6 +210,25 @@ func handleUpdateCard(db *DB) http.HandlerFunc {
}
}
// PUT /api/cards/{id}/stickers { stickers: [{emoji,x,y}, ...] }
func handleUpdateCardStickers(db *DB) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
id := r.PathValue("id")
var body struct {
Stickers []Sticker `json:"stickers"`
}
if err := infra.HTTPParseBody(r, &body, maxBodyBytes); err != nil {
badRequest(w, err.Error())
return
}
if err := db.UpdateStickers(id, body.Stickers); err != nil {
serverError(w, err)
return
}
w.WriteHeader(http.StatusNoContent)
}
}
// DELETE /api/cards/{id}
func handleDeleteCard(db *DB) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
@@ -314,6 +333,7 @@ func apiRoutes(db *DB, chatWorkdir string, logger *ChatLogger) []infra.Route {
{Method: "DELETE", Path: "/api/columns/{id}", Handler: handleDeleteColumn(db)},
{Method: "POST", Path: "/api/cards", Handler: handleCreateCard(db)},
{Method: "PATCH", Path: "/api/cards/{id}", Handler: handleUpdateCard(db)},
{Method: "PUT", Path: "/api/cards/{id}/stickers", Handler: handleUpdateCardStickers(db)},
{Method: "DELETE", Path: "/api/cards/{id}", Handler: handleDeleteCard(db)},
{Method: "POST", Path: "/api/cards/{id}/move", Handler: handleMoveCard(db)},
{Method: "GET", Path: "/api/cards/{id}/history", Handler: handleCardHistory(db)},
+94
View File
@@ -0,0 +1,94 @@
package main
import (
"encoding/json"
"testing"
)
func TestUpdateStickers_PersistsAndRoundTrips(t *testing.T) {
db := setupTestDB(t)
col := executeTool(db, "create_column", mustJSON(t, map[string]string{"name": "X"})).Result.(*Column)
card := executeTool(db, "create_card", mustJSON(t, map[string]string{"column_id": col.ID, "title": "T"})).Result.(*Card)
if card.Stickers == nil || len(card.Stickers) != 0 {
t.Fatalf("expected empty stickers on new card, got %+v", card.Stickers)
}
stickers := []Sticker{
{Emoji: "🔥", X: 0.25, Y: 0.5},
{Emoji: "✅", X: 0.9, Y: 0.1},
}
if err := db.UpdateStickers(card.ID, stickers); err != nil {
t.Fatalf("UpdateStickers: %v", err)
}
cards, err := db.ListCardsWithTime()
if err != nil {
t.Fatalf("ListCardsWithTime: %v", err)
}
if len(cards) != 1 {
t.Fatalf("expected 1 card, got %d", len(cards))
}
got := cards[0].Stickers
if len(got) != 2 || got[0].Emoji != "🔥" || got[1].Emoji != "✅" {
t.Fatalf("sticker round-trip failed: %+v", got)
}
if got[0].X != 0.25 || got[0].Y != 0.5 {
t.Fatalf("coords lost: %+v", got[0])
}
}
func TestUpdateStickers_ClampAndDropEmpty(t *testing.T) {
db := setupTestDB(t)
col := executeTool(db, "create_column", mustJSON(t, map[string]string{"name": "X"})).Result.(*Column)
card := executeTool(db, "create_card", mustJSON(t, map[string]string{"column_id": col.ID, "title": "T"})).Result.(*Card)
in := []Sticker{
{Emoji: " 🚀 ", X: -0.5, Y: 1.5},
{Emoji: "", X: 0.5, Y: 0.5},
{Emoji: "💀", X: 0.3, Y: 0.7},
}
if err := db.UpdateStickers(card.ID, in); err != nil {
t.Fatalf("UpdateStickers: %v", err)
}
cards, _ := db.ListCardsWithTime()
got := cards[0].Stickers
if len(got) != 2 {
t.Fatalf("expected empty emoji dropped, got %+v", got)
}
if got[0].Emoji != "🚀" || got[0].X != 0 || got[0].Y != 1 {
t.Fatalf("clamp failed: %+v", got[0])
}
if got[1].Emoji != "💀" {
t.Fatalf("expected 💀 second, got %+v", got[1])
}
}
func TestUpdateStickers_OverwriteAndClear(t *testing.T) {
db := setupTestDB(t)
col := executeTool(db, "create_column", mustJSON(t, map[string]string{"name": "X"})).Result.(*Column)
card := executeTool(db, "create_card", mustJSON(t, map[string]string{"column_id": col.ID, "title": "T"})).Result.(*Card)
if err := db.UpdateStickers(card.ID, []Sticker{{Emoji: "🔥", X: 0.5, Y: 0.5}}); err != nil {
t.Fatalf("set: %v", err)
}
if err := db.UpdateStickers(card.ID, []Sticker{}); err != nil {
t.Fatalf("clear: %v", err)
}
cards, _ := db.ListCardsWithTime()
if len(cards[0].Stickers) != 0 {
t.Fatalf("expected cleared, got %+v", cards[0].Stickers)
}
}
func TestSticker_JSONShape(t *testing.T) {
s := Sticker{Emoji: "🎯", X: 0.1, Y: 0.2}
b, err := json.Marshal(s)
if err != nil {
t.Fatalf("marshal: %v", err)
}
want := `{"emoji":"🎯","x":0.1,"y":0.2}`
if string(b) != want {
t.Fatalf("got %s want %s", b, want)
}
}