# IGNY8 Platform

Full-stack SEO keyword management platform built with Django REST Framework and React.

## 🏗️ Architecture

- **Backend**: Django + DRF (Port 8010/8011)
- **Frontend**: React + TypeScript + Vite (Port 5173/8021)
- **Database**: PostgreSQL
- **Reverse Proxy**: Caddy (HTTPS on port 443)

## 📁 Structure

```
igny8/
├── backend/              # Django backend
│   ├── igny8_core/      # Django project
│   │   └── modules/     # Feature modules
│   │       └── planner/ # Keywords management module
│   ├── Dockerfile
│   └── requirements.txt
├── frontend/            # React frontend
│   ├── src/
│   │   ├── pages/      # Page components
│   │   │   └── Planner/Keywords.tsx
│   │   ├── services/   # API clients
│   │   └── components/ # UI components
│   ├── Dockerfile
│   ├── Dockerfile.dev  # Development mode
│   └── vite.config.ts
└── docker-compose.app.yml
```

## 🚀 Quick Start

### Prerequisites
- Docker & Docker Compose
- Node.js 18+ (for local development)
- Python 3.11+ (for local development)

### Development Setup

1. **Navigate to the project directory:**
   ```bash
   cd /data/app/igny8
   ```

2. **Backend Setup:**
   ```bash
   cd backend
   pip install -r requirements.txt
   python manage.py migrate
   python manage.py createsuperuser
   python manage.py runserver
   ```

3. **Frontend Setup:**
   ```bash
   cd frontend
   npm install
   npm run dev
   ```

4. **Access:**
   - Frontend: http://localhost:5173
   - Backend API: http://localhost:8011/api/
   - Admin: http://localhost:8011/admin/

### Docker Setup

```bash
# Build images
docker build -f backend/Dockerfile -t igny8-backend ./backend
docker build -f frontend/Dockerfile.dev -t igny8-frontend-dev ./frontend

# Run with docker-compose
docker-compose -f docker-compose.app.yml up
```

## 📚 Features

### ✅ Implemented
- **Foundation**: Multi-tenancy system, Authentication (login/register), RBAC permissions
- **Planner Module**: Keywords & Clusters (full CRUD, filtering, pagination, bulk operations, CSV import/export)
- **Frontend**: Complete component library, 4 master templates, config-driven UI system
- **Backend**: REST API with tenant isolation, Site > Sector hierarchy
- **Development**: Docker Compose setup, hot reload, TypeScript + React

### 🚧 In Progress
- Content Ideas module (backend + frontend)
- AI integration for auto-clustering and idea generation
- Planner Dashboard enhancement with KPIs

### 🔄 Planned
- Writer module (Tasks, Drafts, Published)
- Thinker module (Prompts, Strategies, Image Testing)
- AI Pipeline infrastructure
- WordPress integration
- Automation & CRON tasks

## 🔗 API Endpoints

- **Keywords**: `/api/planner/keywords/`
- **Admin**: `/admin/`

## 📖 Documentation

All documentation is consolidated in the `/docs/` folder:

- **`docs/01-ARCHITECTURE.md`** - System architecture, design patterns, and key principles
- **`docs/02-IMPLEMENTATION-ROADMAP.md`** - Complete build roadmap with 21 phases
- **`docs/03-CURRENT-STATUS.md`** - Current progress, completed items, and next steps
- **`docs/04-API-REFERENCE.md`** - API endpoints reference guide
- **`docs/05-WP-MIGRATION-MAP.md`** - WordPress plugin to Django app migration reference

**Quick Start**: Read `docs/03-CURRENT-STATUS.md` for current state, then `docs/02-IMPLEMENTATION-ROADMAP.md` for what to build next.

## 🛠️ Development

### Backend
- Django 5.2+
- Django REST Framework
- PostgreSQL

### Frontend
- React 19
- TypeScript
- Vite
- Tailwind CSS

## 📝 License

[Add license information]