followthemoney 1.3.7__py3-none-any.whl → 3.8.1__py3-none-any.whl

followthemoney/schema/Address.yaml

@@ -0,0 +1,78 @@
+# OSM: https://wiki.openstreetmap.org/wiki/Proposed_features/House_numbers/Karlsruhe_Schema#Tags
+# Seen in the wild:
+#
+# - full
+# - remarks / note
+# - c/o
+# - location
+# - unknown
+# - address-details / street
+# - house number / house name
+# - address1 / address2 / address3
+# - city
+# - po box
+# - zip code / postcode / postal_code
+# - region
+# - area / state / province
+# - country
+Address:
+  label: Address
+  plural: Addresses
+  extends:
+    - Thing
+  description: >
+    A location associated with an entity.
+  matchable: true
+  generated: false
+  featured:
+    - full
+    - city
+    - street
+    - country
+  caption:
+    - full
+    - summary
+    - city
+    - remarks
+  properties:
+    full:
+      label: "Full address"
+      type: address
+    remarks:
+      label: "Remarks"
+      description: "Handling instructions, like 'care of'."
+    postOfficeBox:
+      label: "PO Box"
+      description: "A mailbox identifier at the post office"
+    street:
+      label: "Street address"
+    street2:
+      label: "Street address (ctd.)"
+    city:
+      label: "City"
+      description: "City, town, village or other locality"
+    postalCode:
+      label: "Postal code"
+      description: "Zip code or postcode."
+      maxLength: 16
+    region:
+      label: "Region"
+      description: "Also province or area."
+    state:
+      label: "State"
+      description: "State or federal unit."
+    latitude:
+      label: "Latitude"
+      type: "number"
+    longitude:
+      label: "Longitude"
+      type: "number"
+    country:
+      label: "Country"
+      type: "country"
+    osmId:
+      label: "OpenStreetmap Place ID"
+      type: "identifier"
+    googlePlaceId:
+      label: "Google Places ID"
+      type: "identifier"

followthemoney/schema/Airplane.yaml

@@ -1,20 +1,27 @@
 Airplane:
   label: Airplane
   plural: Airplanes
-  extends: Vehicle
-  icon: fa-plane
-  matchable: false
+  extends:
+    - Vehicle
+  description: >
+    An airplane, helicopter or other flying vehicle.
+  matchable: true
   featured:
-    - type               # Airbus A320 214SL
+    - type # Airbus A320 214SL
     - registrationNumber # A7-LAE
-    - country            # Qatar
-    - operator           # Qatar Airways
-    - owner              # Qatar Airways
+    - country # Qatar
+    - operator # Qatar Airways
+    - owner # Qatar Airways
+  caption:
+    - name
+    - registrationNumber
   properties:
-    serialNumber:           # 36576093870
+    serialNumber: # 36576093870
       label: Serial Number
       type: identifier
-    icaoCode:               # A320
+    icaoCode: # A320
       label: ICAO aircraft type designator
-    manufacturer:           # Airbus
+      type: identifier
+      maxLength: 16
+    manufacturer: # Airbus
       label: Manufacturer

followthemoney/schema/Analyzable.yaml

@@ -0,0 +1,54 @@
+Analyzable:
+  label: Analyzable
+  plural: Analyzables
+  description: >
+    An entity suitable for being processed via named-entity recognition.
+  abstract: true
+  matchable: false
+  generated: true
+  properties:
+    detectedLanguage:
+      label: "Detected language"
+      matchable: false
+      hidden: true
+      type: language
+    detectedCountry:
+      label: "Detected country"
+      matchable: false
+      hidden: true
+      type: country
+    namesMentioned:
+      label: "Detected names"
+      hidden: true
+      type: name
+    peopleMentioned:
+      label: "Detected people"
+      hidden: true
+      type: name
+    companiesMentioned:
+      label: "Detected companies"
+      hidden: true
+      type: name
+    ibanMentioned:
+      label: "Detected IBANs"
+      hidden: true
+      # type: identifier
+      # format: iban
+      type: iban
+    ipMentioned:
+      label: "Detected IP addresses"
+      hidden: true
+      type: ip
+    locationMentioned:
+      label: "Detected locations"
+      hidden: true
+      matchable: false
+      type: address
+    phoneMentioned:
+      label: "Detected phones"
+      hidden: true
+      type: phone
+    emailMentioned:
+      label: "Detected e-mail addresses"
+      hidden: true
+      type: email

followthemoney/schema/Article.yaml

@@ -0,0 +1,16 @@
+Article:
+  extends:
+    - Document
+  label: Article
+  plural: Articles
+  description: >
+    A piece of media reporting about a subject.
+  matchable: false
+  generated: true
+  featured:
+    - title
+    - author
+    - publishedAt
+  caption:
+    - title
+    - fileName

followthemoney/schema/Assessment.yaml

@@ -0,0 +1,32 @@
+Assessment:
+  # This is overly specific yet not useful. Should we phase it out?
+  label: Assessment
+  plural: Assessments
+  extends:
+    - Thing
+  matchable: false
+  featured:
+    - name
+    - publishDate
+    - author
+  caption:
+    - name
+  required:
+    - name
+  temporalExtent:
+    start:
+      - publishDate
+  properties:
+    publishDate:
+      label: "Date of publishing"
+      type: date
+    assessmentId:
+      label: "Assessment ID"
+    author:
+      label: "Author"
+      plural: "Authors"
+      type: entity
+      range: LegalEntity
+      reverse:
+        name: authoredAssessments
+        label: "Assessments authored"

followthemoney/schema/Asset.yaml

@@ -1,9 +1,15 @@
 Asset:
   label: Asset
   plural: Assets
-  extends: 
+  description: >
+    A piece of property which can be owned and assigned a monetary value.
+  extends:
     - Thing
     - Value
-  icon: fa-shopping-bag
-  abstract: true
-  matchable: false
+  featured:
+    - name
+    - amount
+  caption:
+    - name
+  abstract: false
+  matchable: false

followthemoney/schema/Associate.yaml

@@ -0,0 +1,41 @@
+Associate:
+  label: "Associate"
+  plural: "Associates"
+  description: "Non-family association between two people"
+  extends:
+    - Interval
+  matchable: false
+  featured:
+    - person
+    - associate
+    - relationship
+  required:
+    - person
+    - associate
+  edge:
+    source: person
+    label: "associated with"
+    target: associate
+    directed: false
+    caption:
+      - relationship
+  properties:
+    person:
+      label: "Person"
+      description: "The subject of the association."
+      type: entity
+      range: Person
+      reverse:
+        name: associates
+        label: "Associates"
+    associate:
+      label: "Associate"
+      description: "An associate of the subject person."
+      type: entity
+      range: Person
+      reverse:
+        name: associations
+        label: "Associations"
+    relationship:
+      label: "Relationship"
+      description: "Nature of the association"

followthemoney/schema/Audio.yaml

@@ -0,0 +1,24 @@
+Audio:
+  extends:
+    - Document
+  label: Audio
+  plural: Audio files
+  matchable: false
+  generated: true
+  featured:
+    - title
+    - fileName
+    - mimeType
+    - parent
+  caption:
+    - fileName
+    - title
+  properties:
+    duration:
+      label: "Duration"
+      description: "Duration of the audio in ms"
+      type: number
+    samplingRate:
+      label: "Sampling Rate"
+      description: "Sampling rate of the audio in Hz"
+      type: number

followthemoney/schema/BankAccount.yaml

@@ -1,26 +1,70 @@
 BankAccount:
-  label: Bank Account
-  plural: Bank Accounts
-  extends: Asset
-  icon: fa-bank
-  matchable: false
+  label: Bank account
+  plural: Bank accounts
+  extends:
+    - Asset
+  description: >
+    An account held at a bank and controlled by an owner. This may also be used
+    to describe more complex arrangements like correspondent bank settlement accounts.
+  matchable: true
   featured:
     - accountNumber
     - bankName
+  # required:
+  # - accountNumber
+  caption:
+    - name
+    - iban
+    - accountNumber
+  temporalExtent:
+    start:
+      - openingDate
+    end:
+      - closingDate
   properties:
     bankName:
-      label: Bank Name
+      label: Bank name
     accountNumber:
-      label: Account Number
+      label: Account number
       type: identifier
+      maxLength: 64
     iban:
       label: IBAN
+      # type: identifier
+      # format: iban
       type: iban
+      maxLength: 64
     bic:
       label: Bank Identifier Code
+      type: identifier
+      format: bic
+      maxLength: 16
+    bank:
+      label: Bank
+      type: entity
+      range: Organization
+      reverse:
+        name: bankAccounts
+        label: "Bank accounts"
     accountType:
-      label: Account Type
+      label: Account type
+    openingDate:
+      label: Opening date
+      type: date
+    closingDate:
+      label: Closing date
+      type: date
     balance:
       label: Balance
+      type: number
+    balanceDate:
+      label: Balance date
+      type: date
+    maxBalance:
+      label: Maximum balance
+      type: number
+    maxBalanceDate:
+      label: Maximum balance date
+      type: date
     bankAddress:
-      label: Bank Address
+      label: Bank address

followthemoney/schema/Call.yaml

@@ -0,0 +1,48 @@
+Call:
+  extends:
+    - Interval
+  label: "Call"
+  plural: "Calls"
+  matchable: false
+  generated: true
+  featured:
+    - callerNumber
+    - caller
+    - receiverNumber
+    - receiver
+    - date
+  caption:
+    - callerNumber
+    - receiverNumber
+  properties:
+    caller:
+      label: "Caller"
+      type: entity
+      range: LegalEntity
+      reverse:
+        name: callsMade
+        label: "Calls made"
+    callerNumber:
+      label: "Caller's Number"
+      type: phone
+    receiver:
+      label: "Receiver"
+      type: entity
+      range: LegalEntity
+      reverse:
+        name: callsReceived
+        label: "Calls received"
+    receiverNumber:
+      label: "Receiver's Number"
+      type: phone
+    duration:
+      label: "Duration"
+      descriptuon: "Call Duration in seconds"
+      type: number
+    # recording:
+    #   label: "Recording of the call"
+    #   type: entity
+    #   range: Audio
+    #   reverse:
+    #     name: "recordedCall"
+    #     label: "Recording of"

followthemoney/schema/CallForTenders.yaml

@@ -0,0 +1,117 @@
+CallForTenders:
+  label: "Call for tenders"
+  plural: "Calls for tenders"
+  description: >
+    A public appeal issued by an authority, possibly on behalf of another,
+    for buying a specific work, supply or service
+  extends:
+    - Thing
+    - Interval
+  matchable: false
+  required:
+    - title
+    - authority
+  featured:
+    - title
+    - authority
+  caption:
+    - title
+  properties:
+    callId:
+      label: "CfT unique id"
+      type: identifier
+    title:
+      label: "Title"
+    authority:
+      label: "Name of contracting authority"
+      reverse:
+        name: callForTenders
+        label: "Call For Tenders"
+      type: entity
+      range: LegalEntity
+    authorityReferenceId:
+      label: "Contracting authority reference ID"
+      type: identifier
+    onBehalfOf:
+      label: "Published on behalf of"
+      reverse:
+        name: delegatedCallForTenders
+        label: "Delegated call for tenders"
+      type: entity
+      range: LegalEntity
+    publicationDate:
+      label: "Date of publication/invitation"
+      type: date
+    evaluationMechanism:
+      label: "Evaluation mechanism"
+    procurementType:
+      label: "Procurement type"
+    directive:
+      label: "Directive"
+    procedure:
+      label: "Procedure"
+    involvesOutcome:
+      label: "Call for tenders result"
+      description: "The nature of the contractual agreement that will result from this CfT"
+    cpvCode:
+      label: "CPV code"
+      description: "Common Procurement Vocabulary (CPV)"
+      type: identifier
+    reverseAuctionsIncluded:
+      label: "Inclusion of e-Auctions"
+      # cf. https://mita.gov.mt/2021/10/05/reverse-bidding-for-data-connectivity-across-the-public-service-a-first-for-malta/
+    nutsCode:
+      label: "NUTS code"
+      description: "Nomenclature of Territorial Units for Statistics (NUTS)"
+      type: identifier
+    relationToThreshold:
+      label: "Above or below threshold"
+    paymentOptions:
+      label: "Payment options"
+    submissionDeadline:
+      label: "Submission deadline"
+      type: date
+    clarificationDeadline:
+      label: "End of clarification period"
+      type: date
+    awardedInLots:
+      label: "Contract awarded in Lots"
+    numberOfLots:
+      label: "Number of lots"
+      type: number
+    lotsNames:
+      label: "Lots names"
+    tendersForLots:
+      # What does this mean?
+      label: "Tenders for lots"
+    maximumNumberOfLots:
+      label: "Maximum number of lots"
+      type: number
+    euFunding:
+      label: "EU funding"
+    multipleTenders:
+      label: "Multiple tenders will be accepted"
+    tedUrl:
+      label: "TED link for published notices"
+      type: url
+    fallsUnderGPPScope:
+      label: "Does this call fall under the scope of GPP?"
+      description: "European Green Public Procurement (GPP) or green purchasing."
+    certificationCheck:
+      label: "Certification check"
+    awardingDate:
+      label: "Date of awarding"
+      type: date
+    contractNoticeDate:
+      label: "Contract notice date"
+      type: date
+    awardNoticeDate:
+      label: "Award Notice Date"
+      type: date
+    tenderers:
+      label: "Tenderers"
+      reverse:
+        name: callForTenders
+        label: "Tender"
+      type: entity
+      range: LegalEntity

followthemoney/schema/Company.yaml

@@ -1,16 +1,23 @@
 Company:
   label: Company
   plural: Companies
-  icon: fa-industry
+  description: >
+    A corporation, usually for profit. Does not distinguish between private and public
+    companies, and can also be used to model more specific constructs like trusts and
+    funds. Companies are assets, so they can be owned by other legal entities.
   matchable: true
   extends:
     - Organization
     - Asset
   featured:
     - name
-    - registrationNumber
     - jurisdiction
+    - registrationNumber
     - incorporationDate
+  required:
+    - name
+  caption:
+    - name
   properties:
     jurisdiction:
       label: Jurisdiction
@@ -24,14 +31,12 @@ Company:
       label: "VOEN"
       description: "Azerbaijan taxpayer ID"
       type: identifier
+      maxLength: 32
     coatoCode:
       label: "COATO / SOATO / OKATO"
       type: identifier
-      descrption: "Soviet classifier for territories, regions, districts, villages. Aka. SOATO and same as OKATO"
-    vatCode:
-      label: "VAT Identifier"
-      description: "(EU) VAT number"
-      type: identifier
+      description: "Soviet classifier for territories, regions, districts, villages. Aka. SOATO and same as OKATO"
+      matchable: false
     irsCode:
       label: "IRS Number"
       description: "US tax ID"
@@ -39,6 +44,7 @@ Company:
     ipoCode:
       label: "IPO"
       type: identifier
+      matchable: false
     cikCode:
       label: "SEC Central Index Key"
       description: "US SEC Central Index Key"
@@ -51,36 +57,55 @@ Company:
       label: "MBS"
       type: identifier
     ibcRuc:
+      # TODO: Remove this. It's a column name in the ICIJ-released OffshoreLeaks datasets
+      # but seems to just mean "company number".
+      deprecated: true
       label: "ibcRUC"
       type: identifier
     caemCode:
       label: "COD CAEM"
       description: "(RO) What kind of activity a legal entity is allowed to develop"
+      matchable: false
     kppCode:
       label: "KPP"
       description: "(RU, КПП) in addition to INN for orgs; reason for registration at FNS"
       type: identifier
+      matchable: false
     okvedCode:
       label: "OKVED(2) Classifier"
       description: "(RU, ОКВЭД) Economical activity classifier. OKVED2 is the same but newer"
+      matchable: false
     okopfCode:
       label: "OKOPF"
       description: "(RU, ОКОПФ) What kind of business entity"
+      matchable: false
     fnsCode:
       label: "Federal tax service code"
       description: "(RU, ФНС) Federal Tax Service related info"
       type: identifier
+      matchable: false
     fssCode:
       label: "FSS"
       description: "(RU, ФСС) Social Security"
-    ogrnCode:
-      label: "OGRN"
-      description: "Major State Registration Number"
-      type: identifier
+    bikCode:
+      label: "BIK"
+      description: "Russian bank account code"
     pfrNumber:
       label: "PFR Number"
       description: "(RU, ПФР) Pension Fund Registration number. AAA-BBB-CCCCCC, where AAA is organisation region, BBB is district, CCCCCC number at a specific branch"
       type: identifier
     oksmCode:
       label: OKSM
-      description: "Russian (ОКСМ) countries classifer"
+      description: "Russian (ОКСМ) countries classifier"
+      matchable: false
+    isinCode:
+      label: ISIN
+      description: International Securities Identification Number
+      type: identifier
+    ticker:
+      label: Stock ticker symbol
+      type: identifier
+    ricCode:
+      label: Reuters Instrument Code
+      type: identifier
+      maxLength: 16