openimis-be-claim-sampling 1.0.0__tar.gz

openimis_be_claim_sampling-1.0.0/LICENSE.md

@@ -0,0 +1,14 @@
+
+The program users must agree to the following terms:
+
+License notices
+This program is free software: you can redistribute it and/or modify it under the terms of the GNU AGPL v3 License as published by the Free Software Foundation, version 3 of the License.
+This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU AGPL v3 License for more details www.gnu.org.
+
+Disclaimer of Warranty
+There is no warranty for the program, to the extent permitted by applicable law; except when otherwise stated in writing the copyright holders and/or other parties provide the program "as is" without warranty of any kind, either expressed or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. The entire risk as to the quality and performance of the program is with you. Should the program prove defective, you assume the cost of all necessary servicing, repair or correction.
+
+Limitation of Liability 
+In no event unless required by applicable law or agreed to in writing will any copyright holder, or any other party who modifies and/or conveys the program as permitted above, be liable to you for damages, including any general, special, incidental or consequential damages arising out of the use or inability to use the program (including but not limited to loss of data or data being rendered inaccurate or losses sustained by you or third parties or a failure of the program to operate with any other programs), even if such holder or other party has been advised of the possibility of such damages.
+
+In case of dispute arising out or in relation to the use of the program, it is subject to the public law of Switzerland. The place of jurisdiction is Berne.

openimis_be_claim_sampling-1.0.0/PKG-INFO

@@ -0,0 +1,52 @@
+Metadata-Version: 2.1
+Name: openimis-be-claim_sampling
+Version: 1.0.0
+Summary: The openIMIS Backend claim_sampling reference module.
+Home-page: https://openimis.org/
+Author: wzgliniecki
+Author-email: wzgliniecki@soldevelo.com
+License: GNU AGPL v3
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.2
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU Affero General Public License v3
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: django
+Requires-Dist: django-db-signals
+Requires-Dist: djangorestframework
+Requires-Dist: openimis-be-core
+Requires-Dist: openimis-be-claim
+
+# openIMIS Backend claim_sampling reference module
+This repository holds the files of the openIMIS Backend Claim Sampling reference module.
+
+[![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
+
+## Code climate (develop branch)
+
+## ORM mapping:
+
+## Listened Django Signals
+
+## Services
+
+## Reports (template can be overloaded via report.ReportDefinition)
+
+## GraphQL Queries
+
+## GraphQL Mutations - each mutation emits default signals and return standard error lists (cfr. openimis-be-core_py)
+
+## Additional Endpoints
+
+## Reports
+
+## Configuration options (can be changed via core.ModuleConfiguration)
+
+
+## openIMIS Modules Dependencies
+

openimis_be_claim_sampling-1.0.0/README.md

@@ -0,0 +1,28 @@
+# openIMIS Backend claim_sampling reference module
+This repository holds the files of the openIMIS Backend Claim Sampling reference module.
+
+[![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)
+
+## Code climate (develop branch)
+
+## ORM mapping:
+
+## Listened Django Signals
+
+## Services
+
+## Reports (template can be overloaded via report.ReportDefinition)
+
+## GraphQL Queries
+
+## GraphQL Mutations - each mutation emits default signals and return standard error lists (cfr. openimis-be-core_py)
+
+## Additional Endpoints
+
+## Reports
+
+## Configuration options (can be changed via core.ModuleConfiguration)
+
+
+## openIMIS Modules Dependencies
+

openimis_be_claim_sampling-1.0.0/claim_sampling/admin.py

@@ -0,0 +1,3 @@
+from django.contrib import admin
+
+# Register your models here.

openimis_be_claim_sampling-1.0.0/claim_sampling/apps.py

@@ -0,0 +1,29 @@
+from django.apps import AppConfig
+
+MODULE_NAME = 'claim_sampling'
+
+DEFAULT_CFG = {
+    "gql_query_claim_batch_samplings_perms": ["126001"],
+    "gql_mutation_create_claim_batch_samplings_perms": ["126002"],
+    "gql_mutation_update_claim_batch_samplings_perms": ["126003"],
+    "gql_mutation_approve_claim_batch_samplings_perms": ["126004"],
+}
+
+
+class ClaimSamplingConfig(AppConfig):
+    name = MODULE_NAME
+
+    gql_query_claim_batch_samplings_perms = None
+    gql_mutation_create_claim_batch_samplings_perms = None
+    gql_mutation_update_claim_batch_samplings_perms = None
+    gql_mutation_approve_claim_batch_samplings_perms = None
+
+    def __load_config(self, cfg):
+        for field in cfg:
+            if hasattr(ClaimSamplingConfig, field):
+                setattr(ClaimSamplingConfig, field, cfg[field])
+
+    def ready(self):
+        from core.models import ModuleConfiguration
+        cfg = ModuleConfiguration.get_or_default(MODULE_NAME, DEFAULT_CFG)
+        self.__load_config(cfg)

openimis_be_claim_sampling-1.0.0/claim_sampling/gql_mutations.py

@@ -0,0 +1,171 @@
+import logging
+import uuid
+import pathlib
+import base64
+from typing import Callable, Dict
+import random
+import graphene
+
+from claim.gql_queries import ClaimGQLType
+from core.gql.gql_mutations import mutation_on_uuids_from_filter
+from tasks_management.models import TaskGroup
+from .apps import ClaimSamplingConfig
+from core.schema import TinyInt, OpenIMISMutation
+from django.contrib.auth.models import AnonymousUser
+from django.core.exceptions import ValidationError, PermissionDenied
+from django.utils.translation import gettext as _
+
+from claim.gql_mutations import ClaimCodeInputType, ClaimGuaranteeIdInputType, FeedbackInputType
+from claim.models import ClaimAdmin, Claim
+
+from django.db import transaction
+
+from .models import ClaimSamplingBatch, ClaimSamplingBatchAssignment
+from .services import ClaimSamplingService
+
+logger = logging.getLogger(__name__)
+
+
+class ClaimSamplingBatchInputType(OpenIMISMutation.Input):
+    percentage = graphene.Int(required=True)
+    t = graphene.Int(required=True)
+
+    status = TinyInt(required=False)
+    id = graphene.Int(required=False, read_only=True)
+    uuid = graphene.String(required=False)
+    autogenerate = graphene.Boolean(required=False)
+    insuree_id = graphene.Int(required=False)
+    date_from = graphene.Date(required=False)
+    date_to = graphene.Date(required=False)
+    icd_id = graphene.Int(required=False)
+    icd_1_id = graphene.Int(required=False)
+    icd_2_id = graphene.Int(required=False)
+    icd_3_id = graphene.Int(required=False)
+    icd_4_id = graphene.Int(required=False)
+    review_status = TinyInt(required=False)
+    date_claimed = graphene.Date(required=False)
+    date_processed = graphene.Date(required=False)
+    health_facility_id = graphene.Int(required=False)
+    refer_from_id = graphene.Int(required=False)
+    refer_to_id = graphene.Int(required=False)
+    batch_run_id = graphene.Int(required=False)
+    category = graphene.String(max_length=1, required=False)
+    visit_type = graphene.String(max_length=1, required=False)
+    admin_id = graphene.Int(required=False)
+    explanation = graphene.String(required=False)
+    adjustment = graphene.String(required=False)
+    json_ext = graphene.types.json.JSONString(required=False)
+    restore = graphene.UUID(required=False)
+    feedback_available = graphene.Boolean(default=False)
+    feedback_status = TinyInt(required=False)
+    care_type = graphene.String(required=False)
+
+    # code = graphene.Field(ClaimCodeInputType, required=True)
+    # feedback = graphene.Field(FeedbackInputType, required=False)
+    # guarantee_id = ClaimGuaranteeIdInputType(required=False)
+
+
+@transaction.atomic
+def update_or_create_claim_sampling_batch(data, user, task_group=None):
+
+    service = ClaimSamplingService(user)
+
+    if data.get('uuid', None) is not None:
+        return service.update(data)
+    else:
+        claim_sampling_batch = service.create(data, task_group)
+        return claim_sampling_batch
+
+
+class CreateClaimSamplingBatchMutation(OpenIMISMutation):
+    """
+    Create a new claim sampling batch.
+    """
+    __filter_handlers = {
+        'services': 'services__service__code__in',
+        'items': 'items__item__code__in'
+    }
+
+    _mutation_module = "claim_sampling"
+    _mutation_class = "CreateClaimSamplingBatchMutation"
+
+    class Input(OpenIMISMutation.Input):
+        filters = graphene.String()
+        percentage = graphene.Int(required=True)
+        taskGroupUuid = graphene.String(required=False)
+
+    @classmethod
+    @mutation_on_uuids_from_filter(Claim, ClaimGQLType, 'filters', __filter_handlers)
+    def async_mutate(cls, user, **data):
+        try:
+            if type(user) is AnonymousUser or not user.id:
+                raise ValidationError(_("mutation.authentication_required"))
+            # if not user.has_perms(ClaimSamplingConfig.gql_mutation_create_claim_batch_samplings_perms):
+            #     raise PermissionDenied(_("unauthorized"))
+            if "client_mutation_id" in data:
+                data.pop('client_mutation_id')
+            if "client_mutation_label" in data:
+                data.pop('client_mutation_label')
+            # data['audit_user_id'] = user.id_for_audit
+            from core.utils import TimeUtils
+            # data['validity_from'] = TimeUtils.now()
+            group_id = data.get('taskGroupUuid')
+
+            task_group = TaskGroup.objects.get(id=group_id) if group_id else None
+            claim_sampling_batch = update_or_create_claim_sampling_batch(data, user, task_group)
+            return None
+        except Exception as exc:
+            from django.conf import settings
+            if settings.DEBUG:
+                import traceback
+                logging.debug("Error in claim sampling mutation: ", exc)
+                traceback.print_exc()
+            return [{
+                'message': _("claim.mutation.failed_to_create_claim_sampling_batch") % {'code': data['code']},
+                'detail': str(exc)}]
+
+
+class UpdateClaimSamplingBatchMutation(OpenIMISMutation):
+    """
+    Update a claim. The claim items and services can all be updated with this call
+    """
+    _mutation_module = "claim_sampling"
+    _mutation_class = "UpdateClaimSamplingBatchMutation"
+
+    class Input(ClaimSamplingBatchInputType):
+        pass
+
+    @classmethod
+    def async_mutate(cls, user, **data):
+        try:
+            if type(user) is AnonymousUser or not user.id:
+                raise ValidationError(
+                    _("mutation.authentication_required"))
+            if not user.has_perms(ClaimSamplingConfig.gql_mutation_update_claim_batch_samplings_perms):
+                raise PermissionDenied(_("unauthorized"))
+            data['audit_user_id'] = user.id_for_audit
+            update_or_create_claim_sampling_batch(data, user)
+            return None
+        except Exception as exc:
+            return [{
+                'message': _("claim.mutation.failed_to_update_claim_sampling_batch") % {'code': data['code']},
+                'detail': str(exc)}]
+
+
+class ApproveClaimSamplingBatchMutation(OpenIMISMutation):
+    """
+    Approve given claim batch and apply deduction rate or other parameters across all claims in given batch.
+    """
+    _mutation_module = "claim_sampling"
+    _mutation_class = "ApproveClaimSamplingBatchMutation"
+
+    class Input(ClaimSamplingBatchInputType):
+        pass
+
+    @classmethod
+    def async_mutate(cls, user, **data):
+        if not user.has_perms(ClaimSamplingConfig.gql_mutation_approve_claim_batch_samplings_perms):
+            raise PermissionDenied(_("unauthorized"))
+        errors = []
+
+        return errors

openimis_be_claim_sampling-1.0.0/claim_sampling/gql_queries.py

@@ -0,0 +1,79 @@
+import graphene
+from core import prefix_filterset, ExtendedConnection
+from graphene_django import DjangoObjectType
+from .apps import ClaimSamplingConfig
+from .models import Claim
+from django.utils.translation import gettext as _
+from django.core.exceptions import PermissionDenied
+
+
+class ClaimSamplingBatchGQLType(DjangoObjectType):
+    attachments_count = graphene.Int()
+    client_mutation_id = graphene.String()
+
+    class Meta:
+        model = Claim
+        interfaces = (graphene.relay.Node,)
+        filter_fields = {
+            "uuid": ["exact"],
+            "code": ["exact", "istartswith", "icontains", "iexact"],
+            "status": ["exact", "gt"],
+            "date_claimed": ["exact", "lt", "lte", "gt", "gte"],
+            "date_from": ["exact", "lt", "lte", "gt", "gte"],
+            "date_to": ["exact", "lt", "lte", "gt", "gte"],
+            "date_processed": ["exact", "lt", "lte", "gt", "gte"],
+            "feedback_status": ["exact"],
+            "review_status": ["exact"],
+            "claimed": ["exact", "lt", "lte", "gt", "gte"],
+            "approved": ["exact", "lt", "lte", "gt", "gte"],
+            "visit_type": ["exact"],
+            "attachments_count__value": ["exact", "lt", "lte", "gt", "gte"],
+        }
+        connection_class = ExtendedConnection
+
+    def resolve_client_mutation_id(self, info):
+        if not info.context.user.has_perms(ClaimSamplingConfig.gql_query_claim_batch_samplings_perms):
+            raise PermissionDenied(_("unauthorized"))
+        claim_mutation = self.mutations.select_related(
+            'mutation').filter(mutation__status=0).first()
+        return claim_mutation.mutation.client_mutation_id if claim_mutation else None
+
+    @classmethod
+    def get_queryset(cls, queryset, info):
+        claim_ids = Claim.get_queryset(queryset, info).values('uuid').all()
+        return Claim.objects.filter(uuid__in=claim_ids)
+
+
+class ClaimSamplingBatchAssignmentGQLType(DjangoObjectType):
+    """
+    Main element for a Claim. It can contain items and/or services.
+    The filters are possible on BatchRun, Insuree, HealthFacility, Admin and ICD in addition to the Claim fields
+    themselves.
+    """
+
+    class Meta:
+        model = Claim
+        interfaces = (graphene.relay.Node,)
+        filter_fields = {
+            "uuid": ["exact"],
+            "code": ["exact", "istartswith", "icontains", "iexact"],
+            "status": ["exact", "gt"],
+            "date_claimed": ["exact", "lt", "lte", "gt", "gte"],
+            "date_from": ["exact", "lt", "lte", "gt", "gte"],
+            "date_to": ["exact", "lt", "lte", "gt", "gte"],
+            "date_processed": ["exact", "lt", "lte", "gt", "gte"],
+            "feedback_status": ["exact"],
+            "review_status": ["exact"],
+            "claimed": ["exact", "lt", "lte", "gt", "gte"],
+            "approved": ["exact", "lt", "lte", "gt", "gte"],
+            "visit_type": ["exact"],
+            "attachments_count__value": ["exact", "lt", "lte", "gt", "gte"],
+        }
+        connection_class = ExtendedConnection
+
+
+class ClaimSamplingSummaryGQLType(graphene.ObjectType):
+    deductible_percentage = graphene.Float(description="Percentage of claims rejected during review - deductibles.")
+    reviewed_percentage = graphene.Float(description="Percentage of reviewed claims in batch.")
+    total_claims_in_batch = graphene.Int(description="Total number of claims selected for review in sampling batch")
+

openimis_be_claim_sampling-1.0.0/claim_sampling/migrations/0001_initial.py

@@ -0,0 +1,56 @@
+# Generated by Django 3.2.16 on 2023-10-25 07:50
+
+import core.fields
+import datetime
+from django.db import migrations, models
+import django.db.models.deletion
+import uuid
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        ('claim', '0024_add_claim_restore_perms'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='ClaimSamplingBatch',
+            fields=[
+                ('validity_from', core.fields.DateTimeField(db_column='ValidityFrom', default=datetime.datetime.now)),
+                ('validity_to', core.fields.DateTimeField(blank=True, db_column='ValidityTo', null=True)),
+                ('legacy_id', models.IntegerField(blank=True, db_column='LegacyID', null=True)),
+                ('id', models.AutoField(db_column='ClaimSamplingBatchID', primary_key=True, serialize=False)),
+                ('uuid', models.CharField(db_column='ClaimSamplingBatchUUID', default=uuid.uuid4, max_length=36, unique=True)),
+                ('is_completed', models.BooleanField()),
+                ('is_applied', models.BooleanField()),
+                ('computed_value', models.JSONField(blank=True, db_column='ComputedValue', null=True)),
+                ('assigned_value', models.JSONField(blank=True, db_column='AssignedValue', null=True)),
+                ('assigned_to', models.ForeignKey(db_column='AssignedTo', on_delete=django.db.models.deletion.DO_NOTHING, related_name='AssignedTo', to='claim.claimadmin')),
+                ('created_by', models.ForeignKey(db_column='CreatedBy', on_delete=django.db.models.deletion.DO_NOTHING, related_name='CreatedBy', to='claim.claimadmin')),
+            ],
+            options={
+                'db_table': 'claim_ClaimSamplingBatch',
+                'managed': True,
+            },
+        ),
+        migrations.CreateModel(
+            name='ClaimSamplingBatchAssignment',
+            fields=[
+                ('validity_from', core.fields.DateTimeField(db_column='ValidityFrom', default=datetime.datetime.now)),
+                ('validity_to', core.fields.DateTimeField(blank=True, db_column='ValidityTo', null=True)),
+                ('legacy_id', models.IntegerField(blank=True, db_column='LegacyID', null=True)),
+                ('id', models.AutoField(db_column='ClaimSamplingBatchAssignmentID', primary_key=True, serialize=False)),
+                ('uuid', models.CharField(db_column='ClaimSamplingBatchAssignmentUUID', default=uuid.uuid4, max_length=36, unique=True)),
+                ('status', models.CharField(choices=[('R', 'Reviewed'), ('S', 'Skipped'), ('I', 'Idle')], default='I', max_length=2)),
+                ('claim_batch_id', models.ForeignKey(db_column='ClaimSamplingBatchID', on_delete=django.db.models.deletion.DO_NOTHING, related_name='ClaimSamplingBatchID', to='claim_sampling.claimsamplingbatch')),
+                ('claim_id', models.ForeignKey(db_column='ClaimID', on_delete=django.db.models.deletion.DO_NOTHING, related_name='ClaimID', to='claim.claim')),
+            ],
+            options={
+                'db_table': 'claim_ClaimBatchAssignment',
+                'managed': True,
+            },
+        ),
+    ]

openimis_be_claim_sampling-1.0.0/claim_sampling/migrations/0002_remove_claimsamplingbatchassignment_claim_batch_id_and_more.py

@@ -0,0 +1,27 @@
+# Generated by Django 4.2.11 on 2024-05-19 14:49
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("claim_sampling", "0001_initial"),
+    ]
+
+    operations = [
+        migrations.RemoveField(
+            model_name="claimsamplingbatchassignment",
+            name="claim_batch_id",
+        ),
+        migrations.RemoveField(
+            model_name="claimsamplingbatchassignment",
+            name="claim_id",
+        ),
+        migrations.DeleteModel(
+            name="ClaimSamplingBatch",
+        ),
+        migrations.DeleteModel(
+            name="ClaimSamplingBatchAssignment",
+        ),
+    ]