mirror of
https://github.com/Sea-Haven-Industries/meal-order-manager.git
synced 2026-09-30 06:33:12 +00:00
d332affd56
Playwright-based menu scraper for Redefine Meals, self-contained HTML order form with S3/CloudFront hosting, DynamoDB-backed order submission via API Gateway, and automated payroll deduction reports via SES.
125 lines
6 KiB
Markdown
125 lines
6 KiB
Markdown
# meal-order-manager
|
||
|
||
Automates weekly meal ordering from [Redefine Meals](https://www.redefinemeals.com) for Sea Haven Industries employees. Scrapes the menu, generates an order form, collects individual orders, and produces payroll deduction reports.
|
||
|
||
## Architecture
|
||
|
||
```
|
||
Monday 8am ET Employees (Mon–Thu) Thursday 6pm ET
|
||
┌─────────────────┐ ┌──────────────────┐ ┌──────────────────┐
|
||
│ GitHub Actions │ │ orders.seahaven │ │ EventBridge │
|
||
│ - Scrape menu │────S3 upload───▶│ ind.com │ │ - Close form │
|
||
│ - Generate form │ + DynamoDB │ (CloudFront+S3) │──POST───┐ │ - Aggregate │
|
||
│ - Slack notify │ └──────────────────┘ │ │ - Slack summary │
|
||
└─────────────────┘ ▼ └──────────────────┘
|
||
┌──────────┐
|
||
Monday 7am ET │ API GW + │
|
||
┌──────────────────┐ │ Lambda │
|
||
│ EventBridge │ │ submit │
|
||
│ - Email payroll │ └────┬─────┘
|
||
│ deductions │ ▼
|
||
└──────────────────┘ ┌──────────┐
|
||
│ DynamoDB │
|
||
Thu 10am: Slack DM │ orders │
|
||
reminders to employees └──────────┘
|
||
who haven't ordered
|
||
```
|
||
|
||
## Weekly Flow
|
||
|
||
| When | What | How |
|
||
|------|------|-----|
|
||
| Monday 7am ET | Email previous week's payroll deductions to `payroll@` | EventBridge → Lambda → SES |
|
||
| Monday 8am ET | Scrape menu, generate form, upload to S3, post link to Slack | GitHub Actions cron |
|
||
| Mon–Thu | Employees visit `orders.seahavenind.com` and submit orders | S3 static form → API Gateway → Lambda → DynamoDB |
|
||
| Thursday 10am ET | DM employees who haven't ordered yet | EventBridge → Lambda → Slack DM |
|
||
| Thursday 6pm ET | Close form, aggregate orders, post Redefine order summary to Slack | EventBridge → Lambda chain |
|
||
|
||
## AWS Resources
|
||
|
||
Stack name: `meal-order-manager` (us-east-1)
|
||
|
||
- **S3** — `meal-order-manager-form-*` (static form hosting), `meal-order-manager-reports-*` (CSV reports)
|
||
- **CloudFront** — HTTPS distribution with custom domain `orders.seahavenind.com`
|
||
- **DynamoDB** — `meal-order-manager-orders` (orders, menu, roster, config)
|
||
- **API Gateway** — HttpApi for order submission
|
||
- **Lambda** — 5 functions: submit-order, close-form, aggregate-orders, slack-notifier, email-report
|
||
- **EventBridge** — scheduled rules (dual EST/EDT) for close, reminders, payroll email
|
||
- **Secrets Manager** — Slack bot token, form API key
|
||
- **SES** — payroll deduction emails
|
||
|
||
## Setup
|
||
|
||
### Local development
|
||
|
||
```bash
|
||
python3 -m venv .venv
|
||
source .venv/bin/activate
|
||
pip install -r requirements.txt
|
||
playwright install chromium
|
||
```
|
||
|
||
### Deploy to AWS
|
||
|
||
```bash
|
||
cp samconfig.toml.example samconfig.toml
|
||
# Edit samconfig.toml with your certificate ARN, API key, etc.
|
||
sam build
|
||
sam deploy
|
||
```
|
||
|
||
### Post-deploy
|
||
|
||
1. Create the Slack bot token secret: `aws secretsmanager create-secret --name meal-order-manager/slack-bot-token --secret-string "xoxb-..."`
|
||
2. Create the form API key secret: `aws secretsmanager create-secret --name meal-order-manager/form-api-key --secret-string "$(openssl rand -hex 32)"`
|
||
3. Update the Slack channel SSM parameter: `aws ssm put-parameter --name /meal-order-manager/slack-channel-id --value "C0XXXXXXX" --overwrite`
|
||
4. Verify SES sender identity for `adam@seahavenind.com`
|
||
5. Set up DNS: CNAME `orders.seahavenind.com` → CloudFront distribution domain
|
||
6. Populate employee roster: edit `config.json` and run `python3 scripts/seed_roster.py`
|
||
|
||
## Local Workflow (no AWS)
|
||
|
||
The scraper, form generator, Flask server, and aggregator still work locally:
|
||
|
||
```bash
|
||
python3 src/scraper/scrape_menu.py # scrape menu
|
||
python3 src/server/generate_form.py # generate form (local mode)
|
||
python3 src/server/app.py # serve on localhost:5050
|
||
python3 src/aggregator/aggregate.py # generate CSV reports
|
||
```
|
||
|
||
## Configuration
|
||
|
||
`config.json` (local dev):
|
||
- `menu_url` — Redefine Meals menu URL
|
||
- `order_deadline` — displayed on the form
|
||
- `roster` — employee list (name, email, slack_user_id)
|
||
- `output_dir` / `orders_dir` — local output paths
|
||
|
||
## Project Structure
|
||
|
||
```
|
||
meal-order-manager/
|
||
├── .github/workflows/
|
||
│ ├── weekly-menu.yml # Monday cron: scrape + publish + notify
|
||
│ ├── ci.yml # PR checks
|
||
│ └── deploy.yml # Push to main: sam deploy
|
||
├── src/
|
||
│ ├── scraper/ # Playwright menu scraper
|
||
│ ├── server/ # Form generator + local Flask server
|
||
│ ├── aggregator/ # Order aggregation + CSV reports
|
||
│ └── shared/python/shared/ # Lambda layer (db, secrets, slack helpers)
|
||
├── functions/ # Lambda handlers
|
||
│ ├── submit_order/
|
||
│ ├── close_form/
|
||
│ ├── aggregate_orders/
|
||
│ ├── slack_notifier/
|
||
│ └── email_report/
|
||
├── scripts/ # CI/CD helper scripts
|
||
│ ├── upload_menu.py
|
||
│ ├── notify_slack.py
|
||
│ └── seed_roster.py
|
||
├── template.yaml # SAM template
|
||
├── samconfig.toml.example
|
||
└── config.json
|
||
```
|