gthole/drink-stash

Drink Stash

一款用于保存和搜索鸡尾酒配方的小型Web应用。

核心功能与特性

• 专为移动设备设计
• 带表达式（极客）查询引擎的配方搜索功能
• 可创建菜单列表或喜爱/想尝试的饮品列表
• 跟踪酒柜中的物品，轻松找到可制作的饮品
• 包含150多种经典鸡尾酒和原创配方，开箱即用
• 支持深色模式
• 轻量级服务器，通过Docker整洁打包

截图

使用方法

建议在HTTP反向代理后运行以实现TLS终止等功能。可基于基础镜像运行，持久化数据存储在挂载卷中的SQLite数据库。使用docker-compose配置示例：

yaml
version: '3.7'

services:
    api:
        image: 'gthole/drink-stash:latest'
        init: true
        restart: 'always'
        environment:
            SECRET_KEY=<yourlongsecretkey>
            ALLOWED_HOSTS=<yourhostname>
        ports:
            - '8000'
        volumes:
            - './data:/data'
            - './public:/public'

SECRET_KEY应为长随机字符串，ALLOWED_HOSTS是用于访问应用的逗号分隔主机名列表。

配置参数

Drink Stash从环境变量导入设置。数组类型的值（如ALLOWED_HOST）被解释为逗号分隔的列表。目前支持有限的变量集。

示例：

EMAIL_HOST=mail.mydomain.com
EMAIL_HOST_USER=no-reply@mydomain.com
EMAIL_HOST_PASSWORD=emailpassword
DEFAULT_FROM_EMAIL=Drink Stash <no-reply@mydomain.com>
SERVER_EMAIL=no-reply@mydomain.com
TIME_ZONE=America/Los_Angeles
ALLOWED_HOSTS=drinks.mydomain.com
DEBUG=False
ADMINS=Me:me@mydomain.com,Someone Else:someone@mydomain.com

初始化设置

启动容器时，应设置以下环境变量以创建初始用户和一些入门配方：

yaml
version: '3'

services:
    api:
        image: 'gthole/drink-stash:latest'
        restart: 'always'
        environment:
            SECRET_KEY=<yourlongsecretkey>
            ALLOWED_HOSTS=<yourhostname>
            DJANGO_SUPERUSER_USERNAME=<yourusername>
            DJANGO_SUPERUSER_EMAIL=<youremail>
            DJANGO_SUPERUSER_PASSWORD=changeme
            DJANGO_SUPERUSER_FIRST_NAME=<first>
            DJANGO_SUPERUSER_LAST_NAME=<last>
            INITIAL_FIXTURES=recipes
        ports:
            - '8000'
        volumes:
            - './data:/data'
            - './public:/public'

启动时将运行初始化脚本，在无用户时创建超级用户并添加初始配方。后续启动可移除DJANGO_SUPERUSER_*和INITIAL_FIXTURES变量。

开发环境

安装https://www.docker.com/products/docker-desktop%E3%80%82

bash
# 构建应用镜像
$ docker-compose build api

# 按照上述初始化设置部分的说明进行配置

# 启动服务器
$ docker-compose up

# 运行API单元测试
$ docker-compose run --rm api ./manage.py test drinks