Ned Halksworth
cb375adbd6
replace chat collection with barcode_products table, seed verified products, drop ollama env vars and types, prune setup docs
77 lines
1.7 KiB
Markdown
77 lines
1.7 KiB
Markdown
# Red Bull tracker setup
|
|
|
|
This app uses Appwrite for auth and intake entries.
|
|
|
|
## env
|
|
|
|
Copy `.env.example` to `.env.local`, then fill in:
|
|
|
|
```sh
|
|
VITE_APPWRITE_ENDPOINT=https://fra.cloud.appwrite.io/v1
|
|
VITE_APPWRITE_PROJECT_ID=your_project_id
|
|
VITE_APPWRITE_DATABASE_ID=redbull_tracker
|
|
VITE_APPWRITE_COLLECTION_ID=intake_entries
|
|
APPWRITE_API_KEY=server_key_for_setup_only
|
|
```
|
|
|
|
Leave the OAuth URLs empty in local dev unless you need fixed callback URLs.
|
|
|
|
## setup
|
|
|
|
Run:
|
|
|
|
```sh
|
|
npm run setup:appwrite
|
|
```
|
|
|
|
The script creates or updates:
|
|
|
|
- database: `redbull_tracker`
|
|
- table: `intake_entries`
|
|
- table permission: `Users -> Create`
|
|
- row security: enabled
|
|
|
|
Rows use per-user read, update, and delete permissions.
|
|
|
|
## intake columns
|
|
|
|
| key | type | required |
|
|
| --- | --- | --- |
|
|
| `userId` | String, 64 | Yes |
|
|
| `cans` | Float | Yes |
|
|
| `flavour` | String, 128 | Yes |
|
|
| `flavourAccent` | String, 32 | Yes |
|
|
| `sizeMl` | Integer | Yes |
|
|
| `pricePerCan` | Float | Yes |
|
|
| `dateTime` | DateTime | Yes |
|
|
| `notes` | String, 2000 | No |
|
|
| `store` | String, 256 | No |
|
|
| `sugarFree` | Boolean | Yes |
|
|
| `caffeineMgPerCan` | Float | No |
|
|
| `importKey` | String, 512 | Yes |
|
|
| `source` | String, 32 | Yes |
|
|
|
|
## indexes
|
|
|
|
- `user_date_desc`: `userId`, `dateTime`
|
|
- `user_import_key`: `userId`, `importKey`
|
|
|
|
## run
|
|
|
|
```sh
|
|
npm install
|
|
npm run dev
|
|
```
|
|
|
|
## deployment-only files
|
|
|
|
The repo ignores `.deploy/` and local public HTML pages.
|
|
|
|
For your own deployment, create:
|
|
|
|
- `.deploy/head.html` for analytics or other head-only snippets
|
|
- `.deploy/body-end.html` for footer links or deploy-only markup
|
|
- any local public HTML pages your host needs
|
|
|
|
Vite injects the optional `.deploy` snippets into `index.html` at build time.
|