ANIMINA is a web based dating platform. In case you have a question do not hesitate to contact Stefan Wintermeyer [email protected]

Please do submit bug reports or feature requests with an issue.

What we assume:

• macOS or Linux as an OS
• Installed PostgreSQL database.
• Basic understanding of Elixir and the Phoenix Framework. Have a look at https://elixir-phoenix-ash.com if you are new to it.

We use asdf to handle the Elixir and Erlang version. You don't have to use it but in our opinion it is the best solution.

• Install asdf (Get started guide)
  • asdf plugin-add elixir https://github.com/asdf-vm/asdf-elixir.git
  • asdf plugin add erlang https://github.com/asdf-vm/asdf-erlang.git
  • asdf plugin add nodejs https://github.com/asdf-vm/asdf-nodejs.git

• Git clone the project with git clone [email protected]:animina-dating/animina.git
• cd animina into the local project clone

• asdf install installs the needed Elixir and Erlang versions

• mix deps.get
• cd assets && npm install to install Alpine.js
• cd ..

• mix ash_postgres.create to create the database
• mix ash_postgres.migrate to run migrations

This step is optional, but very useful for development and demo systems.

• mix seed_demo_system creates dummy accounts and lists them.

• iex -S mix phx.server

Open https://localhost:4000 in your browser. You can create a new profile and visit the demo accounts. And you can log into the demo accounts. The default password of the demo accounts is printed at the end of the list of demo accounts after running mix seed_demo_system.

The User resource is the center of the system. In the very beginning of the registration process we also use BasicUser.

The following user states change their visibility across the system:

• normal - Standard account.
• validated - This is a validated account, indicating that we are confident it belongs to a real person.
• under_investigation - This account has been flagged by another user, an admin, or an AI for suspicious activity. They cannot log in.
• banned - This account is banned. We retain it to block the associated mobile phone number and email address. They cannot log in.
• incognito The user prefers to browse without being seen.
• hibernate- The user wishes to keep the account but is not currently using it.
• archived- The account has been deleted by the user. They cannot log in.

To change the state of a user account use the following actions:

• User.validate - This action is used to validate an account.
• User.investigate - This action is used to flag an account for investigation.
• User.ban - This action is used to ban an account.
• User.incognito - This action is used to set an account to incognito.
• User.hibernate - This action is used to set an account to hibernate.
• User.archive - This action is used to archive an account
• User.reactivate - This action is used to reactivate an account
• User.normalize - This action is used to set an account to normal.
• User.unban - This action is used to unban an account.
• User.recover - This action is used to recover an account from incognito or hibernate.

If you want to for example hibernate a user with the username 'wintermeyer' you can run the following in IEX

{:ok, user} = Animina.Accounts.User.get_by_username("wintermeyer") Animina.Accounts.User.hibernate(%{user_id: user.id})

• To remove a user from a waitlist we use User.give_user_in_waitlist_access . After removing a user from the waitlist, the user will get an email notification that they can now access the platform. An example of how to give a user in the waitlist access via CLI is {:ok, user} = Animina.Accounts.User.get_by_username("wintermeyer") Animina.Accounts.User.give_user_in_waitlist_access(user)

• To completely delete and remove a usr from the system we use User.destroy . If you want to for example delete a user with the username 'wintermeyer' you can run the following in IEX

  {:ok, user} = Animina.Accounts.User.get_by_username("wintermeyer") Animina.Accounts.User.destroy(user)

• We have 2 roles user and admin .
• To make a user an admin , run the following in IEX Animina.Accounts.User.make_admin(%{user_id: your_user.id})
• To remove admin roles from a user , run the following in IEX Animina.Accounts.User.remove_admin(%{user_id: your_user.id})

• There are admin tasks we can do , for example adding points to a user.

• Adding 100 Points To A User

{:ok, user} = Animina.Accounts.User.get_by_username("wintermeyer") user.credit_points Animina.Accounts.Credit.create(%{user_id: user.id, points: 100, subject: "Bonus Points"})

By default the server starts with ML features enabled. To disable running ML features:

• set DISABLE_ML_FEATURES environment variable to true
• ML dependecies are installed by default. If you wish to not install them run DISABLE_ML_FEATURES=true mix deps.get
• For example to start the phoenix server in dev mode without ML features run DISABLE_ML_FEATURES=true iex -S mix phx.server

For development and on our production servers we use Ollama. So should you on your development system. For development we use the Llama3.1 (8B) LLM. Install Ollama and than run ollama run llama3.1:8b to download the needed files for the LLM. You can configure the used LLM in config/dev.exs (search for :llm_version).

To access all the emails sent to the mailbox server, go to localhost:4000/dev/mailbox in your browser once the server is running. Once you register a new account, you can see the email sent to the mailbox server for account verification.

Keep it simple. Let's not use JavaScript everywhere. Better ask [email protected] first before diving into a JavaScript driven feature. Use Phoenix tools when possible.

We are doing a mobile first approach and use Tailwind CSS. Please don't forget a dark mode version when implimenting a new feature.

Please read the CONTRIBUTING.md file.