adb-contracts

flowchart TB
    subgraph Controllers["15 Controllers"]
        CC[ContractController]
        BCC[BankContractController]
        ICC[InsuranceContractController]
        GCC[GuaranteeContractController]
        RACC[RentalAllowanceContractController]
        SMCC[SepaMandateContractController]
        DDC[DirectDebitController]
        DC[DocumentController]
        DnC[DunningController]
        CEC[ContractEventsController]
        CACC[ContractAccountingController]
        CPC[ContractPersonsController]
        CPaC[ContractPartsController]
        TVC[TemplateValuesController]
    end

    subgraph StateMachines
        RCSM[RentalContract SM]
        RDCSM[RentalDelegateContract SM]
        GCSM[GuaranteeContract SM]
        ICSM[InsuranceContract SM]
        RACSM[RentalAllowanceContract SM]
        SMCSM[SepaMandateContract SM]
        SMM[StateMachineManager]
    end

    subgraph Listeners["SQS Listeners"]
        L1[PartFunction → onPartModified]
        L2[PersonFunction → onPersonModified]
        L3[FileFunction → onFileMetaDataModified]
        L4[IndexFunction → onIndexPublished]
        L5[ContractFunction]
        L6[AccountingFunction]
        L7[DunningFunction]
    end

    subgraph External
        Mongo[(adb-contracts)]
        S3[(S3 templates)]
        AtlasTrigger[Atlas Trigger]
        EB[EventBridge]
        SQS[SQS queues]
        SNS["SNS (DLQ router)"]
    end

    Controllers --> StateMachines
    Controllers --> Mongo
    DC --> S3
    Listeners --> Mongo

    Mongo -.entity change.-> AtlasTrigger
    AtlasTrigger -.-> EB
    EB -.-> SQS
    Listeners -.failed msg.-> SNS
    SNS -.routes to DLQ.-> SQS

erDiagram
    ContractEntity ||--o{ ContractPartEntry : "covers"
    ContractEntity ||--|| DirectDebitEntity : "direct debit"
    ContractEntity ||--o{ TemplateValuesEntity : "generates"
    ContractEntity ||--o{ ProposeContractEntity : "draft of"

    ContractEntity {
        string _id
        string type "RC / RDC / OC / BC (bank details) / insurance / guarantee / sepa"
        string state "DRAFT / ACTIVE / TERMINATED"
        date startDate
        date endDate
        array partIds
        array personIds
    }
    DirectDebitEntity {
        string _id
        string contractId
        string mandateId
        number amount
    }
    TemplateValuesEntity {
        string _id
        string contractId
        object values
    }
    ProposeContractEntity {
        string _id
        string contractId
        object proposal
    }

flowchart LR
    contracts[adb-contracts]
    persons[adb-persons]
    parts[adb-parts]
    files[adb-files]
    accounting[adb-accounting]
    utilities[adb-utilities]

    contracts -->|GET /persons| persons
    contracts -->|GET /parts| parts
    contracts -->|GET /files,<br/>POST /files| files
    contracts -->|GET /accounting/balances,<br/>POST /accounting/entries| accounting
    contracts -->|GET /utilities/i18n| utilities

    parts2[adb-parts] -->|GET /contracts/sellPart| contracts
    accounting2[adb-accounting] -->|GET /contracts| contracts
    aggregates[adb-aggregates] -->|GET /contracts| contracts
    views[adb-views] -->|GET /contracts| contracts
    reports[adb-reports] -.via aggregates.-> contracts