gohorsejobs/backoffice/README.md
Tiago Yamamoto 017a34c965 docs: comprehensive documentation update
- DATABASE.md: Complete schema with ER diagram, all tables, migrations history
- ROADMAP.md: Project status, completed/in-progress/backlog items
- TASKS.md: Detailed task list to avoid rework
- README.md: Added documentation links table
- backoffice/README.md: Added auth section (JWT Bearer + Cookie)

Schema notes:
- Core tables use SERIAL (INT): users, companies, jobs
- Newer tables use UUID v4: notifications, tickets, payments
- Schema is unified (removed core_* redundant tables)
2025-12-24 11:12:52 -03:00

55 lines
1.1 KiB
Markdown

# Backoffice API - NestJS
GoHorse Jobs SaaS Administration and Subscription Management API.
## Features
- 💳 **Stripe Integration** - Payment processing and subscriptions
- 📊 **Dashboard Stats** - Platform analytics
- 👥 **User Management** - Admin controls for users
- 🏢 **Company Management** - Tenant administration
- 📋 **Subscription Plans** - Monthly/yearly plans
- 🔐 **JWT Authentication** - Bearer token and Cookie support
## Authentication
The backoffice supports **two authentication methods**:
1. **Bearer Token** - `Authorization: Bearer <token>`
2. **JWT Cookie** - `jwt=<token>` (fallback)
This is implemented in `src/auth/jwt-auth.guard.ts`.
## Tech Stack
- NestJS 10+
- TypeScript
- Stripe SDK
- Swagger (OpenAPI)
- JWT (jsonwebtoken)
## Getting Started
```bash
npm install
npm run start:dev
```
## Environment Variables
```env
PORT=3001
STRIPE_SECRET_KEY=sk_test_xxx
STRIPE_WEBHOOK_SECRET=whsec_xxx
```
## API Documentation
Visit: `http://localhost:3001/api/docs`
## Docker
```bash
docker build -t gohorse-backoffice .
docker run -p 3001:3001 gohorse-backoffice
```