'use strict'; const MainService = require('../main'); /** * 系统方法层:frontConfig(前端独立部署配置接口包装层)。 * * 业务实现全部委托 ctx.service.systems.frontConfig:本层只做参数白名单过滤、 * 鉴权出口与统一成功/失败包装。 */ class FrontConfigMethodsService extends MainService { constructor(ctx) { super(ctx); // 公共按域名拉取:免登录、免权限、免鉴权(保留系统日志,与 workbench 公共接口口径一致) // 注意:getByDomain 是唯一免登录接口;域名验证接口(setDomain/getDomain/checkDomain)一律需登录 const _noNeedLogin = 'getByDomain'; // settings 页配置接口:需登录、免权限、免鉴权(权限由业务层 isWarehouse 判定),不记系统日志 const _noNeedRight = 'getByDomain,getInfo,getCert,saveInfo,saveCert,setDomain,getDomain,checkDomain'; const _noNeedLog = 'getInfo,getCert,saveInfo,saveCert,setDomain,getDomain,checkDomain'; const _noNeedAuth = 'getByDomain,getInfo,getCert,saveInfo,saveCert,setDomain,getDomain,checkDomain'; this.systemInit(_noNeedLogin, _noNeedRight, _noNeedLog, _noNeedAuth); } /** * 获取前端独立部署业务服务(systems/frontConfig)。 * * @return {Object|null} 业务服务实例;不可用时返回 null。 */ getFrontConfigService() { return (this.service && this.service.systems && this.service.systems.frontConfig) || null; } /** * 按域名拉取仓库前端公开配置(公共无鉴权接口)。 * * 安全红线:响应仅含公开字段(domain/title/logo_url/login_bg_url/favicon_url/theme), * 不含 cert_pem/key_pem/cert_path/key_path/sync_status/sync_attempts/last_sync_error 等内部字段。 * * @param {Object} [data={}] 请求参数。 * @param {string} data.domain 待查询域名(必填,非空)。 * @return {Promise} 统一响应结构;命中返回公开字段配置(code=200), * 未登记域名返回 code=404「域名未配置」。 */ async getByDomain(data = {}) { const { domain } = data || {}; const targetService = this.getFrontConfigService(); if (!targetService || typeof targetService.getByDomain !== 'function') { return this.fail('获取前端配置失败', { code: 500 }); } try { const result = await targetService.getByDomain(domain); return this.success('获取成功', { ...result, code: 200 }); } catch (error) { return this.fail(error.message || '获取前端配置失败', { code: Number(error.code) || 500, }); } } /** * 查询当前仓库前端独立部署品牌配置(settings 页回显,需登录)。 * * 仅返回品牌与基础字段(warehouse_id/domain/title/logo_url/favicon_url/login_bg_url/theme/updated_at), * 不含证书/私钥原文与同步状态等内部字段(证书回显走 frontConfig.getCert)。 * * @return {Promise} 统一响应结果。 */ async getInfo() { const targetService = this.getFrontConfigService(); if (!targetService || typeof targetService.getInfo !== 'function') { return this.fail('获取前端配置失败', { code: 500 }); } try { const result = await targetService.getInfo(); return this.success('ok', result); } catch (error) { return this.fail(error.message || '获取前端配置失败', { code: Number(error.code) || 500, }); } } /** * 查询当前仓库前端独立部署证书配置(settings 页回显,需登录)。 * * 响应含证书原文(cert_pem)与私钥原文(key_pem,取自 cert_key 列), * 仅供仓库主体登录后的 settings 页回显,公共无鉴权接口 frontConfig.getByDomain * 仍只返回公开字段白名单。 * * @return {Promise} 统一响应结果。 */ async getCert() { const targetService = this.getFrontConfigService(); if (!targetService || typeof targetService.getCert !== 'function') { return this.fail('获取前端证书配置失败', { code: 500 }); } try { const result = await targetService.getCert(); return this.success('ok', result); } catch (error) { return this.fail(error.message || '获取前端证书配置失败', { code: Number(error.code) || 500, }); } } /** * 保存当前仓库前端独立部署品牌配置(upsert,一仓一行,仅品牌字段部分更新,需登录)。 * * domain 与证书字段不再受理:domain 变更必须走 frontConfig.setDomain(域名验证通过后方可上传证书); * cert_pem/key_pem/cert_path/key_path/cert_expire_at 一律被白名单过滤忽略。 * * @param {Object} data 请求参数。 * @param {string} [data.title] 站点标题(≤100 字符,空值清空)。 * @param {string} [data.logo_url] Logo 地址(≤255 字符,空值清空)。 * @param {string} [data.favicon_url] 站点 favicon 图标地址(≤255 字符,空值清空)。 * @param {string} [data.login_bg_url] 登录页背景图地址(≤255 字符,空值清空)。 * @param {Object|string} [data.theme] 主题配置(合法 JSON 对象或 JSON 字符串,空值清空)。 * @return {Promise} 统一响应结果。 */ async saveInfo(data = {}) { const targetService = this.getFrontConfigService(); if (!targetService || typeof targetService.saveInfo !== 'function') { return this.fail('保存前端配置失败', { code: 500 }); } try { const source = data || {}; const params = {}; // domain/cert_path/key_path/cert_pem/key_pem/cert_expire_at 均不受理: // domain 变更走 setDomain,证书与有效期字段由后端权威维护,前端传值直接忽略 for (const key of [ 'title', 'logo_url', 'favicon_url', 'login_bg_url', 'theme' ]) { if (Object.prototype.hasOwnProperty.call(source, key)) { params[key] = source[key]; } } const result = await targetService.saveInfo(params); return this.success('ok', result); } catch (error) { return this.fail(error.message || '保存前端配置失败', { code: Number(error.code) || 500, }); } } /** * 上传当前仓库前端独立部署证书(需登录、仅仓库主体)。 * * domain 不再受理:域名一律取库内已设置且验证通过的值(前端若仍传 data.domain 一律忽略), * 未设置域名或域名未通过 TXT 验证时由业务层返回 400。 * 后端自动写入 cert_expire_at(证书 validTo 权威值),证书/私钥内容直接入库(不落盘), * 保存后清理该域名的公共拉取缓存并返回证书配置输出 * (响应含证书/私钥原文回显,13 字段,口径与 frontConfig.getCert 一致)。 * * @param {Object} data 请求参数。 * @param {string} data.pem 证书 PEM 文本(必填)。 * @param {string} data.key 私钥 PEM 文本(必填,与证书成对)。 * @return {Promise} 统一响应结果。 */ async saveCert(data = {}) { const targetService = this.getFrontConfigService(); if (!targetService || typeof targetService.saveCert !== 'function') { return this.fail('上传前端证书失败', { code: 500 }); } try { const source = data || {}; const { pem, key } = source; // data.domain 不再受理:域名只认库内已设置并验证通过的值,前端若仍传 domain 一律忽略 const result = await targetService.saveCert({ pem, key, }); return this.success('ok', result); } catch (error) { return this.fail(error.message || '上传前端证书失败', { code: Number(error.code) || 500, }); } } /** * 设置当前仓库前端独立部署域名(需登录、仅仓库主体)。 * * 设置成功会下发一次性 DNS TXT 校验记录(verify_host/verify_value)与 CNAME 目标(cname); * 域名发生变更时会同时清空既有证书并重置同步状态(旧证书不覆盖新域名)。 * * @param {Object} data 请求参数。 * @param {string} data.domain 仓库自持域名(必填,非空,≤100 字符,全局唯一)。 * @return {Promise} 统一响应结果(code=1);data 含 * warehouse_id/domain/domain_status/verify_host/verify_value/cname/verified_at/attempts/last_error。 */ async setDomain(data = {}) { const targetService = this.getFrontConfigService(); if (!targetService || typeof targetService.setDomain !== 'function') { return this.fail('设置域名失败', { code: 500 }); } try { const result = await targetService.setDomain(data || {}); return this.success('ok', result); } catch (error) { return this.fail(error.message || '设置域名失败', { code: Number(error.code) || 500, }); } } /** * 查询当前仓库前端独立部署域名与验证状态(需登录、仅仓库主体)。 * * 返回待校验的 verify_host/verify_value 与 cname;domain_status=1(已验证)时 * verify_host/verify_value 返回空串(校验令牌已无用途);无记录时返回空值默认。 * * @return {Promise} 统一响应结果(code=1);data 含 * warehouse_id/domain/domain_status/verify_host/verify_value/cname/verified_at/attempts/last_error。 */ async getDomain() { const targetService = this.getFrontConfigService(); if (!targetService || typeof targetService.getDomain !== 'function') { return this.fail('获取域名配置失败', { code: 500 }); } try { const result = await targetService.getDomain(); return this.success('ok', result); } catch (error) { return this.fail(error.message || '获取域名配置失败', { code: Number(error.code) || 500, }); } } /** * 主动校验当前仓库前端独立部署域名的 DNS TXT 记录(需登录、仅仓库主体)。 * * 校验结果会回写 domain_status/domain_verified_at/attempts/last_error; * 响应额外含 verified(本次是否通过)与 resolved_values(本次解析到的 TXT 值,最多 5 条)。 * * @return {Promise} 统一响应结果(code=1);未设置域名时 code=400。 */ async checkDomain() { const targetService = this.getFrontConfigService(); if (!targetService || typeof targetService.checkDomain !== 'function') { return this.fail('校验域名失败', { code: 500 }); } try { const result = await targetService.checkDomain(); return this.success('ok', result); } catch (error) { return this.fail(error.message || '校验域名失败', { code: Number(error.code) || 500, }); } } } module.exports = FrontConfigMethodsService;