AgencyOS es todo lo que necesita para hacer despegar su agencia o mejorar las herramientas de su empresa existente. Sitio web/Aplicación Nuxt 3 + Backend Directus.
Presentado gracias a la magia de la asociación entre Directus y NuxtLabs.
Introducción · Características · ? Instalación y Desarrollo · ? Implementación · ? Pila de tecnología · ? Ayuda de la comunidad · ❤️ Contribuyendo
Una de las partes más sencillas de gestionar una agencia digital exitosa es hacer el trabajo real . Quiero decir, ¿a quién no le encanta dedicarse a colaborar, diseñar y crear cosas increíbles para los clientes?
Las partes difíciles son todo lo que conlleva: gestionar grandes proyectos con toneladas de piezas en movimiento, comunicarse con los clientes para gestionar adecuadamente las expectativas, garantizar que le paguen a tiempo y más.
Cuando cada hora facturable cuenta, no tienes tiempo para crear tus propias herramientas desde cero. Y no debería verse obligado a conformarse con tecnología disponible que no se ajusta a su flujo de trabajo preferido.
AgencyOS es el sistema operativo de código abierto que le ayudará a ejecutar (o iniciar) su agencia digital. Está construido sobre herramientas de código abierto (Nuxt y Directus) y diseñado para ser 100% pirateable para que puedas crear TU solución, TU aplicación de gestión de proyectos, el sistema operativo de TU agencia, en un tiempo récord.
¿Por qué?
Muchas personas en el equipo central de Directus tienen experiencia en la gestión de agencias y sabemos que no todo es arcoíris y sol. Queríamos crear una herramienta de la que nuestras agencias asociadas (y cualquier otra agencia) obtuvieran mucho valor. También se creó como un ejemplo completo para mostrar el poder y la flexibilidad de Directus como plataforma para crear rápidamente sus propias aplicaciones y herramientas.
Empezando
Cuando trabaja duro para cumplir con los clientes, su propio sitio tiende a sufrir. AgencyOS incluye una hermosa plantilla de sitio web que se puede personalizar fácilmente y ya está integrada con un CMS headless fácil de usar.
No es una plantilla inicial. Es un proyecto de sitio web completo que puedes personalizar o inspirarte para crear una solución aún mejor.
Mantener relaciones importantes con los clientes no recae únicamente en el equipo de ventas. Entonces, ¿por qué mantener herramientas de gestión de proyectos y CRM separadas? AgencyOS incluye un CRM completamente personalizable para que puedas trabajar como quieras.
La comunicación es probablemente el mayor impulsor del éxito de un proyecto. Con el portal privado para clientes de AgencyOS, puede asegurarse de que sus clientes se mantengan actualizados e incluso responsabilizarlos por la entrega de los archivos y la información que necesita para completar su proyecto.
Hay dos partes principales de AgencyOS: el backend y las API impulsadas por Directus y el sitio web y la aplicación frontend impulsados por Nuxt.
Hay dos formas de configurar rápidamente un proyecto Directus para usarlo en AgencyOS.
1a - Regístrese para obtener una cuenta de Directus Cloud
https://directus.cloud/register
Este es el botón fácil. No tiene que meterse con Docker ni descubrir cómo implementar una instancia de Directus en AWS, Digital Ocean o hosts similares. Un par de clics y en menos de 2 minutos tendrás un proyecto Directus listo para usar.
Directus ofrece una prueba gratuita de 14 días para proyectos en la nube, tiempo suficiente para probar AgencyOS. Nota: Después de la prueba de 14 días deberás pagar por el servicio. Consulte la página de precios de Directus para obtener la información de precios más reciente.
O
1b: Autohospedaje de una instancia de Directus
Si prefiere alojar Directus usted mismo, le recomendamos encarecidamente que lo haga con Docker.
Nota importante : esta es una versión comunitaria gratuita y de código abierto. Por lo tanto, no podemos brindar soporte para instancias autohospedadas SIN una licencia Enterprise Self-Hosted o un acuerdo de soporte formal. Obtenga más información y comuníquese con nuestro equipo para obtener detalles sobre Enterprise Self-Hosted.
Encontrarás un docker-compose.yaml
dentro del repositorio que puedes usar para activar rápidamente una instancia local de Directus para realizar pruebas. Primero debe tener Docker instalado y ejecutándose en su máquina. Puedes descargarlo aquí .
PostgreSQL es el proveedor de bases de datos preferido y probado para este proyecto. Se ha probado y verificado que el proyecto funciona con el archivo docker-compose.yaml incluido en el repositorio. Directus admite muchos proveedores de bases de datos SQL diferentes, pero SÓLO probamos este proyecto con PostgreSQL.
# Navigate to the .directus directory
$ cd .directus
# Run docker compose
$ docker compose up
# Docker does it's thing and your Directus project will be available at http://localhost:8055/ or http://0.0.0.0:8055/
Puede encontrar más instrucciones de instalación usando Docker aquí en la documentación de Directus.
Para implementar el proyecto en vivo, consulte la sección Implementación.
Necesita el token estático para iniciar el proyecto.
Abra su terminal, ejecute el siguiente comando y simplemente siga las instrucciones.
npx directus-template-cli@latest apply
El uso de la etiqueta @latest le garantiza descargar la versión más actualizada de nuestras plantillas, en caso de que haya ejecutado el comando anteriormente.
Agency OS
.Puede obtener más información sobre la herramienta CLI de plantilla Directus aquí. Nota : La secuencia de comandos de la plantilla puede tardar unos minutos en ejecutarse si está utilizando una instancia de Directus alojada de forma remota.
Para su sitio web y portal de clientes, AgencyOS utiliza Nuxt como marco de interfaz de elección.
Utilice esta plantilla
O desde la terminal
git clone https://github.com/directus-community/agency-os.git your-project
Navegar al proyecto
cd your-project
env.example
a .env
Su archivo .env
debería verse similar a este.
# Directus Setup
DIRECTUS_URL = " https://your-instance.directus.app "
DIRECTUS_SERVER_TOKEN = " your_directus_server_token_for_server_only_routes "
SITE_URL = " http://localhost:3000 "
# Stripe Setup (If you want to allow payments within the portal)
STRIPE_SECRET_KEY = sk_test_xxxxxxxxxxxxxxx
STRIPE_PUBLISHABLE_KEY = pk_xxxxxxxxxxxxxxx
STRIPE_WEBHOOK_SECRET = whsec_xxxxxxxxxxxxxxx
pnpm i
pnpm dev
http://localhost:3000
pnpm build
Consulte la documentación de implementación oficial de Nuxt para conocer los proveedores admitidos. Estos son algunos de los hosts más populares que funcionan bien con Nuxt.
Nota: Vercel es el objetivo de implementación recomendado para AgencyOS en este momento debido a algunos problemas de memoria con el proceso de compilación en Netlify.
Vercel
Netlificar
Si no quiere meterse con DevOps o hacer funcionar servidores, puede iniciar un nuevo proyecto en Directus Cloud en aproximadamente 90 segundos.
Si prefiere el autohospedaje, Docker es la forma recomendada de implementar Directus. Consulte la guía oficial de Directus Docker
Recursos para el autohospedaje de Directus
Cree su próxima aplicación Vue.js con confianza utilizando Nuxt. Un framework de código abierto bajo licencia MIT que hace que el desarrollo web sea sencillo y potente. El marco líder de Vue que maneja enrutamiento, renderizado del lado del servidor y más.
Más información sobre Nuxt
Directus es un CMS sin cabeza que convierte instantáneamente su base de datos SQL en API REST y GraphQL y le brinda una aplicación hermosa e intuitiva sin código para administrar todo su contenido y datos. Pero también es más que un simple CMS. Es una plataforma de datos abiertos que tiene todas las herramientas que necesita para crear, administrar, servir, visualizar e incluso automatizar sus datos para su próximo proyecto web, móvil o digital.
Más información sobre Directus
<Icon>
que le permite usar toneladas de íconos. Vea los íconos disponibles aquí. Para obtener ayuda o soporte de la comunidad, consulte el servidor Directus Discord.
AgencyOS es un proyecto impulsado por la comunidad, por lo que nos encantaría contar con sus contribuciones.
Así es como puedes contribuir:
AgencyOS fue creado por Bryant Gillespie (@bryantgillespie). Pero muchas gracias se las debemos a...
nuxt-directus
separados que sirvieron como fuente de inspiración.