storyteller-web
===============
This is our main user account monolith that we'll also bake other pieces into.

Local development
-----------------

### Database migrations

To reset the entire database (drop, migrate), run:

```
diesel database reset
```

To migrate at the current step and beyond: 

```
diesel migration run
```

To undo migrations at the current step: 

```
diesel migration redo
```

To save sqlx database state to cache file (necessary for builds):

```
SQLX_OFFLINE=true cargo sqlx prepare
```

Now that we have multiple binaries, it's required to include all the queries in the main
binary so we can generate the cached queries as a single target. That's then executed
with:

```
SQLX_OFFLINE=true cargo sqlx prepare -- --bin storyteller-web
```

Production
----------

### Database migrations

1. Set `DATABASE_URL` in `.env`
2. Run `diesel migration run`

Actix notes
-----------

json request
```
async fn handler(request: web::Json<Mytype>) -> impl Responder { "whatever" }
```

form-multipart request
```
async fn handler(request: web::Form<Mytype>) -> impl Responder { "whatever" }
```

route parameters
```
#[get("/{name}")]
async fn hello(name: web::Path<String>) -> impl Responder { format!("Hi {}", name) }
```


TODO
----

* Make all "token" types correct
* Use correct collation for all tables
* Install indexes on all foreign keys
* Make sure unique indexes are correct

Notes / TODOs:

* Examples for good Actix+Sqlx Tests: 
  https://stackoverflow.com/questions/65370752/how-do-i-create-an-actix-web-server-that-accepts-both-sqlx-database-pools-and-tr
  
* Actix/sqlx runtime compat:
  https://github.com/launchbadge/sqlx/issues/1117#issuecomment-801237734


Docker builds
-------------

The repository needs to be given read access to the base docker image:

https://github.com/orgs/storytold/packages/container/docker-base-images-rust-ssl/settings

Local Nginx Proxy 
-----------------
Set up a local nginx to proxy to the frontend and backend so cookie issues aren't annoying

Edit, `/etc/nginx/sites-enabled/storyteller`

```
server {
    listen 80; 
    server_name api.jungle.horse;
    location / { 
        proxy_set_header Host $host;
        proxy_pass http://127.0.0.1:12345;
        proxy_redirect off;
    }   
}
server {
    listen 80; 
    server_name jungle.horse;
    location / { 
        proxy_set_header Host $host;
        proxy_pass http://127.0.0.1:7000;
        proxy_redirect off;
    }   
}

```