docs and moving stuff

models/reporting/core/schema.yaml

@@ -18,6 +18,9 @@ models:
       - name: id_payment
         data_type: bigint
         description: Superhog id for this Payment.
+        tests:
+          - unique
+          - not_null
 
       - name: is_refundable
         data_type: boolean
@@ -108,3 +111,70 @@ models:
       - name: notes
         data_type: character varying
         description: Free text description on the payment. Typically, contains explanations for integration issues with the payment processor.
+
+  - name: core__bookings
+    description: |
+
+      Bookings that have been processed by the Superhog backend.
+
+      Each record matches one booking.
+
+      All data is coming from the Superhog backend. Some dimensions have been denormalized. 
+      Some pre-aggregations to the booking level have also been performed and added here.
+
+    columns:
+      - name: id_booking
+        data_type: bigint
+        description: The unique, Superhog generated id for this booking.
+        tests:
+          - unique
+          - not_null
+
+      - name: id_user_guest
+        data_type: character varying
+        description: The UUID of the Superhog user playing the guest role in the booking.
+
+      - name: id_user_host
+        data_type: character varying
+        description: The UUID of the Superhog user playing the host role in the booking.
+
+      - name: id_accommodation
+        data_type: bigint
+        description: The ID of the booked listing.
+
+      - name: is_duplicate_booking
+        data_type: boolean
+        description: |
+          A flag that identifies whether the booking is a duplicate.
+
+          A booking is considered a duplicate if there's an older booking with the same user,
+          accomodation and check-in date. If there are two or more bookings with the same user,
+          accomodation and check-in date, the oldest one will have False as a value in this field,
+          and the other ones will have True as a value in this Failed."
+
+          Put simply, if you don't want to receive duplicates, filter this field to True.
+
+      - name: booking_fee_local
+        data_type: numeric
+        description: |
+          The fee that Superhog should charge the host for this booking, measured in local 
+          currency.
+
+          This fee is calculated by finding what was the active price plan for the host user 
+          when the booking fee had to be charged. 
+
+      - name: booking_fee_charge_at_utc
+        data_type: timestamp without time zone
+        description: |
+          The point in time in which the booking should be invoiced.
+
+          This could be the check-in date of the booking or the date in which the guest verification
+          started, depending on the billing settings of the host.
+
+      - name: booking_fee_charge_date_utc
+        data_type: date
+        description: |
+          The date in which the booking should be invoiced.
+
+          This could be the check-in date of the booking or the date in which the guest verification
+          started, depending on the billing settings of the host.