Fast Food Memes

➡️ https://t.me/ffmemesbot ⬅️

Product Notes

2025-10-12 — Added a persistent "share" button under every meme that links back to the bot via the same deep link we place in the caption. Hypothesis: when users forward a meme, Telegram strips callback buttons (like/dislike) but keeps external links, so this extra button should survive forwards and convert more viewers back into bot sessions. Monitor engagement and roll back if the button hurts the meme experience.

Local Development

First Build Only

cp .env.example .env
docker network create ffmemes_network
docker-compose up -d --build

Don't forget to fill the local .env file with all envs you need.

Test local changes

Before sending a PR you must test your new code. The easiest way is to run ipython shell, then import the functions you may need and test them. Note that ipython can run async functions without wrapping them with asyncio.run(...).

``shell docker compose exec app ipython

### Linters
Format and lint the same paths CI checks:

shell
just lint
For a read-only CI-equivalent check, run just lint-check.
Migrations
Create an automatic migration from changes in src/database.py
shelldocker compose exec app makemigrations migration_name
- Run migrationsshell
docker compose exec app migrate
- Downgrade migrationsshell
docker compose exec app downgrade -1  # or -2 or base or hash of the migration
### Tests
All tests are integrational and require DB connection.
One of the choices I've made is to use default database (postgres), separated from app's app database.
Using default database makes it easier to run tests in CI/CD environments, since there is no need to setup additional databases

Tests are run with upgrading & downgrading alembic migrations. It's not perfect, but works fine.

Run testsshell
docker compose exec app pytest
### Justfile
The template is using Just.
It's a Makefile alternative written in Rust with a nice syntax.
You can find all the shortcuts in justfile or run the following command to list them all:shell
just --list
Info about installation can be found here.
Backup and Restore database
We are using pg_dump and pg_restore to backup and restore the database.
Backupshelljust backup
output example
Backup process started.
Backup has been created and saved to /backups/backup-year-month-date-HHMMSS.dump.gz
- Copy the backup file or a directory with all backups to your local machineshell
just mount-docker-backup  # get all backups
just mount-docker-backup backup-year-month-date-HHMMSS.dump.gz  # get a specific backup
- Restoreshell
just restore backup-year-month-date-HHMMSS.dump.gz
output example
Dropping the database...
Creating a new database...
Applying the backup to the new database...
Backup applied successfully.


useful sql commands that should not be forgotten

SET pg_trgm.similarity_threshold = 0.6;`

ffmemes/ff-backend: Fast Food Memes monolith https://t.me/ffmemesbot

Fast Food Memes

Product Notes

Local Development

First Build Only

Test local changes

Migrations

Backup and Restore database

output example

output example

useful sql commands that should not be forgotten

Reading Mode

Related Stories

Fair Use Benefits Everyone

France is getting download tax for content providers (€0.055/GB)

Linode Security Incident

Sanstun: A sans-IO, parallel-friendly WireGuard implementation in Rust

Through Captain Jean-Luc Picard, Patrick Stewart taught us the measure of a man

Related Stories