Inventory-saas

Inventory Management SaaS

Production-grade, multi-tenant inventory management SaaS. The repository is currently in Phase 1 — Project Foundation.

Documentation

Start here:

1. docs/memory.md — current project state and AI handoff
2. docs/rules.md — mandatory development rules
3. docs/architecture.md — technical architecture
4. docs/product-requirement-document.md — product requirements
5. docs/phases.md — development roadmap

Local development

Prerequisites: Node.js 22+ and pnpm 11.19.0. Docker is optional but recommended for the local PostgreSQL service.

1. Copy Backend/.env.example to Backend/.env and Frontend/.env.example to Frontend/.env.
2. Run docker compose up -d postgres to start PostgreSQL, if Docker is available.
3. Run pnpm install at the repository root.
4. Run pnpm --filter @inventory/api dev and pnpm --filter @inventory/web dev in separate terminals.

The API health endpoint is GET /api/v1/health. No authentication, tenant, or business feature is implemented yet.

Validation

Run pnpm lint, pnpm typecheck, pnpm test, and pnpm build from the repository root.

Important

The documentation must reflect the actual codebase. Future AI developers must inspect the repository before changing code and must update docs/memory.md whenever meaningful implementation changes occur.