Package com.bytedesk.ticket.ticket_settings

Class TicketSettingsRestService

java.lang.Object

com.bytedesk.core.base.BaseRestService<T,TRequest,TResponse>

com.bytedesk.core.base.BaseRestServiceWithExport<TicketSettingsEntity,TicketSettingsRequest,TicketSettingsResponse,TicketSettingsExcel>

com.bytedesk.ticket.ticket_settings.TicketSettingsRestService

@Service
public class TicketSettingsRestService
extends BaseRestServiceWithExport<TicketSettingsEntity,TicketSettingsRequest,TicketSettingsResponse,TicketSettingsExcel>

Field Summary

Fields

Modifier and Type	Field	Description
private final AuthService	authService
private final TicketSettingsBindingRepository	bindingRepository
private final FormRepository	formRepository
private final org.modelmapper.ModelMapper	modelMapper
private final ProcessRepository	ticketProcessRepository
private final TicketSettingsRepository	ticketSettingsRepository
private final UidUtils	uidUtils

Constructor Summary

Constructors

Constructor	Description
TicketSettingsRestService()

Method Summary

Modifier and Type	Method	Description
private void	applyBasicSettingsRequest(TicketBasicSettingsEntity target, TicketBasicSettingsRequest request)
void	bindWorkgroups(String ticketSettingsUid, String orgUid, List<String> workgroupUids)	批量绑定工作组到指定 TicketSettings。
TicketSettingsExcel	convertToExcel(TicketSettingsEntity entity)	转换为Excel对象 子类必须实现此方法
TicketSettingsResponse	convertToResponse(TicketSettingsEntity entity)
private void	copyBasicSettings(TicketBasicSettingsEntity source, TicketBasicSettingsEntity target)
private CategorySettingsData	copyCategorySettings(CategorySettingsData source)
TicketSettingsResponse	create(TicketSettingsRequest request)
private TicketBasicSettingsEntity	createBasicSettingsEntity(TicketBasicSettingsRequest request, String orgUid)
protected org.springframework.data.jpa.domain.Specification<TicketSettingsEntity>	createSpecification(TicketSettingsRequest request)	创建Specification对象，子类必须实现 用于queryByOrg的通用实现
void	delete(TicketSettingsRequest request)
void	deleteByUid(String uid)
protected TicketSettingsEntity	doSave(TicketSettingsEntity entity)	子类实现具体的保存逻辑
private void	ensureSingleDefault(String orgUid, String type, TicketSettingsEntity target)	保证同一个 orgUid 下仅有一个 isDefault=true（参考 WorkgroupSettingsRestService）
protected org.springframework.data.domain.Page<TicketSettingsEntity>	executePageQuery(org.springframework.data.jpa.domain.Specification<TicketSettingsEntity> spec, org.springframework.data.domain.Pageable pageable)	执行分页查询，子类必须实现 用于queryByOrg的通用实现
Boolean	existsByUid(String uid)
Optional<TicketSettingsEntity>	findByNameAndOrgUid(String name, String orgUid, String type)
Optional<TicketSettingsEntity>	findByUid(String uid)
TicketSettingsEntity	getOrCreateDefault(String orgUid)	获取或创建组织默认 TicketSettings（发布+草稿齐全，保证并发唯一）
TicketSettingsEntity	getOrCreateDefault(String orgUid, String rawType)
TicketSettingsResponse	getOrDefaultByWorkgroup(String orgUid, String workgroupUid)	根据 org + workgroup 获取设置；若未绑定则创建/获取组织默认设置并自动绑定该工作组。
TicketSettingsResponse	getOrDefaultByWorkgroup(String orgUid, String workgroupUid, String rawType)
TicketSettingsEntity	handleOptimisticLockingFailureException(org.springframework.orm.ObjectOptimisticLockingFailureException e, TicketSettingsEntity entity)
List<TicketSettingsBindingEntity>	listBindings(String ticketSettingsUid)
private TicketBasicSettingsResponse	mapBasicSettings(TicketBasicSettingsEntity entity)
private TicketCategorySettingsResponse	mapCategorySettings(TicketCategorySettingsEntity entity)
private FormResponse	mapForm(FormEntity entity)
private ProcessResponse	mapProcess(ProcessEntity entity)
private FormTypeEnum	mapTicketTypeToFormType(String normalizedType)
private ProcessTypeEnum	mapTicketTypeToProcessType(String normalizedType)
TicketSettingsResponse	publish(String uid)	发布草稿配置到正式配置，参考 WorkgroupSettings 的 publish 逻辑。
TicketSettingsResponse	publishByWorkgroup(String orgUid, String workgroupUid)	按 orgUid + workgroupUid 发布对应 TicketSettings（便于前端直接在工作组维度触发）。
private String	resolveDefaultFormUid(String orgUid, String normalizedType)
private String	resolveDefaultProcessUid(String orgUid, String normalizedType)
private TicketBasicSettingsRequest	resolveDraftBasicRequest(TicketSettingsRequest request)
private TicketCategorySettingsRequest	resolveDraftCategoryRequest(TicketSettingsRequest request)
TicketSettingsEntity	resolveEntityByWorkgroup(String orgUid, String workgroupUid, String rawType)	Resolve ticket settings entity by workgroup/org for downstream domain services.
private FormEntity	resolveFormReference(String formUid, String orgUid)
private String	resolveFormUidOrDefault(TicketSettingsRequest request, String orgUid, String normalizedType)
private ProcessEntity	resolveProcessReference(String processUid, String orgUid)
private String	resolveProcessUidOrDefault(TicketSettingsRequest request, String orgUid, String normalizedType)
private String	resolveSettingsType(String rawType)
TicketSettingsResponse	saveByWorkgroup(String orgUid, String workgroupUid, TicketSettingsRequest request)	按 orgUid+workgroupUid 保存草稿。
TicketSettingsResponse	update(TicketSettingsRequest request)

Methods inherited from class com.bytedesk.core.base.BaseRestServiceWithExport

queryByOrgEntity

Methods inherited from class com.bytedesk.core.base.BaseRestService

deleteByOrgUid, findByOrgUid, getUidFromRequest, queryByOrg, queryByUid, queryByUser, recover, save, setUserUidToRequest

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

ticketSettingsRepository

private final TicketSettingsRepository ticketSettingsRepository

bindingRepository

private final TicketSettingsBindingRepository bindingRepository

modelMapper

private final org.modelmapper.ModelMapper modelMapper

uidUtils

private final UidUtils uidUtils

authService

private final AuthService authService

ticketProcessRepository

private final ProcessRepository ticketProcessRepository

formRepository

private final FormRepository formRepository

Constructor Details

TicketSettingsRestService

public TicketSettingsRestService()

Method Details

createSpecification

protected org.springframework.data.jpa.domain.Specification<TicketSettingsEntity> createSpecification(TicketSettingsRequest request)

Description copied from class: BaseRestService

创建Specification对象，子类必须实现 用于queryByOrg的通用实现

Specified by:

createSpecification in class BaseRestService<TicketSettingsEntity,TicketSettingsRequest,TicketSettingsResponse>

executePageQuery

protected org.springframework.data.domain.Page<TicketSettingsEntity> executePageQuery(org.springframework.data.jpa.domain.Specification<TicketSettingsEntity> spec,
 org.springframework.data.domain.Pageable pageable)

Description copied from class: BaseRestService

执行分页查询，子类必须实现 用于queryByOrg的通用实现

Specified by:

executePageQuery in class BaseRestService<TicketSettingsEntity,TicketSettingsRequest,TicketSettingsResponse>

findByUid

public Optional<TicketSettingsEntity> findByUid(String uid)

Specified by:

findByUid in class BaseRestService<TicketSettingsEntity,TicketSettingsRequest,TicketSettingsResponse>

findByNameAndOrgUid

public Optional<TicketSettingsEntity> findByNameAndOrgUid(String name,
 String orgUid,
 String type)

existsByUid

public Boolean existsByUid(String uid)

create

@Transactional
public TicketSettingsResponse create(TicketSettingsRequest request)

Specified by:

create in class BaseRestService<TicketSettingsEntity,TicketSettingsRequest,TicketSettingsResponse>

update

@Transactional
public TicketSettingsResponse update(TicketSettingsRequest request)

Specified by:

update in class BaseRestService<TicketSettingsEntity,TicketSettingsRequest,TicketSettingsResponse>

getOrDefaultByWorkgroup

public TicketSettingsResponse getOrDefaultByWorkgroup(String orgUid,
 String workgroupUid)

根据 org + workgroup 获取设置；若未绑定则创建/获取组织默认设置并自动绑定该工作组。

getOrDefaultByWorkgroup

public TicketSettingsResponse getOrDefaultByWorkgroup(String orgUid,
 String workgroupUid,
 String rawType)

resolveEntityByWorkgroup

@Transactional
public TicketSettingsEntity resolveEntityByWorkgroup(String orgUid,
 String workgroupUid,
 String rawType)

Resolve ticket settings entity by workgroup/org for downstream domain services.

getOrCreateDefault

@Transactional
public TicketSettingsEntity getOrCreateDefault(String orgUid)

获取或创建组织默认 TicketSettings（发布+草稿齐全，保证并发唯一）

getOrCreateDefault

@Transactional
public TicketSettingsEntity getOrCreateDefault(String orgUid,
 String rawType)

bindWorkgroups

@Transactional
public void bindWorkgroups(String ticketSettingsUid,
 String orgUid,
 List<String> workgroupUids)

批量绑定工作组到指定 TicketSettings。 每个工作组仅能绑定一条记录：若已存在则覆盖其 ticketSettingsUid。

listBindings

public List<TicketSettingsBindingEntity> listBindings(String ticketSettingsUid)

saveByWorkgroup

@Transactional
public TicketSettingsResponse saveByWorkgroup(String orgUid,
 String workgroupUid,
 TicketSettingsRequest request)

按 orgUid+workgroupUid 保存草稿。若尚未绑定则自动创建默认 settings 绑定后再更新草稿。

publish

@Transactional
public TicketSettingsResponse publish(String uid)

发布草稿配置到正式配置，参考 WorkgroupSettings 的 publish 逻辑。

publishByWorkgroup

@Transactional
public TicketSettingsResponse publishByWorkgroup(String orgUid,
 String workgroupUid)

按 orgUid + workgroupUid 发布对应 TicketSettings（便于前端直接在工作组维度触发）。

doSave

protected TicketSettingsEntity doSave(TicketSettingsEntity entity)

Description copied from class: BaseRestService

子类实现具体的保存逻辑

Specified by:

doSave in class BaseRestService<TicketSettingsEntity,TicketSettingsRequest,TicketSettingsResponse>

handleOptimisticLockingFailureException

public TicketSettingsEntity handleOptimisticLockingFailureException(org.springframework.orm.ObjectOptimisticLockingFailureException e,
 TicketSettingsEntity entity)

Specified by:

handleOptimisticLockingFailureException in class BaseRestService<TicketSettingsEntity,TicketSettingsRequest,TicketSettingsResponse>

deleteByUid

@Transactional
public void deleteByUid(String uid)

Specified by:

deleteByUid in class BaseRestService<TicketSettingsEntity,TicketSettingsRequest,TicketSettingsResponse>

delete

public void delete(TicketSettingsRequest request)

Specified by:

delete in class BaseRestService<TicketSettingsEntity,TicketSettingsRequest,TicketSettingsResponse>

resolveDraftCategoryRequest

private TicketCategorySettingsRequest resolveDraftCategoryRequest(TicketSettingsRequest request)

resolveDraftBasicRequest

private TicketBasicSettingsRequest resolveDraftBasicRequest(TicketSettingsRequest request)

resolveProcessUidOrDefault

private String resolveProcessUidOrDefault(TicketSettingsRequest request,
 String orgUid,
 String normalizedType)

resolveFormUidOrDefault

private String resolveFormUidOrDefault(TicketSettingsRequest request,
 String orgUid,
 String normalizedType)

resolveDefaultProcessUid

private String resolveDefaultProcessUid(String orgUid,
 String normalizedType)

resolveDefaultFormUid

private String resolveDefaultFormUid(String orgUid,
 String normalizedType)

mapTicketTypeToProcessType

private ProcessTypeEnum mapTicketTypeToProcessType(String normalizedType)

mapTicketTypeToFormType

private FormTypeEnum mapTicketTypeToFormType(String normalizedType)

resolveProcessReference

private ProcessEntity resolveProcessReference(String processUid,
 String orgUid)

resolveFormReference

private FormEntity resolveFormReference(String formUid,
 String orgUid)

createBasicSettingsEntity

private TicketBasicSettingsEntity createBasicSettingsEntity(TicketBasicSettingsRequest request,
 String orgUid)

applyBasicSettingsRequest

private void applyBasicSettingsRequest(TicketBasicSettingsEntity target,
 TicketBasicSettingsRequest request)

copyBasicSettings

private void copyBasicSettings(TicketBasicSettingsEntity source,
 TicketBasicSettingsEntity target)

mapBasicSettings

private TicketBasicSettingsResponse mapBasicSettings(TicketBasicSettingsEntity entity)

copyCategorySettings

private CategorySettingsData copyCategorySettings(CategorySettingsData source)

mapCategorySettings

private TicketCategorySettingsResponse mapCategorySettings(TicketCategorySettingsEntity entity)

mapProcess

private ProcessResponse mapProcess(ProcessEntity entity)

mapForm

private FormResponse mapForm(FormEntity entity)

convertToResponse

public TicketSettingsResponse convertToResponse(TicketSettingsEntity entity)

Specified by:

convertToResponse in class BaseRestService<TicketSettingsEntity,TicketSettingsRequest,TicketSettingsResponse>

convertToExcel

public TicketSettingsExcel convertToExcel(TicketSettingsEntity entity)

Description copied from class: BaseRestServiceWithExport

转换为Excel对象 子类必须实现此方法

Specified by:

convertToExcel in class BaseRestServiceWithExport<TicketSettingsEntity,TicketSettingsRequest,TicketSettingsResponse,TicketSettingsExcel>

resolveSettingsType

private String resolveSettingsType(String rawType)

ensureSingleDefault

private void ensureSingleDefault(String orgUid,
 String type,
 TicketSettingsEntity target)

保证同一个 orgUid 下仅有一个 isDefault=true（参考 WorkgroupSettingsRestService）