cooperativa

🤝 Recursos per a Cooperatives

Compartim coneixement i recursos per enfortir el moviment cooperatiu

🛠️ Què és CoopConsum?

Sistema complet de gestió per cooperatives de consum

Tecnologia

🐍 Aplicació web Django (Python) especialment dissenyada per cooperatives de consum amb comandas col·lectives (comandes setmanals/quinzenals dels mateixos productes).

Per a qui és?

  • Cooperatives de consum que fan comandes col·lectives setmanals/quinzenals
  • Grups de consum que volen digitalitzar-se i automatitzar processos
  • Cooperatives que gestionen múltiples proveedors
Cas d'ús típic:

Una cooperativa fa comandes cada dimarts a diversos proveedors (pa, verdures, làctis). Els socis entren a la plataforma durant la setmana, fan les seves comandes, i el dimarts es tanquen automàticament. Els gestors reben un resum i després cobren automàticament als socis.

Tres apartats en una plataforma:

Web Pública
Galeria de fotos, catàleg de productes, informació de la cooperativa. Aparador per mostrar-vos al món.
Intranet de Socis
Àrea privada per fer comandes, consultar el compte personal, veure historial de compres.
Administració
Panell per gestors: configurar socis, proveedors, productes, comandes automàtiques, personalitzar la web.

Automatització:

  • Comandes setmanals/quinzenals automàtiques
  • Tancament automàtic i notificacions
  • Gestió de comptes i cobraments de socis
  • Historial complet de moviments

⚙️🔧 Com implementar la teva cooperativa?

Tria l'opció que millor s'adapti al teu nivell tècnic

Opció Tècnica

Per a desenvolupadors i experts

GitHub + Personalització
Opció No Tècnica

Instal·lació automàtica en 15 min

Docker + Guia pas a pas
Funcionalitats Avançades

Per cooperatives existents

API + Xarxes

👨‍💻 Opció per Desenvolupadors

Codi font complet + Personalització total

Per a qui és?
  • Desenvolupadors amb coneixements Django/Python
  • Cooperatives que volen personalitzacions específiques
  • Projectes que volen contribuir al codi obert
Avantatges:
  • Personalització completa del codi
  • Disseny custom i funcionalitats específiques
  • Control total sobre el desplegament
  • Contribuir al projecte open source
Passos:
  1. Descarrega el codi des de GitHub
  2. Configura l'entorn de desenvolupament local
  3. Personalitza per a la teva cooperativa
  4. Desplega en el teu servidor de producció
Veure Codi a GitHub
Llicència: MIT (Codi lliure)

🐳 Opció per Perfils No Tècnics

Instal·lació automàtica en 15 minuts

Per a qui és?
  • Cooperatives sense coneixements tècnics
  • Gestors que volen una solució ràpida
  • Grups que volen provar la plataforma
Què és Docker? És com una "caixa màgica" que conté tot el necessari per fer funcionar la plataforma. No necessites saber programar!
Avantatges:
  • Instal·lació en 15 minuts
  • Tot automàtic (base de dades, usuaris, configuració)
  • Segur i estable amb backups automàtics
  • Cost baix (5-10€/mes)
Què necessites?
  • Un VPS: Pots llogar-ne un per 5-10€/mes
  • 15 minuts de temps
  • Seguir aquesta guia súper senzilla
Pas 1 Pas 2 Pas 3 Pas 4

Pas 1: Llogar un servidor (5 min)

🛒 On llogar?

Recomanació principal (més detallada):

🥇 OVH VPS (Recomanat)
  • Preu: 3-5€/mes + 3,30€/mes backup aprox.
  • Avantatges: Europeu
  • Motiu: És el que nosaltres utilitzem i el manual més detallat està en aquest format
  • Web: ovh.com/es/vps/

Alternatives:

  • Hetzner
  • DigitalOcean
  • Vultr
⚙️ Configuració del Servidor
  • Sistema operatiu: Ubuntu 22.04 LTS
  • RAM: Mínim 2GB
  • Disc: Mínim 20GB
  • CPU: 1 core és suficient
Molt Recomanat: Backup Automàtic

💡 És altament recomanable contractar el backup automàtic!

A OVH:

  • ✅ Selecciona "Backup automatizado" (+3,30€/mes)
  • 📦 Còpies diàries automàtiques
  • 🔄 Restauració amb un clic des del panell
  • 🛡️ Protecció completa del sistema
Sense backup pots tenir problemes greus en cas d'error del servidor!
Important: Guarda bé les dades d'accés (IP, usuari, contrasenya) que et donin!

Pas 2: Accedir al servidor (5 min)

💻 Des de Windows:
  1. Descarrega PuTTY (és gratuït)
  2. Obre PuTTY i posa la IP del teu servidor
  3. Clica "Open" i accepta l'avís de seguretat
  4. Introdueix l'usuari (normalment "root" o "ubuntu")
  5. Introdueix la contrasenya (OVH t'envia una contrasenya per defecte, el primer access a putty es per a canviarla, després haurás de tornar accedir)
🍎 Des de Mac/Linux:
  1. Obre el Terminal
  2. Escriu: ssh root@LA_TEVA_IP
  3. Introdueix la contrasenya quan te la demani
Si veus algo com root@servidor:~# ja estàs dins!

Pas 3: Instal·lació automàtica (10 min)

🚀 Una sola comanda ho fa tot!

Copia i enganxa aquesta comanda màgica (prem Enter):

curl -sSL https://github.com/fosc19/coopconsum/raw/master/install_docker.sh | bash
Què fa aquesta comanda?
  • Instal·la Docker automàticament
  • Descarrega CoopConsum
  • Usa valors per defecte automàticament
  • Configura tot automàticament
  • Llança la plataforma
  • Configura les tasques automàtiques
No et preocupis per la configuració! L'script ho fa tot automàticament. Després pots canviar el nom de la cooperativa i altres detalls des del panell d'administració.
Això és tot! L'script ho configura tot automàticament, incloses les tasques diàries per gestionar comandes.

Pas 4: Accedir a la teva cooperativa (2 min)

Tot està llest! L'script automàtic ha configurat tot, incloses les tasques diàries per gestionar comandes.
🌐 Accedir a la plataforma
  1. Obre el navegador
  2. Ves a: http://LA_TEVA_IP
  3. Veuràs la pàgina principal de la teva cooperativa!
🔐 Accedir com a administrador
  1. Ves a la ruta privada d'administració configurada a la teva instal·lació
  2. Usuari: admin
  3. Contrasenya: cooperativa2025
  4. IMPORTANT: Canvia la contrasenya immediatament!
Seguretat: El primer que has de fer és canviar la contrasenya de l'administrador! Ves a la secció "Usuaris" dins del panell d'administració, clica sobre "admin" i canvia la contrasenya.
⚙️ Què s'ha configurat automàticament
  • Docker i tots els serveis
  • Base de dades amb la teva cooperativa
  • Usuari administrador
  • Tasques diàries (comandes, backups)
  • Configuració de seguretat
Felicitats!

Ja tens la teva cooperativa funcionant. Ara pots començar a afegir socis, productes i proveedors des del panell d'administració.

🌐 Pas Extra: Contractar un Domini (Opcional)

En lloc d'usar la IP del servidor, pots tenir un domini propi:

  • Què és? En lloc de http://192.168.1.100 pots tenir https://latevacooperativa.cat
  • On comprar? OVH, Namecheap, GoDaddy, o qualsevol registrador de dominis (10-15€/any)
  • Com configurar? Al panell del domini, apunta els DNS cap a la IP del teu servidor
  • HTTPS gratuït: Pots afegir certificat SSL gratuït amb Let's Encrypt
🆘 Necessites ajuda?

🌐 Funcionalitats Avançades (API)

Per cooperatives que ja funcionen i volen més

🔗 API per Cooperatives

Comparteix i accedeix a informació entre cooperatives

Per a qui és?
  • Cooperatives que ja funcionen
  • Xarxes de cooperatives
  • Desenvolupadors que integren sistemes
Què pots obtenir?
  • Proveedors: Contactes i informació
  • Productes: Catàleg sense preus
  • Categories: Organització de productes
  • Esdeveniments: Calendari públic
Beneficis per cooperatives:
  • Xarxes de cooperació regional
  • Compartir proveedors i recursos
  • Descobrir nous productes ecològics
  • Sincronitzar esdeveniments i calendaris
Exemple d'ús:
# Obtenir proveedors públics
GET /api/proveedores/

# Buscar productes ecològics
GET /api/productos/?search=ecològic
Explorar API en Viu
Manual API Documentació Tècnica
API pública i gratuïta per totes les cooperatives