<div align="center">

# Clone the repository
git clone https://github.com/your-org/paper-by-aiconnected.git
cd paper-by-aiconnected

# Copy environment files
cp backend/.env.example backend/.env
cp frontend/.env.example frontend/.env.local

# Start all services
docker-compose -f docker/docker-compose.yml up -d

# Run database migrations
docker-compose exec backend alembic upgrade head

# Access the application
# Frontend: http://localhost:3000
# Backend API: http://localhost:8000
# API Docs: http://localhost:8000/docs

cd backend

# Create virtual environment
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Set up environment variables
cp .env.example .env
# Edit .env with your configuration

# Run migrations
alembic upgrade head

# Start development server
uvicorn app.main:app --reload --port 8000

# In separate terminals, start Celery workers:
celery -A app.workers.celery_app worker --loglevel=info
celery -A app.workers.celery_app beat --loglevel=info

cd frontend

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env.local
# Edit .env.local with your configuration

# Start development server
npm run dev

paper-by-aiconnected/
├── backend/                    # FastAPI backend
│   ├── app/
│   │   ├── main.py            # Application entry point
│   │   ├── config.py          # Settings & configuration
│   │   ├── database.py        # Database connection
│   │   ├── models/            # SQLAlchemy models
│   │   ├── schemas/           # Pydantic schemas
│   │   ├── api/v1/            # API routes
│   │   ├── services/          # Business logic
│   │   ├── workers/           # Celery tasks
│   │   └── templates/         # PDF templates (Jinja2)
│   ├── alembic/               # Database migrations
│   ├── tests/                 # Backend tests
│   └── requirements.txt
│
├── frontend/                   # Next.js frontend
│   ├── src/
│   │   ├── app/               # App Router pages
│   │   ├── components/        # React components
│   │   ├── hooks/             # Custom hooks
│   │   ├── lib/               # Utilities & API client
│   │   ├── stores/            # Zustand stores
│   │   └── types/             # TypeScript definitions
│   ├── public/                # Static assets & logos
│   └── package.json
│
├── docker/                     # Docker configurations
│   ├── docker-compose.yml     # Development
│   └── docker-compose.prod.yml # Production
│
├── docs/                       # Additional documentation
├── CLAUDE.md                   # Claude Code project guide
├── DEVELOPER-PRD.md           # Complete technical specification
├── UI-UX-DESIGN-SPEC.md       # Design system documentation
└── README.md                   # This file

# Database
DATABASE_URL=postgresql+asyncpg://user:password@localhost:5432/paper

# Redis
REDIS_URL=redis://localhost:6379/0

# Security
SECRET_KEY=your-secret-key-minimum-32-characters
ALGORITHM=HS256
ACCESS_TOKEN_EXPIRE_MINUTES=30

# External APIs
ANTHROPIC_API_KEY=sk-ant-...
FREEPIK_API_KEY=...

# Optional: Social Media APIs
LINKEDIN_CLIENT_ID=...
LINKEDIN_CLIENT_SECRET=...

NEXT_PUBLIC_API_URL=http://localhost:8000
NEXT_PUBLIC_WS_URL=ws://localhost:8000
NEXT_PUBLIC_APP_URL=http://localhost:3000

# Backend tests
cd backend
pytest
pytest --cov=app tests/  # With coverage

# Frontend tests
cd frontend
npm test
npm run test:coverage

# Backend
cd backend
ruff check .        # Linting
ruff format .       # Formatting
mypy app/           # Type checking

# Frontend
cd frontend
npm run lint        # ESLint
npm run lint:fix    # Fix issues
npm run type-check  # TypeScript

cd backend

# Create a new migration
alembic revision --autogenerate -m "description of changes"

# Apply migrations
alembic upgrade head

# Rollback one migration
alembic downgrade -1

# Build images
docker-compose -f docker/docker-compose.prod.yml build

# Deploy
docker-compose -f docker/docker-compose.prod.yml up -d

Base URL: https://paper.aiconnected.ai/api/v1

# Login
POST /api/v1/auth/login
Content-Type: application/json
{"email": "user@example.com", "password": "..."}

# Use token
GET /api/v1/clients
Authorization: Bearer <access_token>

<div align="center">