74 lines
3.2 KiB
Markdown
74 lines
3.2 KiB
Markdown
# Moon Base — Project Notes
|
|
|
|
Property management for the Moon homestead (Eau Claire, WI) — food forest plant
|
|
registry, home maintenance tracking, and equipment logs. Next.js 14 + Prisma +
|
|
Postgres. Same conventions as FMB (`/Users/bonnamoon/Projects/fullmoonbakehouse`).
|
|
|
|
## Modules
|
|
|
|
- **v0.1 — Garden:** food forest plant registry + care/harvest log. Live.
|
|
- **Home maintenance** — planned next: systems, recurring tasks, repair history.
|
|
- **Equipment** — planned: tools/machines, service intervals, maintenance logs.
|
|
|
|
## Local dev
|
|
|
|
- DB: `postgresql://tonym@localhost:5432/moonbase_dev`
|
|
- Copy `.env.example` → `.env` and fill in values.
|
|
- `npm install` then `npm run dev` (port 3000)
|
|
- After schema edits: `npx prisma generate` then restart dev server.
|
|
- Seed demo data: `npm run db:seed` (creates Bonna + Tony accounts + sample plants)
|
|
- Minimal seed (admin accounts only): `SEED_MODE=minimal npm run db:seed`
|
|
- Apply migrations: `npx prisma migrate deploy`
|
|
|
|
## First-run setup (brand new machine / fresh DB)
|
|
|
|
1. `npm install`
|
|
2. Create `.env` from `.env.example`
|
|
3. `npx prisma migrate deploy` — creates the DB schema + provisions Bonna and Tony accounts
|
|
4. Default password for both is `moonbase!` with `mustChangePassword=true` — change on first login.
|
|
|
|
## Conventions (same as FMB)
|
|
|
|
- **Every commit bumps APP_VERSION** in `src/lib/version.ts` + a plain-English
|
|
entry at the top of `src/lib/changelog.ts`. Minor (0.X.0) for features/migrations,
|
|
patch for fixes. Write changelog for Bonna, not engineers.
|
|
- **AuditEvent on every mutation** — append-only, never delete.
|
|
- **Soft-delete** via `active=false` for Plant (keeps log history intact).
|
|
- **Pure core + colocated test** — new logic goes in `src/lib/...` as a pure
|
|
function with a `.test.ts` next to it; API routes stay thin.
|
|
- **Worktrees for parallel sessions** — same pattern as FMB. Use a worktree
|
|
(`git worktree add ../moonbase-<slug> -b <slug>`) if running two Claude sessions.
|
|
|
|
## Git remote
|
|
|
|
Add Gitea remote once the repo is created there:
|
|
```sh
|
|
git remote add gitea http://192.168.0.5:3022/tonym/moonbase.git
|
|
git push gitea main
|
|
```
|
|
|
|
## Auth
|
|
|
|
- Username OR email login (same as FMB). Accounts: `bonna` / `tony`, role ADMIN.
|
|
- `mustChangePassword=true` on provisioned accounts — user is prompted on next login
|
|
(add that redirect to `src/app/(dashboard)/layout.tsx` when implementing it).
|
|
- `getSession()` / `isAdmin()` in `src/lib/auth.ts`.
|
|
|
|
## Garden module — data model
|
|
|
|
- **Plant** — commonName, species (scientific), variety, category (PlantCategory enum),
|
|
zone (freeform text: "Back yard north fence"), plantedAt, source, notes, active.
|
|
- **PlantLog** — per-plant log: type (OBSERVATION / CARE / HARVEST / TREATMENT /
|
|
TRANSPLANT / DIED), date, notes, quantity (freeform, for harvests).
|
|
- Category labels + log type labels/colors live in `src/lib/garden/categories.ts`.
|
|
- API: `POST /api/plants` (create plant), `POST /api/plants/[id]/logs` (add log entry).
|
|
|
|
## Color palette
|
|
|
|
Forest / earth theme. Key CSS variables:
|
|
- `--canopy` — dark forest green sidebar
|
|
- `--leaf` — fresh green accent
|
|
- `--soil` / `--soil-muted` — body text
|
|
- `--dew` — pale sage background
|
|
- `--ember` — red for destructive actions
|