📚 StackRuby

Clon opensource y ligero de Stack Overflow
Construido con Ruby on Rails, licenciado bajo GPLv2

Características • Instalación • Arquitectura • Contribuir • Licencia

📖 Descripción

StackRuby es un clon completo y funcional de Stack Overflow desarrollado en Ruby on Rails. El proyecto nació con el objetivo de crear una alternativa libre, ligera y totalmente opensource al sistema de preguntas y respuestas más popular del mundo.

¿Por qué otro clon de Stack Overflow?

Libertad total: Código 100% abierto bajo GPLv2
Simplicidad: Sin complejidad innecesaria, solo lo esencial
Privacidad: Tu propia instancia, tus propias reglas
Aprendizaje: Base de código limpia para estudiar y modificar
FreeJS: Funciona sin JavaScript, compatible hasta con Emacs

✨ Características

Core Features

🔐 Sistema de Autenticación

Registro e inicio de sesión con email y contraseña
Encriptación de contraseñas con BCrypt
Sesiones persistentes con cookies encrypted
Perfiles de usuario personalizables

❓ Preguntas y Respuestas

Crear, editar y eliminar preguntas
Sistema de comentarios anidados (hilos de conversación)
Respuestas con soporte completo de Markdown
Confirmación de eliminación (escribir título exacto)

⭐ Sistema de Estrellas

Una estrella por usuario por pregunta
No puedes dar estrella a tus propias preguntas
Sistema de favoritos: guarda preguntas con estrella
Solo el autor ve quiénes le dieron estrella (privacidad)
Contador público de estrellas

📝 Soporte de Markdown (GFM)

GitHub Flavored Markdown con Kramdown
Preview server-side sin JavaScript
Soporte de HTML raw (<div>, <img>, etc.)
Bloques de código con syntax
Tablas, listas, quotes, enlaces
Botón "Ver Markdown" para ver código fuente original
Compatible con arte ASCII

💬 Sistema de Comentarios Avanzado

Comentarios en árbol con respuestas anidadas
Algoritmo de Poda de Fantasmas™:
- Soft-delete si el comentario tiene hijos
- Hard-delete si no tiene descendencia
- Recolector en cascada reversa para limpiar fantasmas vacíos
Edición inline de comentarios
Respuestas a cualquier nivel de profundidad

👤 Perfiles de Usuario

Perfil público con biografía y foto (Base64)
Estadísticas:
- Preguntas realizadas
- ⭐ Estrellas otorgadas (total, sin mostrar a quién)
- ⭐ Estrellas recibidas (total)
Grid de preguntas del usuario

🔍 Búsqueda

Búsqueda por título y cuerpo de pregunta
Búsqueda de usuarios por nombre

👁️ Sistema de Vistas

Contador automático de vistas en preguntas
Se incrementa cada vez que alguien abre la pregunta
Visible para todos (pero no quién vio)

📰 Novedades (Blog)

Sistema de noticias/anuncios
Solo lectura para usuarios
Ordenadas por fecha

🎨 UI/UX

Dark theme nativo: Inspirado en GitHub dark
Sidebar sticky: Se mantiene visible al hacer scroll
Diseño responsive: Grid layout moderno
CSS puro: Sin frameworks CSS externos
Accesible: Funciona en navegadores de texto (Lynx, w3m)
Compatible con Emacs: Funciona con eww-mode

🛠️ Stack Técnico

Tecnología	Versión	Propósito
Ruby	3.2.3	Lenguaje base
Rails	6.1.7.10	Framework web
SQLite	3.x	Base de datos (desarrollo/producción ligera)
BCrypt	3.1.7	Encriptación de contraseñas
Kramdown	2.4+	Parser de Markdown
kramdown-parser-gfm	1.1+	GitHub Flavored Markdown
Puma	6.0+	Servidor de aplicaciones

Arquitectura MVC Clásica

StackRuby/
├── app/
│   ├── controllers/
│   │   ├── application_controller.rb
│   │   ├── sesiones_controller.rb       # Autenticación
│   │   ├── pregunta_controller.rb       # CRUD preguntas
│   │   ├── comentarios_controller.rb    # Sistema de comentarios
│   │   ├── usuarios_controller.rb       # Perfiles
│   │   └── novedades_controller.rb      # Blog
│   ├── models/
│   │   ├── preguntum.rb                 # Modelo de pregunta
│   │   ├── comentario.rb                # Árbol de comentarios
│   │   ├── usuario.rb                   # Usuario + autenticación
│   │   ├── estrella.rb                  # Sistema de estrellas
│   │   └── novedad.rb                   # Noticias
│   ├── views/
│   │   ├── layouts/
│   │   │   └── application.html.erb     # Layout principal + CSS
│   │   ├── pregunta/
│   │   ├── comentarios/
│   │   ├── usuarios/
│   │   └── sesiones/
│   └── helpers/
│       └── markdown_helper.rb           # Procesamiento Markdown
├── config/
│   ├── routes.rb                        # Rutas de la aplicación
│   └── database.yml                     # Configuración BD
├── db/
│   ├── migrate/                         # Migraciones
│   └── schema.rb                        # Esquema actual
└── test/                                # Tests (por implementar)

📊 Modelo de Datos

usuarios
├── id (PK)
├── nombre (unique)
├── contrasena (encrypted)
├── descripcion
├── foto_base64
└── timestamps

pregunta
├── id (PK)
├── usuario_id (FK)
├── titulo
├── cuerpo (deprecated)
├── cuerpo_markdown (source)
├── cuerpo_html (rendered)
├── votos (deprecated)
├── vistas
└── timestamps

comentarios
├── id (PK)
├── usuario_id (FK, nullable)
├── preguntum_id (FK)
├── comentario_padre_id (FK, self-ref)
├── cuerpo (deprecated)
├── cuerpo_markdown (source)
├── cuerpo_html (rendered)
└── timestamps

estrellas
├── id (PK)
├── usuario_id (FK)
├── preguntum_id (FK)
└── timestamps
└── UNIQUE(usuario_id, preguntum_id)

novedads
├── id (PK)
├── titulo
├── cuerpo
└── timestamps

Relaciones

Usuario
  has_many :pregunta
  has_many :comentarios
  has_many :estrellas
  has_many :preguntas_favoritas, through: :estrellas

Preguntum
  belongs_to :usuario
  has_many :comentarios
  has_many :estrellas
  has_many :usuarios_que_dieron_estrella, through: :estrellas

Comentario
  belongs_to :usuario (optional: true)  # Permite fantasmas
  belongs_to :preguntum
  belongs_to :padre, class_name: "Comentario" (optional: true)
  has_many :hijos, class_name: "Comentario"

Estrella
  belongs_to :usuario
  belongs_to :preguntum

🚀 Instalación

Prerrequisitos

Ruby 3.2.3
Rails 6.1.7+
SQLite3
Bundler

Instalación Local

# 1. Clonar el repositorio
git clone https://github.com/Qmaker-programmer/stackruby.git
cd stackruby

# 2. Instalar dependencias
bundle install

# 3. Crear y migrar la base de datos
rails db:create
rails db:migrate

# 4. (Opcional) Cargar datos de ejemplo
rails db:seed

# 5. Iniciar el servidor
rails server

# 6. Abrir en navegador
open http://localhost:3000

Variables de Entorno (Producción)

# No hay variables críticas
# SQLite funciona out-of-the-box
# Para producción con PostgreSQL:
# DATABASE_URL=postgres://...
# RAILS_ENV=production

🔧 Uso

Crear un usuario

Ve a http://localhost:3000/entrar
Haz clic en "Registrarse"
Ingresa nombre de usuario y contraseña
Listo, sesión iniciada automáticamente

Publicar una pregunta

Desde el home, clic en "Hacer una Pregunta"
Escribe el título y cuerpo (con Markdown)
Haz clic en "Preview" para ver cómo se verá
Clic en "Publicar Pregunta"

Dar una estrella

Abre cualquier pregunta (que no sea tuya)
Clic en "☆ Dar Estrella"
Para quitarla, clic en "★ Quitar Estrella"

Ver favoritos

Menú lateral → "Favoritos"
Verás todas las preguntas a las que diste estrella

Comentar

Abrir pregunta
Escribir comentario (Markdown soportado)
Para responder a un comentario → "Responder"
Para editar tu comentario → "Editar"

🏗️ Características Técnicas Avanzadas

1. Sistema de Soft-Delete Inteligente

El Algoritmo de Poda de Fantasmas™ es una implementación recursiva que:

def eliminar_con_poda!
  if hijos.any?
    # Soft-delete: Convierte en fantasma
    update(cuerpo: "[Este comentario fue eliminado]", usuario_id: nil)
  else
    # Hard-delete: Purga física
    destroy
  end
end

Ventajas:

Preserva la estructura del árbol de comentarios
No deja "huecos" visuales en la conversación
Recolector de basura automático para fantasmas sin hijos

2. Procesamiento de Markdown Server-Side

Todo el Markdown se procesa en el servidor:

# En el modelo, before_save callback
def procesar_markdown
  if cuerpo_markdown_changed?
    self.cuerpo_html = Kramdown::Document.new(
      cuerpo_markdown,
      input: 'GFM',
      parse_block_html: true
    ).to_html
  end
end

Ventajas:

No depende de JavaScript del cliente
Funciona en navegadores sin JS
Preview sin AJAX, simple POST al servidor
HTML sanitizado y seguro

3. Sistema de Estrellas con Validación Única

class Estrella < ApplicationRecord
  validates :usuario_id, uniqueness: { 
    scope: :preguntum_id,
    message: "Ya diste una estrella a esta pregunta"
  }
end

Esto garantiza a nivel de base de datos que un usuario no pueda dar múltiples estrellas.

4. Encriptación de Contraseñas con BCrypt

before_save :encriptar_contrasena, if: :will_save_change_to_contrasena?

def contrasena_valida?(password_ingresado)
  BCrypt::Password.new(self.contrasena) == password_ingresado
end

Las contraseñas nunca se almacenan en texto plano.

🧪 Testing

# Ejecutar tests (pendiente de implementar)
rails test

# Cobertura
rails test:coverage

Estado actual: Tests pendientes de implementación. Contribuciones bienvenidas.

🤝 Contribuir

¡Las contribuciones son bienvenidas! Este proyecto es 100% opensource.

Proceso de Contribución

Fork el repositorio
Crea una rama para tu feature:
```
git checkout -b feature/mi-mejora-epica
```

Commit tus cambios:

git commit -m "feat: descripción clara del cambio"

Push a tu fork:
```
git push origin feature/mi-mejora-epica
```
Abre un Pull Request

Estilo de Código

Sigue las convenciones de Ruby/Rails estándar
Usa comentarios descriptivos en español
Mantén los métodos cortos y con una sola responsabilidad
Escribe tests para nuevas features (cuando el sistema de tests esté listo)

Ideas de Contribución

✅ Sistema de badges/insignias para usuarios
✅ Búsqueda full-text con pg_search
✅ Sistema de tags/etiquetas en preguntas
✅ Notificaciones de respuestas
✅ Export de preguntas a PDF/Markdown
✅ API REST para integración externa
✅ Sistema de moderación
✅ Tests unitarios y de integración
✅ Docker setup
✅ Deploy con Heroku/Fly.io

📝 Roadmap

v1.0 (Actual) ✅

v1.1 (Próximo)

v2.0 (Futuro)

⚖️ Licencia

Este proyecto está licenciado bajo la GNU General Public License v2.0 (GPLv2).

¿Por qué GPLv2?

Coherencia ideológica: La misma licencia que usa el kernel Linux
Copyleft fuerte: Garantiza que el software siempre será libre
No versión 3: Por razones técnicas y filosóficas de compatibilidad
Libertad total: Puedes usar, modificar y distribuir libremente

Ver LICENSE para más detalles.

🙏 Créditos

Tecnologías

Ruby on Rails - El framework que hace posible todo esto
Kramdown - Por el excelente soporte de Markdown
BCrypt - Por mantener las contraseñas seguras
SQLite - Por ser simple y funcionar perfectamente

Inspiración

Stack Overflow - Por crear el modelo de Q&A que todos conocemos
Reddit - Por el sistema de comentarios anidados
GitHub - Por el dark theme y el GFM
La comunidad opensource - Por compartir conocimiento libremente

📧 Contacto

Proyecto: StackRuby en GitHub

Issues: Reportar un bug
Autor: Qmaker

StackRuby - El clon de Stack Overflow que necesitabas

Hecho con mucho té y Ruby on Rails

⬆ Volver arriba

Name		Name	Last commit message	Last commit date
Latest commit History 10 Commits
app		app
bin		bin
config		config
db		db
lib		lib
log		log
public		public
test		test
tmp		tmp
vendor		vendor
.gitattributes		.gitattributes
.gitignore		.gitignore
.ruby-version		.ruby-version
CAMBIOS_SISTEMA_ESTRELLAS.md		CAMBIOS_SISTEMA_ESTRELLAS.md
Gemfile		Gemfile
Gemfile.lock		Gemfile.lock
README.md		README.md
Rakefile		Rakefile
config.ru		config.ru

Folders and files

Latest commit

History

Repository files navigation