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:

   cd /data/app/igny8
   

2. Backend Setup:

   cd backend
   pip install -r requirements.txt
   python manage.py migrate
   python manage.py createsuperuser
   python manage.py runserver
   

3. Frontend Setup:

   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

# 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]