Files
refboard-ayon/backend/socket/board-room.js
T
Hiren Kangad eb0bd210ac feat: per-board activity log
Adds an audit trail per board, visible from a new clock-icon button on the
toolbar. Useful for review-style work where someone wants to see who
contributed which references and when.

Logged events (high-signal only — canvas-edit noise intentionally skipped):
- image / video / pdf added (whether dropped, pasted, or pulled from a URL)
- board created / renamed / deleted
- thread started, resolved, reopened
- comment posted on a thread

Backend:
- new activity_logs table (id, board_id, user_id, denormalised actor name +
  email, action, target_type/id/label, metadata JSON, created_at) with an
  index on (board_id, created_at DESC).
- logActivity helper resolves the user once at log time and stores their
  display name + email so entries survive deactivation/rename.
- recordActivity wraps logActivity + a Socket.IO emit to the board's room
  so the panel updates live without polling.
- GET /api/boards/:id/activity?limit=&before= for pagination
  (collection-membership gated, viewer+).

Frontend:
- ActivityPanel side-drawer: time-grouped feed (Today / Yesterday / older),
  per-action icons + tone colours (add/remove/edit/comment), pagination
  via "Load older", live append on Socket.IO 'activity:new'.
- Relative timestamps refresh every 30s.
- Wired into Editor + Toolbar.

README updated; roadmap entry checked off.
2026-04-28 21:29:48 +05:30

186 lines
5.2 KiB
JavaScript

const { getBoard, getCollection, getCollectionMember } = require('../db');
// Track active users per room: Map<roomName, Map<userId, userInfo>>
const activeUsers = new Map();
function getRoomName(boardId) {
return `board:${boardId}`;
}
function getActiveUsersInRoom(roomName) {
if (!activeUsers.has(roomName)) {
activeUsers.set(roomName, new Map());
}
return activeUsers.get(roomName);
}
function setupBoardRoom(io, socket) {
// ---- Join / Leave ----
socket.on('board:join', ({ boardId }, callback) => {
try {
const board = getBoard(boardId);
if (!board) return callback?.({ error: 'Board not found' });
const collection = getCollection(board.collection_id);
if (!collection) return callback?.({ error: 'Collection not found' });
const member = getCollectionMember(board.collection_id, socket.userId);
if (!member && !collection.is_public) return callback?.({ error: 'Access denied' });
const roomName = getRoomName(boardId);
// Leave any previous board room
for (const room of socket.rooms) {
if (room.startsWith('board:') && room !== roomName) {
leaveRoom(io, socket, room);
}
}
socket.join(roomName);
socket.currentBoardId = boardId;
const roomUsers = getActiveUsersInRoom(roomName);
const userInfo = {
id: socket.userId,
display_name: socket.userDisplayName,
email: socket.userEmail,
role: member?.role || 'viewer',
};
roomUsers.set(socket.userId, userInfo);
socket.to(roomName).emit('user:joined', userInfo);
const users = Array.from(roomUsers.values());
callback?.({ ok: true, users });
console.log(`[socket] ${socket.userDisplayName} joined ${roomName} (${users.length} users)`);
} catch (err) {
console.error('[socket] board:join error:', err);
callback?.({ error: 'Failed to join board' });
}
});
socket.on('board:leave', ({ boardId }, callback) => {
const roomName = getRoomName(boardId);
leaveRoom(io, socket, roomName);
callback?.({ ok: true });
});
// ---- Full scene sync (Excalidraw-style) ----
socket.on('scene:update', (data) => {
if (!socket.currentBoardId) return;
const roomName = getRoomName(socket.currentBoardId);
socket.to(roomName).emit('scene:update', {
...data,
userId: socket.userId,
});
});
// ---- Incremental element sync (Excalidraw-style) ----
socket.on('element:update', (data) => {
if (!socket.currentBoardId) return;
const roomName = getRoomName(socket.currentBoardId);
socket.to(roomName).emit('element:update', {
...data,
userId: socket.userId,
});
});
socket.on('element:remove', (data) => {
if (!socket.currentBoardId) return;
const roomName = getRoomName(socket.currentBoardId);
socket.to(roomName).emit('element:remove', {
...data,
userId: socket.userId,
});
});
// ---- Lightweight transform (during drag/resize/rotate) ----
socket.on('object:transform', (data) => {
if (!socket.currentBoardId) return;
const roomName = getRoomName(socket.currentBoardId);
socket.to(roomName).emit('object:transform', {
...data,
userId: socket.userId,
});
});
// ---- Cursor movement ----
socket.on('cursor:move', (data) => {
if (!socket.currentBoardId) return;
const roomName = getRoomName(socket.currentBoardId);
socket.to(roomName).emit('cursor:moved', {
...data,
userId: socket.userId,
displayName: socket.userDisplayName,
});
});
// ---- Selection presence (broadcast what items a user has selected) ----
socket.on('selection:update', (data) => {
if (!socket.currentBoardId) return;
const roomName = getRoomName(socket.currentBoardId);
socket.volatile.to(roomName).emit('selection:update', {
...data,
userId: socket.userId,
displayName: socket.userDisplayName,
});
});
// ---- Laser pointer ----
socket.on('laser:move', (data) => {
if (!socket.currentBoardId) return;
const roomName = getRoomName(socket.currentBoardId);
socket.volatile.to(roomName).emit('laser:move', { ...data, userId: socket.userId });
});
socket.on('laser:stop', (data) => {
if (!socket.currentBoardId) return;
const roomName = getRoomName(socket.currentBoardId);
socket.to(roomName).emit('laser:stop', { ...data, userId: socket.userId });
});
// ---- Disconnect cleanup ----
socket.on('disconnecting', () => {
const rooms = [...socket.rooms];
for (const room of rooms) {
if (room.startsWith('board:')) {
leaveRoom(io, socket, room);
}
}
});
}
function leaveRoom(io, socket, roomName) {
socket.leave(roomName);
const roomUsers = getActiveUsersInRoom(roomName);
roomUsers.delete(socket.userId);
socket.to(roomName).emit('user:left', {
id: socket.userId,
display_name: socket.userDisplayName,
});
if (roomUsers.size === 0) {
activeUsers.delete(roomName);
}
if (socket.currentBoardId && roomName === getRoomName(socket.currentBoardId)) {
socket.currentBoardId = null;
}
console.log(`[socket] ${socket.userDisplayName} left ${roomName}`);
}
module.exports = { setupBoardRoom, getRoomName };