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.
186 lines
5.2 KiB
JavaScript
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 };
|