Plutomi

Plutomi is a multi-tenant applicant tracking system that streamlines your entire application process with automated workflows at any scale.

Motivation

Having worked at a company that needed to recruit thousands of contractors every month, improving our acquisition flow at that scale became a challenge. Many processes had to be done manually because there just wasn't an API available for it. We often hit limits and had to work around them with a myriad of webhooks, queues, and batch jobs to keep things running smoothly. It would have benefited us to have an open platform to contribute to and build upon and this project is my attempt to do just that.

Summary

You can create applications which people can apply to. An application can be anything from a job, a location for a delivery company, or a program like a summer camp.

In these applications, you can create stages which are individual steps that need to be completed by your applicants. You can add questions and setup automatic move rules that determine where applicants go next depending on their responses or after a certain time period.

An application for a delivery company might look like this:

New York City

Stages:

1. Questionnaire - Collect basic information of an applicant. If an applicant does not complete this stage in 30 days, move them to the Waiting List.
2. Waiting List - An idle pool of applicants
3. Document Upload - Collect an applicant's license
4. Final Review - Manually review an applicant's license for compliance
5. Ready to Drive - Applicants that have completed your application

Prerequisites

• Node 20
• Rust
• Docker
• Docker Compose - For local development
• AWS CDK CLI and SSO

Tech Stack

Plutomi is deployed to any VPS you can get your hands on (we recommend Hetzner). The frontend is a Remix app and the API is written in Rust using the Axum web framework. We use Traefik as ingress with cert-manager + Let's Encrypt for TLS certificates. We use MongoDB for our main transactional database and try to follow patterns like this where we store everything in a single collection.

We use AWS CDK to deploy a couple of resources like setting up SES for emails, SNS to receive email events like opens, clicks, bounces, etc., and a queue to put those events in.

We also use Cloudflare for DNS, CDN, WAF and R2 for storage.

We plan to add:

• NATS for asynchronous communication streams
• Multiple consumers to read from NATS Jetstream and the email events queue
• MeiliSearch/ElasticSearch for full text search
• DuckDB/ClickHouse for analytics
• Prometheus/Loki/Grafana for monitoring & logging

Running Locally

Simply make a copy of .env.example to a .env file and run ./scripts/run.sh. This will:

1. Setup MongoDB for you

• Credentials are in the docker-compose.yaml

2. Start the Web app in development mode on port 3000

3. Start the API on port 8080

• Because the majority of our backend is in Rust, and due to the infamous compile times of Rust, we are running them outside of Docker
• The API along with any future consumers will run with cargo watch which might take some time to initially start but will have hot reloading after that

You can also run any stack individually:

$ ./scripts/run.sh --stack <web|api|datasources>

Deploying

To deploy Plutomi, you'll want to deploy to AWS for setting up SES first and then the rest of the backend with Kubernetes (K3S). Check out DEPLOYING.md for more information.

License

This project is licensed under the Apache 2.0 license. Here is a TLDR.

Contributing

To make a contribution, submit a pull request into the main branch. You will be asked to sign a Contributor License Agreement for your PR. You'll only have to do this once.

Useful Links

• plutomi.com
• Plutomi Docs
• K3S
• Rust Docs
• MongoDB Docs
• NATS Docs
• Remix Docs
• Multipass

Questions?

If you're wondering why certain architectural decisions were made, check the decisions folder as you might find it in there. If it's not in there or you have any other questions, open a discussion or an issue and we can talk about it, or reach out to me on Twitter @notjoswayski or email jose@plutomi.com!