Files

T

Agent Zero 7f7da15965 Initial commit: Rentman Clone - Phase 0-6 (T001-T023)

Completed:
- Phase 0: Project Setup (T001-T003) - Docker Compose, FastAPI skeleton, React SPA
- Phase 1: Auth System (T004-T008) - DB models, JWT auth, RBAC middleware, user management
- Phase 2: Contacts & Tags (T009-T011) - CRUD API + UI
- Phase 3: Equipment Catalog (T012-T014) - Models, API, UI with barcode/QR
- Phase 4: Crew Management (T015-T017) - Models, availability, UI
- Phase 5: Vehicle Fleet (T018-T020) - Models, assignments, UI
- Phase 6: Projects (T021-T023) - Project hierarchy models, CRUD API, list/detail UI

2026-05-31 20:36:42 +00:00

2.9 KiB

Raw Permalink Blame History

Rentman Clone

A full-stack clone of Rentman.io, a project-centric SaaS platform for rental and event industries.

Tech Stack

Backend: FastAPI (Python 3.12+), SQLAlchemy 2.0, SQLite/PostgreSQL, Redis, Celery
Frontend: React 19, TypeScript, Vite, Tailwind CSS, Radix UI, Zustand, React Query
Storage: MinIO (S3-compatible)
Deployment: Docker Compose, Coolify

Getting Started

Prerequisites

Docker & Docker Compose
Or Python 3.12+, Node.js 20+

Quick Start (Docker)

cp .env.example .env
# Edit .env if needed
make dev

This starts:

Backend API at http://localhost:8000 (Swagger at /docs)
Frontend at http://localhost:5173
Redis at port 6379
MinIO at ports 9000 (API) and 9001 (Console)

Local Development (without Docker)

Backend

cd backend
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
cp ../.env.example .env  # adjust DATABASE_URL if needed
uvicorn app.main:app --reload

Frontend

cd frontend
npm install
npm run dev

Project Structure

.
├── backend/          # FastAPI application
│   ├── app/
│   │   ├── main.py       # App entry point
│   │   ├── core/         # Config, security
│   │   ├── db/           # Database setup
│   │   ├── models/       # SQLAlchemy models
│   │   ├── schemas/      # Pydantic schemas
│   │   ├── api/          # API routes
│   │   └── services/     # Business logic
│   ├── alembic/          # Database migrations
│   └── requirements.txt
├── frontend/         # React application
│   ├── src/
│   │   ├── components/   # Shared UI components
│   │   ├── pages/        # Page components
│   │   ├── stores/       # Zustand stores
│   │   ├── hooks/        # Custom hooks
│   │   └── lib/          # Utilities
│   └── package.json
├── docker-compose.yml
├── Makefile
└── .env.example

Environment Variables

See .env.example for all required variables. Key ones:

Variable	Description
DATABASE_URL	Database connection string (SQLite for dev)
JWT_SECRET_KEY	Secret for signing JWT tokens
REDIS_URL	Redis connection URL
MINIO_ACCESS_KEY / MINIO_SECRET_KEY	MinIO credentials
CORS_ORIGINS	Allowed origins for CORS

Available Scripts

make dev              # Start all services
make install-backend  # Install Python dependencies
make install-frontend # Install npm dependencies
make migrate          # Run database migrations
make create-migration MSG="description"  # Create new migration
make clean            # Clean cache files

API Documentation

Once the backend is running, visit:

Swagger UI: http://localhost:8000/docs
ReDoc: http://localhost:8000/redoc

License

MIT

2.9 KiB Raw Permalink Blame History