Complete refactoring: Migrate to modern FastAPI + Next.js App Router …

.gitignore

@@ -1,9 +1,70 @@
-__pycache__
-venv
-htmlcov
-.coverage*
-.pytest_cache/
-aerich.ini/
-setup.cfg/
-*.env
+# Dependencies
 node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Production builds
+.next/
+out/
+build/
+dist/
+
+# Environment variables
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+logs/
+
+# Database
+*.db
+*.sqlite
+
+# TypeScript
+*.tsbuildinfo
+
+# Coverage reports
+htmlcov/
+.coverage
+.coverage.*
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# Alembic
+alembic/versions/*.py
+!alembic/versions/__init__.py

README.md

@@ -1,16 +1,212 @@
-# SummarizerPWA with Bart Large CNN ⚡️🔥🚀
+# SummarizerAI - Refactored
 
-### Setup
-1. docker-compose --env-file FILE_NAME.env up -d --build
-2. docker-compose logs web -f
+A modern AI-powered text summarization service built with FastAPI and Next.js App Router.
 
-### DB setup
-Go inside the web-db running container and use the postgres CLI:
+## Architecture
+
+This project has been completely refactored from the legacy structure to a modern, scalable architecture:
+
+### Backend (FastAPI + SQLAlchemy)
+- **FastAPI 0.104.1** with async/await support
+- **SQLAlchemy 2.0** with async engine and sessions
+- **PostgreSQL** with asyncpg driver
+- **Alembic** for database migrations
+- **JWT Authentication** with secure password hashing
+- **Pydantic v2** for data validation
+- **Modern ML Stack**: PyTorch, Transformers, spaCy
+
+### Frontend (Next.js App Router)
+- **Next.js 14** with App Router
+- **TypeScript** for type safety
+- **Tailwind CSS** with shadcn/ui components
+- **React Hook Form** with Zod validation
+- **Axios** for API communication
+- **Responsive design** with modern UI/UX
+
+## Project Structure
+
+```
+/
+├── backend/                    # FastAPI Application
+│   ├── app/
+│   │   ├── api/v1/            # API Routes
+│   │   │   ├── endpoints/     # Individual endpoint modules
+│   │   │   └── api.py         # Main API router
+│   │   ├── core/              # Core configuration
+│   │   │   ├── config.py      # Settings management
+│   │   │   └── security.py    # Authentication & security
+│   │   ├── crud/              # Database operations (async)
+│   │   ├── db/                # Database setup
+│   │   │   ├── session.py     # Async session management
+│   │   │   └── base_class.py  # Base model class
+│   │   ├── models/            # SQLAlchemy models
+│   │   ├── schemas/           # Pydantic schemas
+│   │   ├── services/          # Business logic
+│   │   └── main.py           # FastAPI app entrypoint
+│   ├── alembic/              # Database migrations
+│   ├── tests/                # Backend tests (pytest-asyncio)
+│   ├── requirements.txt      # Python dependencies
+│   └── Dockerfile           # Backend container
+│
+├── frontend/                 # Next.js Application
+│   ├── src/
+│   │   ├── app/             # App Router structure
+│   │   │   ├── layout.tsx   # Root layout
+│   │   │   ├── page.tsx     # Home page
+│   │   │   └── globals.css  # Global styles
+│   │   ├── components/      # React components
+│   │   │   ├── ui/         # Basic UI components
+│   │   │   └── shared/     # Complex shared components
+│   │   ├── hooks/          # Custom React hooks
+│   │   ├── lib/            # Utility libraries
+│   │   │   ├── api.ts      # API client
+│   │   │   └── utils.ts    # Utility functions
+│   │   ├── store/          # State management
+│   │   └── types/          # TypeScript definitions
+│   ├── public/             # Static assets
+│   ├── package.json        # Node.js dependencies
+│   └── Dockerfile         # Frontend container
+│
+└── docker-compose.yml      # Multi-service orchestration
+```
+
+## Features
+
+### Core Functionality
+- **Text Summarization**: Paste text directly for instant summarization
+- **URL Summarization**: Extract and summarize content from web articles
+- **Summary History**: Browse and manage previously generated summaries
+- **Real-time Processing**: Background task processing for URL content extraction
+
+### Technical Features
+- **Async Architecture**: Full async/await implementation for optimal performance
+- **Type Safety**: Complete TypeScript coverage on frontend
+- **Modern UI**: Responsive design with Tailwind CSS and shadcn/ui
+- **Database Migrations**: Alembic for schema version control
+- **Comprehensive Testing**: pytest-asyncio test suite
+- **Docker Support**: Multi-service containerization
+- **Security**: JWT authentication with secure password hashing
+
+## Quick Start
+
+### Prerequisites
+- Python 3.11+
+- Node.js 18+
+- PostgreSQL 15+
+- Docker & Docker Compose (optional)
+
+### Development Setup
+
+1. **Clone and setup backend:**
+```bash
+cd backend
+pip install -r requirements.txt
+python -m spacy download en_core_web_sm
+
+# Setup database
+cp .env.example .env  # Configure your database URL
+alembic upgrade head
+
+# Run backend
+uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
+```
+
+2. **Setup frontend:**
+```bash
+cd frontend
+npm install
+
+# Run frontend
+npm run dev
+```
+
+3. **Using Docker (recommended):**
+```bash
+docker-compose up --build
 ```
-docker-compose exec web-db psql -U postgres
 
-\c web_dev
-\dt # shows tables
-\q # exit
+### Access Points
+- **Frontend**: http://localhost:12000
+- **Backend API**: http://localhost:8000
+- **API Documentation**: http://localhost:8000/docs
+
+## API Endpoints
+
+### Summaries
+- `POST /api/v1/summaries/` - Create new summary
+- `GET /api/v1/summaries/` - List all summaries
+- `GET /api/v1/summaries/{id}` - Get specific summary
+- `DELETE /api/v1/summaries/{id}` - Delete summary
+
+### Health
+- `GET /api/v1/health` - Health check endpoint
+
+## Environment Variables
+
+### Backend (.env)
+```env
+DATABASE_URL=postgresql+asyncpg://user:pass@localhost:5432/summarizerdb
+SECRET_KEY=your-secret-key-here
+ENVIRONMENT=development
+HF_TOKEN=your-huggingface-token  # Optional for advanced models
 ```
 
+### Frontend (.env.local)
+```env
+NEXT_PUBLIC_API_URL=http://localhost:8000
+```
+
+## Testing
+
+### Backend Tests
+```bash
+cd backend
+pytest -v
+```
+
+### Frontend Type Checking
+```bash
+cd frontend
+npm run type-check
+```
+
+## Migration from Legacy
+
+This refactoring includes:
+
+### Backend Changes
+- ✅ Migrated from Tortoise ORM to SQLAlchemy 2.0 async
+- ✅ Updated to FastAPI 0.104.1 with modern patterns
+- ✅ Implemented proper async database sessions
+- ✅ Added Alembic for database migrations
+- ✅ Modernized ML dependencies (PyTorch 2.1.1, Transformers 4.35.2)
+- ✅ Added comprehensive test suite with pytest-asyncio
+- ✅ Implemented JWT authentication system
+
+### Frontend Changes
+- ✅ Migrated from Pages Router to App Router (Next.js 14)
+- ✅ Updated to modern React patterns with hooks
+- ✅ Implemented TypeScript throughout
+- ✅ Added modern UI with Tailwind CSS and shadcn/ui
+- ✅ Integrated React Hook Form with Zod validation
+- ✅ Added proper state management patterns
+
+### Infrastructure Changes
+- ✅ Updated Docker configuration for multi-service setup
+- ✅ Added proper environment configuration
+- ✅ Implemented proper CORS settings for development
+- ✅ Added health check endpoints
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add tests for new functionality
+5. Ensure all tests pass
+6. Submit a pull request
+
+## License
+
+This project is licensed under the MIT License.
+

backend/Dockerfile

@@ -0,0 +1,32 @@
+FROM python:3.11-slim
+
+WORKDIR /app
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y \
+    gcc \
+    g++ \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy requirements first for better caching
+COPY requirements.txt .
+
+# Install Python dependencies
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Download spacy model
+RUN python -m spacy download en_core_web_sm
+
+# Copy application code
+COPY . .
+
+# Create non-root user
+RUN useradd --create-home --shell /bin/bash app \
+    && chown -R app:app /app
+USER app
+
+# Expose port
+EXPOSE 8000
+
+# Run the application
+CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000", "--reload"]