Merge pull request #100 from Freika/notifications

Notifications

.app_version

@@ -1 +1 @@
-0.8.2
+0.8.3

CHANGELOG.md

@@ -5,7 +5,16 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/)
 and this project adheres to [Semantic Versioning](http://semver.org/).
 
-## [0.8.1] — 2024-06-30
+## [0.8.3] — 2024-07-03
+
+### Added
+
+- Notifications system. Now you will receive a notification when an import or export is finished, when stats update is completed and if any error occurs during any of these processes. Notifications are displayed in the top right corner of the screen and are stored in the database. You can see all your notifications on the Notifications page.
+- Swagger API docs for /api/v1/owntracks/points You can find the API docs at `/api-docs`.
+
+---
+
+## [0.8.2] — 2024-06-30
 
 ### Added
 

app/controllers/application_controller.rb

@@ -3,8 +3,16 @@
 class ApplicationController < ActionController::Base
   include Pundit::Authorization
 
+  before_action :unread_notifications
+
   protected
 
+  def unread_notifications
+    return [] unless current_user
+
+    @unread_notifications ||= Notification.where(user: current_user).unread
+  end
+
   def authenticate_api_key
     return head :unauthorized unless current_api_user
 

app/controllers/notifications_controller.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+class NotificationsController < ApplicationController
+  before_action :authenticate_user!
+  before_action :set_notification, only: %i[show destroy]
+
+  def index
+    @notifications =
+      current_user.notifications.order(created_at: :desc).paginate(page: params[:page], per_page: 20)
+  end
+
+  def show; end
+
+  def mark_as_read
+    current_user.notifications.unread.update_all(read_at: Time.zone.now)
+
+    redirect_to notifications_url, notice: 'All notifications marked as read.', status: :see_other
+  end
+
+  def destroy
+    @notification.destroy!
+    redirect_to notifications_url, notice: 'Notification was successfully destroyed.', status: :see_other
+  end
+
+  private
+
+  def set_notification
+    @notification = Notification.find(params[:id])
+  end
+end

app/jobs/import_job.rb

@@ -13,7 +13,21 @@ class ImportJob < ApplicationJob
       raw_points: result[:raw_points], doubles: result[:doubles], processed: result[:processed]
     )
 
+    Notifications::Create.new(
+      user:,
+      kind: :info,
+      title: 'Import finished',
+      content: "Import \"#{import.name}\" successfully finished."
+    ).call
+
     StatCreatingJob.perform_later(user_id)
+  rescue StandardError => e
+    Notifications::Create.new(
+      user:,
+      kind: :error,
+      title: 'Import failed',
+      content: "Import \"#{import.name}\" failed: #{e.message}"
+    ).call
   end
 
   private

app/jobs/owntracks/point_creating_job.rb

@@ -3,8 +3,7 @@
 class Owntracks::PointCreatingJob < ApplicationJob
   queue_as :default
 
-  # TODO: after deprecation of old endpoint, make user_id required
-  def perform(point_params, user_id = nil)
+  def perform(point_params, user_id)
     parsed_params = OwnTracks::Params.new(point_params).call
 
     return if point_exists?(parsed_params, user_id)

app/models/notification.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+class Notification < ApplicationRecord
+  belongs_to :user
+
+  validates :title, :content, :kind, presence: true
+
+  enum kind: { info: 0, warning: 1, error: 2 }
+
+  scope :unread, -> { where(read_at: nil) }
+end

app/models/user.rb

@@ -11,6 +11,7 @@ class User < ApplicationRecord
   has_many :stats, dependent: :destroy
   has_many :tracked_points, class_name: 'Point', dependent: :destroy
   has_many :exports, dependent: :destroy
+  has_many :notifications, dependent: :destroy
 
   after_create :create_api_key
 

app/services/create_stats.rb

@@ -26,6 +26,10 @@ class CreateStats
           stat.save
         end
       end
+
+      Notifications::Create.new(user:, kind: :info, title: 'Stats updated', content: 'Stats updated').call
+    rescue StandardError => e
+      Notifications::Create.new(user:, kind: :error, title: 'Stats update failed', content: e.message).call
     end
   end
 

app/services/exports/create.rb

@@ -23,9 +23,23 @@ class Exports::Create
     File.open(file_path, 'w') { |file| file.write(data) }
 
     export.update!(status: :completed, url: "exports/#{export.name}.json")
+
+    Notifications::Create.new(
+      user:,
+      kind: :info,
+      title: 'Export finished',
+      content: "Export \"#{export.name}\" successfully finished."
+    ).call
   rescue StandardError => e
     Rails.logger.error("====Export failed to create: #{e.message}")
 
+    Notifications::Create.new(
+      user:,
+      kind: :error,
+      title: 'Export failed',
+      content: "Export \"#{export.name}\" failed: #{e.message}"
+    ).call
+
     export.update!(status: :failed)
   end
 

app/services/notifications/create.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+class Notifications::Create
+  attr_reader :user, :kind, :title, :content
+
+  def initialize(user:, kind:, title:, content:)
+    @user     = user
+    @kind     = kind
+    @title    = title
+    @content  = content
+  end
+
+  def call
+    Notification.create!(user:, kind:, title:, content:)
+  end
+end

app/views/imports/new.html.erb

@@ -35,5 +35,5 @@
 
   <%= render "form", import: @import %>
 
-  <%= link_to "Back to imports", imports_path, class: "ml-2 rounded-lg py-3 px-5 bg-gray-100 inline-block font-medium" %>
+  <%= link_to "Back to imports", imports_path, class: "btn mx-5 mb-5" %>
 </div>

app/views/layouts/application.html.erb

@@ -6,7 +6,7 @@
     <%= csrf_meta_tags %>
     <%= csp_meta_tag %>
 
-    <link href="https://cdn.jsdelivr.net/npm/daisyui@4.11.1/dist/full.css" rel="stylesheet" type="text/css">
+    <link href="https://cdn.jsdelivr.net/npm/daisyui@4.12.10/dist/full.css" rel="stylesheet" type="text/css">
     <link rel="stylesheet" href="https://unpkg.com/leaflet@1.9.4/dist/leaflet.css" integrity="sha256-p4NxAoJBhIIN+hmNHrzRCf9tD/miZyoHS5obTRR9BMY=" crossorigin="" />
 
     <%= stylesheet_link_tag "tailwind", "inter-font", "data-turbo-track": "reload" %>

app/views/map/index.html.erb

@@ -1,6 +1,6 @@
 <% content_for :title, 'Map' %>
 
-<div class='w-4/5 mt-10'>
+<div class='w-4/5 mt-8'>
   <div class="flex flex-col space-y-4 mb-4 w-full">
     <%= form_with url: map_path, method: :get do |f| %>
       <div class="flex flex-col md:flex-row md:space-x-4 md:items-end">
@@ -55,7 +55,7 @@
   </div>
 
 </div>
-<div class='w-1/5 mt-10'>
+<div class='w-1/5 mt-8'>
   <%= render 'shared/right_sidebar' %>
 </div>
 

app/views/notifications/_notification.html.erb

@@ -0,0 +1,22 @@
+<div role="<%= notification.kind %>" class="<%= notification.kind %> shadow-lg p-5 flex justify-between items-center mb-4 rounded-lg bg-neutral" id="<%= dom_id notification %>">
+  <div class="flex-1">
+    <h3 class="font-bold text-xl">
+      <%= link_to notification.title, notification, class: 'link hover:no-underline text-blue-600' %>
+    </h3>
+    <div class="text-sm text-gray-500"><%= time_ago_in_words notification.created_at %> ago</div>
+
+    <% if params[:action] == 'show' %>
+      <div class="mt-2">
+        <%= notification.content %>
+
+        <% if notification.error? %>
+          <div class="mt-2">
+            Please, when reporting a bug to <a href="https://github.com/Freika/dawarich/issues" class="link hover:no-underline text-blue-600">Github Issues</a>, don't forget to include logs from <code>dawarich_app</code> and <code>dawarich_sidekiq</code> docker containers. Thank you!
+          </div>
+        <% end %>
+      </div>
+    <% end %>
+  </div>
+  <div class="badge badge-<%= notification.kind %> gap-2">
+  </div>
+</div>

app/views/notifications/index.html.erb

@@ -0,0 +1,17 @@
+<% content_for :title, "Notifications" %>
+<div class="flex flex-col items-center w-full">
+  <div class="text-center mb-6">
+    <h1 class="font-bold text-4xl mb-4">Notifications</h1>
+    <div class="flex items-center justify-center mb-4">
+      <%= link_to "Mark all as read", mark_notifications_as_read_path, method: :post, data: { turbo_method: :post }, class: "btn btn-sm btn-primary" %>
+    </div>
+    <div class="mb-4">
+      <%= will_paginate @notifications %>
+    </div>
+  </div>
+  <div id="notifications" class="w-full max-w-2xl">
+    <% @notifications.each do |notification| %>
+      <%= render notification %>
+    <% end %>
+  </div>
+</div>

app/views/notifications/show.html.erb

@@ -0,0 +1,12 @@
+<div class="mx-auto md:w-2/3 w-full flex">
+  <div class="mx-auto">
+    <%= render @notification %>
+
+    <div class='my-5'>
+      <%= link_to "Back to notifications", notifications_path, class: "btn btn-small" %>
+      <div class="inline-block ml-2">
+        <%= button_to "Destroy this notification", @notification, data: { confirm: "Are you sure?", turbo_confirm: "Are you sure?", turbo_method: :delete }, method: :delete, class: "btn btn-small btn-warning" %>
+      </div>
+    </div>
+  </div>
+</div>

app/views/shared/_navbar.html.erb

@@ -1,4 +1,4 @@
-<div class="navbar bg-base-100 mb-5">
+<div class="navbar bg-base-100">
   <div class="navbar-start">
     <div class="dropdown">
       <label tabindex="0" class="btn btn-ghost lg:hidden">
@@ -46,22 +46,53 @@
     </ul>
   </div>
   <div class="navbar-end">
-  <%# menu menu-sm dropdown-content mt-3 z-[1] p-2 shadow bg-base-100 rounded-box w-52 %>
     <ul class="menu menu-horizontal bg-base-100 rounded-box px-1">
       <% if user_signed_in? %>
-        <li>
-        <details>
-          <summary>
-            <%= "#{current_user.email}" %>
-          </summary>
-          <ul class="p-2 bg-base-100 rounded-t-none z-10">
-            <li><%= link_to 'Account', edit_user_registration_path %></li>
-            <li><%= link_to 'Settings', settings_path %></li>
-            <li><%= link_to 'Logout', destroy_user_session_path, method: :delete, data: { turbo_method: :delete } %></li>
+        <div class="dropdown dropdown-end dropdown-bottom">
+          <div tabindex="0" role="button" class='btn btn-sm btn-ghost hover:btn-ghost'>
+            <svg
+              xmlns="http://www.w3.org/2000/svg"
+              class="h-5 w-5"
+              fill="none"
+              viewBox="0 0 24 24"
+              stroke="currentColor">
+              <path
+                stroke-linecap="round"
+                stroke-linejoin="round"
+                stroke-width="2"
+                d="M15 17h5l-1.405-1.405A2.032 2.032 0 0118 14.158V11a6.002 6.002 0 00-4-5.659V5a2 2 0 10-4 0v.341C7.67 6.165 6 8.388 6 11v3.159c0 .538-.214 1.055-.595 1.436L4 17h5m6 0v1a3 3 0 11-6 0v-1m6 0H9" />
+            </svg>
+            <% if @unread_notifications.present? %>
+              <span class="badge badge-xs badge-primary"></span>
+            <% end %>
+          </div>
+          <ul tabindex="0" class="dropdown-content z-10 menu p-2 shadow-lg bg-base-100 rounded-box min-w-52">
+            <% if @unread_notifications.any? %>
+              <li><%= link_to 'See all', notifications_path %></li>
+              <div class="divider p-0 m-0"></div>
+            <% end %>
+            <% @unread_notifications.first(10).each do |notification| %>
+              <li>
+                <%= link_to notification do %>
+                  <%= notification.title %>
+                  <div class="badge badge-xs justify-self-end badge-<%= notification.kind %>"></div>
+                <% end %>
+              </li>
+            <% end %>
           </ul>
-        </details>
-      </li>
-        </details>
+        </div>
+        <li>
+          <details>
+            <summary>
+              <%= "#{current_user.email}" %>
+            </summary>
+            <ul class="p-2 bg-base-100 rounded-t-none z-10">
+              <li><%= link_to 'Account', edit_user_registration_path %></li>
+              <li><%= link_to 'Settings', settings_path %></li>
+              <li><%= link_to 'Logout', destroy_user_session_path, method: :delete, data: { turbo_method: :delete } %></li>
+            </ul>
+          </details>
+        </li>
       <% else %>
         <li><%= link_to 'Login', new_user_session_path %></li>
       <% end %>

config/routes.rb

@@ -23,6 +23,8 @@ Rails.application.routes.draw do
       delete :bulk_destroy
     end
   end
+  resources :notifications, only: %i[index show destroy]
+  post 'notifications/mark_as_read', to: 'notifications#mark_as_read', as: :mark_notifications_as_read
   resources :stats, only: :index do
     collection do
       post :update

db/migrate/20240703105734_create_notifications.rb

@@ -0,0 +1,14 @@
+class CreateNotifications < ActiveRecord::Migration[7.1]
+  def change
+    create_table :notifications do |t|
+      t.string :title, null: false
+      t.text :content, null: false
+      t.references :user, null: false, foreign_key: true
+      t.integer :kind, null: false, default: 0
+      t.datetime :read_at
+
+      t.timestamps
+    end
+    add_index :notifications, :kind
+  end
+end

db/schema.rb

@@ -10,7 +10,7 @@
 #
 # It's strongly recommended that you check this file into your version control system.
 
-ActiveRecord::Schema[7.1].define(version: 2024_06_30_093005) do
+ActiveRecord::Schema[7.1].define(version: 2024_07_03_105734) do
   # These are extensions that must be enabled in order to support this database
   enable_extension "plpgsql"
 
@@ -70,6 +70,18 @@ ActiveRecord::Schema[7.1].define(version: 2024_06_30_093005) do
     t.index ["user_id"], name: "index_imports_on_user_id"
   end
 
+  create_table "notifications", force: :cascade do |t|
+    t.string "title", null: false
+    t.text "content", null: false
+    t.bigint "user_id", null: false
+    t.integer "kind", default: 0, null: false
+    t.datetime "read_at"
+    t.datetime "created_at", null: false
+    t.datetime "updated_at", null: false
+    t.index ["kind"], name: "index_notifications_on_kind"
+    t.index ["user_id"], name: "index_notifications_on_user_id"
+  end
+
   create_table "points", force: :cascade do |t|
     t.integer "battery_status"
     t.string "ping"
@@ -142,6 +154,7 @@ ActiveRecord::Schema[7.1].define(version: 2024_06_30_093005) do
 
   add_foreign_key "active_storage_attachments", "active_storage_blobs", column: "blob_id"
   add_foreign_key "active_storage_variant_records", "active_storage_blobs", column: "blob_id"
+  add_foreign_key "notifications", "users"
   add_foreign_key "points", "users"
   add_foreign_key "stats", "users"
 end

spec/factories/notifications.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+FactoryBot.define do
+  factory :notification do
+    title { "MyString" }
+    content { "MyText" }
+    user
+    kind { :info }
+    read_at { nil }
+  end
+end

spec/jobs/import_job_spec.rb

@@ -18,5 +18,23 @@ RSpec.describe ImportJob, type: :job do
 
       perform
     end
+
+    it 'creates a notification' do
+      expect { perform }.to change { Notification.count }.by(1)
+    end
+
+    context 'when there is an error' do
+      before do
+        allow_any_instance_of(OwnTracks::ExportParser).to receive(:call).and_raise(StandardError)
+      end
+
+      it 'does not create points' do
+        expect { perform }.not_to(change { Point.count })
+      end
+
+      it 'creates a notification' do
+        expect { perform }.to change { Notification.count }.by(1)
+      end
+    end
   end
 end

spec/models/notification_spec.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require 'rails_helper'
+
+RSpec.describe Notification, type: :model do
+  describe 'validations' do
+    it { is_expected.to validate_presence_of(:title) }
+    it { is_expected.to validate_presence_of(:content) }
+    it { is_expected.to validate_presence_of(:kind) }
+  end
+
+  describe 'associations' do
+    it { is_expected.to belong_to(:user) }
+  end
+
+  describe 'enums' do
+    it { is_expected.to define_enum_for(:kind).with_values(info: 0, warning: 1, error: 2) }
+  end
+
+  describe 'scopes' do
+    describe '.unread' do
+      let(:read_notification) { create(:notification, read_at: Time.current) }
+      let(:unread_notification) { create(:notification, read_at: nil) }
+
+      it 'returns only unread notifications' do
+        expect(described_class.unread).to eq([unread_notification])
+      end
+    end
+  end
+end

spec/models/point_spec.rb

@@ -12,8 +12,5 @@ RSpec.describe Point, type: :model do
     it { is_expected.to validate_presence_of(:latitude) }
     it { is_expected.to validate_presence_of(:longitude) }
     it { is_expected.to validate_presence_of(:timestamp) }
-    # Disabled them (for now) because they are not present in the Overland data
-    xit { is_expected.to validate_presence_of(:tracker_id) }
-    xit { is_expected.to validate_presence_of(:topic) }
   end
 end

spec/models/user_spec.rb

@@ -9,6 +9,7 @@ RSpec.describe User, type: :model do
     it { is_expected.to have_many(:stats) }
     it { is_expected.to have_many(:tracked_points).class_name('Point').dependent(:destroy) }
     it { is_expected.to have_many(:exports).dependent(:destroy) }
+    it { is_expected.to have_many(:notifications).dependent(:destroy) }
   end
 
   describe 'callbacks' do

spec/requests/devise/registrations_spec.rb

@@ -1,16 +0,0 @@
-# frozen_string_literal: true
-
-require 'rails_helper'
-
-RSpec.describe 'users', type: :request do
-  # Skip this because user registration is disabled
-  xdescribe 'POST /create' do
-    let(:user_params) do
-      { user: FactoryBot.attributes_for(:user) }
-    end
-
-    it 'creates master' do
-      expect { post '/users', params: user_params }.to change(User, :count).by(1)
-    end
-  end
-end

spec/requests/notifications_spec.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require 'rails_helper'
+
+RSpec.describe '/notifications', type: :request do
+  before do
+    stub_request(:any, 'https://api.github.com/repos/Freika/dawarich/tags')
+      .to_return(status: 200, body: '[{"name": "1.0.0"}]', headers: {})
+  end
+
+  context 'when user is not logged in' do
+    it 'redirects to the login page' do
+      get notifications_url
+
+      expect(response).to redirect_to(new_user_session_url)
+    end
+  end
+
+  context 'when user is logged in' do
+    let(:user) { create(:user) }
+
+    before do
+      sign_in user
+    end
+
+    describe 'GET /index' do
+      it 'renders a successful response' do
+        get notifications_url
+
+        expect(response).to be_successful
+      end
+    end
+
+    describe 'GET /show' do
+      let(:notification) { create(:notification, user:) }
+
+      it 'renders a successful response' do
+        get notification_url(notification)
+
+        expect(response).to be_successful
+      end
+    end
+
+    describe 'DELETE /destroy' do
+      let!(:notification) { create(:notification, user:) }
+
+      it 'destroys the requested notification' do
+        expect do
+          delete notification_url(notification)
+        end.to change(Notification, :count).by(-1)
+      end
+
+      it 'redirects to the notifications list' do
+        delete notification_url(notification)
+
+        expect(response).to redirect_to(notifications_url)
+      end
+    end
+
+    describe 'POST /mark_as_read' do
+      let!(:notification) { create(:notification, user:, read_at: nil) }
+
+      it 'marks all notifications as read' do
+        post mark_notifications_as_read_url
+
+        expect(notification.reload.read_at).to be_present
+      end
+
+      it 'redirects to the notifications list' do
+        post mark_notifications_as_read_url
+
+        expect(response).to redirect_to(notifications_url)
+      end
+    end
+  end
+end

spec/services/create_stats_spec.rb

@@ -30,6 +30,24 @@ RSpec.describe CreateStats do
 
         expect(Stat.last.distance).to eq(563)
       end
+
+      it 'created notifications' do
+        expect { create_stats }.to change { Notification.count }.by(1)
+      end
+
+      context 'when there is an error' do
+        before do
+          allow(Stat).to receive(:find_or_initialize_by).and_raise(StandardError)
+        end
+
+        it 'does not create stats' do
+          expect { create_stats }.not_to(change { Stat.count })
+        end
+
+        it 'created notifications' do
+          expect { create_stats }.to change { Notification.count }.by(1)
+        end
+      end
     end
   end
 end

spec/services/exports/create_spec.rb

@@ -28,6 +28,16 @@ RSpec.describe Exports::Create do
       expect(export.reload.url).to eq("exports/#{export.name}.json")
     end
 
+    it 'updates the export status to completed' do
+      create_export
+
+      expect(export.reload.completed?).to be_truthy
+    end
+
+    it 'creates a notification' do
+      expect { create_export }.to change { Notification.count }.by(1)
+    end
+
     context 'when an error occurs' do
       before do
         allow(File).to receive(:open).and_raise(StandardError)
@@ -38,6 +48,16 @@ RSpec.describe Exports::Create do
 
         expect(export.reload.failed?).to be_truthy
       end
+
+      it 'logs the error' do
+        expect(Rails.logger).to receive(:error).with('====Export failed to create: StandardError')
+
+        create_export
+      end
+
+      it 'creates a notification' do
+        expect { create_export }.to change { Notification.count }.by(1)
+      end
     end
   end
 end

spec/swagger/api/v1/overland/batches_controller_spec.rb

@@ -2,7 +2,7 @@
 
 require 'swagger_helper'
 
-describe 'Batches API', type: :request do
+describe 'Overland Batches API', type: :request do
   path '/api/v1/overland/batches' do
     post 'Creates a batch of points' do
       request_body_example value: {

spec/swagger/api/v1/owntracks/points_controller_spec.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+require 'swagger_helper'
+
+describe 'OwnTracks Points API', type: :request do
+  path '/api/v1/owntracks/points' do
+    post 'Creates a point' do
+      request_body_example value: {
+        'batt': 85,
+        'lon': -74.0060,
+        'acc': 8,
+        'bs': 2,
+        'inrids': [
+          '5f1d1b'
+        ],
+        'BSSID': 'b0:f2:8:45:94:33',
+        'SSID': 'Home Wifi',
+        'vac': 3,
+        'inregions': [
+          'home'
+        ],
+        'lat': 40.7128,
+        'topic': 'owntracks/jane/iPhone 12 Pro',
+        't': 'p',
+        'conn': 'w',
+        'm': 1,
+        'tst': 1706965203,
+        'alt': 41,
+        '_type': 'location',
+        'tid': 'RO',
+        '_http': true,
+        'ghash': 'u33d773',
+        'isorcv': '2024-02-03T13:00:03Z',
+        'isotst': '2024-02-03T13:00:03Z',
+        'disptst': '2024-02-03 13:00:03'
+      }
+      tags 'Points'
+      consumes 'application/json'
+      parameter name: :point, in: :body, schema: {
+        type: :object,
+        properties: {
+          batt: { type: :number },
+          lon: { type: :number },
+          acc: { type: :number },
+          bs: { type: :number },
+          inrids: { type: :array },
+          BSSID: { type: :string },
+          SSID: { type: :string },
+          vac: { type: :number },
+          inregions: { type: :array },
+          lat: { type: :number },
+          topic: { type: :string },
+          t: { type: :string },
+          conn: { type: :string },
+          m: { type: :number },
+          tst: { type: :number },
+          alt: { type: :number },
+          _type: { type: :string },
+          tid: { type: :string },
+          _http: { type: :boolean },
+          ghash: { type: :string },
+          isorcv: { type: :string },
+          isotst: { type: :string },
+          disptst: { type: :string }
+        },
+        required: %w[owntracks/jane]
+      }
+
+      parameter name: :api_key, in: :query, type: :string, required: true, description: 'API Key'
+
+      response '200', 'Point created' do
+        let(:file_path) { 'spec/fixtures/files/owntracks/export.json' }
+        let(:file) { File.open(file_path) }
+        let(:json) { JSON.parse(file.read) }
+        let(:point) { json['test']['iphone-12-pro'].first }
+        let(:api_key) { create(:user).api_key }
+
+        run_test!
+      end
+
+      response '401', 'Unauthorized' do
+        let(:file_path) { 'spec/fixtures/files/owntracks/export.json' }
+        let(:file) { File.open(file_path) }
+        let(:json) { JSON.parse(file.read) }
+        let(:point) { json['test']['iphone-12-pro'].first }
+        let(:api_key) { nil }
+
+        run_test!
+      end
+    end
+  end
+end

swagger/v1/swagger.yaml

@@ -102,6 +102,106 @@ paths:
                       wifi: unknown
                       battery_state: unknown
                       battery_level: 0
+  "/api/v1/owntracks/points":
+    post:
+      summary: Creates a point
+      tags:
+      - Points
+      parameters:
+      - name: api_key
+        in: query
+        required: true
+        description: API Key
+        schema:
+          type: string
+      responses:
+        '200':
+          description: Point created
+        '401':
+          description: Unauthorized
+      requestBody:
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                batt:
+                  type: number
+                lon:
+                  type: number
+                acc:
+                  type: number
+                bs:
+                  type: number
+                inrids:
+                  type: array
+                BSSID:
+                  type: string
+                SSID:
+                  type: string
+                vac:
+                  type: number
+                inregions:
+                  type: array
+                lat:
+                  type: number
+                topic:
+                  type: string
+                t:
+                  type: string
+                conn:
+                  type: string
+                m:
+                  type: number
+                tst:
+                  type: number
+                alt:
+                  type: number
+                _type:
+                  type: string
+                tid:
+                  type: string
+                _http:
+                  type: boolean
+                ghash:
+                  type: string
+                isorcv:
+                  type: string
+                isotst:
+                  type: string
+                disptst:
+                  type: string
+              required:
+              - owntracks/jane
+            examples:
+              '0':
+                summary: Creates a point
+                value:
+                  batt: 85
+                  lon: -74.006
+                  acc: 8
+                  bs: 2
+                  inrids:
+                  - 5f1d1b
+                  BSSID: b0:f2:8:45:94:33
+                  SSID: Home Wifi
+                  vac: 3
+                  inregions:
+                  - home
+                  lat: 40.7128
+                  topic: owntracks/jane/iPhone 12 Pro
+                  t: p
+                  conn: w
+                  m: 1
+                  tst: 1706965203
+                  alt: 41
+                  _type: location
+                  tid: RO
+                  _http: true
+                  ghash: u33d773
+                  isorcv: '2024-02-03T13:00:03Z'
+                  isotst: '2024-02-03T13:00:03Z'
+                  disptst: '2024-02-03 13:00:03'
 servers:
 - url: http://{defaultHost}
   variables: