Add layout

assets/js/app.js

@@ -25,9 +25,11 @@ import {LiveSocket} from "phoenix_live_view"
 import "../vendor/alpine.js";
 import topbar from "../vendor/topbar"
 import { QrScanner } from "./qr_reading.js";
+import { InitSorting } from "./sorting.js";
 
 let Hooks = {
-  QrScanner: QrScanner
+  QrScanner: QrScanner,
+  InitSorting: InitSorting
 };
 
 let csrfToken = document.querySelector("meta[name='csrf-token']").getAttribute("content")

assets/js/sorting.js

@@ -0,0 +1,17 @@
+import Sortable from "../vendor/sortable.js"
+
+export const InitSorting = {
+  mounted() {
+    new Sortable(this.el, {
+      animation: 150,
+      ghostClass: "bg-slate-100",
+      dragClass: "shadow-2xl",
+      handle: ".handle",
+      onEnd: (evt) => {
+        const elements = Array.from(this.el.children)
+        const ids = elements.map(elm => elm.id)
+        this.pushEvent("update-sorting", {ids: ids})
+      }
+    })
+  }
+}

assets/tailwind.config.js

@@ -10,7 +10,14 @@ module.exports = {
     '../lib/*_web/**/*.*ex',
   ],
   theme: {
-    extend: {},
+    extend: {
+      border: {
+        '1': '1px'
+      },
+      backgroundImage: {
+        'hero-pattern': "url('/images/atomic.png')",
+      },
+    },
   },
   plugins: [
     require('@tailwindcss/forms'),

config/config.exs

@@ -8,7 +8,14 @@
 import Config
 
 config :atomic,
-  ecto_repos: [Atomic.Repo]
+  ecto_repos: [Atomic.Repo],
+  generators: [binary_id: true],
+  owner: %{
+    name: "Atomic",
+    time_zone: "Europe/Lisbon",
+    day_start: 0,
+    day_end: 24
+  }
 
 # Configures the endpoint
 config :atomic, AtomicWeb.Endpoint,
@@ -67,6 +74,9 @@ config :tailwind,
     cd: Path.expand("../assets", __DIR__)
   ]
 
+config :icons,
+  collection: [Heroicons, Ionicons]
+
 config :atomic, Atomic.Scheduler,
   jobs: [
     # Runs every midnight:

lib/atomic/accounts.ex

@@ -80,11 +80,36 @@ defmodule Atomic.Accounts do
     |> Repo.insert()
   end
 
+  @doc """
+    List all users.
+
+    ## Examples
+
+      iex > list_users()
+      {:ok, [%User{}]}
+
+      iex > list_users()
+      {:error, %Ecto.Changeset{}}
+
+  """
   def list_users do
     User
     |> Repo.all()
   end
 
+  @doc """
+    Gets a course by id.
+
+    Raises `Ecto.NoResultsError` if the Course does not exist.
+
+    ## Examples
+
+      iex> get_course(123)
+      %Course{}
+
+      iex> get_course(456)
+      ** (Ecto.NoResultsError)
+  """
   def get_course(id) do
     Repo.get(Course, id)
   end
@@ -115,6 +140,35 @@ defmodule Atomic.Accounts do
     end
   end
 
+  @doc """
+  Return the first and last name of a name.
+
+  ## Examples
+
+        iex> extract_first_last_name("John Doe")
+        "John Doe"
+
+        iex> extract_first_last_name("John")
+        "John"
+
+        iex> extract_first_last_name(nil)
+        ""
+
+  """
+  def extract_first_last_name(name) do
+    names =
+      name
+      |> String.split(" ")
+      |> Enum.filter(&String.match?(String.slice(&1, 0, 1), ~r/^\p{L}$/u))
+      |> Enum.map(&String.capitalize/1)
+
+    case length(names) do
+      0 -> ""
+      1 -> hd(names)
+      _ -> List.first(names) <> " " <> List.last(names)
+    end
+  end
+
   @doc """
   Returns an `%Ecto.Changeset{}` for tracking user changes.
 
@@ -388,29 +442,59 @@ defmodule Atomic.Accounts do
     end
   end
 
+  @doc """
+  Updates the user picture.
+
+  ## Examples
+
+      iex> update_user_picture(user, %{profile_picture: ...})
+      {:ok, %User{}}
+
+      iex> update_user_picture(user, %{profile_picture: ...})
+      {:error, %Ecto.Changeset{}}
+
+  """
   def update_user_picture(%User{} = user, attrs \\ %{}) do
     user
     |> User.picture_changeset(attrs)
     |> Repo.update()
   end
 
+  @doc """
+  Updates the user.
+
+  ## Examples
+
+      iex> update_user(user, %{field: value})
+      {:ok, %User{}}
+
+      iex> update_user(user, %{field: bad_value})
+      {:error, %Ecto.Changeset{}}
+
+  """
   def update_user(%User{} = user, attrs \\ %{}) do
     user
     |> User.changeset(attrs)
     |> Repo.update()
   end
 
-  def change_user(%User{} = user, attrs \\ %{}) do
-    user
-    |> User.changeset(attrs)
-  end
+  @doc """
+  Gets a list of courses.
+
+  ## Examples
+
+      iex> list_courses()
+      {:ok,[%Course{}]}
 
+      iex> list_courses()
+      {:error, %Ecto.Changeset{}}
+  """
   def list_courses do
     Repo.all(Course)
   end
 
   @doc """
-  Creates a course
+  Creates a course.
 
   ## Examples
 
@@ -428,7 +512,15 @@ defmodule Atomic.Accounts do
   end
 
   @doc """
-  Gets the user's organizations
+  Gets an user organizations.
+
+  ## Examples
+
+      iex> get_user_organizations(user)
+      {:ok,[%Organization{}]}
+
+      iex> get_user_organizations(user)
+      {:error, %Ecto.Changeset{}}
   """
   def get_user_organizations(user) do
     Repo.all(Ecto.assoc(user, :organizations))

lib/atomic/accounts/course.ex

@@ -15,6 +15,9 @@ defmodule Atomic.Accounts.Course do
     timestamps()
   end
 
+  @doc """
+    A changeset for a course.
+  """
   def changeset(course, attrs) do
     course
     |> cast(attrs, @required_fields)

lib/atomic/accounts/user.ex

@@ -9,8 +9,8 @@ defmodule Atomic.Accounts.User do
   alias Atomic.Organizations.{Membership, Organization}
   alias Atomic.Uploaders.ProfilePicture
 
-  @required_fields ~w(email password role name)a
-  @optional_fields ~w(course_id default_organization_id)a
+  @required_fields ~w(email password)a
+  @optional_fields ~w(name course_id default_organization_id)a
 
   @roles ~w(admin student)a
 
@@ -24,7 +24,7 @@ defmodule Atomic.Accounts.User do
 
     belongs_to :course, Course
     field :profile_picture, ProfilePicture.Type
-    field :role, Ecto.Enum, values: @roles
+    field :role, Ecto.Enum, values: @roles, default: :student
 
     has_many :enrollments, Enrollment
 
@@ -63,6 +63,9 @@ defmodule Atomic.Accounts.User do
     |> cast_attachments(attrs, [:profile_picture])
   end
 
+  @doc """
+    A user changeset for updating the user.
+  """
   def changeset(user, attrs) do
     user
     |> cast(attrs, @required_fields ++ @optional_fields)