001// --------------------------------------------------------------------------------
002// Copyright 2002-2026 Echo Three, LLC
003//
004// Licensed under the Apache License, Version 2.0 (the "License");
005// you may not use this file except in compliance with the License.
006// You may obtain a copy of the License at
007//
008//     http://www.apache.org/licenses/LICENSE-2.0
009//
010// Unless required by applicable law or agreed to in writing, software
011// distributed under the License is distributed on an "AS IS" BASIS,
012// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
013// See the License for the specific language governing permissions and
014// limitations under the License.
015// --------------------------------------------------------------------------------
016
017package com.echothree.model.control.tax.server.logic;
018
019import com.echothree.control.user.tax.common.spec.TaxClassificationUniversalSpec;
020import com.echothree.model.control.core.common.ComponentVendors;
021import com.echothree.model.control.core.common.EntityTypes;
022import com.echothree.model.control.core.common.exception.InvalidParameterCountException;
023import com.echothree.model.control.core.server.logic.EntityInstanceLogic;
024import com.echothree.model.control.geo.server.control.GeoControl;
025import com.echothree.model.control.tax.common.exception.DuplicateTaxClassificationNameException;
026import com.echothree.model.control.tax.common.exception.UnknownDefaultTaxClassificationException;
027import com.echothree.model.control.tax.common.exception.UnknownTaxClassificationNameException;
028import com.echothree.model.control.tax.server.control.TaxControl;
029import com.echothree.model.data.core.server.entity.MimeType;
030import com.echothree.model.data.geo.server.entity.GeoCode;
031import com.echothree.model.data.party.server.entity.Language;
032import com.echothree.model.data.tax.server.entity.TaxClassification;
033import com.echothree.model.data.tax.server.value.TaxClassificationDetailValue;
034import com.echothree.util.common.message.ExecutionErrors;
035import com.echothree.util.common.persistence.BasePK;
036import com.echothree.util.server.control.BaseLogic;
037import com.echothree.util.server.message.ExecutionErrorAccumulator;
038import com.echothree.util.server.persistence.EntityPermission;
039import com.echothree.util.server.validation.ParameterUtils;
040import javax.enterprise.context.ApplicationScoped;
041import javax.enterprise.inject.spi.CDI;
042import javax.inject.Inject;
043
044@ApplicationScoped
045public class TaxClassificationLogic
046        extends BaseLogic {
047
048    @Inject
049    GeoControl geoControl;
050
051    @Inject
052    TaxControl taxControl;
053
054    @Inject
055    EntityInstanceLogic entityInstanceLogic;
056
057    protected TaxClassificationLogic() {
058        super();
059    }
060
061    public static TaxClassificationLogic getInstance() {
062        return CDI.current().select(TaxClassificationLogic.class).get();
063    }
064
065    public TaxClassification createTaxClassification(final ExecutionErrorAccumulator eea, final GeoCode countryGeoCode,
066            final String taxClassificationName, final Boolean isDefault, final Integer sortOrder, final Language language,
067            final String description, final MimeType overviewMimeType, final String overview, final BasePK createdBy) {
068        var taxClassification = taxControl.getTaxClassificationByName(countryGeoCode, taxClassificationName);
069
070        if(taxClassification == null) {
071            taxClassification = taxControl.createTaxClassification(countryGeoCode, taxClassificationName, isDefault, sortOrder, createdBy);
072
073            if(description != null) {
074                taxControl.createTaxClassificationTranslation(taxClassification, language, description, overviewMimeType, overview, createdBy);
075            }
076        } else {
077            handleExecutionError(DuplicateTaxClassificationNameException.class, eea, ExecutionErrors.DuplicateTaxClassificationName.name(),
078                    countryGeoCode.getLastDetail().getGeoCodeName(), taxClassificationName);
079        }
080
081        return taxClassification;
082    }
083
084    public TaxClassification getTaxClassificationByName(final ExecutionErrorAccumulator eea, final GeoCode countryGeoCode,
085            final String taxClassificationName, final EntityPermission entityPermission) {
086        var taxClassification = entityPermission == EntityPermission.READ_WRITE
087                ? taxControl.getTaxClassificationByNameForUpdate(countryGeoCode, taxClassificationName)
088                : taxControl.getTaxClassificationByName(countryGeoCode, taxClassificationName);
089
090        if(taxClassification == null) {
091            handleExecutionError(UnknownTaxClassificationNameException.class, eea, ExecutionErrors.UnknownTaxClassificationName.name(),
092                    countryGeoCode.getLastDetail().getGeoCodeName(), taxClassificationName);
093        }
094
095        return taxClassification;
096    }
097
098    public TaxClassification getTaxClassificationByName(final ExecutionErrorAccumulator eea, final GeoCode countryGeoCode,
099            final String taxClassificationName) {
100        return getTaxClassificationByName(eea, countryGeoCode, taxClassificationName, EntityPermission.READ_ONLY);
101    }
102
103    public TaxClassification getTaxClassificationByNameForUpdate(final ExecutionErrorAccumulator eea, final GeoCode countryGeoCode,
104            final String taxClassificationName) {
105        return getTaxClassificationByName(eea, countryGeoCode, taxClassificationName, EntityPermission.READ_WRITE);
106    }
107
108    public TaxClassification getTaxClassificationByUniversalSpec(final ExecutionErrorAccumulator eea,
109            final TaxClassificationUniversalSpec universalSpec, final boolean allowDefault,
110            final EntityPermission entityPermission) {
111        var countryName = universalSpec.getCountryName();
112        var taxClassificationName = universalSpec.getTaxClassificationName();
113        var nameParameterCount = ParameterUtils.getInstance().countNonNullParameters(countryName, taxClassificationName);
114        TaxClassification taxClassification = null;
115        var parameterCount = nameParameterCount + entityInstanceLogic.countPossibleEntitySpecs(universalSpec);
116
117        switch(parameterCount) {
118            case 1 -> {
119                if(nameParameterCount == 0) {
120                    var entityInstance = entityInstanceLogic.getEntityInstance(eea, universalSpec,
121                            ComponentVendors.ECHO_THREE.name(), EntityTypes.TaxClassification.name());
122
123                    if(eea == null || !eea.hasExecutionErrors()) {
124                        taxClassification = taxControl.getTaxClassificationByEntityInstance(entityInstance, entityPermission);
125                    }
126                } else if(countryName != null && allowDefault) {
127                    var countryGeoCode = geoControl.getCountryByAlias(countryName);
128
129                    if(countryGeoCode == null) {
130                        handleExecutionError(null, eea, ExecutionErrors.UnknownGeoCodeName.name(), countryName);
131                    } else {
132                        taxClassification = entityPermission == EntityPermission.READ_WRITE
133                                ? taxControl.getDefaultTaxClassificationForUpdate(countryGeoCode)
134                                : taxControl.getDefaultTaxClassification(countryGeoCode);
135
136                        if(taxClassification == null) {
137                            handleExecutionError(UnknownDefaultTaxClassificationException.class, eea,
138                                    ExecutionErrors.UnknownDefaultTaxClassification.name());
139                        }
140                    }
141                } else {
142                    handleExecutionError(InvalidParameterCountException.class, eea, ExecutionErrors.InvalidParameterCount.name());
143                }
144            }
145            case 2 -> {
146                if(nameParameterCount == 2) {
147                    var countryGeoCode = geoControl.getCountryByAlias(countryName);
148
149                    if(countryGeoCode == null) {
150                        handleExecutionError(null, eea, ExecutionErrors.UnknownGeoCodeName.name(), countryName);
151                    } else {
152                        taxClassification = getTaxClassificationByName(eea, countryGeoCode, taxClassificationName, entityPermission);
153                    }
154                } else {
155                    handleExecutionError(InvalidParameterCountException.class, eea, ExecutionErrors.InvalidParameterCount.name());
156                }
157            }
158            default ->
159                    handleExecutionError(InvalidParameterCountException.class, eea, ExecutionErrors.InvalidParameterCount.name());
160        }
161
162        return taxClassification;
163    }
164
165    public TaxClassification getTaxClassificationByUniversalSpec(final ExecutionErrorAccumulator eea,
166            final TaxClassificationUniversalSpec universalSpec, final boolean allowDefault) {
167        return getTaxClassificationByUniversalSpec(eea, universalSpec, allowDefault, EntityPermission.READ_ONLY);
168    }
169
170    public TaxClassification getTaxClassificationByUniversalSpecForUpdate(final ExecutionErrorAccumulator eea,
171            final TaxClassificationUniversalSpec universalSpec, final boolean allowDefault) {
172        return getTaxClassificationByUniversalSpec(eea, universalSpec, allowDefault, EntityPermission.READ_WRITE);
173    }
174
175    public void updateTaxClassificationFromValue(final TaxClassificationDetailValue taxClassificationDetailValue, final BasePK updatedBy) {
176        taxControl.updateTaxClassificationFromValue(taxClassificationDetailValue, updatedBy);
177    }
178
179    public void deleteTaxClassification(final ExecutionErrorAccumulator eea, final TaxClassification taxClassification, final BasePK deletedBy) {
180        taxControl.deleteTaxClassification(taxClassification, deletedBy);
181    }
182    
183}