PR a main per actualitzar

.flake8

@@ -1,4 +1,4 @@
 [flake8]
-max-line-length = 88
+max-line-length = 100
 extend-ignore = E203, W503
 exclude = .venv,venv,migrations,__pycache__,.git

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 [Anyer Moreno Alcaraz]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,31 +1,106 @@
 # MetaAppCollector - Backend
 
-MetaAppCollector és una eina per agregar metadades d'aplicacions mòbils des de diverses fonts externes, com botigues d'apps, xarxes socials i motors de cerca.
+**MetaAppCollector** és una eina *open source* per monitoritzar aplicacions mòbils agregant informació pública de diverses fonts com botigues d'apps i xarxes socials.
 
-Aquest projecte és el backend del sistema, desenvolupat amb **Django**.
+> 🧪 Desenvolupada amb Django, Celery, Redis i Docker. Pensada per a desenvolupadors, investigadors i equips de màrqueting que volen entendre millor la visibilitat de les seves apps.
 
-## 🔧 Requisits
+![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
 
-- Python 3.12
-- Django 5.1.7
-- Git
+---
 
-## 🚀 Instal·lació
+## 🔧 Funcionalitats principals
+
+- 🔍 Recuperació de metadades i reviews d'aplicacions mòbils (Google Play, etc.)
+- 📊 Agregació de mètriques d'interacció i visibilitat
+- ⏱️ Polling periòdic configurable per recollida automàtica
+- 🧠 Arquitectura extensible amb adaptadors dinàmics
+- 🐇 Execució asíncrona de tasques amb Celery + Redis
+
+---
+
+## 🚀 Posada en marxa amb Docker
+
+Assegura’t de tenir instal·lats:
+
+- [Docker](https://www.docker.com/)
+- [Docker Compose](https://docs.docker.com/compose/)
+
+### 1. Clona el projecte
+
+```bash
+git clone https://github.com/el-teu-usuari/metaappcollector-backend.git
+cd metaappcollector-backend
+```
+
+### 2. Configura variables d'entorn
+
+Crea un fitxer .env a l'arrel amb el següent contingut mínim:
+
+```bash
+DJANGO_SECRET_KEY=your-secret-key
+DJANGO_DEBUG=True
+```
+
+### 3. Executa els serveis
 
 ```bash
-git clone git@github.com:Anyerrr/MetaAppCollector-Backend.git
-cd MetaAppCollector-Backend
-python -m venv .venv
-.venv\Scripts\activate
-pip install -r requirements.txt
+docker compose up --build
 ```
+Això iniciarà:
 
-## 🛠 ️ Execució
+- El servidor Django a http://localhost:8000
+- El worker de Celery
+- El Beat de Celery (scheduler)
+- Redis com a broker
+
+## 🧪 Prova Celery
+Obre una shell dins del contenidor web:
+```bash
+docker compose exec web python manage.py shell
+```
+I prova una tasca:
+```bash
+from polling.tasks import prueba_celery
+prueba_celery.delay()
+```
+Pots veure els resultats al log del worker:
+```bash
+docker compose logs -f celery
+```
+
+## 🧱 Estructura del projecte
 ```bash
-python manage.py runserver
+├── polling/             # Lògica de polling i tasques Celery
+├── metric/              # Agregació de mètriques
+├── review/              # Gestió de reviews
+├── source/              # Fonts de dades integrades
+├── app/                 # Aplicacions mòbils registrades
+├── config/              # Configuració general de Django i Celery
+├── docker-compose.yml   # Definició dels serveis
 ```
 
-## 🧪 Proves
+## 📚 Comandes útils
 ```bash
-python manage.py test
-```
+docker compose exec web python manage.py migrate     # Aplicar migracions
+docker compose exec web python manage.py createsuperuser
+docker compose exec web python manage.py shell        # Obrir shell
+```
+
+## 🤝 Contribució
+Les contribucions són benvingudes! Si vols col·laborar:
+
+1. Fes un fork del repositori
+2. Crea una branca nova (git checkout -b feature/nou-adaptador)
+3. Fes els teus canvis i commiteja (git commit -am 'Afegit adaptador per X')
+4. Puja la branca (git push origin feature/nou-adaptador)
+5. Fes una pull request 🙌
+
+Abans d’enviar, assegura’t de seguir l’estil de codi del projecte i escriure tests quan sigui necessari.
+
+
+## ✉️ Contacte
+Per dubtes tècnics o col·laboració, contacta amb el desenvolupador principal:
+📧 a.moreno@estudiantat.upc.edu
+
+## 📄 Llicència
+Aquest projecte està llicenciat sota la MIT License – consulta el fitxer LICENSE per a més informació.

app/migrations/0002_app_code.py

@@ -0,0 +1,19 @@
+# Generated by Django 5.1.7 on 2025-04-05 14:17
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("app", "0001_initial"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="app",
+            name="code",
+            field=models.CharField(default="default_code", max_length=100, unique=True),
+            preserve_default=False,
+        ),
+    ]

app/migrations/0003_alter_app_developer.py

@@ -0,0 +1,18 @@
+# Generated by Django 5.1.7 on 2025-04-27 12:31
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("app", "0002_app_code"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="app",
+            name="developer",
+            field=models.CharField(max_length=100, null=True),
+        ),
+    ]

app/models.py

@@ -2,11 +2,12 @@
 
 
 class App(models.Model):
+    code = models.CharField(max_length=100, unique=True)
     name = models.CharField(max_length=200)
     description = models.TextField()
     appstore_id = models.CharField(max_length=100, null=True, unique=True)
     playstore_id = models.CharField(max_length=100, null=True, unique=True)
-    developer = models.CharField(max_length=100, null=True, unique=True)
+    developer = models.CharField(max_length=100, null=True)
     available_on_ios = models.BooleanField(default=False)
     available_on_android = models.BooleanField(default=False)
     pegi_rating = models.CharField(max_length=10, null=True)  # PEGI rating

app/repositories.py

@@ -0,0 +1,26 @@
+from .models import App
+
+
+class AppRepository:
+    @staticmethod
+    def get_all():
+        return App.objects.all()
+
+    @staticmethod
+    def get_by_id(app_id):
+        return App.objects.get(id=app_id)
+
+    @staticmethod
+    def create(data):
+        return App.objects.create(**data)
+
+    @staticmethod
+    def update(instance, data):
+        for attr, value in data.items():
+            setattr(instance, attr, value)
+        instance.save()
+        return instance
+
+    @staticmethod
+    def delete(instance):
+        instance.delete()

app/serializers.py

@@ -0,0 +1,28 @@
+from rest_framework import serializers
+
+from .models import App
+
+
+class AppSerializer(serializers.ModelSerializer):
+    class Meta:
+        model = App
+        fields = [
+            "id",
+            "code",
+            "name",
+            "description",
+            "appstore_id",
+            "playstore_id",
+            "developer",
+            "available_on_ios",
+            "available_on_android",
+            "pegi_rating",
+            "release_date",
+            "min_ios_version",
+        ]
+
+
+class AppCreateSerializer(serializers.ModelSerializer):
+    class Meta:
+        model = App
+        fields = ["code", "name", "description", "appstore_id", "playstore_id"]

app/services.py

@@ -0,0 +1,93 @@
+from datetime import datetime
+
+from django.core.exceptions import ObjectDoesNotExist
+from rest_framework.exceptions import NotFound
+
+from .repositories import AppRepository
+
+
+class AppService:
+    def __init__(self, itunes_adapter=None, google_play_adapter=None):
+        self.repo = AppRepository()
+        self._itunes_adapter = itunes_adapter
+        self._google_play_adapter = google_play_adapter
+
+    @property
+    def itunes_adapter(self):
+        if self._itunes_adapter is None:
+            from source.adapters.itunes import ItunesSearchAPIAdapter
+
+            self._itunes_adapter = ItunesSearchAPIAdapter()
+        return self._itunes_adapter
+
+    @property
+    def google_play_adapter(self):
+        if self._google_play_adapter is None:
+            from source.adapters.google_play_scraper import GooglePlayScraperAdapter
+
+            self._google_play_adapter = GooglePlayScraperAdapter()
+        return self._google_play_adapter
+
+    def list_apps(self):
+        return self.repo.get_all()
+
+    def get_app(self, app_id):
+        try:
+            return self.repo.get_by_id(app_id)
+        except ObjectDoesNotExist:
+            raise NotFound(f"The app with ID '{app_id}' is not registered.")
+
+    def create_app(self, validated_data):
+        self._fetch_appstore_data(validated_data)
+        self._fetch_playstore_data(validated_data)
+        return self.repo.create(validated_data)
+
+    def _fetch_appstore_data(self, validated_data):
+        if not validated_data.get("appstore_id"):
+            return
+
+        result = self.itunes_adapter.lookup_app(validated_data["appstore_id"])
+        if not result:
+            return
+
+        validated_data["available_on_ios"] = True
+        validated_data["developer"] = result.get("artistName")
+        validated_data["pegi_rating"] = result.get("contentAdvisoryRating")
+        validated_data["min_ios_version"] = result.get("minimumOsVersion")
+
+        released_str = result.get("releaseDate")
+        if released_str:
+            try:
+                if "T" in released_str:
+                    release_date = datetime.fromisoformat(released_str.replace("Z", "")).date()
+                    validated_data["release_date"] = release_date
+            except Exception as e:
+                print(f"Error parsejant release_date (AppStore): {released_str} ({e})")
+
+    def _fetch_playstore_data(self, validated_data):
+        if not validated_data.get("playstore_id"):
+            return
+
+        result = self.google_play_adapter.lookup_app(validated_data["playstore_id"])
+        if not result:
+            return
+
+        validated_data["available_on_android"] = True
+        validated_data["developer"] = validated_data.get("developer") or result.get("developer")
+        validated_data["pegi_rating"] = validated_data.get("pegi_rating") or result.get(
+            "contentRating"
+        )
+
+        released_str = result.get("released")
+        if released_str and not validated_data.get("release_date"):
+            try:
+                release_date = datetime.strptime(released_str, "%b %d, %Y").date()
+                validated_data["release_date"] = release_date
+            except ValueError:
+                print(f"Format de data invàlid (PlayStore): {released_str}")
+
+    def update_app(self, instance, validated_data):
+        return self.repo.update(instance, validated_data)
+
+    def delete_app(self, instance):
+        return self.repo.delete(instance)

app/tests.py

@@ -0,0 +1,18 @@
+import pytest
+
+from app.models import App
+
+
+@pytest.mark.django_db
+def test_create_source():
+    a = App.objects.create(
+        code="test_app",
+        name="Test App",
+        description="Descripction of the test app",
+        appstore_id="123456",
+    )
+    assert a.pk is not None
+    assert a.code == "test_app"
+    assert a.name == "Test App"
+    assert a.description == "Descripction of the test app"
+    assert a.appstore_id == "123456"

app/urls.py

@@ -0,0 +1,11 @@
+from django.urls import include, path
+from rest_framework.routers import DefaultRouter
+
+from .views import AppViewSet
+
+router = DefaultRouter()
+router.register(r"apps", AppViewSet, basename="app")
+
+urlpatterns = [
+    path("", include(router.urls)),
+]