Modulo makers3d desarrollado con codex V 0.0.1

This commit is contained in:
Ryuk Mike
2026-07-29 23:58:58 +02:00
commit 2bedf7cbb7
171 changed files with 29421 additions and 0 deletions
+413
View File
@@ -0,0 +1,413 @@
# Makers3D - Especificacion Minima
## 1. Proposito
Makers3D es una plataforma web para descubrir, evaluar y contactar makers y proveedores de fabricacion 3D en Argentina. No es un marketplace ni procesa el pago entre cliente y maker. Su funcion es ayudar a encontrar al profesional adecuado y permitir el primer contacto con contexto suficiente.
## 2. Alcance del MVP
El MVP incluye:
- descubrimiento publico mediante mapa y lista;
- busqueda y filtros;
- perfil publico del maker;
- publicacion de trabajos y servicios;
- cuenta unica para cliente y maker;
- alta de maker en borrador;
- suscripcion unica para aparecer publicamente;
- contacto guiado;
- mensajeria interna basica;
- resenas verificadas;
- moderacion y administracion basicas.
Queda fuera del MVP:
- compra de piezas o servicios dentro de la plataforma;
- apps nativas;
- favoritos;
- comparacion entre makers;
- escaparates tematicos;
- multiples planes;
- multiples ubicaciones por maker;
- gamificacion;
- publicidad;
- patrocinio;
- comunidad social;
- cotizaciones automáticas.
## 3. Actores
### Visitante
Persona que navega sin cuenta y puede:
- explorar mapa y lista;
- buscar y filtrar;
- ver perfiles, trabajos y servicios;
- iniciar una consulta;
- registrarse sin perder el contexto.
### Cliente registrado
Usuario con cuenta que puede:
- enviar consultas;
- mantener conversaciones;
- marcar un trabajo como completado si ambas partes lo confirman;
- dejar una resena verificada cuando exista relacion valida;
- gestionar su cuenta y privacidad.
### Maker
Usuario con cuenta que, ademas, puede:
- crear un perfil profesional privado;
- configurar una ubicacion publica;
- publicar servicios;
- publicar trabajos;
- gestionar disponibilidad;
- responder consultas;
- contratar y gestionar su plan.
### Admin
Usuario interno que puede:
- revisar makers, contenido y resenas;
- gestionar casos e incidencias;
- consultar estado de pagos;
- suspender publicacion cuando exista causa;
- acceder a auditoria basica.
## 4. Objetos funcionales
### Cuenta
Identidad base del usuario. Una misma cuenta puede actuar como cliente y maker.
### Perfil maker
Ficha profesional del maker. Puede existir en borrador sin ser publica.
### Ubicacion
Unica ubicacion operativa del maker en el MVP. Se guarda con coordenada privada y proyeccion publica protegida cuando corresponda.
### Servicio
Oferta que explica que hace el maker, con capacidad, tecnologia y modalidades.
### Trabajo
Caso real publicado por el maker con fotos y descripcion.
### Consulta
Primer contacto estructurado entre cliente y maker.
### Conversacion
Hilo de mensajes asociado a una consulta.
### Suscripcion
Estado comercial del maker respecto a su aparicion publica.
### Relacion
Confirmacion de que la consulta llego a convertirse en trabajo realizado.
### Resena
Valoracion posterior a una relacion completada.
### Caso de moderacion
Registro interno para revisar contenido, resenas o conducta.
## 5. Recorridos principales
### 5.1 Descubrir un maker
1. El visitante entra en la home.
2. Ve mapa, lista o ambas vistas segun dispositivo.
3. Puede usar ubicacion manual o geolocalizacion opcional.
4. Aplica busqueda y filtros.
5. Abre un perfil.
6. Revisa trabajos, servicios, ubicacion publica y resenas.
7. Inicia una consulta.
### 5.2 Enviar una consulta
1. El usuario pulsa contactar desde perfil, trabajo o servicio.
2. La plataforma muestra un formulario guiado segun contexto.
3. El usuario responde necesidad, material, tamano, cantidad, urgencia, envio y adjuntos permitidos.
4. La plataforma genera un resumen editable.
5. Si el usuario no esta registrado, se registra o accede sin perder el borrador.
6. La consulta se envia una sola vez.
7. Se crea una conversacion.
### 5.3 Crear una presencia maker
1. El usuario crea cuenta.
2. Activa su area maker.
3. Completa perfil basico.
4. Configura una ubicacion.
5. Declara disponibilidad.
6. Publica al menos un servicio.
7. Publica al menos un trabajo con foto.
8. Contrata el plan.
9. Solicita publicacion.
10. El perfil pasa a visible si cumple requisitos y no tiene bloqueos.
### 5.4 Gestionar una conversacion
1. Cliente y maker ven la misma conversacion.
2. Pueden responder y adjuntar imagenes o PDF.
3. El maker puede rechazar la consulta con motivo.
4. Ambas partes pueden continuar por canales externos si lo desean.
5. La plataforma conserva el origen y el historial de mensajes internos.
### 5.5 Generar una resena verificada
1. La consulta existe.
2. La conversacion deriva en trabajo realizado.
3. Hay confirmacion de relacion completada.
4. El cliente recibe invitacion para valorar.
5. Se permite una sola resena por relacion y autor.
6. La resena puede ser reportada y moderada.
## 6. Modulos funcionales
### 6.1 Descubrimiento publico
Incluye:
- home con propuesta de valor;
- mapa interactivo;
- lista de resultados;
- busqueda textual;
- filtros;
- perfil publico;
- detalle de trabajo;
- detalle de servicio.
No incluye:
- feed social;
- ranking por popularidad;
- favoritos;
- comparacion;
- contenidos patrocinados.
### 6.2 Perfil publico del maker
Debe mostrar:
- nombre comercial;
- descripcion;
- localidad y provincia;
- cobertura local y modalidad de envio;
- disponibilidad declarada;
- servicios;
- trabajos;
- resenas verificadas;
- CTA de contacto.
No debe mostrar:
- direccion privada;
- telefonos privados si no han sido marcados como publicos;
- datos fiscales;
- senales internas de riesgo;
- metricas vanidosas sin valor publico.
### 6.3 Servicios
Cada maker debe poder publicar servicios con:
- tipo de servicio;
- descripcion;
- tecnologias compatibles;
- materiales compatibles;
- modalidad local y/o envio;
- plazos orientativos;
- precio orientativo opcional.
### 6.4 Trabajos
Cada trabajo debe incluir:
- titulo;
- descripcion orientada a cliente;
- fotos;
- tecnologia o servicio relacionado;
- material cuando aplique;
- resultado mostrado;
- enlace de contacto contextual.
### 6.5 Cuenta y acceso
El sistema debe permitir:
- registro por email y contrasena;
- verificacion de email;
- login;
- recuperacion de contrasena;
- cierre de sesion;
- gestion basica de privacidad.
### 6.6 Area maker
Debe permitir:
- editar perfil;
- editar ubicacion;
- editar disponibilidad;
- crear y editar servicios;
- crear y editar trabajos;
- consultar estado de publicacion;
- consultar estado de suscripcion;
- responder conversaciones;
- ver resenas recibidas.
### 6.7 Suscripcion y publicacion
Reglas:
- existe un unico plan;
- pagar no publica automaticamente;
- la publicacion requiere accion explicita del maker;
- el perfil solo es visible si cumple minimos y no tiene suspension;
- al perder suscripcion, el contenido se conserva pero deja de ser visible publicamente.
### 6.8 Moderacion
Se moderan:
- perfiles;
- trabajos;
- servicios;
- resenas;
- reportes de conducta.
El sistema debe permitir:
- reportar;
- revisar;
- dejar evidencia;
- tomar una medida;
- dejar trazabilidad.
## 7. Reglas de negocio
1. La plataforma cobra por presencia profesional, no por transaccion.
2. El ranking organico no se vende.
3. El perfil publico exige:
- suscripcion activa o habilitacion comercial valida;
- perfil completo;
- una ubicacion;
- un servicio;
- un trabajo con foto;
- un medio de contacto;
- ausencia de suspension.
4. La distancia se calcula con coordenada privada, pero se muestra redondeada.
5. Un maker que trabaja desde casa no publica direccion exacta por defecto.
6. La geolocalizacion del visitante es opcional.
7. La plataforma no garantiza contratacion ni ingresos al maker.
8. Las resenas validas solo nacen de relaciones registradas en la plataforma.
9. No se permiten likes, comentarios publicos ni popularidad social.
10. Los resultados patrocinados no forman parte del MVP.
11. Un archivo subido al sistema no se publica sin pasar por las reglas del contexto correspondiente.
12. El contacto puede continuar fuera de la plataforma, pero el origen queda registrado.
## 8. Estados principales
### Perfil maker
- borrador;
- listo para publicar;
- publicado;
- suspendido;
- oculto por suscripcion inactiva;
- eliminado.
### Consulta
- borrador;
- enviada;
- respondida;
- rechazada;
- cerrada;
- convertida en relacion.
### Suscripcion
- pendiente;
- activa;
- en gracia;
- vencida;
- cancelada.
### Resena
- publicada;
- reportada;
- en revision;
- retirada.
## 9. Modelo funcional minimo
| Entidad | Relacion principal |
|---|---|
| Cuenta | 1 cuenta puede ser cliente y maker |
| Perfil maker | 1 cuenta puede tener 1 perfil maker activo |
| Ubicacion | 1 perfil maker tiene 1 ubicacion operativa en MVP |
| Servicio | 1 perfil maker tiene muchos servicios |
| Trabajo | 1 perfil maker tiene muchos trabajos |
| Consulta | 1 cliente abre 1 consulta hacia 1 maker |
| Conversacion | 1 consulta genera 1 conversacion |
| Mensaje | muchos mensajes pertenecen a 1 conversacion |
| Suscripcion | 1 perfil maker tiene 1 suscripcion vigente como maximo |
| Relacion | 1 consulta puede generar 0 o 1 relacion completada |
| Resena | 1 relacion permite 1 resena por cliente |
| Caso | puede referenciar perfil, contenido, resena o usuario |
## 10. Criterios de aceptacion por modulo
### Descubrimiento
- un visitante puede buscar sin cuenta;
- puede usar mapa o lista;
- puede entender por que un maker aparece;
- nunca ve direccion privada.
### Perfil maker
- muestra oferta, evidencia y contacto en una sola vista;
- no muestra informacion privada;
- permite abrir consulta desde varias entradas.
### Publicacion maker
- el maker puede guardar borradores;
- sabe exactamente que le falta para publicar;
- el sistema no publica perfiles vacios.
### Contacto y mensajeria
- el contexto del origen se conserva;
- el registro no destruye el borrador;
- no se crean mensajes duplicados por doble click o recarga.
### Suscripcion
- el pago se registra;
- la activacion economica no publica automaticamente;
- una suscripcion vencida retira la visibilidad publica sin borrar contenido.
### Resenas y moderacion
- solo hay resenas verificadas desde relacion completada;
- toda accion de moderacion deja auditoria;
- el admin puede retirar contenido si existe causa.