📖 Nearbrary

Proyecto realizado para el NCD Bootcamp NEAR Hispano, edición de octubre 2021.

Nearbrary es un plataforma donde puedes subir escritos y ganar dinero con ellos, sin editoriales de por medio.

📕 En Nearbrary, los usuarios podrán:

• Subir libros completos de su autoría con el fin de obtener ingresos o ponerlos públicos
• Comprar obras, ya sea un capítulo o de forma completa
• Revisar el catálogo de obras disponibles o próximas a publicar

Cada miembro dentro de la comunidad se identifica con su NEAR account ID

✎ Prerequisitos

1. Node.js (Versión en la que se realizó: 16.11.1)
2. Yarn instalado npm install --global yarn
3. instalar dependencias yarn install
4. Si es el caso, crear una cuenta de NEAR en testnet
5. Instalar NEAR CLI yarn install --global near-cli
6. autorizar app para dar acceso a la cuenta de NEAR near login

🐑 Clonar el Repositorio

git clone https://github.com/MiguelIslasH/nearbrary

🥶 instalar y compilar el contrato

• yarn install
• yarn build

🚀 Deployar el contrato

• yarn dev:deploy:contract

☃ Correr comandos

Una vez en deploy el contrato, a partir de ahora [será utilizado como CONTRACT_ID en los ejemplos de comandos] Utilizaremos [ACCOUNT_ID para identificar el account Id] que utilizamos para autorizar la app.

Registrar usuario

near call CONTRACT_ID registerUser '{"email": "este-email-mola@eldominio.com","name": "Carlitos"}' --accountId ACCOUNT_ID

Publicar una obra: ejemplo que se usa en comprar libro

near call CONTRACT_ID postBook '{"title": "La hacedora de viudas", "price": "20.20", "synopsis": "La noche es mi velo", "content": "Una vez un hombre me dijo que me pusiera ropa, así que me vestí con..."}' --accountId ACCOUNT_ID

Consultar una obra

near view CONTRACT_ID getBook '{"title": "La noche"}'

Consultar todas las obras: regresa la instacia, pues se planea usar así para futuros avances

near view CONTRACT_ID getBooks

Comprar libro: ejemplo válido e inválido por la cantidad

near call CONTRACT_ID buyBook '{"title": "La hacedora de viudas"}' --amount 20.20 --accountId ACCOUNT_ID near call CONTRACT_ID buyBook '{"title": "La hacedora de viudas"}' --amount 0 --accountId ACCOUNT_ID

Consultar datos del usuario

near view CONTRACT_ID getUserData '{"accountId": "ACCOUNT_ID"}'

Caso de uso: Publicación y compra de obras.

Pensamos en un diseño que tuviera colores oscuros de forma predominante, la gente se desgasta menos su vista si la página cuenta con fondos oscuros, lo que el usuario haría sería:

• Consultar las obras publicadas y próximas a publicar
• Consultar las obras adquiridas
• Crear una cuenta usando tu cuenta de mainet.
• Iniciar sesión usando tu cuenta de mainet y tu contraseña.
• Ver el el detalle de alguna obra y:
  • Comprarla completamente
  • Comprarla parcialmente: por capítulos
  • Los comentarios y reseñas sobre la obra
  • Poder comentar y hacer una reseña
• Buscar obras por título, extensión, año y autor.
• Subir obras de su autoría

Estos diseños se pueden encontrar y navegar por ellos aquí: https://www.canva.com/design/DAEuDoppBm4/Ds8X480YRXE-LiZmxx1VOg/view?utm_content=DAEuDoppBm4&utm_campaign=designshare&utm_medium=link&utm_source=sharebutton