football2801
a536baabd6
Adds the complete project foundation: - BMAD BMM workflow tooling (_bmad/) - Claude slash commands, skills, and project memories (.claude/) - ESP32 firmware scaffold (PlatformIO + Waveshare e-ink driver) - .gitignore excluding _bmad-output/ and .pio/ build artifacts Planning artifacts (PRD, architecture, epics) are intentionally not tracked — they live in _bmad-output/ per project convention. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2.5 KiB
2.5 KiB
name, description, type
| name | description | type |
|---|---|---|
| pictureFrame project context | Goals, stack, hardware, current status, and key decisions for the pictureFrame project | project |
Handcrafted e-ink digital picture frame ecosystem built as a meaningful gift. ESP32 + Waveshare 7.3" 6-color e-ink display, battery or plugin, companion Symfony web app for image management, device configuration, and family sharing.
Why: Personal project — frames are hand-built and gifted. The software keeps them personal and current without requiring the recipient to do anything.
Hardware
- ESP32 dev board (esp32dev), dual-core 240MHz, 4MB flash
- Waveshare 7.3" 6-colour e-ink (800×480, E-Ink Spectra 6)
- SPI pinout: SCK=18, MOSI=23, CS=5, DC=17, RST=16, BUSY=4
- 4bpp packed, palette: BLACK=0x0, WHITE=0x1, YELLOW=0x2, RED=0x3, BLUE=0x5, GREEN=0x6
Stack
- Firmware: PlatformIO + Arduino framework (C/C++)
- Web app: Symfony 8.0 (PHP 8.4+), PostgreSQL 16, Nginx-FPM
- Local dev: DDEV (mirrors ~/src/aqua-iq setup)
- Infra reference: ~/src/aqua-iq for Docker/DDEV config, server location, SSH details
- Git: git.edholm.me (self-hosted Gitea/Forgejo)
- Domain: pictureframe.edholm.me
Current status (2026-04-27)
- POC firmware previously built (display driver proven)
- PRD complete and validated (4/5 holistic quality, all fixes applied)
- Architecture complete — all 8 steps done, document at
_bmad-output/planning-artifacts/architecture.md - No production code written yet; next step is epics/stories or direct Symfony scaffold
Key architectural decisions
- Async image processing: Symfony Messenger (Doctrine transport),
max_retries: 1 - Image storage:
storage/images/{id}/{model}_{orientation}.bin, relative paths in DB,STORAGE_PATHenv var - Device pull endpoint:
GET /api/device/{mac}/image— 200 (binary), 204 (no ready image), 404 (unknown MAC) - Enums: PHP 8.1 backed enums for
RenderStatus,TokenType,Orientation - Repositories:
findActive*prefix for all soft-delete-aware methods - Token entity: UUID PK, type enum, expires_at, used_at — single-use authorization links
- Testing: Unit/Integration/Functional split, no DB mocks
- Imagick for Floyd-Steinberg dithering (not GD)
How to apply
Stack is decided — Symfony, PostgreSQL, DDEV. Don't suggest alternatives. For infrastructure patterns (docker-compose, server location, SSH), reference ~/src/aqua-iq. APP_BASE_URL = https://pictureframe.edholm.me — baked into firmware as build constant. First implementation command: symfony new pictureframe --webapp.