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.control.user.tax.server.command;
018
019import com.echothree.control.user.tax.common.edit.TaxClassificationEdit;
020import com.echothree.control.user.tax.common.edit.TaxEditFactory;
021import com.echothree.control.user.tax.common.form.EditTaxClassificationForm;
022import com.echothree.control.user.tax.common.result.EditTaxClassificationResult;
023import com.echothree.control.user.tax.common.result.TaxResultFactory;
024import com.echothree.control.user.tax.common.spec.TaxClassificationSpec;
025import com.echothree.model.control.core.common.MimeTypeUsageTypes;
026import com.echothree.model.control.core.server.logic.MimeTypeLogic;
027import com.echothree.model.control.geo.server.control.GeoControl;
028import com.echothree.model.control.party.common.PartyTypes;
029import com.echothree.model.control.security.common.SecurityRoleGroups;
030import com.echothree.model.control.security.common.SecurityRoles;
031import com.echothree.model.control.tax.server.control.TaxControl;
032import com.echothree.model.data.core.server.entity.MimeType;
033import com.echothree.model.data.geo.server.entity.GeoCode;
034import com.echothree.model.data.tax.server.entity.TaxClassification;
035import com.echothree.model.data.user.common.pk.UserVisitPK;
036import com.echothree.util.common.message.ExecutionErrors;
037import com.echothree.util.common.validation.FieldDefinition;
038import com.echothree.util.common.validation.FieldType;
039import com.echothree.util.common.command.EditMode;
040import com.echothree.util.server.control.BaseAbstractEditCommand;
041import com.echothree.util.server.control.CommandSecurityDefinition;
042import com.echothree.util.server.control.PartyTypeDefinition;
043import com.echothree.util.server.control.SecurityRoleDefinition;
044import java.util.List;
045import javax.enterprise.context.Dependent;
046import javax.inject.Inject;
047
048@Dependent
049public class EditTaxClassificationCommand
050        extends BaseAbstractEditCommand<TaxClassificationSpec, TaxClassificationEdit, EditTaxClassificationResult, TaxClassification, TaxClassification> {
051
052    private final static CommandSecurityDefinition COMMAND_SECURITY_DEFINITION;
053    private final static List<FieldDefinition> SPEC_FIELD_DEFINITIONS;
054    private final static List<FieldDefinition> EDIT_FIELD_DEFINITIONS;
055
056    static {
057        COMMAND_SECURITY_DEFINITION = new CommandSecurityDefinition(List.of(
058                new PartyTypeDefinition(PartyTypes.UTILITY.name(), null),
059                new PartyTypeDefinition(PartyTypes.EMPLOYEE.name(), List.of(
060                        new SecurityRoleDefinition(SecurityRoleGroups.TaxClassification.name(), SecurityRoles.Edit.name())
061                ))
062        ));
063
064        SPEC_FIELD_DEFINITIONS = List.of(
065                new FieldDefinition("CountryName", FieldType.ENTITY_NAME, true, null, null),
066                new FieldDefinition("TaxClassificationName", FieldType.ENTITY_NAME, true, null, null)
067        );
068
069        EDIT_FIELD_DEFINITIONS = List.of(
070                new FieldDefinition("TaxClassificationName", FieldType.ENTITY_NAME, true, null, null),
071                new FieldDefinition("IsDefault", FieldType.BOOLEAN, true, null, null),
072                new FieldDefinition("SortOrder", FieldType.SIGNED_INTEGER, true, null, null),
073                new FieldDefinition("Description", FieldType.STRING, false, 1L, 132L),
074                new FieldDefinition("OverviewMimeTypeName", FieldType.MIME_TYPE, false, null, null),
075                new FieldDefinition("Overview", FieldType.STRING, false, null, null)
076        );
077    }
078
079    @Inject
080    GeoControl geoControl;
081
082    @Inject
083    TaxControl taxControl;
084
085    @Inject
086    MimeTypeLogic mimeTypeLogic;
087
088    /** Creates a new instance of EditTaxClassificationCommand */
089    public EditTaxClassificationCommand() {
090        super(COMMAND_SECURITY_DEFINITION, SPEC_FIELD_DEFINITIONS, EDIT_FIELD_DEFINITIONS);
091    }
092
093    @Override
094    public EditTaxClassificationResult getResult() {
095        return TaxResultFactory.getEditTaxClassificationResult();
096    }
097
098    @Override
099    public TaxClassificationEdit getEdit() {
100        return TaxEditFactory.getTaxClassificationEdit();
101    }
102
103    GeoCode countryGeoCode;
104
105    @Override
106    public TaxClassification getEntity(EditTaxClassificationResult result) {
107        TaxClassification taxClassification = null;
108        var countryName = spec.getCountryName();
109
110        countryGeoCode = geoControl.getCountryByAlias(countryName);
111
112        if(countryGeoCode != null) {
113            var taxClassificationName = spec.getTaxClassificationName();
114
115            if(editMode.equals(EditMode.LOCK) || editMode.equals(EditMode.ABANDON)) {
116                taxClassification = taxControl.getTaxClassificationByName(countryGeoCode, taxClassificationName);
117            } else { // EditMode.UPDATE
118                taxClassification = taxControl.getTaxClassificationByNameForUpdate(countryGeoCode, taxClassificationName);
119            }
120
121            if(taxClassification == null) {
122                addExecutionError(ExecutionErrors.UnknownTaxClassificationName.name(), countryName, taxClassificationName);
123            }
124        } else {
125            addExecutionError(ExecutionErrors.UnknownGeoCodeName.name(), countryName);
126        }
127
128        return taxClassification;
129    }
130
131    @Override
132    public TaxClassification getLockEntity(TaxClassification taxClassification) {
133        return taxClassification;
134    }
135
136    @Override
137    public void fillInResult(EditTaxClassificationResult result, TaxClassification taxClassification) {
138        result.setTaxClassification(taxControl.getTaxClassificationTransfer(getUserVisit(), taxClassification));
139    }
140
141    MimeType overviewMimeType;
142    
143    @Override
144    public void doLock(TaxClassificationEdit edit, TaxClassification taxClassification) {
145        var taxClassificationTranslation = taxControl.getTaxClassificationTranslation(taxClassification, getPreferredLanguage());
146        var taxClassificationDetail = taxClassification.getLastDetail();
147
148        edit.setTaxClassificationName(taxClassificationDetail.getTaxClassificationName());
149        edit.setIsDefault(taxClassificationDetail.getIsDefault().toString());
150        edit.setSortOrder(taxClassificationDetail.getSortOrder().toString());
151
152        if(taxClassificationTranslation != null) {
153            overviewMimeType = taxClassificationTranslation.getOverviewMimeType();
154            
155            edit.setDescription(taxClassificationTranslation.getDescription());
156            edit.setOverviewMimeTypeName(overviewMimeType == null? null: overviewMimeType.getLastDetail().getMimeTypeName());
157            edit.setOverview(taxClassificationTranslation.getOverview());
158        }
159    }
160    
161    @Override
162    public void canUpdate(TaxClassification taxClassification) {
163        var geoCodeDetail = countryGeoCode.getLastDetail();
164        var taxClassificationName = edit.getTaxClassificationName();
165        var duplicateTaxClassification = taxControl.getTaxClassificationByName(countryGeoCode, taxClassificationName);
166
167        if(duplicateTaxClassification != null && !taxClassification.equals(duplicateTaxClassification)) {
168            addExecutionError(ExecutionErrors.DuplicateTaxClassificationName.name(), geoCodeDetail.getGeoCodeName(), taxClassificationName);
169        } else {
170            var overviewMimeTypeName = edit.getOverviewMimeTypeName();
171            var overview = edit.getOverview();
172
173            overviewMimeType = mimeTypeLogic.checkMimeType(this, overviewMimeTypeName, overview, MimeTypeUsageTypes.TEXT.name(),
174                    ExecutionErrors.MissingRequiredOverviewMimeTypeName.name(), ExecutionErrors.MissingRequiredOverview.name(),
175                    ExecutionErrors.UnknownOverviewMimeTypeName.name(), ExecutionErrors.UnknownOverviewMimeTypeUsage.name());
176        }
177    }
178
179    @Override
180    public void doUpdate(TaxClassification taxClassification) {
181        var partyPK = getPartyPK();
182        var taxClassificationDetailValue = taxControl.getTaxClassificationDetailValueForUpdate(taxClassification);
183        var taxClassificationTranslation = taxControl.getTaxClassificationTranslationForUpdate(taxClassification, getPreferredLanguage());
184        var description = edit.getDescription();
185        var overview = edit.getOverview();
186
187        taxClassificationDetailValue.setTaxClassificationName(edit.getTaxClassificationName());
188        taxClassificationDetailValue.setIsDefault(Boolean.valueOf(edit.getIsDefault()));
189        taxClassificationDetailValue.setSortOrder(Integer.valueOf(edit.getSortOrder()));
190
191        taxControl.updateTaxClassificationFromValue(taxClassificationDetailValue, partyPK);
192
193        if(taxClassificationTranslation == null && (description != null || overview != null)) {
194            taxControl.createTaxClassificationTranslation(taxClassification, getPreferredLanguage(), description, overviewMimeType, overview, partyPK);
195        } else if(taxClassificationTranslation != null && (description == null && overview == null)) {
196            taxControl.deleteTaxClassificationTranslation(taxClassificationTranslation, partyPK);
197        } else if(taxClassificationTranslation != null && (description != null || overview != null)) {
198            var taxClassificationTranslationValue = taxControl.getTaxClassificationTranslationValue(taxClassificationTranslation);
199
200            taxClassificationTranslationValue.setDescription(description);
201            taxClassificationTranslationValue.setOverviewMimeTypePK(overviewMimeType == null? null: overviewMimeType.getPrimaryKey());
202            taxClassificationTranslationValue.setOverview(overview);
203            taxControl.updateTaxClassificationTranslationFromValue(taxClassificationTranslationValue, partyPK);
204        }
205    }
206
207}