# BioMature

> Lifecycle-aware inventory and forecasting tool for operators of time-matured biological assets.

BioMature is a web application built for boutique nurseries, specimen-plant collectors, and hobbyist reptile morph breeders. It solves a specific problem: biological inventory does not behave like standard e-commerce stock. Units mature on biological timelines, not calendar dates. BioMature models this explicitly.

## What it does

- **Batch tracking**: Groups of interchangeable units (e.g. a tray of Monstera Albo cuttings, a reptile clutch) advance through configurable lifecycle stages driven by time. Each stage has a duration, an expected loss rate, and an associated price tier.
- **Specimen management**: Individual, non-fungible specimens (distinct plants, named animals) tracked separately from batches.
- **Pre-order management**: Pre-orders are tied to batch biological readiness rather than arbitrary ship dates. The system projects when units will be available at each price tier.
- **Revenue forecasting**: Projects revenue across the production pipeline using scenario analysis — operators can model expected losses, timing assumptions, and demand.
- **Sales tracking**: Records completed sales against batches and specimens.
- **Stock dashboard**: Real-time view of available, reserved, and incoming units across all active batches.

## Target users

- Boutique plant nurseries and tissue-culture operations
- Specialist reptile morph breeders (ball pythons, chameleons, geckos, etc.)
- Hobbyist collectors managing expensive specimen plants (aroids, orchids, cycads)
- Any operator whose inventory has a biological maturation cycle before it can be sold

## Current status

Beta — access via waitlist at https://biomature-web.fly.dev/waitlist

## Public pages

- Home / Sign-in: https://biomature-web.fly.dev/
- Waitlist: https://biomature-web.fly.dev/waitlist
- Roadmap & Feedback: https://biomature-web.fly.dev/roadmap
- Terms of Service: https://biomature-web.fly.dev/terms
- Privacy Policy: https://biomature-web.fly.dev/privacy

## API

The BioMature REST API is documented via OpenAPI. All endpoints require Bearer token authentication (Clerk JWT).

- API base: https://biomature-api-vnsieg7kpq-uc.a.run.app
- OpenAPI docs: https://biomature-api-vnsieg7kpq-uc.a.run.app/docs
- Health check: https://biomature-api-vnsieg7kpq-uc.a.run.app/health

### Key resource endpoints (authenticated)

| Resource | Endpoint |
|---|---|
| Batches | GET/POST /api/batches |
| Batch detail | GET/PUT/DELETE /api/batches/{id} |
| Specimens | GET/POST /api/specimens |
| Specimen detail | GET/PUT/DELETE /api/specimens/{id} |
| Pre-orders | GET/POST /api/pre-orders |
| Sales | GET/POST /api/sales |
| Forecast | GET /api/forecast |
| Stock | GET /api/stock |
| CSV export | GET /api/csv/batches, /api/csv/specimens |
| Onboarding | GET/POST /api/onboarding/status |

## Technology

- Frontend: React 18, Vite, TypeScript, react-router-dom v6
- Backend: Python 3.12, FastAPI, SQLAlchemy, Alembic
- Auth: Clerk (JWT, waitlist mode during beta)
- Hosting: Frontend on Fly.io (lhr region), API on Google Cloud Run
- Architecture: Hexagonal (ports-and-adapters); pure domain core with no framework imports

## Contact

BioMature — https://biomature-web.fly.dev/