AgencyOS é tudo que você precisa para lançar sua agência ou melhorar as ferramentas de sua empresa existente. Site / Aplicativo Nuxt 3 + Backend Directus.
Trazido a você pela parceria mágica entre Directus e NuxtLabs.
Introdução · Recursos · ? Instalação e Desenvolvimento · ? Implantação · ? Pilha de tecnologia · ? Ajuda da comunidade · ❤️ Contribuindo
Uma das partes mais fáceis de administrar uma agência digital de sucesso é fazer o trabalho real . Quero dizer - quem não gosta de se dedicar para colaborar, projetar e construir coisas incríveis para os clientes?
As partes difíceis são tudo o que vem junto com isso – gerenciar grandes projetos com toneladas de peças móveis, comunicar-se com os clientes para gerenciar adequadamente as expectativas, garantir que você seja pago em dia e muito mais.
Quando cada hora faturável conta, você não tem tempo para criar suas próprias ferramentas do zero. E você não deve ser forçado a se contentar com uma tecnologia pronta para uso que fica aquém do seu fluxo de trabalho preferido.
AgencyOS é o sistema operacional de código aberto para ajudá-lo a administrar (ou iniciar) sua agência digital. Ele é baseado em ferramentas de código aberto (Nuxt e Directus) e projetado para ser 100% hackeável para que você possa construir SUA solução, SEU aplicativo de gerenciamento de projetos, o sistema operacional da SUA agência – em tempo recorde.
Por que?
Muitas pessoas da equipe principal do Directus têm experiência em administrar agências e sabemos que nem tudo são arco-íris e raios de sol. Queríamos construir uma ferramenta da qual nossas agências parceiras (e qualquer outra agência) obtivessem muito valor. Também foi criado como um exemplo completo para mostrar o poder e a flexibilidade do Directus como plataforma para construir rapidamente seus próprios aplicativos e ferramentas.
Começando
Quando você trabalha duro para entregar aos clientes, seu próprio site tende a sofrer. AgencyOS inclui um lindo modelo de site que é facilmente personalizável e já integrado a um CMS headless fácil de usar.
Não é um modelo inicial. É um projeto de site completo para você personalizar ou inspirar a construir uma solução ainda melhor.
Manter relacionamentos importantes com os clientes não cabe apenas à equipe de vendas. Então, por que manter ferramentas separadas de gerenciamento de projetos e CRM? AgencyOS inclui um CRM totalmente personalizável para que você possa trabalhar da maneira que desejar.
A comunicação é provavelmente o maior impulsionador do sucesso do projeto. Com o portal de clientes privados da AgencyOS - você pode garantir que seus clientes se mantenham atualizados e até mesmo responsabilizá-los pela entrega dos arquivos e informações necessários para concluir seus projetos
O AgencyOS tem duas partes principais: o back-end e as APIs desenvolvidas pela Directus e o site front-end e o aplicativo desenvolvido pela Nuxt.
Existem duas maneiras de configurar rapidamente um projeto Directus para usar no AgencyOS.
1a - Registre-se para uma conta Directus Cloud
https://directus.cloud/register
Este é o botão fácil. Você não precisa mexer no Docker ou descobrir como implantar uma instância Directus na AWS, Digital Ocean ou hosts semelhantes. Alguns cliques e em menos de 2 minutos você terá um projeto Directus pronto para usar.
Directus oferece um teste gratuito de 14 dias para projetos em nuvem, tempo suficiente para dar uma chance ao AgencyOS. Nota: Após o teste de 14 dias, você precisará pagar pelo serviço. Consulte a página de preços do Directus para obter as informações de preços mais recentes.
OU
1b - Auto-hospedar uma instância Directus
Se você preferir auto-hospedar o Directus, é altamente recomendável que você faça isso com o Docker.
Nota importante : Este é um lançamento comunitário gratuito e de código aberto. Portanto, não podemos fornecer suporte para instâncias auto-hospedadas SEM uma licença Enterprise Self-Hosted ou um contrato de suporte formal. Saiba mais e entre em contato com nossa equipe para obter detalhes sobre o Enterprise Self-Hosted.
Você encontrará um docker-compose.yaml
dentro do repositório que pode ser usado para ativar rapidamente uma instância local do Directus para testar. Você deve primeiro ter o Docker instalado e funcionando em sua máquina. Você pode baixá-lo aqui .
PostgreSQL é o fornecedor de banco de dados testado e preferido para este projeto. O projeto foi testado e verificado para funcionar no arquivo docker-compose.yaml incluído no repositório. Directus oferece suporte a muitos fornecedores diferentes de bancos de dados SQL, mas SÓ testamos este projeto no 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/
Você pode encontrar mais instruções de instalação usando Docker aqui na documentação do Directus.
Para implantar o projeto ao vivo, consulte a seção Implantação.
Você precisa do token estático para propagar o projeto.
Abra seu terminal, execute o seguinte comando e simplesmente siga as instruções.
npx directus-template-cli@latest apply
Usar a tag @latest garante que você baixe a versão mais atualizada de nossos modelos - caso você tenha executado o comando anteriormente.
Agency OS
.Você pode aprender mais sobre a ferramenta Directus Template CLI aqui. Observação : pode levar alguns minutos para que o script do modelo seja executado se você estiver usando uma instância do Directus hospedada remotamente.
Para o seu site e portal do cliente, AgencyOS usa Nuxt como estrutura de front-end preferida.
Use este modelo
Ou do terminal
git clone https://github.com/directus-community/agency-os.git your-project
Navegue até o projeto
cd your-project
env.example
para .env
Seu arquivo .env
deve ser semelhante 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
Verifique a documentação oficial de implantação do Nuxt para os provedores suportados. Aqui estão alguns dos hosts mais populares que funcionam bem com o Nuxt.
Observação: Vercel é o alvo de implantação recomendado para AgencyOS no momento devido a alguns problemas de memória com o processo de construção no Netlify.
Vercel
Netlificar
Se não quiser mexer com DevOps ou ativar servidores, você pode iniciar um novo projeto no Directus Cloud em cerca de 90 segundos.
Se você preferir auto-hospedagem, Docker é a forma recomendada de implantar Directus. Por favor, verifique o Guia oficial do Directus Docker
Recursos para auto-hospedagem Directus
Crie seu próximo aplicativo Vue.js com confiança usando Nuxt. Uma estrutura de código aberto sob licença do MIT que torna o desenvolvimento web simples e poderoso. A estrutura Vue líder que lida com roteamento, renderização no servidor e muito mais.
Saiba mais sobre Nuxt
Directus é um CMS headless que transforma instantaneamente seu banco de dados SQL em APIs REST e GraphQL e oferece um aplicativo bonito e intuitivo sem código para gerenciar todo o seu conteúdo e dados. Mas também é mais do que apenas um CMS sem cabeça. É uma plataforma de dados aberta que possui todas as ferramentas que você precisa para criar, gerenciar, servir, visualizar e até mesmo automatizar seus dados para seu próximo projeto web, móvel ou digital.
Saiba mais sobre Directus
<Icon>
que permite usar vários ícones. Veja os ícones disponíveis aqui. Para ajuda ou suporte da comunidade, consulte o servidor Directus Discord.
AgencyOS é um projeto conduzido pela comunidade, então adoraríamos receber sua contribuição.
Veja como você pode contribuir:
AgencyOS foi criada por Bryant Gillespie (@bryantgillespie). Mas um grande agradecimento é devido a...
nuxt-directus
separados que serviram como fonte de inspiração.