'use strict'; /** * 账号在「主体维度」下的资料(名称 / 头像) * * 口径(2026-09-14 按用户要求):同一账号在不同主体下可以有不同名称与头像, * 数据落在主体账号关联表 `principal_users.name` / `principal_users.avatar`: * - 推送单据的操作人取该关联表的名称(入库 entryOrder.operatorName、发货单 deliveryOrder.operatorName 等) * - 页面右上角展示:有关联头像显示头像 → 无头像显示名称首字符 → 无名称显示账号(username)首字符 * * 回退顺序(关联表未配置时保持旧行为,避免历史账号显示空白): * name:principal_users.name → users.nickname → users.username * avatar:principal_users.avatar → users.avatar */ /** * 取账号在指定主体下的资料 * @param {Object} ctx egg context * @param {Number|String} userId 用户ID * @param {Number|String} principalId 主体ID(缺省时只取全局 users 字段) * @return {Promise<{name: string, avatar: string}>} 名称与头像(可能为空串) */ async function resolveAccountProfile(ctx, userId, principalId) { const id = Number(userId); if (!id) return { name: '', avatar: '' }; let relation = null; if (Number(principalId)) { relation = await ctx.model.PrincipalUser.findOne({ where: { user_id: id, principal_id: Number(principalId) }, attributes: [ 'name', 'avatar' ], }); } let user = null; if (!relation || !relation.name || !relation.avatar) { user = await ctx.model.User.findByPk(id, { attributes: [ 'nickname', 'username', 'avatar' ] }); } const name = (relation && relation.name) || (user && (user.nickname || user.username)) || ''; const avatar = (relation && relation.avatar) || (user && user.avatar) || ''; return { name: String(name), avatar: String(avatar) }; } /** * 取账号在指定主体下的显示名称(推送单据操作人用) * @param {Object} ctx egg context * @param {Number|String} userId 用户ID * @param {Number|String} principalId 主体ID * @return {Promise} 名称(兜底为空串) */ async function resolveAccountName(ctx, userId, principalId) { const { name } = await resolveAccountProfile(ctx, userId, principalId); return name; } /** * 取展示用首字符:名称首字符(支持中文)→ 账号首字符 * @param {String} name 关联表名称 * @param {String} username 账号 * @return {String} 单个字符(都没有时返回空串) */ function firstCharOf(name, username) { const source = String(name || '').trim() || String(username || '').trim(); if (!source) return ''; // 取首个「字」,避免把 emoji/代理对切一半 return Array.from(source)[0]; } module.exports = { resolveAccountProfile, resolveAccountName, firstCharOf };