Setup research README and PDF deployment to GitHub Pages

- Created comprehensive research README with project overview, quick start guide, and technical architecture
- Updated GitHub Actions workflow to automatically deploy PDF to GitHub Pages (/docs/static/pdfs/thesis.pdf)
- Updated academic project page to link to auto-deployed thesis PDF
- Commented out arXiv link placeholder until paper is published

The PDF will now be automatically updated on GitHub Pages whenever the paper is rebuilt.

.github/workflows/latex.yml

@@ -26,3 +26,18 @@ jobs:
         with:
           name: thesis-pdf
           path: paper/build/main.pdf
+
+      - name: Deploy PDF to GitHub Pages
+        if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+        run: |
+          # Copy PDF to docs directory for GitHub Pages
+          mkdir -p docs/static/pdfs
+          cp paper/build/main.pdf docs/static/pdfs/thesis.pdf
+
+          # Configure git
+          git config --local user.email "github-actions[bot]@users.noreply.github.com"
+          git config --local user.name "github-actions[bot]"
+
+          # Commit and push if there are changes
+          git add docs/static/pdfs/thesis.pdf
+          git diff --quiet && git diff --staged --quiet || (git commit -m "Update thesis PDF [skip ci]" && git push)

README.md

@@ -1 +1,191 @@
+# PHANTOM: Pricing Heuristics Against Non-human Transaction Orchestration Mechanisms
+
 [![Build PDF](https://github.com/velocitatem/PHANTOM/actions/workflows/latex.yml/badge.svg)](https://github.com/velocitatem/PHANTOM/actions/workflows/latex.yml)
+
+> Bachelor's Thesis Project by Daniel Rösel, IE University Madrid (2025)
+> Advisor: Alberto Martín Izquierdo
+
+## Overview
+
+PHANTOM is an academic research project investigating **pricing heuristics to protect e-commerce platforms from exploitation by LLM agents** in dynamic pricing environments. This project explores behavioral signature detection for agent identification and develops protection mechanisms against automated transaction orchestration.
+
+**Research Focus Areas:**
+- AI security in e-commerce systems
+- Behavioral signature detection for autonomous agent identification
+- Dynamic pricing protection mechanisms
+- LLM agent behavior analysis and exploitation patterns
+
+## Project Structure
+
+This repository contains both the research thesis and a full-stack experimental platform:
+
+```
+PHANTOM/
+├── paper/              # LaTeX Bachelor's Thesis
+│   ├── src/           # LaTeX source files
+│   ├── build/         # Compiled PDF output
+│   └── concat_code.sh # Auto-concatenate code for appendix
+│
+├── docs/              # GitHub Pages academic project page
+│   └── index.html     # Academic project showcase
+│
+├── web/               # Next.js research platform dashboard
+│   └── src/           # Frontend application
+│
+├── backend/           # Python backend services
+│   ├── provider/      # Data provider service
+│   └── worker/        # Kafka consumer worker
+│
+├── experiments/       # Research experiments and data analysis
+│   └── data_export.ipynb
+│
+└── docker/            # Infrastructure configurations
+```
+
+## Quick Start
+
+### Prerequisites
+
+- Docker & Docker Compose (for infrastructure)
+- Node.js 18+ (for web application)
+- Python 3.9+ (for backend services)
+- LaTeX distribution (for building thesis paper)
+
+### Infrastructure Setup
+
+Start Kafka, Redis, and monitoring services:
+
+```bash
+docker-compose up -d
+```
+
+**Services:**
+- Redis: `localhost:6379`
+- Kafka: `localhost:9092`
+- Zookeeper: `localhost:2181`
+- Redpanda Console (Kafka UI): `http://localhost:8080`
+
+### Web Application
+
+```bash
+cd web
+npm install
+npm run dev
+```
+
+Access at `http://localhost:3000`
+
+### Backend Services
+
+Install dependencies:
+```bash
+pip install -r requirements.txt
+```
+
+Run worker:
+```bash
+cd backend/worker
+python main.py
+```
+
+## Building the Thesis Paper
+
+### Using Make
+
+```bash
+make pdf        # Compile LaTeX to PDF
+make watch      # Continuous compilation (live preview)
+make clean      # Remove build artifacts
+```
+
+### Manual Build
+
+```bash
+cd paper/src
+latexmk -pdf main.tex
+```
+
+**Output**: `paper/build/main.pdf`
+
+### Automated CI/CD
+
+The thesis PDF is automatically built via GitHub Actions on every push to `main` that affects `paper/**`. The compiled PDF artifact is available in the Actions tab.
+
+## Technical Architecture
+
+**Frontend**: Next.js 14, React 18, TypeScript, Tailwind CSS
+**Backend**: Python, Kafka (event streaming)
+**Infrastructure**: Redis (cache), Kafka + Zookeeper
+**Monitoring**: Redpanda Console
+**Data Analysis**: Jupyter Notebooks, Pandas, Matplotlib
+
+### Event-Driven Architecture
+
+The platform uses Kafka for real-time event streaming, enabling:
+- Asynchronous task processing
+- Scalable data collection
+- Experiment tracking and analysis
+- Behavioral pattern detection
+
+## Research Experiments
+
+Jupyter notebooks in `experiments/` contain:
+- Data exploration and analysis
+- Behavioral pattern visualizations
+- Statistical analysis of agent behaviors
+- Experiment result processing
+
+Run experiments:
+```bash
+cd experiments
+jupyter notebook data_export.ipynb
+```
+
+## Documentation
+
+- **Academic Project Page**: Hosted on GitHub Pages at `/docs`
+- **Thesis Paper**: Latest PDF available via GitHub Actions artifacts
+- **Web App README**: See `web/README.md`
+- **Backend READMEs**: See `backend/provider/README.md` and `backend/worker/README.md`
+
+## Development Workflow
+
+1. **Paper Development**: Edit LaTeX files in `paper/src/`, use `make watch` for live preview
+2. **Web Development**: Standard Next.js workflow in `web/`
+3. **Backend Development**: Python services in `backend/`
+4. **Experiments**: Jupyter notebooks in `experiments/`
+
+### Code in Thesis Appendix
+
+The `paper/concat_code.sh` script automatically generates a LaTeX appendix containing all source code from:
+- `backend/` (Python, JavaScript, Shell, YAML)
+- `experiments/` (Analysis scripts)
+- `docker/` (Infrastructure configs)
+- `web/src/` (TypeScript/React components)
+
+This runs automatically during PDF compilation.
+
+## Contributing
+
+This is an academic thesis project. For questions or collaboration inquiries, please open an issue.
+
+## License
+
+Academic research project - all rights reserved.
+
+## Citation
+
+```bibtex
+@thesis{rosel2025phantom,
+  title={Pricing Heuristics Against Non-human Transaction Orchestration Mechanisms},
+  author={Rösel, Daniel},
+  year={2025},
+  school={IE University},
+  address={Madrid, Spain},
+  type={Bachelor's Thesis}
+}
+```
+
+## Acknowledgments
+
+Special thanks to Alberto Martín Izquierdo for academic supervision and guidance throughout this research project.

docs/index.html

@@ -47,7 +47,7 @@
   <meta name="citation_author" content="Rösel, Daniel">
   <meta name="citation_publication_date" content="2025">
   <meta name="citation_conference_title" content="IE University Bachelor's Thesis">
-  <meta name="citation_pdf_url" content="TODO">
+  <meta name="citation_pdf_url" content="static/pdfs/thesis.pdf">
 
   <!-- Additional SEO -->
   <meta name="theme-color" content="#2563eb">
@@ -238,14 +238,14 @@
 
                   <div class="column has-text-centered">
                     <div class="publication-links">
-                         <!-- TODO: Update with your arXiv paper ID -->
+                         <!-- Thesis PDF - automatically updated via GitHub Actions -->
                       <span class="link-block">
-                        <a href="https://arxiv.org/pdf/<ARXIV PAPER ID>.pdf" target="_blank"
+                        <a href="static/pdfs/thesis.pdf" target="_blank"
                         class="external-link button is-normal is-rounded is-dark">
                         <span class="icon">
                           <i class="fas fa-file-pdf"></i>
                         </span>
-                        <span>Paper</span>
+                        <span>Thesis PDF</span>
                       </a>
                     </span>
 
@@ -270,8 +270,8 @@
                   </a>
                 </span>
 
-                <!-- TODO: Update with your arXiv paper ID -->
+                <!-- TODO: Update with your arXiv paper ID when available -->
-                <span class="link-block">
+                <!-- <span class="link-block">
                   <a href="https://arxiv.org/abs/<ARXIV PAPER ID>" target="_blank"
                   class="external-link button is-normal is-rounded is-dark">
                   <span class="icon">
@@ -279,7 +279,7 @@
                   </span>
                   <span>arXiv</span>
                 </a>
-              </span>
+              </span> -->
             </div>
           </div>
         </div>