135 lines
3.6 KiB
Markdown
135 lines
3.6 KiB
Markdown
# 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]
|
|
|