9400828f62
Rebrand from Forte (music-store-specific) to LunarFront (any small business): - Package namespace @forte/* → @lunarfront/* - Database forte/forte_test → lunarfront/lunarfront_test - Docker containers, volumes, connection strings - UI branding, localStorage keys, test emails - All documentation and planning docs Generalize music-specific terminology: - instrumentDescription → itemDescription - instrumentCount → itemCount - instrumentType → itemCategory (on service templates) - New migration 0027_generalize_terminology for column renames - Seed data updated with generic examples - RBAC descriptions updated
56 lines
1.6 KiB
Markdown
56 lines
1.6 KiB
Markdown
# LunarFront
|
|
|
|
Small business management platform — POS, inventory, rentals, scheduling, repairs, and accounting.
|
|
|
|
Built by [Lunarfront Tech LLC](https://lunarfront.com).
|
|
|
|
## Tech Stack
|
|
|
|
- **Runtime:** Bun
|
|
- **Language:** TypeScript (end-to-end)
|
|
- **API:** Fastify + Drizzle ORM + PostgreSQL 16
|
|
- **Frontend:** React + TanStack Router + TanStack Query
|
|
- **Validation:** Zod (shared schemas)
|
|
- **Queue/Cache:** BullMQ + Valkey 8
|
|
- **Monorepo:** Turborepo + Bun workspaces
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
bun install
|
|
cp .env.example .env # configure DATABASE_URL, REDIS_URL, JWT_SECRET
|
|
cd packages/backend && bunx drizzle-kit migrate
|
|
bun run dev # starts backend (:8000) + admin UI (:5173)
|
|
```
|
|
|
|
## Packages
|
|
|
|
| Package | Description |
|
|
|---------|-------------|
|
|
| `packages/backend` | Fastify API server |
|
|
| `packages/admin` | Admin UI (React + Vite) |
|
|
| `packages/shared` | Zod schemas, types, shared utils |
|
|
|
|
## Documentation
|
|
|
|
| Doc | Description |
|
|
|-----|-------------|
|
|
| [Setup](docs/setup.md) | Prerequisites, environment, installation, running |
|
|
| [Architecture](docs/architecture.md) | Monorepo structure, backend/frontend design, state management |
|
|
| [API Reference](docs/api.md) | All endpoints, pagination, auth, permissions |
|
|
| [Database](docs/database.md) | Schema overview, migrations, multi-tenancy |
|
|
| [Testing](docs/testing.md) | Test runner, suites, writing tests, assertions |
|
|
|
|
## Commands
|
|
|
|
```bash
|
|
bun run dev # start all packages in dev mode
|
|
bun run test # run all tests
|
|
bun run lint # lint all packages
|
|
bun run format # format with Prettier
|
|
```
|
|
|
|
## License
|
|
|
|
Proprietary. All rights reserved.
|