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
commit 7f7da15965
135 changed files with 18980 additions and 0 deletions
@@ -0,0 +1,113 @@
+# 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)
+
+```bash
+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
+
+```bash
+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
+
+```bash
+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
+
+```bash
+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