This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
Loading actions...
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
Tap-Taza is a cleaning services marketplace for Kazakhstan (Almaty/Astana). Monorepo with a React Native/Expo frontend and a Spring Boot backend. Currently in MVP stage — frontend UI is mostly built, backend APIs are defined, integration between them is in progress.
frontend/)npm start # Expo dev server (press i/a/w for platform)
npm run ios # iOS simulator
npm run android # Android emulator
npm run web # Web browser
npm run lint # ESLint + Prettier check
npm run format # Auto-fix formatting
npm run prebuild # Generate native projects
backend/)mvn spring-boot:run # Run locally (needs PostgreSQL on :5432)
mvn clean package # Build JAR
mvn clean package -DskipTests # Build without tests
docker-compose up # Start backend + PostgreSQL together
docker build -t taptaza-backend . # Build Docker image
See backend/.env.example for required vars: POSTGRES_*, JWT_SECRET, TWILIO_*.
frontend/)app/. Route groups: (tabs) for bottom nav, (auth) for login flow, companies/ for browsing, booking/ for order flownativewind Babel JSX import source and metro.config.js setupsrc/store/bookingStore.ts)src/services/api/client.ts) — token stored in AsyncStorage under @taptaza:access_token@/* maps to src/* (configured in tsconfig.json)backend/)JwtAuthFilter extracts Bearer token, JwtTokenProvider handles generation/validationdto/request/ and dto/response/@CurrentUser annotation resolves authenticated user in controllersdata.sql (runs on startup, contains sample companies in Russian)| Method | Path | Auth | Purpose |
|---|---|---|---|
| POST | /api/auth/send-otp | No | Send 4-digit OTP via WhatsApp |
| POST | /api/auth/verify-otp | No | Verify OTP, returns JWT |
| GET | /api/companies | No | List companies (paginated) |
| GET | /api/companies/{id} | No | Company detail with services |
| POST | /api/bookings | Yes | Create booking |
| GET | /api/bookings | Yes | User's bookings |
| GET | /api/users/me | Yes | Current user profile |
| PUT | /api/users/me | Yes | Update profile |
src/config/index.ts — uses ngrok tunnel URL for deventity/ to model/ package (uncommitted)Detailed docs in project-doc/: Features.md (feature specs), Roadmap.md (4-phase plan), Issues.md (known issues with priorities), ProjectArc.md (architecture), Documentation.md (setup guide), UIDesign.md (screen specs).