ANIMINA is a web based dating platform. In case you have a question do not hesitate to contact Stefan Wintermeyer sw@wintermeyer-consulting.de
Warning
The current version a beta version. We appreciate all bug reports!
Please do submit bug reports or feature requests with an issue.
Note
Project founder Stefan Wintermeyer gave a (German) talk about the first ANIMINA Beta at FrOSCon.
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.
Important
If you wish to disable ML features (e.g., because of slow hardware), add DISABLE_ML_FEATURES=true before mix and iex commands.
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.gitasdf plugin add erlang https://github.com/asdf-vm/asdf-erlang.gitasdf plugin add nodejs https://github.com/asdf-vm/asdf-nodejs.git
- Git clone the project with
git clone git@github.com:animina-dating/animina.git cd animinainto the local project clone
asdf installinstalls the needed Elixir and Erlang versions
mix deps.getcd assets && npm installto install Alpine.jscd ..
mix ash_postgres.createto create the databasemix ash_postgres.migrateto run migrations
This step is optional, but very useful for development and demo systems.
mix seed_demo_systemcreates dummy accounts and lists them.
iex -S mix phx.server
Open http://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.incognitoThe 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 accountUser.reactivate- This action is used to reactivate an accountUser.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
userandadmin. - 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_FEATURESenvironment 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 sw@wintermeyer-consulting.de 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.