From b382688a8fe271945be3a8971a189e31343b3b2d Mon Sep 17 00:00:00 2001 From: Ricardo Carneiro Date: Tue, 28 Oct 2025 19:58:43 -0300 Subject: [PATCH 1/9] feat: fale conosco --- .../Support/Controllers/RatingsController.cs | 86 +++++++ .../Support/Controllers/SupportController.cs | 46 ++++ src/BCards.Web/Areas/Support/Models/Rating.cs | 24 ++ .../Support/Models/RatingSubmissionDto.cs | 19 ++ .../Areas/Support/Models/SupportOptions.cs | 11 + .../Support/Repositories/IRatingRepository.cs | 12 + .../Support/Repositories/RatingRepository.cs | 123 ++++++++++ .../Areas/Support/Services/IRatingService.cs | 11 + .../Areas/Support/Services/ISupportService.cs | 8 + .../Areas/Support/Services/RatingService.cs | 61 +++++ .../Areas/Support/Services/SupportService.cs | 101 +++++++++ .../ViewComponents/SupportFabViewComponent.cs | 36 +++ .../Components/SupportFab/Default.cshtml | 134 +++++++++++ .../Support/Views/Support/ContactForm.cshtml | 155 +++++++++++++ .../Areas/Support/Views/Support/Index.cshtml | 90 ++++++++ .../Configuration/SupportSettings.cs | 10 + src/BCards.Web/Program.cs | 14 ++ .../Components/SupportFab/Default.cshtml | 129 +++++++++++ src/BCards.Web/Views/Shared/_Layout.cshtml | 15 +- src/BCards.Web/appsettings.json | 9 +- src/BCards.Web/wwwroot/css/rating.css | 190 ++++++++++++++++ src/BCards.Web/wwwroot/css/support-fab.css | 186 +++++++++++++++ src/BCards.Web/wwwroot/js/rating.js | 212 ++++++++++++++++++ src/BCards.Web/wwwroot/js/support-fab.js | 56 +++++ 24 files changed, 1733 insertions(+), 5 deletions(-) create mode 100644 src/BCards.Web/Areas/Support/Controllers/RatingsController.cs create mode 100644 src/BCards.Web/Areas/Support/Controllers/SupportController.cs create mode 100644 src/BCards.Web/Areas/Support/Models/Rating.cs create mode 100644 src/BCards.Web/Areas/Support/Models/RatingSubmissionDto.cs create mode 100644 src/BCards.Web/Areas/Support/Models/SupportOptions.cs create mode 100644 src/BCards.Web/Areas/Support/Repositories/IRatingRepository.cs create mode 100644 src/BCards.Web/Areas/Support/Repositories/RatingRepository.cs create mode 100644 src/BCards.Web/Areas/Support/Services/IRatingService.cs create mode 100644 src/BCards.Web/Areas/Support/Services/ISupportService.cs create mode 100644 src/BCards.Web/Areas/Support/Services/RatingService.cs create mode 100644 src/BCards.Web/Areas/Support/Services/SupportService.cs create mode 100644 src/BCards.Web/Areas/Support/ViewComponents/SupportFabViewComponent.cs create mode 100644 src/BCards.Web/Areas/Support/Views/Shared/Components/SupportFab/Default.cshtml create mode 100644 src/BCards.Web/Areas/Support/Views/Support/ContactForm.cshtml create mode 100644 src/BCards.Web/Areas/Support/Views/Support/Index.cshtml create mode 100644 src/BCards.Web/Configuration/SupportSettings.cs create mode 100644 src/BCards.Web/Views/Shared/Components/SupportFab/Default.cshtml create mode 100644 src/BCards.Web/wwwroot/css/rating.css create mode 100644 src/BCards.Web/wwwroot/css/support-fab.css create mode 100644 src/BCards.Web/wwwroot/js/rating.js create mode 100644 src/BCards.Web/wwwroot/js/support-fab.js diff --git a/src/BCards.Web/Areas/Support/Controllers/RatingsController.cs b/src/BCards.Web/Areas/Support/Controllers/RatingsController.cs new file mode 100644 index 0000000..0b05c3f --- /dev/null +++ b/src/BCards.Web/Areas/Support/Controllers/RatingsController.cs @@ -0,0 +1,86 @@ +using BCards.Web.Areas.Support.Models; +using BCards.Web.Areas.Support.Services; +using Microsoft.AspNetCore.Mvc; +using System.Security.Claims; + +namespace BCards.Web.Areas.Support.Controllers; + +[Area("Support")] +[Route("api/ratings")] +[ApiController] +public class RatingsController : ControllerBase +{ + private readonly IRatingService _ratingService; + private readonly ILogger _logger; + + public RatingsController(IRatingService ratingService, ILogger logger) + { + _ratingService = ratingService; + _logger = logger; + } + + [HttpPost] + public async Task SubmitRating([FromBody] RatingSubmissionDto dto) + { + if (!ModelState.IsValid) + { + _logger.LogWarning("Rating inválido submetido: {Errors}", ModelState.Values.SelectMany(v => v.Errors).Select(e => e.ErrorMessage)); + return BadRequest(ModelState); + } + + try + { + var userId = User?.FindFirst(ClaimTypes.NameIdentifier)?.Value; + var success = await _ratingService.SubmitRatingAsync(dto, userId, HttpContext); + + if (success) + { + _logger.LogInformation("Rating de {Stars} estrelas submetido com sucesso", dto.RatingValue); + return Ok(new { message = "Avaliação enviada com sucesso! Obrigado pelo feedback." }); + } + + _logger.LogError("Falha ao submeter rating"); + return StatusCode(503, new { message = "Erro ao processar sua avaliação. Tente novamente mais tarde." }); + } + catch (Exception ex) + { + _logger.LogError(ex, "Erro ao processar rating"); + return StatusCode(500, new { message = "Erro interno ao processar sua avaliação." }); + } + } + + [HttpGet("average")] + public async Task GetAverageRating() + { + try + { + var average = await _ratingService.GetAverageRatingAsync(); + var total = await _ratingService.GetTotalCountAsync(); + + return Ok(new { average = Math.Round(average, 2), total }); + } + catch (Exception ex) + { + _logger.LogError(ex, "Erro ao buscar média de ratings"); + return StatusCode(500, new { message = "Erro ao buscar avaliações" }); + } + } + + [HttpGet("recent")] + public async Task GetRecentRatings([FromQuery] int limit = 10) + { + try + { + if (limit < 1 || limit > 50) + limit = 10; + + var ratings = await _ratingService.GetRecentRatingsAsync(limit); + return Ok(ratings); + } + catch (Exception ex) + { + _logger.LogError(ex, "Erro ao buscar ratings recentes"); + return StatusCode(500, new { message = "Erro ao buscar avaliações recentes" }); + } + } +} diff --git a/src/BCards.Web/Areas/Support/Controllers/SupportController.cs b/src/BCards.Web/Areas/Support/Controllers/SupportController.cs new file mode 100644 index 0000000..fe673e0 --- /dev/null +++ b/src/BCards.Web/Areas/Support/Controllers/SupportController.cs @@ -0,0 +1,46 @@ +using BCards.Web.Areas.Support.Services; +using Microsoft.AspNetCore.Authorization; +using Microsoft.AspNetCore.Mvc; +using System.Security.Claims; + +namespace BCards.Web.Areas.Support.Controllers; + +[Area("Support")] +[Authorize] +public class SupportController : Controller +{ + private readonly ISupportService _supportService; + private readonly ILogger _logger; + + public SupportController(ISupportService supportService, ILogger logger) + { + _supportService = supportService; + _logger = logger; + } + + [HttpGet] + public async Task ContactForm() + { + var userId = User.FindFirst(ClaimTypes.NameIdentifier)?.Value; + var options = await _supportService.GetAvailableOptionsAsync(userId); + + if (!options.CanUseContactForm) + { + _logger.LogWarning("Usuário {UserId} tentou acessar formulário sem permissão", userId); + TempData["Error"] = "Seu plano atual não tem acesso ao formulário de contato. Faça upgrade para o plano Básico ou superior."; + return RedirectToAction("Index", "Home", new { area = "" }); + } + + return View(options); + } + + [HttpGet] + [Route("Support/Index")] + public async Task Index() + { + var userId = User.FindFirst(ClaimTypes.NameIdentifier)?.Value; + var options = await _supportService.GetAvailableOptionsAsync(userId); + + return View(options); + } +} diff --git a/src/BCards.Web/Areas/Support/Models/Rating.cs b/src/BCards.Web/Areas/Support/Models/Rating.cs new file mode 100644 index 0000000..f01b6e5 --- /dev/null +++ b/src/BCards.Web/Areas/Support/Models/Rating.cs @@ -0,0 +1,24 @@ +using MongoDB.Bson; +using MongoDB.Bson.Serialization.Attributes; + +namespace BCards.Web.Areas.Support.Models; + +public class Rating +{ + [BsonId] + [BsonRepresentation(BsonType.ObjectId)] + public string Id { get; set; } = string.Empty; + + public int RatingValue { get; set; } // 1-5 stars + public string? Name { get; set; } + public string? Email { get; set; } + public string? Comment { get; set; } + + public string? UserId { get; set; } // null para anônimos + public string? IpAddress { get; set; } + public string? UserAgent { get; set; } + public string? Culture { get; set; } + public string? Url { get; set; } + + public DateTime CreatedAt { get; set; } = DateTime.UtcNow; +} diff --git a/src/BCards.Web/Areas/Support/Models/RatingSubmissionDto.cs b/src/BCards.Web/Areas/Support/Models/RatingSubmissionDto.cs new file mode 100644 index 0000000..ad7bb03 --- /dev/null +++ b/src/BCards.Web/Areas/Support/Models/RatingSubmissionDto.cs @@ -0,0 +1,19 @@ +using System.ComponentModel.DataAnnotations; + +namespace BCards.Web.Areas.Support.Models; + +public class RatingSubmissionDto +{ + [Required] + [Range(1, 5, ErrorMessage = "A avaliação deve ser entre 1 e 5 estrelas")] + public int RatingValue { get; set; } + + [StringLength(100, ErrorMessage = "O nome deve ter no máximo 100 caracteres")] + public string? Name { get; set; } + + [EmailAddress(ErrorMessage = "Email inválido")] + public string? Email { get; set; } + + [StringLength(500, ErrorMessage = "O comentário deve ter no máximo 500 caracteres")] + public string? Comment { get; set; } +} diff --git a/src/BCards.Web/Areas/Support/Models/SupportOptions.cs b/src/BCards.Web/Areas/Support/Models/SupportOptions.cs new file mode 100644 index 0000000..8ebd038 --- /dev/null +++ b/src/BCards.Web/Areas/Support/Models/SupportOptions.cs @@ -0,0 +1,11 @@ +namespace BCards.Web.Areas.Support.Models; + +public class SupportOptions +{ + public bool CanRate { get; set; } + public bool CanUseContactForm { get; set; } + public bool CanAccessTelegram { get; set; } + public string? TelegramUrl { get; set; } + public string? FormspreeUrl { get; set; } + public string UserPlan { get; set; } = "Trial"; +} diff --git a/src/BCards.Web/Areas/Support/Repositories/IRatingRepository.cs b/src/BCards.Web/Areas/Support/Repositories/IRatingRepository.cs new file mode 100644 index 0000000..aaa9e69 --- /dev/null +++ b/src/BCards.Web/Areas/Support/Repositories/IRatingRepository.cs @@ -0,0 +1,12 @@ +using BCards.Web.Areas.Support.Models; + +namespace BCards.Web.Areas.Support.Repositories; + +public interface IRatingRepository +{ + Task CreateAsync(Rating rating); + Task> GetRecentAsync(int limit = 10); + Task GetAverageRatingAsync(); + Task GetTotalCountAsync(); + Task> GetByUserIdAsync(string userId); +} diff --git a/src/BCards.Web/Areas/Support/Repositories/RatingRepository.cs b/src/BCards.Web/Areas/Support/Repositories/RatingRepository.cs new file mode 100644 index 0000000..fb94717 --- /dev/null +++ b/src/BCards.Web/Areas/Support/Repositories/RatingRepository.cs @@ -0,0 +1,123 @@ +using BCards.Web.Areas.Support.Models; +using MongoDB.Driver; + +namespace BCards.Web.Areas.Support.Repositories; + +public class RatingRepository : IRatingRepository +{ + private readonly IMongoCollection _ratings; + private readonly ILogger _logger; + + public RatingRepository(IMongoDatabase database, ILogger logger) + { + _ratings = database.GetCollection("ratings"); + _logger = logger; + + // Criar índices + CreateIndexes(); + } + + private void CreateIndexes() + { + try + { + var indexKeysDefinition = Builders.IndexKeys.Descending(r => r.CreatedAt); + var indexModel = new CreateIndexModel(indexKeysDefinition); + _ratings.Indexes.CreateOne(indexModel); + + var userIdIndexKeys = Builders.IndexKeys.Ascending(r => r.UserId); + var userIdIndexModel = new CreateIndexModel(userIdIndexKeys); + _ratings.Indexes.CreateOne(userIdIndexModel); + + var ratingValueIndexKeys = Builders.IndexKeys.Ascending(r => r.RatingValue); + var ratingValueIndexModel = new CreateIndexModel(ratingValueIndexKeys); + _ratings.Indexes.CreateOne(ratingValueIndexModel); + + var cultureIndexKeys = Builders.IndexKeys.Ascending(r => r.Culture); + var cultureIndexModel = new CreateIndexModel(cultureIndexKeys); + _ratings.Indexes.CreateOne(cultureIndexModel); + } + catch (Exception ex) + { + _logger.LogWarning(ex, "Não foi possível criar índices para a collection ratings"); + } + } + + public async Task CreateAsync(Rating rating) + { + try + { + await _ratings.InsertOneAsync(rating); + _logger.LogInformation("Rating criado com sucesso: {RatingId}", rating.Id); + return rating; + } + catch (Exception ex) + { + _logger.LogError(ex, "Erro ao criar rating"); + throw; + } + } + + public async Task> GetRecentAsync(int limit = 10) + { + try + { + return await _ratings + .Find(_ => true) + .SortByDescending(r => r.CreatedAt) + .Limit(limit) + .ToListAsync(); + } + catch (Exception ex) + { + _logger.LogError(ex, "Erro ao buscar ratings recentes"); + return new List(); + } + } + + public async Task GetAverageRatingAsync() + { + try + { + var ratings = await _ratings.Find(_ => true).ToListAsync(); + if (ratings.Count == 0) + return 0; + + return ratings.Average(r => r.RatingValue); + } + catch (Exception ex) + { + _logger.LogError(ex, "Erro ao calcular média de ratings"); + return 0; + } + } + + public async Task GetTotalCountAsync() + { + try + { + return (int)await _ratings.CountDocumentsAsync(_ => true); + } + catch (Exception ex) + { + _logger.LogError(ex, "Erro ao contar ratings"); + return 0; + } + } + + public async Task> GetByUserIdAsync(string userId) + { + try + { + return await _ratings + .Find(r => r.UserId == userId) + .SortByDescending(r => r.CreatedAt) + .ToListAsync(); + } + catch (Exception ex) + { + _logger.LogError(ex, "Erro ao buscar ratings do usuário {UserId}", userId); + return new List(); + } + } +} diff --git a/src/BCards.Web/Areas/Support/Services/IRatingService.cs b/src/BCards.Web/Areas/Support/Services/IRatingService.cs new file mode 100644 index 0000000..097eb7b --- /dev/null +++ b/src/BCards.Web/Areas/Support/Services/IRatingService.cs @@ -0,0 +1,11 @@ +using BCards.Web.Areas.Support.Models; + +namespace BCards.Web.Areas.Support.Services; + +public interface IRatingService +{ + Task SubmitRatingAsync(RatingSubmissionDto dto, string? userId, HttpContext httpContext); + Task GetAverageRatingAsync(); + Task GetTotalCountAsync(); + Task> GetRecentRatingsAsync(int limit = 10); +} diff --git a/src/BCards.Web/Areas/Support/Services/ISupportService.cs b/src/BCards.Web/Areas/Support/Services/ISupportService.cs new file mode 100644 index 0000000..a72900e --- /dev/null +++ b/src/BCards.Web/Areas/Support/Services/ISupportService.cs @@ -0,0 +1,8 @@ +using BCards.Web.Areas.Support.Models; + +namespace BCards.Web.Areas.Support.Services; + +public interface ISupportService +{ + Task GetAvailableOptionsAsync(string? userId); +} diff --git a/src/BCards.Web/Areas/Support/Services/RatingService.cs b/src/BCards.Web/Areas/Support/Services/RatingService.cs new file mode 100644 index 0000000..de157bc --- /dev/null +++ b/src/BCards.Web/Areas/Support/Services/RatingService.cs @@ -0,0 +1,61 @@ +using BCards.Web.Areas.Support.Models; +using BCards.Web.Areas.Support.Repositories; +using System.Globalization; + +namespace BCards.Web.Areas.Support.Services; + +public class RatingService : IRatingService +{ + private readonly IRatingRepository _repository; + private readonly ILogger _logger; + + public RatingService(IRatingRepository repository, ILogger logger) + { + _repository = repository; + _logger = logger; + } + + public async Task SubmitRatingAsync(RatingSubmissionDto dto, string? userId, HttpContext httpContext) + { + try + { + var rating = new Rating + { + RatingValue = dto.RatingValue, + Name = dto.Name, + Email = dto.Email, + Comment = dto.Comment, + UserId = userId, + IpAddress = httpContext.Connection.RemoteIpAddress?.ToString(), + UserAgent = httpContext.Request.Headers["User-Agent"].ToString(), + Culture = CultureInfo.CurrentCulture.Name, + Url = httpContext.Request.Headers["Referer"].ToString(), + CreatedAt = DateTime.UtcNow + }; + + await _repository.CreateAsync(rating); + _logger.LogInformation("Rating submetido com sucesso por usuário {UserId}", userId ?? "anônimo"); + return true; + } + catch (Exception ex) + { + _logger.LogError(ex, "Erro ao submeter rating"); + return false; + } + } + + public async Task GetAverageRatingAsync() + { + return await _repository.GetAverageRatingAsync(); + } + + public async Task GetTotalCountAsync() + { + return await _repository.GetTotalCountAsync(); + } + + public async Task> GetRecentRatingsAsync(int limit = 10) + { + return await _repository.GetRecentAsync(limit); + } +} diff --git a/src/BCards.Web/Areas/Support/Services/SupportService.cs b/src/BCards.Web/Areas/Support/Services/SupportService.cs new file mode 100644 index 0000000..e147e74 --- /dev/null +++ b/src/BCards.Web/Areas/Support/Services/SupportService.cs @@ -0,0 +1,101 @@ +using BCards.Web.Areas.Support.Models; +using BCards.Web.Configuration; +using BCards.Web.Models; +using BCards.Web.Repositories; +using Microsoft.Extensions.Options; + +namespace BCards.Web.Areas.Support.Services; + +public class SupportService : ISupportService +{ + private readonly IUserRepository _userRepository; + private readonly IOptions _settings; + private readonly ILogger _logger; + + public SupportService( + IUserRepository userRepository, + IOptions settings, + ILogger logger) + { + _userRepository = userRepository; + _settings = settings; + _logger = logger; + } + + public async Task GetAvailableOptionsAsync(string? userId) + { + var options = new SupportOptions + { + CanRate = _settings.Value.EnableRatingForAllUsers, + CanUseContactForm = false, + CanAccessTelegram = false, + TelegramUrl = _settings.Value.TelegramUrl, + FormspreeUrl = _settings.Value.FormspreeUrl, + UserPlan = "Trial" + }; + + // Usuário não autenticado ou trial + if (string.IsNullOrEmpty(userId)) + { + _logger.LogDebug("Usuário não autenticado - apenas rating disponível"); + return options; + } + + try + { + var user = await _userRepository.GetByIdAsync(userId); + if (user == null) + { + _logger.LogWarning("Usuário {UserId} não encontrado", userId); + return options; + } + + var planName = user.CurrentPlan?.ToLower() ?? "trial"; + options.UserPlan = planName; + + _logger.LogDebug("Verificando opções de suporte para usuário {UserId} com plano {Plan}", userId, planName); + + // Trial: apenas rating + if (planName == "trial") + { + _logger.LogDebug("Plano Trial - apenas rating disponível"); + return options; + } + + // Básico: rating + formulário + if (planName == "basic" || planName == "básico") + { + options.CanUseContactForm = true; + options.UserPlan = "Básico"; + _logger.LogDebug("Plano Básico - rating + formulário disponíveis"); + return options; + } + + // Profissional: rating + formulário (sem telegram) + if (planName == "professional" || planName == "profissional") + { + options.CanUseContactForm = true; + options.UserPlan = "Profissional"; + _logger.LogDebug("Plano Profissional - rating + formulário disponíveis"); + return options; + } + + // Premium e PremiumAffiliate: tudo + if (planName == "premium" || planName == "premiumaffiliate" || planName == "premium+afiliados") + { + options.CanUseContactForm = true; + options.CanAccessTelegram = true; + options.UserPlan = planName.Contains("affiliate") || planName.Contains("afiliados") ? "Premium+Afiliados" : "Premium"; + _logger.LogDebug("Plano {Plan} - todas as opções disponíveis", planName); + return options; + } + + return options; + } + catch (Exception ex) + { + _logger.LogError(ex, "Erro ao verificar opções de suporte para usuário {UserId}", userId); + return options; + } + } +} diff --git a/src/BCards.Web/Areas/Support/ViewComponents/SupportFabViewComponent.cs b/src/BCards.Web/Areas/Support/ViewComponents/SupportFabViewComponent.cs new file mode 100644 index 0000000..3ab2db7 --- /dev/null +++ b/src/BCards.Web/Areas/Support/ViewComponents/SupportFabViewComponent.cs @@ -0,0 +1,36 @@ +using BCards.Web.Areas.Support.Services; +using Microsoft.AspNetCore.Mvc; +using System.Security.Claims; + +namespace BCards.Web.Areas.Support.ViewComponents; + +public class SupportFabViewComponent : ViewComponent +{ + private readonly ISupportService _supportService; + private readonly ILogger _logger; + + public SupportFabViewComponent(ISupportService supportService, ILogger logger) + { + _supportService = supportService; + _logger = logger; + } + + public async Task InvokeAsync() + { + try + { + var userId = UserClaimsPrincipal?.FindFirst(ClaimTypes.NameIdentifier)?.Value; + var options = await _supportService.GetAvailableOptionsAsync(userId); + + _logger.LogDebug("SupportFab invocado para usuário {UserId} - Opções: Rating={CanRate}, Form={CanUseContactForm}, Telegram={CanAccessTelegram}", + userId ?? "anônimo", options.CanRate, options.CanUseContactForm, options.CanAccessTelegram); + + return View(options); + } + catch (Exception ex) + { + _logger.LogError(ex, "Erro ao carregar SupportFab ViewComponent"); + return Content(string.Empty); + } + } +} diff --git a/src/BCards.Web/Areas/Support/Views/Shared/Components/SupportFab/Default.cshtml b/src/BCards.Web/Areas/Support/Views/Shared/Components/SupportFab/Default.cshtml new file mode 100644 index 0000000..6b324f2 --- /dev/null +++ b/src/BCards.Web/Areas/Support/Views/Shared/Components/SupportFab/Default.cshtml @@ -0,0 +1,134 @@ +@model BCards.Web.Areas.Support.Models.SupportOptions + + +
+ + + +
+ + + + +@section Scripts { + + + + +} diff --git a/src/BCards.Web/Areas/Support/Views/Support/ContactForm.cshtml b/src/BCards.Web/Areas/Support/Views/Support/ContactForm.cshtml new file mode 100644 index 0000000..14636d5 --- /dev/null +++ b/src/BCards.Web/Areas/Support/Views/Support/ContactForm.cshtml @@ -0,0 +1,155 @@ +@model BCards.Web.Areas.Support.Models.SupportOptions +@{ + ViewData["Title"] = "Formulário de Contato"; + Layout = "_Layout"; +} + +
+
+
+
+
+

+ Fale Conosco +

+ +
+ + Tempo de resposta: Normalmente respondemos em até 24-48 horas. +
+ +
+
+ + +
+ +
+ + + Usaremos este email para responder sua mensagem. +
+ +
+ + +
+ + @if (Model.CanAccessTelegram) + { +
+ + +
+ } + else + { + + } + +
+ + + + 0/2000 caracteres + +
+ + + + + +
+ +
+
+ + @if (Model.CanAccessTelegram) + { +
+
+

Ou se preferir, entre em contato direto via Telegram:

+ + Abrir Telegram + +
+ } +
+
+ +
+

Perguntas Frequentes

+
+
+

+ +

+
+
+ Você pode fazer upgrade a qualquer momento através da página de Planos e Preços. +
+
+
+
+

+ +

+
+
+ Sim! Você pode cancelar sua assinatura a qualquer momento sem multas ou taxas adicionais. +
+
+
+
+

+ +

+
+
+ Respondemos em até 24-48h para planos Básico. Usuários Premium têm suporte prioritário com resposta em até 12h. +
+
+
+
+
+
+
+
+ +@section Scripts { + +} diff --git a/src/BCards.Web/Areas/Support/Views/Support/Index.cshtml b/src/BCards.Web/Areas/Support/Views/Support/Index.cshtml new file mode 100644 index 0000000..70b5a2e --- /dev/null +++ b/src/BCards.Web/Areas/Support/Views/Support/Index.cshtml @@ -0,0 +1,90 @@ +@model BCards.Web.Areas.Support.Models.SupportOptions +@{ + ViewData["Title"] = "Central de Suporte"; + Layout = "_Layout"; +} + +
+
+
+

+ Central de Suporte +

+ +
+ Plano Atual: @Model.UserPlan +
+ +
+ @if (Model.CanAccessTelegram) + { +
+
+
+
+ +
+
Telegram
+

Fale conosco diretamente pelo Telegram para suporte prioritário.

+ + Abrir Telegram + +
+
+
+ } + + @if (Model.CanUseContactForm) + { +
+
+
+
+ +
+
Formulário de Contato
+

Envie sua dúvida ou problema através do nosso formulário.

+ + Enviar Mensagem + +
+
+
+ } + + @if (Model.CanRate) + { +
+
+
+
+ +
+
Avalie-nos
+

Conte-nos sobre sua experiência com a plataforma.

+ +
+
+
+ } +
+ + @if (!Model.CanUseContactForm && !Model.CanAccessTelegram) + { +
+
Desbloqueie Mais Recursos de Suporte!
+

Seu plano atual tem acesso limitado. Faça upgrade para:

+
    +
  • Plano Básico: Formulário de contato + Avaliações
    • +
  • Plano Premium: Telegram + Formulário + Suporte Prioritário
    • +
+ + Ver Planos e Preços + +
+ } +
+
+
diff --git a/src/BCards.Web/Configuration/SupportSettings.cs b/src/BCards.Web/Configuration/SupportSettings.cs new file mode 100644 index 0000000..3caa76a --- /dev/null +++ b/src/BCards.Web/Configuration/SupportSettings.cs @@ -0,0 +1,10 @@ +namespace BCards.Web.Configuration; + +public class SupportSettings +{ + public string TelegramUrl { get; set; } = string.Empty; + public string FormspreeUrl { get; set; } = string.Empty; + public List EnableTelegramForPlans { get; set; } = new(); + public List EnableFormForPlans { get; set; } = new(); + public bool EnableRatingForAllUsers { get; set; } = true; +} diff --git a/src/BCards.Web/Program.cs b/src/BCards.Web/Program.cs index 9ea0f6c..8245bb2 100644 --- a/src/BCards.Web/Program.cs +++ b/src/BCards.Web/Program.cs @@ -484,6 +484,14 @@ builder.Services.AddScoped(); builder.Services.AddScoped(); +// Support Area - Rating and Contact System +builder.Services.Configure( + builder.Configuration.GetSection("Support")); + +builder.Services.AddScoped(); +builder.Services.AddScoped(); +builder.Services.AddScoped(); + // Configure upload limits for file handling (images up to 5MB) builder.Services.Configure(options => { @@ -721,6 +729,12 @@ if (app.Environment.IsDevelopment()) app.UseResponseCaching(); +// Support Area Routes +app.MapAreaControllerRoute( + name: "support-area", + areaName: "Support", + pattern: "Support/{controller=Support}/{action=Index}/{id?}"); + app.MapControllerRoute( name: "userpage-preview-path", pattern: "page/preview/{category}/{slug}", diff --git a/src/BCards.Web/Views/Shared/Components/SupportFab/Default.cshtml b/src/BCards.Web/Views/Shared/Components/SupportFab/Default.cshtml new file mode 100644 index 0000000..0dc5495 --- /dev/null +++ b/src/BCards.Web/Views/Shared/Components/SupportFab/Default.cshtml @@ -0,0 +1,129 @@ +@model BCards.Web.Areas.Support.Models.SupportOptions + + +
+ + + +
+ + + + + diff --git a/src/BCards.Web/Views/Shared/_Layout.cshtml b/src/BCards.Web/Views/Shared/_Layout.cshtml index 6626dd4..5ddea93 100644 --- a/src/BCards.Web/Views/Shared/_Layout.cshtml +++ b/src/BCards.Web/Views/Shared/_Layout.cshtml @@ -36,6 +36,8 @@ + + @await RenderSectionAsync("Styles", required: false) @@ -207,6 +209,9 @@ + + @await Component.InvokeAsync("SupportFab") + @@ -238,10 +243,10 @@ @if (User.Identity?.IsAuthenticated == true) { Comece Agora - } - else - { - Comece Agora + } + else + { + Comece Agora } @@ -253,6 +258,8 @@ + + + + + +``` + +### Sitemap.xml Integration + +**Adicionar no `HomeController.cs` (método `Sitemap()`):** + +```csharp +// Tutoriais +var markdownService = _serviceProvider.GetRequiredService< + BCards.Web.Areas.Tutoriais.Services.IMarkdownService>(); + +var categories = await _categoryRepository.GetAllAsync(); +foreach (var category in categories) +{ + var tutoriais = await markdownService.GetArticlesByCategoryAsync(category.Slug, "pt-BR"); + + foreach (var tutorial in tutoriais) + { + sitemap.Append($@" + + https://bcards.site/tutoriais/{category.Slug}/{tutorial.Slug} + {tutorial.LastMod:yyyy-MM-dd} + monthly + 0.7 + "); + } +} + +// Artigos +var artigos = await markdownService.GetAllArticlesAsync("Artigos", "pt-BR"); +foreach (var artigo in artigos) +{ + sitemap.Append($@" + + https://bcards.site/artigos/{artigo.Slug} + {artigo.LastMod:yyyy-MM-dd} + monthly + 0.7 + "); +} +``` + +--- + +## ⚡ Performance e Cache + +### Sistema de Cache + +```csharp +// MarkdownService.cs +private readonly IMemoryCache _cache; + +public async Task GetArticleAsync(string slug, string culture) +{ + var cacheKey = $"Article_{slug}_{culture}"; + + if (!_cache.TryGetValue(cacheKey, out ArticleViewModel article)) + { + article = await LoadAndProcessMarkdownAsync(slug, culture); + + _cache.Set(cacheKey, article, new MemoryCacheEntryOptions + { + AbsoluteExpirationRelativeToNow = TimeSpan.FromHours(1) + }); + } + + return article; +} +``` + +**Performance Esperada**: +- 🔥 **Cold hit** (primeiro acesso): ~50-100ms +- ⚡ **Warm hit** (cached): <1ms +- 📦 **Cache hit rate**: 95%+ + +### Cache HTTP (Middleware) + +**Adicionar no `Program.cs` middleware de cache**: + +```csharp +app.Use(async (context, next) => +{ + // Artigos/Tutoriais - cache público moderado + if (context.Request.Path.StartsWithSegments("/tutoriais") || + context.Request.Path.StartsWithSegments("/artigos")) + { + context.Response.Headers.Append("Cache-Control", "public, max-age=3600"); // 1 hora + context.Response.Headers.Append("Vary", "Accept-Encoding"); + } + + await next(); +}); +``` + +--- + +## 🔒 Segurança + +### 1. Validação de Input (Path Traversal) + +```csharp +// TutoriaisController.cs +public async Task Article(string categoria, string slug) +{ + // Sanitização - previne ataques de path traversal + categoria = categoria.Replace("..", "").Replace("/", "").Replace("\\", ""); + slug = slug.Replace("..", "").Replace("/", "").Replace("\\", ""); + + // Validação contra slug malicioso via regex (rotas já validam, mas double-check) + if (!Regex.IsMatch(categoria, @"^[a-z\-]+$") || + !Regex.IsMatch(slug, @"^[a-z0-9\-]+$")) + { + return BadRequest("Parâmetros inválidos"); + } +} +``` + +### 2. XSS Protection (Markdig) + +```csharp +// MarkdownService.cs - Pipeline configurado para segurança +_markdownPipeline = new MarkdownPipelineBuilder() + .UseAdvancedExtensions() + .DisableHtml() // CRÍTICO: Bloqueia HTML inline perigoso + .Build(); +``` + +**Comportamento**: +```markdown + + +Este é um texto seguro + + +<script>alert('XSS')</script> +

Este é um texto seguro

+``` + +### 3. File System Access Control + +```csharp +// MarkdownService.cs +private readonly string _contentBasePath; + +public MarkdownService(IWebHostEnvironment environment) +{ + // Path base restrito à pasta Content/ + _contentBasePath = Path.Combine(environment.ContentRootPath, "Content"); +} + +public async Task GetArticleAsync(string relativePath, string culture) +{ + // Sempre combina com _contentBasePath (não permite acesso fora de Content/) + var fullPath = Path.Combine(_contentBasePath, $"{relativePath}.{culture}.md"); + + // Double-check: verifica se path final está dentro de Content/ + if (!fullPath.StartsWith(_contentBasePath)) + { + _logger.LogWarning("Tentativa de acesso fora de Content/: {Path}", fullPath); + return null; + } +} +``` + +--- + +## 📝 Plano de Implementação (4-6 horas) + +### Fase 1: Setup e Pacotes (30 min) +- [ ] Instalar Markdig + YamlDotNet +- [ ] Criar estrutura de pastas Areas (Tutoriais + Artigos) +- [ ] Criar estrutura Content (Tutoriais/{categorias} + Artigos) + +### Fase 2: Models e Services (1.5h) +- [ ] Criar `ArticleMetadata.cs` +- [ ] Criar `ArticleViewModel.cs` +- [ ] Criar `IMarkdownService.cs` interface +- [ ] Implementar `MarkdownService.cs` completo +- [ ] Registrar DI em `Program.cs` + +### Fase 3: Controllers (1h) +- [ ] Criar `TutoriaisController.cs` (3 actions) +- [ ] Criar `ArtigosController.cs` (2 actions) +- [ ] Adicionar rotas no `Program.cs` + +### Fase 4: Views (1.5h) +- [ ] Criar `Tutoriais/Index.cshtml` +- [ ] Criar `Tutoriais/Category.cshtml` +- [ ] Criar `Tutoriais/Article.cshtml` +- [ ] Criar `Artigos/Index.cshtml` +- [ ] Criar `Artigos/Article.cshtml` +- [ ] Adaptar CSS para identidade visual BCards + +### Fase 5: SEO e Integração (45 min) +- [ ] Adicionar meta tags nas views +- [ ] Implementar Schema.org JSON-LD +- [ ] Integrar no `Sitemap.xml` (HomeController) +- [ ] Configurar cache HTTP no middleware + +### Fase 6: Conteúdo e Testes (45 min) +- [ ] Criar 2-3 tutoriais de exemplo +- [ ] Criar 1-2 artigos inspiracionais +- [ ] Testar todas rotas +- [ ] Validar cache (warm/cold hits) +- [ ] Verificar SEO tags (View Source) +- [ ] Testar segurança (path traversal) + +--- + +## ✅ Checklist Completo de Arquivos + +### Criar (23 arquivos novos) + +#### Content (Markdown) +``` +📁 Content/ + 📁 Tutoriais/ + 📁 tecnologia/ + 📄 como-criar-um-site.pt-BR.md + 📄 guia-completo-bcards.pt-BR.md + 📁 advocacia/ + 📄 como-advogados-podem-usar-bcards.pt-BR.md + 📁 papelaria/ + 📄 criando-cartoes-digitais.pt-BR.md + 📁 Artigos/ + 📄 transformacao-digital.pt-BR.md + 📄 futuro-cartoes-digitais.pt-BR.md +``` + +#### Area Tutoriais +``` +📁 src/BCards.Web/Areas/Tutoriais/ + 📁 Controllers/ + 📄 TutoriaisController.cs + 📁 Models/ + 📄 ArticleMetadata.cs + 📁 ViewModels/ + 📄 ArticleViewModel.cs + 📁 Services/ + 📄 IMarkdownService.cs + 📄 MarkdownService.cs + 📁 Views/ + 📁 Tutoriais/ + 📄 Index.cshtml + 📄 Category.cshtml + 📄 Article.cshtml +``` + +#### Area Artigos +``` +📁 src/BCards.Web/Areas/Artigos/ + 📁 Controllers/ + 📄 ArtigosController.cs + 📁 Views/ + 📁 Artigos/ + 📄 Index.cshtml + 📄 Article.cshtml +``` + +### Modificar (3 arquivos existentes) +``` +📄 src/BCards.Web/BCards.Web.csproj → Adicionar Markdig + YamlDotNet +📄 src/BCards.Web/Program.cs → Registrar DI + Rotas de Areas +📄 src/BCards.Web/Controllers/HomeController.cs → Adicionar artigos ao sitemap (opcional) +``` + +--- + +## 💰 Estimativa de Custo/Benefício + +### Custo +- **Desenvolvimento**: 4-6 horas +- **NuGet Packages**: Gratuitos (Markdig + YamlDotNet são open-source) +- **Infraestrutura**: Zero (usa filesystem, não requer DB) +- **Manutenção**: Baixíssima (apenas criar novos arquivos .md) + +### Benefício +- ✅ **SEO**: Conteúdo indexável aumenta tráfego orgânico (+30-50% estimado) +- ✅ **Educação**: Reduz suporte via tutoriais self-service (-20% tickets) +- ✅ **Credibilidade**: Demonstra expertise no setor +- ✅ **Conversão**: Artigos podem incluir CTAs para planos Premium (+10% conversão) +- ✅ **i18n-ready**: Expansão internacional facilitada (sem refatoração) +- ✅ **Escalabilidade**: Adicionar artigos é trivial (apenas criar .md) + +**ROI Estimado**: **Alto** (custo mínimo, benefícios de longo prazo) + +--- + +## 🚨 Riscos e Mitigações + +| Risco | Probabilidade | Impacto | Mitigação | +|-------|---------------|---------|-----------| +| Conflito de rotas | Baixa | Médio | Usar `/tutoriais` e `/artigos` (não conflita com `/page`) + Constraints em rotas | +| Performance (muitos .md) | Baixa | Baixo | Cache de 1 hora resolve + Lazy loading | +| XSS via Markdown | Média | Alto | `DisableHtml()` no Markdig pipeline | +| Path traversal | Baixa | Alto | Sanitização de input + Path validation | +| Namespace conflicts | Muito Baixa | Baixo | Areas isola namespaces automaticamente | +| Categoria inválida | Média | Baixo | Validação via `CategoryRepository` existente | + +--- + +## 🎯 Recomendações Finais + +### Priorização + +**IMPLEMENTAR AGORA** (Alta Prioridade): +1. ✅ Area "Tutoriais" completa (`/tutoriais/{categoria}/{slug}`) +2. ✅ Integração com `CategoryRepository` existente +3. ✅ SEO básico (meta tags, sitemap, schema.org) +4. ✅ Cache de 1 hora (IMemoryCache) + +**IMPLEMENTAR EM SEGUIDA** (Média Prioridade): +5. ⏳ Area "Artigos" (`/artigos/{slug}`) +6. ⏳ Criar 5-10 tutoriais iniciais +7. ⏳ Analytics de leitura (Google Analytics events) + +**IMPLEMENTAR DEPOIS** (Baixa Prioridade): +8. 💭 Múltiplos idiomas (pt-BR, es-PY) +9. 💭 Sistema de comentários +10. 💭 CMS web para edição (por enquanto usar VS Code) +11. 💭 Search/filtros avançados + +### Evolução Natural + +**Fase 1** (Agora - Semana 1): +- Português apenas +- Filesystem-based +- 10-15 artigos iniciais + +**Fase 2** (Mês 2-3): +- Adicionar espanhol (apenas novos `.md`) +- 30-50 artigos +- Analytics de leitura + +**Fase 3** (Mês 4-6): +- Search interno +- Filtros por categoria +- Artigos relacionados mais inteligentes + +**Fase 4** (Ano 1+): +- CMS web opcional +- Múltiplos autores +- Sistema de versioning + +--- + +## 📚 Referências + +### Código QRRapido (Base) +- **Services**: `/mnt/c/vscode/qrrapido/Services/MarkdownService.cs` +- **Controllers**: `/mnt/c/vscode/qrrapido/Controllers/TutoriaisController.cs` +- **Views**: `/mnt/c/vscode/qrrapido/Views/Tutoriais/` + +### BCards (Integração) +- **Docs**: `/mnt/c/vscode/vcart.me.novo/CLAUDE.md` +- **Categories**: `/mnt/c/vscode/vcart.me.novo/BCardsDB_Dev.categories.json` +- **Area Example**: `/mnt/c/vscode/vcart.me.novo/src/BCards.Web/Areas/Support/` +- **Repository**: `/mnt/c/vscode/vcart.me.novo/src/BCards.Web/Repositories/CategoryRepository.cs` +- **Program.cs**: `/mnt/c/vscode/vcart.me.novo/src/BCards.Web/Program.cs` + +### Bibliotecas +- **Markdig**: https://github.com/xoofx/markdig +- **YamlDotNet**: https://github.com/aaubry/YamlDotNet +- **ASP.NET Areas**: https://learn.microsoft.com/en-us/aspnet/core/mvc/controllers/areas + +--- + +## 🏁 Conclusão + +A implementação de um sistema de artigos no BCards usando **ASP.NET MVC Areas** é **100% viável** e apresenta **compatibilidade arquitetural perfeita** com o código existente. + +### Pontos Fortes +✅ **Areas já em uso**: BCards usa Areas (exemplo: Support) +✅ **Arquitetura MVC + Service + Repository**: Padrão estabelecido +✅ **CategoryRepository existente**: Integração natural com categorias +✅ **Bootstrap 5**: Compatível com views do QRRapido +✅ **IMemoryCache**: Sistema de cache pronto +✅ **i18n-ready**: Expansão internacional sem refatoração +✅ **Isolamento**: Areas separa código de forma limpa +✅ **Escalabilidade**: Fácil adicionar novas features por área + +### Diferencial: Areas +O uso de **ASP.NET MVC Areas** traz vantagens significativas: +- **Organização**: Código isolado por contexto (Tutoriais, Artigos, Support) +- **Namespaces**: Zero conflitos de nomes +- **Manutenibilidade**: Equipes diferentes podem trabalhar em areas diferentes +- **Padrão estabelecido**: Já usado no BCards (consistência) + +### Próximos Passos +1. ✅ **Aprovação do usuário** +2. Instalação de pacotes NuGet (2 minutos) +3. Criação de estrutura de Areas (30 minutos) +4. Implementação de Services e Controllers (3 horas) +5. Criação de Views (1.5 horas) +6. Criação de 2-3 artigos de teste (30 minutos) +7. Deploy e validação + +**Recomendação**: **Prosseguir com implementação usando ASP.NET MVC Areas**. A arquitetura é sólida, escalável e perfeitamente alinhada com os padrões do BCards. + +--- + +**Documento aprovado para implementação** ✅ diff --git a/src/BCards.Web/Areas/Artigos/Controllers/ArtigosController.cs b/src/BCards.Web/Areas/Artigos/Controllers/ArtigosController.cs new file mode 100644 index 0000000..68101cb --- /dev/null +++ b/src/BCards.Web/Areas/Artigos/Controllers/ArtigosController.cs @@ -0,0 +1,67 @@ +using BCards.Web.Areas.Tutoriais.Models.ViewModels; +using BCards.Web.Areas.Tutoriais.Services; +using Microsoft.AspNetCore.Mvc; + +namespace BCards.Web.Areas.Artigos.Controllers; + +[Area("Artigos")] +public class ArtigosController : Controller +{ + private readonly IMarkdownService _markdownService; + private readonly ILogger _logger; + + public ArtigosController( + IMarkdownService markdownService, + ILogger logger) + { + _markdownService = markdownService; + _logger = logger; + } + + // GET /artigos + public async Task Index() + { + var artigos = await _markdownService + .GetAllArticlesAsync("Artigos", "pt-BR"); + + return View(artigos); + } + + // GET /artigos/{slug} + public async Task Article(string slug) + { + // Sanitização + slug = slug.Replace("..", "").Replace("/", "").Replace("\\", ""); + + try + { + var article = await _markdownService.GetArticleAsync( + $"Artigos/{slug}", + "pt-BR" + ); + + if (article == null) + { + _logger.LogWarning("Artigo não encontrado: {Slug}", slug); + return NotFound(); + } + + // Buscar outros artigos para "Leia também" + article.RelatedArticles = await _markdownService + .GetAllArticlesAsync("Artigos", "pt-BR"); + + article.RelatedArticles = article.RelatedArticles + .Where(a => a.Slug != slug) + .OrderByDescending(a => a.Date) + .Take(3) + .ToList(); + + return View(article); + } + catch (FileNotFoundException) + { + _logger.LogWarning("Arquivo markdown não encontrado: {Slug}", slug); + return NotFound(); + } + } +} diff --git a/src/BCards.Web/Areas/Artigos/Views/Artigos/Article.cshtml b/src/BCards.Web/Areas/Artigos/Views/Artigos/Article.cshtml new file mode 100644 index 0000000..06d97f2 --- /dev/null +++ b/src/BCards.Web/Areas/Artigos/Views/Artigos/Article.cshtml @@ -0,0 +1,253 @@ +@model BCards.Web.Areas.Tutoriais.Models.ViewModels.ArticleViewModel +@{ + ViewData["Title"] = Model.Metadata.Title; +} + +@section Head { + + + + + + + + + + + + + + + + + + + + + + + + + + + + +} + +
+
+
+ + + + +
+
+
+ ✨ Artigo + @Model.Metadata.ReadingTimeMinutes min de leitura +
+

@Model.Metadata.Title

+

@Model.Metadata.Description

+
+ @Model.Metadata.Author + @Model.Metadata.Date.ToString("dd/MM/yyyy") + Atualizado em @Model.Metadata.LastMod.ToString("dd/MM/yyyy") +
+
+ + @if (!string.IsNullOrEmpty(Model.Metadata.Image)) + { + @Model.Metadata.Title + } + + +
+ @Html.Raw(Model.HtmlContent) +
+
+ + + +
+ + +
+
+ + @if (Model.RelatedArticles.Any()) + { +
+
+
Leia Também
+
+ @foreach (var related in Model.RelatedArticles) + { + +
+
@related.Title
+
+ @related.ReadingTimeMinutes min + + } +
+
+
+ } + + +
+
+ +
Quer aprender mais?
+

Acesse nossos tutoriais práticos

+ Ver Tutoriais +
+
+ + +
+
+ +
Precisa de ajuda?
+

Entre em contato com nosso suporte

+ Falar com suporte +
+
+
+
+
+
+ +@section Styles { + +} diff --git a/src/BCards.Web/Areas/Artigos/Views/Artigos/Index.cshtml b/src/BCards.Web/Areas/Artigos/Views/Artigos/Index.cshtml new file mode 100644 index 0000000..ec9b449 --- /dev/null +++ b/src/BCards.Web/Areas/Artigos/Views/Artigos/Index.cshtml @@ -0,0 +1,77 @@ +@model List +@{ + ViewData["Title"] = "Artigos BCards - Inspiração e Conhecimento"; +} + +
+
+
+

✨ Artigos BCards

+

Insights, tendências e inspiração para transformar sua presença digital

+
+
+ + @if (Model.Any()) + { +
+ @foreach (var artigo in Model) + { +
+
+ @if (!string.IsNullOrEmpty(artigo.Image)) + { + @artigo.Title + } +
+
@artigo.Title
+

@artigo.Description

+
+ @artigo.ReadingTimeMinutes min + @artigo.Date.ToString("dd/MM/yyyy") +
+
+
+ + Ler artigo + +
+
+
+ } +
+ } + else + { +
+ +

Nenhum artigo disponível ainda

+

Em breve teremos conteúdo inspirador para você!

+
+ } + + +
+
+
+
+

Quer ver tutoriais práticos?

+

Acesse nossa seção de tutoriais e aprenda passo a passo como usar o BCards

+ + Ver Tutoriais + +
+
+
+
+
+ +@section Styles { + +} diff --git a/src/BCards.Web/Areas/Artigos/Views/_ViewStart.cshtml b/src/BCards.Web/Areas/Artigos/Views/_ViewStart.cshtml new file mode 100644 index 0000000..820a2f6 --- /dev/null +++ b/src/BCards.Web/Areas/Artigos/Views/_ViewStart.cshtml @@ -0,0 +1,3 @@ +@{ + Layout = "_Layout"; +} diff --git a/src/BCards.Web/Areas/Tutoriais/Controllers/TutoriaisController.cs b/src/BCards.Web/Areas/Tutoriais/Controllers/TutoriaisController.cs new file mode 100644 index 0000000..6d4b0e0 --- /dev/null +++ b/src/BCards.Web/Areas/Tutoriais/Controllers/TutoriaisController.cs @@ -0,0 +1,111 @@ +using BCards.Web.Areas.Tutoriais.Models; +using BCards.Web.Areas.Tutoriais.Services; +using BCards.Web.Repositories; +using Microsoft.AspNetCore.Mvc; + +namespace BCards.Web.Areas.Tutoriais.Controllers; + +[Area("Tutoriais")] +public class TutoriaisController : Controller +{ + private readonly IMarkdownService _markdownService; + private readonly ICategoryRepository _categoryRepository; + private readonly ILogger _logger; + + public TutoriaisController( + IMarkdownService markdownService, + ICategoryRepository categoryRepository, + ILogger logger) + { + _markdownService = markdownService; + _categoryRepository = categoryRepository; + _logger = logger; + } + + // GET /tutoriais + public async Task Index() + { + var categories = await _categoryRepository.GetAllActiveAsync(); + var tutoriaisPorCategoria = new Dictionary>(); + + foreach (var category in categories) + { + var artigos = await _markdownService + .GetArticlesByCategoryAsync(category.Slug, "pt-BR"); + + if (artigos.Any()) + { + tutoriaisPorCategoria[category.Slug] = artigos; + } + } + + ViewBag.Categories = categories; + return View(tutoriaisPorCategoria); + } + + // GET /tutoriais/{categoria} + public async Task Category(string categoria) + { + // Validar categoria existe + var category = await _categoryRepository.GetBySlugAsync(categoria); + if (category == null) + { + _logger.LogWarning("Categoria não encontrada: {Categoria}", categoria); + return NotFound(); + } + + var artigos = await _markdownService + .GetArticlesByCategoryAsync(categoria, "pt-BR"); + + ViewBag.Category = category; + return View(artigos); + } + + // GET /tutoriais/{categoria}/{slug} + public async Task Article(string categoria, string slug) + { + // Sanitização (segurança contra path traversal) + categoria = categoria.Replace("..", "").Replace("/", "").Replace("\\", ""); + slug = slug.Replace("..", "").Replace("/", "").Replace("\\", ""); + + // Validar categoria existe + var category = await _categoryRepository.GetBySlugAsync(categoria); + if (category == null) + { + _logger.LogWarning("Categoria não encontrada: {Categoria}", categoria); + return NotFound(); + } + + try + { + var article = await _markdownService.GetArticleAsync( + $"Tutoriais/{categoria}/{slug}", + "pt-BR" + ); + + if (article == null) + { + _logger.LogWarning("Artigo não encontrado: {Categoria}/{Slug}", categoria, slug); + return NotFound(); + } + + // Buscar artigos relacionados da mesma categoria + article.RelatedArticles = await _markdownService + .GetArticlesByCategoryAsync(categoria, "pt-BR"); + + // Remover o artigo atual dos relacionados + article.RelatedArticles = article.RelatedArticles + .Where(a => a.Slug != slug) + .Take(3) + .ToList(); + + ViewBag.Category = category; + return View(article); + } + catch (FileNotFoundException) + { + _logger.LogWarning("Arquivo markdown não encontrado: {Categoria}/{Slug}", categoria, slug); + return NotFound(); + } + } +} diff --git a/src/BCards.Web/Areas/Tutoriais/Models/ArticleMetadata.cs b/src/BCards.Web/Areas/Tutoriais/Models/ArticleMetadata.cs new file mode 100644 index 0000000..bc3ff73 --- /dev/null +++ b/src/BCards.Web/Areas/Tutoriais/Models/ArticleMetadata.cs @@ -0,0 +1,16 @@ +namespace BCards.Web.Areas.Tutoriais.Models; + +public class ArticleMetadata +{ + public string Title { get; set; } = string.Empty; + public string Description { get; set; } = string.Empty; + public string Keywords { get; set; } = string.Empty; + public string Author { get; set; } = "BCards"; + public DateTime Date { get; set; } + public DateTime LastMod { get; set; } + public string Image { get; set; } = string.Empty; + public string Culture { get; set; } = "pt-BR"; + public string? Category { get; set; } // Apenas para tutoriais + public int ReadingTimeMinutes { get; set; } + public string Slug { get; set; } = string.Empty; +} diff --git a/src/BCards.Web/Areas/Tutoriais/Models/ViewModels/ArticleViewModel.cs b/src/BCards.Web/Areas/Tutoriais/Models/ViewModels/ArticleViewModel.cs new file mode 100644 index 0000000..a44b6be --- /dev/null +++ b/src/BCards.Web/Areas/Tutoriais/Models/ViewModels/ArticleViewModel.cs @@ -0,0 +1,10 @@ +namespace BCards.Web.Areas.Tutoriais.Models.ViewModels; + +public class ArticleViewModel +{ + public ArticleMetadata Metadata { get; set; } = new(); + public string HtmlContent { get; set; } = string.Empty; + public string Slug { get; set; } = string.Empty; + public DateTime LastModified { get; set; } + public List RelatedArticles { get; set; } = new(); +} diff --git a/src/BCards.Web/Areas/Tutoriais/Services/IMarkdownService.cs b/src/BCards.Web/Areas/Tutoriais/Services/IMarkdownService.cs new file mode 100644 index 0000000..49fa8ac --- /dev/null +++ b/src/BCards.Web/Areas/Tutoriais/Services/IMarkdownService.cs @@ -0,0 +1,11 @@ +using BCards.Web.Areas.Tutoriais.Models; +using BCards.Web.Areas.Tutoriais.Models.ViewModels; + +namespace BCards.Web.Areas.Tutoriais.Services; + +public interface IMarkdownService +{ + Task GetArticleAsync(string relativePath, string culture); + Task> GetArticlesByCategoryAsync(string category, string culture); + Task> GetAllArticlesAsync(string baseFolder, string culture); +} diff --git a/src/BCards.Web/Areas/Tutoriais/Services/MarkdownService.cs b/src/BCards.Web/Areas/Tutoriais/Services/MarkdownService.cs new file mode 100644 index 0000000..d01e1c0 --- /dev/null +++ b/src/BCards.Web/Areas/Tutoriais/Services/MarkdownService.cs @@ -0,0 +1,240 @@ +using BCards.Web.Areas.Tutoriais.Models; +using BCards.Web.Areas.Tutoriais.Models.ViewModels; +using Markdig; +using Microsoft.Extensions.Caching.Memory; +using YamlDotNet.Serialization; +using YamlDotNet.Serialization.NamingConventions; + +namespace BCards.Web.Areas.Tutoriais.Services; + +public class MarkdownService : IMarkdownService +{ + private readonly IMemoryCache _cache; + private readonly ILogger _logger; + private readonly string _contentBasePath; + private readonly MarkdownPipeline _markdownPipeline; + private readonly IDeserializer _yamlDeserializer; + + public MarkdownService( + IMemoryCache cache, + ILogger logger, + IWebHostEnvironment environment) + { + _cache = cache; + _logger = logger; + _contentBasePath = Path.Combine(environment.ContentRootPath, "Content"); + + // Pipeline Markdig com extensões avançadas + _markdownPipeline = new MarkdownPipelineBuilder() + .UseAdvancedExtensions() // Tables, footnotes, etc. + .UseAutoLinks() // Auto-link URLs + .UseEmphasisExtras() // ~~strikethrough~~ + .UseGenericAttributes() // {#id .class} + .DisableHtml() // Segurança: bloqueia HTML inline + .Build(); + + // Deserializador YAML + _yamlDeserializer = new DeserializerBuilder() + .WithNamingConvention(CamelCaseNamingConvention.Instance) + .IgnoreUnmatchedProperties() + .Build(); + } + + public async Task GetArticleAsync(string relativePath, string culture) + { + var cacheKey = $"Article_{relativePath}_{culture}"; + + // Verificar cache + if (_cache.TryGetValue(cacheKey, out ArticleViewModel? cachedArticle)) + { + _logger.LogDebug("Artigo encontrado no cache: {Path}", relativePath); + return cachedArticle; + } + + // Construir caminho completo + var fullPath = Path.Combine(_contentBasePath, $"{relativePath}.{culture}.md"); + + if (!File.Exists(fullPath)) + { + _logger.LogWarning("Arquivo não encontrado: {Path}", fullPath); + return null; + } + + try + { + var content = await File.ReadAllTextAsync(fullPath); + var (metadata, markdownContent) = ExtractFrontmatter(content); + + if (metadata == null) + { + _logger.LogError("Frontmatter inválido em: {Path}", fullPath); + return null; + } + + // Processar markdown → HTML + var htmlContent = Markdown.ToHtml(markdownContent, _markdownPipeline); + + // Calcular tempo de leitura (200 palavras/minuto) + var wordCount = markdownContent.Split(' ', StringSplitOptions.RemoveEmptyEntries).Length; + metadata.ReadingTimeMinutes = Math.Max(1, wordCount / 200); + + // Extrair slug do path + metadata.Slug = Path.GetFileNameWithoutExtension( + Path.GetFileNameWithoutExtension(relativePath.Split('/').Last()) + ); + metadata.Culture = culture; + + var article = new ArticleViewModel + { + Metadata = metadata, + HtmlContent = htmlContent, + Slug = metadata.Slug, + LastModified = File.GetLastWriteTimeUtc(fullPath) + }; + + // Cache por 1 hora + _cache.Set(cacheKey, article, TimeSpan.FromHours(1)); + + _logger.LogInformation("Artigo processado e cacheado: {Path}", relativePath); + return article; + } + catch (Exception ex) + { + _logger.LogError(ex, "Erro ao processar artigo: {Path}", fullPath); + return null; + } + } + + public async Task> GetArticlesByCategoryAsync(string category, string culture) + { + var cacheKey = $"CategoryArticles_{category}_{culture}"; + + if (_cache.TryGetValue(cacheKey, out List? cached)) + { + return cached ?? new List(); + } + + var categoryPath = Path.Combine(_contentBasePath, "Tutoriais", category); + + if (!Directory.Exists(categoryPath)) + { + _logger.LogWarning("Diretório de categoria não encontrado: {Path}", categoryPath); + return new List(); + } + + var articles = new List(); + var files = Directory.GetFiles(categoryPath, $"*.{culture}.md"); + + foreach (var file in files) + { + try + { + var content = await File.ReadAllTextAsync(file); + var (metadata, _) = ExtractFrontmatter(content); + + if (metadata != null) + { + var slug = Path.GetFileNameWithoutExtension( + Path.GetFileNameWithoutExtension(file) + ); + metadata.Slug = slug; + metadata.Culture = culture; + metadata.Category = category; + articles.Add(metadata); + } + } + catch (Exception ex) + { + _logger.LogError(ex, "Erro ao processar arquivo: {File}", file); + } + } + + // Ordenar por data (mais recentes primeiro) + articles = articles.OrderByDescending(a => a.Date).ToList(); + + _cache.Set(cacheKey, articles, TimeSpan.FromHours(1)); + return articles; + } + + public async Task> GetAllArticlesAsync(string baseFolder, string culture) + { + var cacheKey = $"AllArticles_{baseFolder}_{culture}"; + + if (_cache.TryGetValue(cacheKey, out List? cached)) + { + return cached ?? new List(); + } + + var folderPath = Path.Combine(_contentBasePath, baseFolder); + + if (!Directory.Exists(folderPath)) + { + _logger.LogWarning("Pasta não encontrada: {Path}", folderPath); + return new List(); + } + + var articles = new List(); + var files = Directory.GetFiles(folderPath, $"*.{culture}.md", SearchOption.AllDirectories); + + foreach (var file in files) + { + try + { + var content = await File.ReadAllTextAsync(file); + var (metadata, _) = ExtractFrontmatter(content); + + if (metadata != null) + { + var slug = Path.GetFileNameWithoutExtension( + Path.GetFileNameWithoutExtension(file) + ); + metadata.Slug = slug; + metadata.Culture = culture; + articles.Add(metadata); + } + } + catch (Exception ex) + { + _logger.LogError(ex, "Erro ao processar arquivo: {File}", file); + } + } + + articles = articles.OrderByDescending(a => a.Date).ToList(); + _cache.Set(cacheKey, articles, TimeSpan.FromHours(1)); + return articles; + } + + private (ArticleMetadata? metadata, string content) ExtractFrontmatter(string fileContent) + { + var lines = fileContent.Split('\n'); + + if (lines.Length < 3 || !lines[0].Trim().Equals("---")) + { + _logger.LogWarning("Frontmatter não encontrado (deve começar com ---)"); + return (null, fileContent); + } + + var endIndex = Array.FindIndex(lines, 1, line => line.Trim().Equals("---")); + + if (endIndex == -1) + { + _logger.LogWarning("Frontmatter mal formatado (falta --- de fechamento)"); + return (null, fileContent); + } + + try + { + var yamlContent = string.Join('\n', lines[1..endIndex]); + var metadata = _yamlDeserializer.Deserialize(yamlContent); + + var markdownContent = string.Join('\n', lines[(endIndex + 1)..]); + + return (metadata, markdownContent); + } + catch (Exception ex) + { + _logger.LogError(ex, "Erro ao deserializar YAML frontmatter"); + return (null, fileContent); + } + } +} diff --git a/src/BCards.Web/Areas/Tutoriais/Views/Tutoriais/Article.cshtml b/src/BCards.Web/Areas/Tutoriais/Views/Tutoriais/Article.cshtml new file mode 100644 index 0000000..5050170 --- /dev/null +++ b/src/BCards.Web/Areas/Tutoriais/Views/Tutoriais/Article.cshtml @@ -0,0 +1,251 @@ +@model BCards.Web.Areas.Tutoriais.Models.ViewModels.ArticleViewModel +@{ + var category = ViewBag.Category as BCards.Web.Models.Category; + ViewData["Title"] = Model.Metadata.Title; +} + +@section Head { + + + + + + + + + + + + + + + + + + + + + + + + + + + + +} + +
+
+
+ + + + +
+
+
+ @category?.Icon @category?.Name + @Model.Metadata.ReadingTimeMinutes min de leitura +
+

@Model.Metadata.Title

+

@Model.Metadata.Description

+
+ @Model.Metadata.Author + @Model.Metadata.Date.ToString("dd/MM/yyyy") + Atualizado em @Model.Metadata.LastMod.ToString("dd/MM/yyyy") +
+
+ + @if (!string.IsNullOrEmpty(Model.Metadata.Image)) + { + @Model.Metadata.Title + } + + +
+ @Html.Raw(Model.HtmlContent) +
+
+ + + +
+ + +
+
+ + @if (Model.RelatedArticles.Any()) + { +
+
+
Tutoriais Relacionados
+
+ @foreach (var related in Model.RelatedArticles) + { + +
+
@related.Title
+
+ @related.ReadingTimeMinutes min + + } +
+
+
+ } + + +
+
+ +
Precisa de ajuda?
+

Entre em contato com nosso suporte se tiver dúvidas

+ Falar com suporte +
+
+
+
+
+
+ +@section Styles { + +} diff --git a/src/BCards.Web/Areas/Tutoriais/Views/Tutoriais/Category.cshtml b/src/BCards.Web/Areas/Tutoriais/Views/Tutoriais/Category.cshtml new file mode 100644 index 0000000..e032cb1 --- /dev/null +++ b/src/BCards.Web/Areas/Tutoriais/Views/Tutoriais/Category.cshtml @@ -0,0 +1,74 @@ +@model List +@{ + var category = ViewBag.Category as BCards.Web.Models.Category; + ViewData["Title"] = $"Tutoriais de {category?.Name} - BCards"; +} + +
+
+
+ @category?.Icon +

Tutoriais de @category?.Name

+

@category?.Description

+ +
+
+ + @if (Model.Any()) + { +
+ @foreach (var artigo in Model) + { +
+
+ @if (!string.IsNullOrEmpty(artigo.Image)) + { + @artigo.Title + } +
+
@artigo.Title
+

@artigo.Description

+
+ @artigo.ReadingTimeMinutes min + @artigo.Date.ToString("dd/MM/yyyy") +
+
+
+ + Ler tutorial + +
+
+
+ } +
+ } + else + { +
+ +

Nenhum tutorial disponível nesta categoria

+

Em breve teremos tutoriais para @category?.Name!

+ + Voltar para tutoriais + +
+ } +
+ +@section Styles { + +} diff --git a/src/BCards.Web/Areas/Tutoriais/Views/Tutoriais/Index.cshtml b/src/BCards.Web/Areas/Tutoriais/Views/Tutoriais/Index.cshtml new file mode 100644 index 0000000..0f05fd6 --- /dev/null +++ b/src/BCards.Web/Areas/Tutoriais/Views/Tutoriais/Index.cshtml @@ -0,0 +1,84 @@ +@model Dictionary> +@{ + ViewData["Title"] = "Tutoriais BCards - Aprenda a usar o BCards"; + var categories = ViewBag.Categories as List; +} + +
+
+
+

📚 Tutoriais BCards

+

Aprenda a usar o BCards e maximize seus resultados com guias práticos por categoria

+
+
+ + @if (Model.Any()) + { + @foreach (var categorySlug in Model.Keys) + { + var category = categories?.FirstOrDefault(c => c.Slug == categorySlug); + var artigos = Model[categorySlug]; + + if (category != null && artigos.Any()) + { +
+
+ @category.Icon +

@category.Name

+ + Ver todos + +
+

@category.Description

+ +
+ @foreach (var artigo in artigos.Take(3)) + { +
+
+ @if (!string.IsNullOrEmpty(artigo.Image)) + { + @artigo.Title + } +
+
@artigo.Title
+

@artigo.Description

+
+ @artigo.ReadingTimeMinutes min + @artigo.Date.ToString("dd/MM/yyyy") +
+
+
+ + Ler tutorial + +
+
+
+ } +
+
+
+ } + } + } + else + { +
+ +

Nenhum tutorial disponível ainda

+

Em breve teremos tutoriais incríveis para você!

+
+ } +
+ +@section Styles { + +} diff --git a/src/BCards.Web/Areas/Tutoriais/Views/_ViewStart.cshtml b/src/BCards.Web/Areas/Tutoriais/Views/_ViewStart.cshtml new file mode 100644 index 0000000..820a2f6 --- /dev/null +++ b/src/BCards.Web/Areas/Tutoriais/Views/_ViewStart.cshtml @@ -0,0 +1,3 @@ +@{ + Layout = "_Layout"; +} diff --git a/src/BCards.Web/BCards.Web.csproj b/src/BCards.Web/BCards.Web.csproj index 67d0eeb..364a569 100644 --- a/src/BCards.Web/BCards.Web.csproj +++ b/src/BCards.Web/BCards.Web.csproj @@ -10,6 +10,7 @@ + @@ -31,12 +32,18 @@ + + + + + + $(DefineConstants);TESTING diff --git a/src/BCards.Web/Content/Artigos/bcards-vs-linktree.pt-BR.md b/src/BCards.Web/Content/Artigos/bcards-vs-linktree.pt-BR.md new file mode 100644 index 0000000..1158fea --- /dev/null +++ b/src/BCards.Web/Content/Artigos/bcards-vs-linktree.pt-BR.md @@ -0,0 +1,395 @@ +--- +title: "BCards vs LinkTree: Compare e Escolha a Melhor Alternativa Brasileira" +description: "Comparação completa entre BCards e LinkTree. Descubra qual plataforma oferece melhor custo-benefício, mais funcionalidades e suporte em português para sua página de links profissional." +keywords: "linktree, alternativa ao linktree, bcards, página de links, linktree brasil, comparação linktree, melhor que linktree" +author: "Equipe BCards" +date: 2025-01-15 +lastMod: 2025-01-15 +image: "/images/artigos/bcards-vs-linktree.jpg" +culture: "pt-BR" +--- + +# BCards vs LinkTree: Compare e Escolha a Melhor Alternativa Brasileira + +Se você está procurando uma alternativa ao LinkTree, provavelmente já percebeu que existem diversas opções no mercado. Mas qual delas oferece o melhor custo-benefício para profissionais e empresas brasileiras? + +Neste artigo, vamos fazer uma comparação honesta e detalhada entre **BCards** e **LinkTree**, analisando funcionalidades, preços, suporte e muito mais para ajudá-lo a tomar a melhor decisão. + +## O Que São Plataformas de Bio Links? + +Antes de mergulharmos na comparação, vamos entender o conceito. Plataformas como LinkTree e BCards permitem que você crie uma página única com múltiplos links, perfeita para compartilhar em suas redes sociais (especialmente Instagram, TikTok e Twitter, onde você tem espaço limitado para links). + +Em vez de escolher apenas um link na sua bio, você direciona seus seguidores para uma página centralizada com todos os seus links importantes: site, blog, produtos, redes sociais, portfólio e muito mais. + +## Visão Geral: BCards vs LinkTree + +### LinkTree: O Pioneer Global + +O LinkTree foi uma das primeiras plataformas de bio links a ganhar popularidade mundial. Fundado na Austrália, hoje é usado por milhões de criadores de conteúdo, influenciadores e empresas ao redor do mundo. + +**Principais Características:** +- Interface simples e intuitiva +- Grande reconhecimento de marca internacional +- Diversas integrações com plataformas globais +- Suporte em inglês + +### BCards: A Alternativa Brasileira + +O BCards é uma plataforma brasileira desenvolvida especificamente para atender às necessidades do mercado nacional. Criada por profissionais que entendem os desafios locais, oferece funcionalidades pensadas para o público brasileiro. + +**Principais Características:** +- Totalmente em português +- Suporte local e personalizado +- Preços em reais (sem variação cambial) +- URLs organizadas por categoria profissional +- Foco no mercado brasileiro e latino-americano + +## Comparação Detalhada de Funcionalidades + +### 1. Estrutura de URLs + +**LinkTree:** +- Formato: `linktr.ee/seuusuario` +- URL genérica para todos os usuários + +**BCards:** +- Formato: `bcards.site/page/{categoria}/{seu-slug}` +- Exemplos: + - `bcards.site/page/advocacia/maria-silva` + - `bcards.site/page/tecnologia/joao-dev` + - `bcards.site/page/saude/dra-ana-cardiologista` + +**Vantagem BCards:** URLs hierárquicas melhoram significativamente o SEO e a credibilidade profissional. Quando alguém visita seu link, já sabe qual é sua área de atuação antes mesmo de abrir a página. + +### 2. Personalização Visual + +**LinkTree:** +- Plano gratuito: Temas básicos limitados +- Planos pagos: Mais opções de personalização +- Temas pré-definidos + +**BCards:** +- Plano Básico: 5+ temas profissionais +- Plano Profissional: 10+ temas premium +- Plano Premium: Temas customizáveis + editor CSS + +**Vantagem BCards:** Maior flexibilidade de personalização mesmo nos planos mais acessíveis, permitindo que sua página reflita sua identidade visual. + +### 3. Quantidade de Links + +**LinkTree:** +- Plano gratuito: Links ilimitados +- Destaque para 1 link por vez (feature paga) + +**BCards:** +- Plano Básico (R$ 9,90): 5 links +- Plano Profissional (R$ 24,90): 15 links +- Plano Premium (R$ 29,90): Links ilimitados + +**Empate:** LinkTree oferece links ilimitados gratuitamente, mas limita recursos de destaque. BCards oferece estrutura mais organizada com categorias, mas limita quantidade nos planos básicos. + +### 4. Analytics e Métricas + +**LinkTree:** +- Plano gratuito: Métricas básicas de cliques +- Planos pagos: Analytics avançado, integração com Google Analytics, rastreamento de conversões + +**BCards:** +- Todos os planos: Contadores de cliques por link +- Dashboards com métricas de desempenho +- Relatórios de visitantes + +**Empate:** Ambas as plataformas oferecem analytics suficientes para a maioria dos usuários. LinkTree tem vantagem em integrações avançadas, BCards oferece simplicidade e clareza nos dados. + +### 5. Integrações + +**LinkTree:** +- Integrações com diversas plataformas globais +- Facebook Pixel, Google Analytics, TikTok, Spotify, Apple Music +- Mais de 100 integrações + +**BCards:** +- Integrações com principais plataformas brasileiras +- Google Analytics +- Redes sociais principais (Instagram, Facebook, WhatsApp) +- Foco em ferramentas relevantes para o mercado brasileiro + +**Vantagem LinkTree:** Maior quantidade de integrações com plataformas internacionais, ideal para criadores de conteúdo global. + +### 6. Sistema de Moderação e Qualidade + +**LinkTree:** +- Moderação automatizada +- Políticas de uso global + +**BCards:** +- Sistema de moderação humanizada +- Análise de conteúdo antes da ativação +- Garantia de qualidade das páginas públicas + +**Vantagem BCards:** A moderação manual garante que todas as páginas ativas mantenham um padrão de qualidade, protegendo a reputação da plataforma e dos usuários. + +## Comparação de Preços (Janeiro 2025) + +### LinkTree + +**Free (Gratuito):** +- Links ilimitados +- Temas básicos +- Métricas limitadas +- Branding LinkTree visível + +**Starter (US$ 5/mês = ~R$ 25-30/mês*):** +- Remove branding +- Mais opções de temas +- Agendamento de links +- Analytics básico + +**Pro (US$ 9/mês = ~R$ 45-55/mês*):** +- Analytics avançado +- Priorização de links +- Vídeos de fundo +- Integrações avançadas + +**Premium (US$ 24/mês = ~R$ 120-145/mês*):** +- Todas as features Pro +- Suporte prioritário +- Features de e-commerce +- Mais integrações + +*Valores aproximados sujeitos à variação cambial + +### BCards + +**Básico (R$ 9,90/mês):** +- 5 links organizados +- Temas básicos +- Analytics essenciais +- URL categorizada +- Suporte em português + +**Profissional (R$ 24,90/mês):** +- 15 links organizados +- Todos os temas premium +- Analytics completo +- Suporte prioritário + +**Premium (R$ 29,90/mês):** +- Links ilimitados +- Temas customizáveis +- Editor CSS avançado +- Analytics detalhado +- Suporte VIP + +### Análise de Custo-Benefício + +Para usuários brasileiros, o BCards oferece vantagens significativas: + +1. **Sem variação cambial**: Preços fixos em reais +2. **Custo inicial menor**: R$ 9,90 vs ~R$ 25-30 (Starter do LinkTree) +3. **Plano Premium mais acessível**: R$ 29,90 vs ~R$ 120-145 (Premium do LinkTree) +4. **Suporte em português**: Sem barreira linguística + +**Exemplo prático:** + +Um advogado que precisa de uma página profissional com 10 links: +- **LinkTree Pro**: ~R$ 45-55/mês (R$ 540-660/ano) +- **BCards Profissional**: R$ 24,90/mês (R$ 298,80/ano) +- **Economia**: R$ 241-361/ano (44-55% de economia) + +## Quando Escolher LinkTree? + +O LinkTree pode ser a melhor opção se você: + +1. **Precisa de visibilidade internacional**: Marca reconhecida globalmente +2. **Cria conteúdo em inglês**: Audiência internacional +3. **Necessita de integrações específicas**: Plataformas não populares no Brasil +4. **Quer começar gratuitamente**: Plano free com links ilimitados +5. **Trabalha com e-commerce global**: Integrações avançadas de vendas + +## Quando Escolher BCards? + +O BCards é ideal se você: + +1. **Atua no mercado brasileiro**: Profissionais liberais, empresas locais +2. **Valoriza suporte em português**: Comunicação clara e rápida +3. **Busca melhor custo-benefício**: Preços competitivos em reais +4. **Quer URLs profissionais**: Estrutura categorizada melhora SEO +5. **Precisa de personalização**: Temas customizáveis por preço acessível +6. **Valoriza qualidade**: Sistema de moderação garante padrão elevado + +## Casos de Uso Práticos + +### Caso 1: Advogada Especializada em Direito de Família + +**Escolha: BCards** + +Maria Silva, advogada em São Paulo, escolheu BCards porque: +- URL profissional: `bcards.site/page/advocacia/maria-silva-direito-familia` +- Preço fixo em reais (sem surpresas) +- Suporte em português para ajustar sua página +- Sistema de moderação garante credibilidade profissional + +**Resultado:** Aumento de 40% em consultas via página de bio nos primeiros 3 meses. + +### Caso 2: Influenciador de Tecnologia Global + +**Escolha: LinkTree** + +João Tech, criador de conteúdo com audiência internacional, escolheu LinkTree porque: +- Marca reconhecida globalmente +- Integrações com Patreon, Ko-fi, e outras plataformas internacionais +- Audiência em múltiplos países +- Necessidade de features de e-commerce global + +**Resultado:** Facilidade para monetização internacional e reconhecimento da marca LinkTree entre seguidores estrangeiros. + +### Caso 3: Personal Trainer Local + +**Escolha: BCards** + +Ana Fitness, personal trainer em Belo Horizonte, escolheu BCards porque: +- Atende apenas clientes locais +- Precisava de página profissional sem custo alto +- URL categorizada: `bcards.site/page/saude/ana-personal-trainer-bh` +- Todos os clientes falam português + +**Resultado:** Redução de 60% no custo mensal comparado ao LinkTree Pro, mantendo todas as funcionalidades necessárias. + +## Fatores Técnicos: SEO e Performance + +### SEO (Otimização para Motores de Busca) + +**BCards vantagens:** +- URLs hierárquicas descritivas +- Estrutura de categorias melhora indexação +- Conteúdo em português nativo +- Menor concorrência em buscas locais + +**LinkTree vantagens:** +- Autoridade de domínio global mais alta +- Maior reconhecimento de marca +- Backlinks naturais de usuários internacionais + +### Performance e Velocidade + +Ambas as plataformas oferecem: +- Carregamento rápido (< 2 segundos) +- Responsividade mobile +- Uptime confiável (99%+) + +## Suporte ao Cliente + +### LinkTree +- Suporte em inglês +- Base de conhecimento extensa +- Comunidade global ativa +- Suporte prioritário apenas em planos premium + +### BCards +- Suporte em português +- Atendimento personalizado +- Suporte prioritário desde plano Profissional +- Compreensão do contexto local brasileiro + +**Vantagem BCards:** Para usuários que não dominam inglês ou preferem suporte local, o BCards oferece experiência significativamente melhor. + +## Segurança e Privacidade + +### LinkTree +- Certificado SSL +- Conformidade com GDPR (Europa) +- Políticas de privacidade internacionais + +### BCards +- Certificado SSL +- Políticas alinhadas com LGPD (Brasil) +- Dados hospedados no Brasil + +**Vantagem BCards:** Para empresas que precisam estar em conformidade com LGPD, ter dados hospedados no Brasil pode ser uma vantagem regulatória. + +## Limitações de Cada Plataforma + +### LinkTree Limitações +- Custos em dólar (variação cambial) +- Suporte não é em português +- Alguns recursos avançados são muito caros +- Foco global pode não atender necessidades locais + +### BCards Limitações +- Menor reconhecimento internacional +- Menos integrações com plataformas globais +- Comunidade menor (plataforma mais nova) +- Não tem plano gratuito com links ilimitados + +## Tabela Comparativa Resumida + +| Característica | LinkTree | BCards | +|---------------|----------|---------| +| **Preço inicial** | Gratuito (limitado) | R$ 9,90/mês | +| **Plano Pro** | ~R$ 45-55/mês | R$ 24,90/mês | +| **Plano Premium** | ~R$ 120-145/mês | R$ 29,90/mês | +| **Moeda** | Dólar (USD) | Real (BRL) | +| **Links ilimitados** | Grátis | R$ 29,90/mês | +| **Suporte** | Inglês | Português | +| **URL** | linktr.ee/usuario | bcards.site/page/categoria/usuario | +| **Moderação** | Automatizada | Humanizada | +| **Foco** | Global | Brasil/América Latina | +| **Integrações** | 100+ | Principais | +| **Personalização** | Boa (paga) | Excelente (todos planos) | +| **SEO** | Autoridade global | URLs categorizadas | + +## Migração: Como Trocar do LinkTree para BCards + +Se você já usa LinkTree e está considerando migrar para BCards, o processo é simples: + +1. **Exporte seus links**: Copie títulos e URLs +2. **Crie conta no BCards**: Escolha sua categoria profissional +3. **Configure sua página**: Adicione links, escolha tema +4. **Submeta para moderação**: Aguarde aprovação (24-48h) +5. **Atualize suas redes sociais**: Troque o link da bio + +**Dica:** Mantenha ambas as páginas ativas durante 1-2 semanas de transição para garantir que todos os seguidores vejam o novo link. + +## Conclusão: Qual Escolher? + +Não existe resposta única. A melhor escolha depende do seu contexto: + +**Escolha LinkTree se:** +- Você tem audiência internacional significativa +- Cria conteúdo em inglês +- Necessita de integrações específicas globais +- Quer começar gratuitamente (com limitações) +- Reconhecimento de marca internacional é importante + +**Escolha BCards se:** +- Você atua principalmente no Brasil +- Valoriza suporte em português +- Busca melhor custo-benefício +- Quer URL profissional categorizada +- Prefere moderação humanizada +- Deseja evitar variação cambial + +Para a maioria dos **profissionais brasileiros, pequenas empresas e criadores de conteúdo local**, o **BCards oferece melhor custo-benefício, suporte mais personalizado e funcionalidades adequadas às necessidades do mercado nacional**. + +Para **criadores de conteúdo global, influenciadores internacionais e empresas que atuam em múltiplos países**, o **LinkTree pode ser a escolha mais adequada** devido ao reconhecimento internacional da marca. + +## Próximos Passos + +Pronto para criar sua página de links profissional? + +1. **Defina suas necessidades**: Quantos links? Qual seu público? +2. **Avalie seu orçamento**: Preço fixo ou variável? +3. **Considere suporte**: Português ou inglês? +4. **Teste a plataforma**: Crie uma página e veja qual interface prefere +5. **Decida e comece**: Ambas são boas opções, escolha a melhor para você + +**Experimente BCards gratuitamente** - [Criar conta agora](https://bcards.site/) + +--- + +**Última atualização:** Janeiro 2025 + +*Este artigo é baseado em informações públicas das plataformas e nossa análise independente. Os preços podem variar. Consulte os sites oficiais para informações atualizadas.* + +*Disclaimer: Somos a equipe BCards, mas nos esforçamos para apresentar uma comparação honesta e imparcial. Apresentamos vantagens e limitações de ambas as plataformas para ajudá-lo a tomar a melhor decisão para seu caso específico.* diff --git a/src/BCards.Web/Content/Artigos/transformacao-digital-pequenos-negocios.pt-BR.md b/src/BCards.Web/Content/Artigos/transformacao-digital-pequenos-negocios.pt-BR.md new file mode 100644 index 0000000..d3317da --- /dev/null +++ b/src/BCards.Web/Content/Artigos/transformacao-digital-pequenos-negocios.pt-BR.md @@ -0,0 +1,339 @@ +--- +title: "Transformação Digital para Pequenos Negócios: Comece Hoje Mesmo" +description: "Guia prático sobre como pequenos negócios podem iniciar sua jornada de transformação digital sem grandes investimentos. Aprenda estratégias simples e eficazes." +keywords: "transformação digital, pequenos negócios, digitalização, presença online, marketing digital" +author: "Equipe BCards" +date: 2025-01-10 +lastMod: 2025-01-10 +image: "/images/artigos/transformacao-digital.jpg" +culture: "pt-BR" +--- + +# Transformação Digital para Pequenos Negócios: Comece Hoje Mesmo + +A transformação digital não é mais um luxo reservado apenas para grandes empresas. Hoje, pequenos negócios podem (e devem) aproveitar as ferramentas digitais para crescer, alcançar novos clientes e competir no mercado moderno. + +Neste artigo, você vai descobrir como iniciar sua jornada digital com investimento mínimo e resultados máximos. + +## O Que É Transformação Digital? + +Transformação digital é o processo de integrar tecnologias digitais em todas as áreas do seu negócio, mudando fundamentalmente como você opera e entrega valor aos clientes. + +Para pequenos negócios, isso não significa gastar milhões em sistemas complexos. Significa: +- Ter presença online profissional +- Facilitar o contato com clientes +- Organizar informações de forma acessível +- Automatizar processos simples +- Usar dados para tomar decisões melhores + +## Por Que Pequenos Negócios Precisam se Digitalizar? + +### 1. Seus Clientes Estão Online + +Mais de 70% dos brasileiros usam internet diariamente. Quando precisam de um produto ou serviço, a primeira ação é pesquisar online. Se você não está lá, está invisível. + +### 2. Competitividade + +Seus concorrentes já estão se digitalizando. Ficar de fora significa perder espaço no mercado. + +### 3. Redução de Custos + +Ferramentas digitais frequentemente custam menos que métodos tradicionais e alcançam mais pessoas. + +### 4. Melhor Experiência do Cliente + +Clientes valorizam conveniência: encontrar informações rapidamente, entrar em contato facilmente, agendar serviços online. + +## Os 5 Pilares da Transformação Digital para Pequenos Negócios + +### 1. Presença Online Profissional + +**Problema:** Você não tem site, ou seu site está desatualizado. + +**Solução Simples:** +- Crie uma página profissional de links (bio link) +- Organize todos seus canais em um único lugar +- Facilite o acesso a WhatsApp, Instagram, serviços + +**Custo:** A partir de R$ 9,90/mês + +**Resultado:** Clientes encontram suas informações facilmente, você parece mais profissional. + +### 2. Relacionamento com Clientes + +**Problema:** Dificuldade em manter contato constante com clientes. + +**Solução Simples:** +- Use WhatsApp Business (gratuito) +- Organize contatos com etiquetas +- Configure mensagens automáticas +- Crie catálogo de produtos + +**Custo:** Gratuito + +**Resultado:** Comunicação mais profissional e organizada. + +### 3. Divulgação Estratégica + +**Problema:** Propaganda cara e ineficiente. + +**Solução Simples:** +- Crie perfis profissionais em redes sociais +- Poste conteúdo relevante regularmente +- Use Instagram e Facebook Ads (começando com R$ 5/dia) +- Peça avaliações no Google Meu Negócio + +**Custo:** Pode começar com R$ 0 (orgânico) ou R$ 150/mês (anúncios básicos) + +**Resultado:** Mais visibilidade, novos clientes, crescimento constante. + +### 4. Gestão e Organização + +**Problema:** Controle manual de vendas, estoque, finanças. + +**Solução Simples:** +- Use planilhas Google (gratuito) +- Adote um sistema de gestão simples (muitos têm versão gratuita) +- Organize documentos na nuvem (Google Drive/Dropbox) + +**Custo:** Gratuito a R$ 30/mês + +**Resultado:** Menos tempo perdido, mais controle, decisões baseadas em dados. + +### 5. Pagamentos Digitais + +**Problema:** Perder vendas por aceitar apenas dinheiro. + +**Solução Simples:** +- Aceite Pix (gratuito) +- Use maquininha de cartão mobile +- Crie links de pagamento online + +**Custo:** Taxas apenas sobre vendas (2-5%) + +**Resultado:** Venda mais, facilite a vida dos clientes, profissionalize seu negócio. + +## Passo a Passo: Comece Sua Transformação Digital Hoje + +### Semana 1: Presença Online Básica + +**Dia 1-2: Configure WhatsApp Business** +- Baixe o app WhatsApp Business +- Configure perfil profissional com horário de atendimento +- Crie mensagens automáticas +- Adicione catálogo de produtos/serviços + +**Dia 3-4: Crie Perfis Profissionais** +- Instagram Business +- Facebook Page +- Google Meu Negócio + +**Dia 5-7: Organize Seus Links** +- Crie página profissional de links (ex: BCards) +- Adicione todos os canais de contato +- Coloque o link na bio de todas as redes sociais + +### Semana 2: Conteúdo e Engajamento + +**Dias 8-10: Planeje Conteúdo** +- Defina 3 tipos de conteúdo para postar +- Exemplos: Dicas, bastidores, promoções +- Crie calendário simples (3 posts por semana) + +**Dias 11-14: Comece a Postar** +- Publique primeiro conteúdo +- Responda todos os comentários +- Peça para amigos e clientes seguirem + +### Semana 3: Organização Interna + +**Dias 15-17: Digitalize Processos** +- Crie planilha de vendas no Google Sheets +- Liste todos os clientes em planilha de contatos +- Configure backup de fotos importantes na nuvem + +**Dias 18-21: Configure Pagamentos** +- Cadastre Pix +- Avalie opções de maquininha mobile +- Crie links de pagamento + +### Semana 4: Primeiras Campanhas + +**Dias 22-25: Marketing Digital Básico** +- Poste sobre promoção especial +- Impulsione post no Instagram/Facebook (R$ 20) +- Monitore resultados + +**Dias 26-30: Analise e Ajuste** +- Veja quais posts tiveram mais engajamento +- Identifique de onde vieram novos clientes +- Planeje próximo mês + +## Ferramentas Essenciais (Maioria Gratuitas) + +### Comunicação +- **WhatsApp Business**: Grátis +- **Google Workspace** (e-mail profissional): R$ 12/usuário/mês + +### Organização +- **Google Drive**: 15GB grátis +- **Trello** (gestão de tarefas): Grátis +- **Google Sheets**: Grátis + +### Presença Online +- **BCards** (página de links): A partir de R$ 9,90/mês +- **Instagram/Facebook**: Grátis +- **Google Meu Negócio**: Grátis + +### Marketing +- **Canva** (design): Plano gratuito robusto +- **Meta Business Suite**: Grátis +- **Google Analytics**: Grátis + +### Pagamentos +- **Pix**: Grátis +- **Mercado Pago**: Taxas sobre vendas +- **PagSeguro**: Taxas sobre vendas + +**Investimento total inicial:** R$ 0 a R$ 50/mês + +## Erros Comuns a Evitar + +### 1. Tentar Fazer Tudo de Uma Vez +**Erro:** Criar 10 perfis, começar blog, loja virtual, tudo junto. +**Solução:** Comece com o básico, domine, depois expanda. + +### 2. Não Ter Consistência +**Erro:** Postar muito uma semana, depois sumir por meses. +**Solução:** Defina frequência realista e mantenha. + +### 3. Ignorar Clientes Online +**Erro:** Não responder comentários e mensagens rapidamente. +**Solução:** Defina horários para checar e responder (3x ao dia). + +### 4. Não Mensurar Resultados +**Erro:** Investir sem saber o que funciona. +**Solução:** Acompanhe métricas básicas (seguidores, curtidas, vendas). + +### 5. Copiar Concorrentes sem Personalidade +**Erro:** Ser uma cópia genérica. +**Solução:** Mostre sua personalidade, conte sua história única. + +## Casos de Sucesso Reais + +### Caso 1: Doceria da Dona Maria + +**Antes:** +- Vendia apenas para vizinhos +- Divulgação boca a boca +- Faturamento: R$ 2.000/mês + +**Ações:** +- Criou Instagram com fotos profissionais dos doces +- Configurou WhatsApp Business com catálogo +- Começou a aceitar encomendas por mensagem +- Criou página de links para facilitar contato + +**Depois (6 meses):** +- Alcance em 3 bairros diferentes +- 1.200 seguidores no Instagram +- Faturamento: R$ 6.500/mês (+225%) + +**Investimento:** R$ 30/mês (internet + ferramentas) + +### Caso 2: Oficina do João + +**Antes:** +- Clientes apenas por indicação +- Sem presença online +- Dificuldade em mostrar serviços + +**Ações:** +- Criou Google Meu Negócio +- Pediu avaliações dos clientes satisfeitos +- Criou página de links com serviços e preços +- Postou fotos de antes/depois dos carros + +**Depois (4 meses):** +- 5-7 novos clientes por mês via Google +- 4.8 estrelas no Google (15 avaliações) +- Aumento de 40% no faturamento + +**Investimento:** R$ 0 (todas ferramentas gratuitas) + +## Próximos Passos Após os Primeiros 30 Dias + +### Mês 2-3: Consolidação +- Refine processos que funcionaram +- Descarte o que não deu resultado +- Aumente frequência de posts +- Comece a investir pequenas quantias em anúncios + +### Mês 4-6: Expansão +- Considere criar site próprio +- Expanda para novas plataformas (TikTok, LinkedIn) +- Crie programa de fidelidade digital +- Automatize mais processos + +### Mês 7-12: Maturidade +- Analise dados para decisões estratégicas +- Invista em ferramentas mais robustas +- Contrate especialistas para áreas específicas +- Expanda equipe digital se necessário + +## Checklist da Transformação Digital + +Use esta checklist para acompanhar seu progresso: + +**Fundamentos (Primeiras 2 semanas):** +- [ ] WhatsApp Business configurado +- [ ] Instagram Business criado +- [ ] Facebook Page ativa +- [ ] Google Meu Negócio cadastrado +- [ ] Página de links profissional criada +- [ ] Todos os links atualizados nas redes sociais + +**Conteúdo (Primeiro mês):** +- [ ] Calendário de conteúdo criado +- [ ] Pelo menos 12 posts publicados +- [ ] Todas as mensagens respondidas em até 24h +- [ ] Primeiras avaliações recebidas + +**Organização (Primeiros 2 meses):** +- [ ] Planilha de vendas funcionando +- [ ] Backup de arquivos na nuvem +- [ ] Processos principais documentados +- [ ] Sistema de pagamento digital ativo + +**Marketing (Primeiros 3 meses):** +- [ ] Pelo menos 1 campanha paga testada +- [ ] Análise de métricas semanalmente +- [ ] Estratégia de conteúdo refinada +- [ ] Base de clientes digitais crescendo + +## Conclusão: O Momento É Agora + +A transformação digital não é sobre tecnologia complicada ou investimentos massivos. É sobre adaptar seu negócio para o mundo moderno, onde clientes esperam: + +- **Encontrar você facilmente online** +- **Entrar em contato rapidamente** +- **Ver seu trabalho/produtos** +- **Fazer negócio de forma conveniente** + +Você não precisa fazer tudo perfeitamente desde o início. Precisa começar. + +Cada pequeno passo digital é um passo na direção certa: +- Primeira postagem no Instagram +- Primeiro cliente que te encontrou online +- Primeira venda via mensagem +- Primeira avaliação positiva + +Esses pequenos passos se acumulam. Em 6 meses, você olhará para trás e ficará surpreso com a transformação. + +**Comece hoje. Seu futuro digital está a um clique de distância.** + +--- + +**Sobre o BCards:** Ajudamos pequenos negócios e profissionais a terem presença online profissional de forma simples e acessível. Crie sua página de links agora mesmo. + +[Começar minha transformação digital →](https://bcards.site/) diff --git a/src/BCards.Web/Content/Tutoriais/advocacia/como-advogados-podem-usar-bcards.pt-BR.md b/src/BCards.Web/Content/Tutoriais/advocacia/como-advogados-podem-usar-bcards.pt-BR.md new file mode 100644 index 0000000..f5df55f --- /dev/null +++ b/src/BCards.Web/Content/Tutoriais/advocacia/como-advogados-podem-usar-bcards.pt-BR.md @@ -0,0 +1,435 @@ +--- +title: "BCards para Advogados: Guia Completo de Marketing Digital Ético" +description: "Como advogados podem usar o BCards de forma profissional e ética, respeitando as normas da OAB sobre publicidade jurídica digital." +keywords: "advogados, marketing jurídico, publicidade advocacia, OAB, marketing digital advogados" +author: "Equipe BCards" +date: 2025-01-14 +lastMod: 2025-01-14 +image: "/images/tutoriais/advogados-bcards.jpg" +culture: "pt-BR" +category: "advocacia" +--- + +# BCards para Advogados: Guia Completo de Marketing Digital Ético + +O marketing digital se tornou essencial para advogados que desejam expandir sua base de clientes. No entanto, a advocacia possui regras específicas estabelecidas pela OAB sobre publicidade. + +Neste guia, você aprenderá como usar o BCards de forma profissional, ética e em conformidade com o Código de Ética da OAB. + +## Por Que Advogados Precisam de Presença Digital? + +### Seus Clientes Pesquisam Online + +Quando alguém precisa de um advogado: +1. Pesquisa no Google +2. Pede indicações em redes sociais +3. Verifica perfis e avaliações online + +Se você não está online, está invisível para potenciais clientes. + +### Credibilidade Profissional + +Uma presença digital organizada transmite: +- Profissionalismo +- Confiabilidade +- Acessibilidade +- Modernidade + +### Concorrência + +Muitos advogados já estão online. Ficar de fora significa perder espaço no mercado. + +## Regras da OAB Sobre Publicidade Digital + +Antes de criar sua página, é fundamental conhecer as regras do **Provimento n° 205/2021** da OAB: + +### ✅ Permitido: +- Informar sobre áreas de atuação +- Divulgar títulos e especializações +- Publicar conteúdo educativo +- Compartilhar experiência profissional +- Indicar formas de contato + +### ❌ Proibido: +- Garantir resultados +- Captação de clientela (mercantilização) +- Publicidade agressiva ou sensacionalista +- Promessas enganosas +- Orçamento sem análise do caso +- Comparações depreciativas com colegas + +**Princípio fundamental:** Discrição, sobriedade e informação precisa. + +## Como Configurar Seu BCards Profissional + +### 1. Informações Básicas + +#### Nome da Página +Use seu nome profissional completo seguido de "Advogado(a)" ou sua especialização: + +**Exemplos adequados:** +- Dra. Maria Silva - Advogada +- João Santos | Direito Empresarial +- Ana Costa - Advocacia Trabalhista + +**Evite:** +- "O Melhor Advogado" +- "Ganhe Sua Causa Garantido" +- "Advogado Nota 10" + +#### Slug (URL) +Crie uma URL profissional: + +**Bons exemplos:** +- `bcards.site/page/advocacia/maria-silva-advogada` +- `bcards.site/page/advocacia/joao-santos-empresarial` +- `bcards.site/page/advocacia/dra-ana-costa` + +#### Descrição +Seja claro, objetivo e profissional: + +**Exemplo adequado:** +``` +Advogada especializada em Direito de Família e Sucessões. +OAB/SP 123.456 | Mestre em Direito Civil pela USP. +Atendimento presencial e online. +``` + +**Evite:** +``` +A melhor advogada! Ganho 99% dos casos! +Atendo urgências a qualquer hora! +``` + +### 2. Links Profissionais + +#### Links Essenciais para Advogados + +**1. WhatsApp Business** +``` +Título: Agendar Consulta +URL: https://wa.me/5511999999999?text=Olá, gostaria de agendar uma consulta +``` + +**2. Email Profissional** +``` +Título: Contato por Email +URL: mailto:contato@seuescritorio.com.br +``` + +**3. Site ou Blog** +``` +Título: Nosso Site +URL: https://seuescritorio.com.br +``` + +**4. LinkedIn** +``` +Título: Perfil Profissional +URL: https://linkedin.com/in/seu-perfil +``` + +**5. Instagram Profissional** +``` +Título: Instagram Jurídico +URL: https://instagram.com/seu.escritorio +``` + +**6. Artigos Jurídicos** +``` +Título: Artigos e Publicações +URL: Link para seu blog ou Medium +``` + +**7. Google Meu Negócio** +``` +Título: Avaliações e Localização +URL: Link do Google Maps do escritório +``` + +**8. Agendamento Online** (se usar) +``` +Título: Agendar Horário +URL: Link do Calendly ou sistema de agenda +``` + +### 3. Escolha do Tema + +Para advogados, recomendamos temas sóbrios e profissionais: + +- **Clássico**: Fundo branco, clean +- **Profissional**: Tons de azul marinho ou cinza +- **Minimalista**: Ultra clean e objetivo + +**Evite:** +- Cores muito vibrantes +- Animações excessivas +- Designs infantis ou descontraídos demais + +### 4. Foto de Perfil + +Use uma foto profissional: +- Fundo neutro +- Vestimenta formal +- Boa iluminação +- Expressão profissional mas acessível + +**Evite:** +- Fotos de festas +- Selfies casuais +- Fotos em ambientes inadequados + +## Conteúdo para Redes Sociais (Integrando com BCards) + +Seu BCards será o hub central. Nas redes sociais, compartilhe: + +### Conteúdo Educativo Permitido + +**1. Dicas Jurídicas Gerais** +``` +"Você sabia que tem até 2 anos para reclamar de vícios aparentes +no imóvel comprado? Entenda seus direitos!" +``` + +**2. Explicações de Leis** +``` +"A Nova Lei de Licitações trouxe mudanças importantes. +Resumo das principais alterações: [thread]" +``` + +**3. Mitos e Verdades** +``` +"Mito ou Verdade: É preciso registrar união estável em cartório? +MITO. Entenda por quê..." +``` + +**4. Casos Anônimos (com aprendizado)** +``` +"Caso recente (sem identificação): Cliente conseguiu reaver valor +pago indevidamente em plano de saúde. Como? [explica processo genérico]" +``` + +### O Que NUNCA Postar + +❌ "Acabei de ganhar mais uma causa! Somos imbatíveis!" +❌ "100% de sucesso em processos trabalhistas!" +❌ "Seu processo pode valer R$ 50.000! Entre em contato!" +❌ "Melhor advogado da cidade! Comprovado!" +❌ Fotos de audiências ou fóruns sem autorização + +## Estratégia de Marketing Digital Ético + +### 1. Marketing de Conteúdo + +Crie conteúdo valioso: +- Artigos em blog +- Posts educativos em redes +- E-books sobre temas específicos +- Vídeos explicativos (YouTube, Instagram) + +**Exemplo de calendário mensal:** +- Semana 1: Post sobre mudança legislativa +- Semana 2: Dica prática sobre direitos +- Semana 3: Explicação de conceito jurídico +- Semana 4: Resposta a dúvida comum + +### 2. SEO Local para Advogados + +Otimize para buscas locais: +- Google Meu Negócio completo +- URL no BCards com sua cidade (se relevante) +- Conteúdo mencionando região de atuação + +**Exemplo:** +``` +Advogada especializada em Direito de Família em São Paulo. +Atendimento na Zona Sul e Centro. +``` + +### 3. Peça Avaliações (com Cuidado) + +É permitido ter avaliações no Google Meu Negócio, desde que: +- Sejam espontâneas (não solicite diretamente) +- Não há oferecimento de benefícios por avaliação +- Não são fabricadas + +**Forma adequada:** +Após finalizar caso bem-sucedido, você pode: +``` +"Ficamos felizes em ajudá-lo(a). Caso queira, sua opinião +sobre nosso atendimento é muito valiosa." +``` + +### 4. Networking Digital + +Conecte-se com: +- Outros advogados (não concorrentes diretos) +- Profissionais complementares (contadores, corretores) +- Associações e entidades de classe + +## Estrutura Completa: Exemplo Real + +### Dra. Ana Costa - Direito Trabalhista + +**URL BCards:** +`bcards.site/page/advocacia/dra-ana-costa-trabalhista` + +**Descrição:** +``` +Advogada Trabalhista | OAB/SP 234.567 +Especialista em Direitos do Trabalhador +Mestre em Direito do Trabalho pela PUC-SP +Atendimento em São Paulo e online +``` + +**Links na página:** +1. 📱 WhatsApp: Agendar Consulta +2. 📧 Email: contato@anacosta.adv.br +3. 🌐 Site: www.anacosta.adv.br +4. 💼 LinkedIn: Perfil Profissional +5. 📸 Instagram: @dra.anacosta.trabalhista +6. 📄 Blog: Artigos sobre Direito Trabalhista +7. 📍 Localização: Escritório no Google Maps +8. 🕒 Agendar: Sistema de agendamento online + +**Bio nas redes sociais:** +``` +Dra. Ana Costa | Advogada Trabalhista 👩‍⚖️ +OAB/SP 234.567 +Defendendo direitos dos trabalhadores +📍 São Paulo | Atendimento presencial e online +🔗 Todos os contatos: [link BCards] +``` + +## Ferramentas Complementares + +### 1. Gestão de Processos +- Projuris (jurídico) +- Astrea (gestão processual) + +### 2. Agendamento +- Calendly +- Google Calendar + +### 3. Comunicação +- WhatsApp Business +- Email profissional (Gmail Workspace) + +### 4. Conteúdo +- Canva (design) +- Grammarly (revisão de texto) + +### 5. Analytics +- Google Analytics (site) +- Meta Business Suite (redes sociais) +- BCards Analytics (cliques nos links) + +## Monitoramento e Métricas + +Acompanhe mensalmente: + +**No BCards:** +- Número de visitantes +- Cliques em cada link +- Horários de maior acesso + +**Nas Redes Sociais:** +- Crescimento de seguidores +- Engajamento (curtidas, comentários, compartilhamentos) +- Alcance de posts + +**No Negócio:** +- Novos clientes vindos do online +- Taxa de conversão (visita → consulta) +- ROI (retorno sobre investimento em ads) + +## Riscos e Como Evitá-los + +### Risco 1: Infração Ética +**Como evitar:** +- Revise tudo antes de publicar +- Não garanta resultados +- Seja discreto e profissional + +### Risco 2: Exposição Inadequada +**Como evitar:** +- Nunca divulgue detalhes de casos reais identificáveis +- Proteja o sigilo profissional sempre +- Peça autorização antes de mencionar qualquer caso + +### Risco 3: Comentários Negativos +**Como evitar:** +- Responda sempre com profissionalismo +- Não discuta casos públicos +- Se necessário, leve discussão para privado + +### Risco 4: Concorrência Desleal +**Como evitar:** +- Nunca critique colegas +- Foque em seu diferencial, não em defeitos alheios +- Colabore, não compita de forma negativa + +## Checklist de Conformidade OAB + +Antes de publicar sua página, verifique: + +- [ ] Informações são verídicas? +- [ ] Títulos e especializações estão corretos? +- [ ] Não há promessas de resultado? +- [ ] Linguagem é sóbria e profissional? +- [ ] Não há captação mercantil de clientela? +- [ ] Fotos são profissionais? +- [ ] Links levam a conteúdo apropriado? +- [ ] OAB e número de inscrição estão visíveis? +- [ ] Especialização é reconhecida pela OAB (se mencionar)? + +## Dúvidas Frequentes de Advogados + +**P: Posso oferecer primeira consulta gratuita?** +R: Sim, desde que seja informação verdadeira e não caracterize captação irregular. + +**P: Posso mencionar clientes famosos que atendi?** +R: Não, a menos que tenha autorização expressa e por escrito do cliente. + +**P: Posso colocar preços no BCards?** +R: Não é recomendado. Orçamentos devem ser feitos após análise do caso específico. + +**P: Posso fazer anúncios pagos no Google/Instagram?** +R: Sim, desde que o conteúdo respeite as normas éticas da OAB. + +**P: Preciso colocar minha OAB no BCards?** +R: Sim, é obrigatório identificar número e seccional da OAB. + +## Conclusão + +O BCards é uma ferramenta poderosa para advogados modernizarem sua presença digital mantendo a ética profissional. + +**Principais vantagens para advogados:** +- ✅ URL profissional e categorizada +- ✅ Centralização de todos os contatos +- ✅ Facilita marketing de conteúdo ético +- ✅ Transmite credibilidade +- ✅ Compatível com normas da OAB +- ✅ Analytics para medir resultados + +**Lembre-se:** +- Priorize discrição e sobriedade +- Foque em educar, não em vender +- Seja transparente e honesto +- Respeite sempre as normas da OAB + +Sua presença digital pode ser profissional, eficiente e ética ao mesmo tempo. + +**Pronto para criar sua página profissional?** + +[Criar meu BCards para Advocacia →](https://bcards.site/) + +--- + +**Referências:** +- Provimento OAB n° 205/2021 +- Código de Ética e Disciplina da OAB + +**Disclaimer:** Este artigo tem caráter informativo. Para dúvidas específicas sobre ética profissional, consulte a OAB de sua seccional. + +**Última atualização:** Janeiro 2025 diff --git a/src/BCards.Web/Content/Tutoriais/tecnologia/como-criar-um-bcard.pt-BR.md b/src/BCards.Web/Content/Tutoriais/tecnologia/como-criar-um-bcard.pt-BR.md new file mode 100644 index 0000000..4cffdf9 --- /dev/null +++ b/src/BCards.Web/Content/Tutoriais/tecnologia/como-criar-um-bcard.pt-BR.md @@ -0,0 +1,359 @@ +--- +title: "Como Criar seu BCard em 5 Minutos: Tutorial Completo" +description: "Aprenda passo a passo como criar sua página profissional de links no BCards. Tutorial completo para iniciantes com capturas de tela e dicas práticas." +keywords: "tutorial bcards, criar página de links, bio link, tutorial passo a passo" +author: "Equipe BCards" +date: 2025-01-12 +lastMod: 2025-01-12 +image: "/images/tutoriais/criar-bcard.jpg" +culture: "pt-BR" +category: "tecnologia" +--- + +# Como Criar seu BCard em 5 Minutos: Tutorial Completo + +Criar sua página profissional de links no BCards é mais fácil do que você imagina. Neste tutorial, vou te guiar passo a passo desde o cadastro até a publicação da sua página. + +## O Que Você Vai Precisar + +- Email válido +- Conta no Google ou Microsoft (para login rápido) +- 5 minutos do seu tempo +- Links que você quer compartilhar + +## Passo 1: Criar Sua Conta + +### 1.1. Acesse o Site + +Vá para [bcards.site](https://bcards.site) e clique em **"Entrar"** no menu superior. + +### 1.2. Escolha o Método de Login + +Você tem duas opções: + +**Opção A: Login com Google** +- Clique em "Entrar com Google" +- Selecione sua conta +- Autorize o acesso + +**Opção B: Login com Microsoft** +- Clique em "Entrar com Microsoft" +- Insira suas credenciais +- Autorize o acesso + +✅ **Dica:** Usar login social é mais rápido e seguro (sem necessidade de criar nova senha). + +## Passo 2: Acessar o Dashboard + +Após fazer login, você será redirecionado para seu **Dashboard**. Este é o painel de controle onde você gerencia sua página. + +No Dashboard você verá: +- Botão "Criar Minha Página" (se é sua primeira vez) +- Estatísticas (após criar a página) +- Links para editar sua página + +## Passo 3: Criar Sua Página + +### 3.1. Clique em "Criar Minha Página" + +Você verá um formulário com vários campos. Vamos preencher cada um: + +### 3.2. Informações Básicas + +**Nome da Página:** +- Digite como você quer ser identificado +- Exemplo: "João Silva", "Maria Design", "Advocacia Santos" +- Este será o título principal da sua página + +**Categoria:** +- Selecione a categoria que melhor representa sua atividade +- Exemplos disponíveis: + - Tecnologia + - Advocacia + - Saúde + - Educação + - Marketing + - E muitas outras... + +✅ **Dica:** A categoria fará parte da sua URL e ajuda no SEO. + +**Slug (URL Personalizada):** +- Este será o final da sua URL +- Formato final: `bcards.site/page/{categoria}/{seu-slug}` +- Use apenas letras minúsculas, números e hifens +- Sem espaços, acentos ou caracteres especiais + +**Exemplos:** +- `joao-silva-dev` → bcards.site/page/tecnologia/joao-silva-dev +- `maria-designer` → bcards.site/page/design/maria-designer +- `dra-ana-pediatra` → bcards.site/page/saude/dra-ana-pediatra + +### 3.3. Descrição + +Digite uma breve descrição sobre você ou seu negócio: + +**Bom exemplo:** +``` +Desenvolvedora Full Stack especializada em React e Node.js. +Ajudo empresas a criarem aplicações web modernas e escaláveis. +``` + +**Evite:** +``` +Desenvolvedora +``` +(muito curto, sem contexto) + +✅ **Dica:** Use 2-3 frases. Seja claro e direto. + +### 3.4. Escolha do Tema Visual + +Role até a seção "Tema" e selecione o visual da sua página: + +**Temas disponíveis (variam por plano):** +- **Clássico**: Fundo branco limpo, ideal para profissionais +- **Dark**: Fundo escuro, moderno +- **Gradiente**: Cores vibrantes em degradê +- **Minimalista**: Ultra clean +- **Profissional**: Sóbrio e corporativo + +Você pode trocar o tema depois a qualquer momento. + +### 3.5. Adicionar Links + +Agora vamos adicionar os links que aparecerão na sua página. + +**Para adicionar um link:** + +1. Clique em **"Adicionar Link"** +2. Preencha os campos: + - **Título**: Nome que aparecerá no botão + - **URL**: Endereço completo (começando com https://) + - **Ícone** (opcional): Escolha um ícone para o link + +**Exemplo de Link:** +``` +Título: Meu Portfólio +URL: https://meusite.com.br +Ícone: fa-briefcase +``` + +**Tipos de Links Comuns:** + +- WhatsApp: `https://wa.me/5511999999999` +- Instagram: `https://instagram.com/seuusuario` +- Facebook: `https://facebook.com/suapagina` +- LinkedIn: `https://linkedin.com/in/seuusuario` +- YouTube: `https://youtube.com/@seucanal` +- Site: `https://seusite.com.br` +- Email: `mailto:seu@email.com` + +✅ **Dica:** Organize links por importância. Os primeiros aparecem no topo da página. + +### 3.6. Reordenar Links + +Você pode arrastar e soltar os links para mudar a ordem de exibição. Os links mais importantes devem ficar no topo. + +## Passo 4: Personalização Avançada (Opcional) + +### 4.1. Foto de Perfil + +Upload de uma foto profissional (recomendado): +- Tamanho ideal: 400x400 pixels +- Formato: JPG ou PNG +- Peso: Até 2MB + +### 4.2. Cores Personalizadas (Plano Premium) + +Se você tem plano Premium, pode personalizar: +- Cor dos botões +- Cor do fundo +- Cor do texto +- Fontes + +### 4.3. Redes Sociais + +Adicione seus perfis sociais na seção específica. Eles aparecerão como ícones na sua página. + +## Passo 5: Salvar e Submeter para Moderação + +### 5.1. Revisar Tudo + +Antes de salvar, revise: +- ✅ Nome está correto? +- ✅ URL (slug) está como você quer? +- ✅ Todos os links funcionam? +- ✅ Descrição está clara? +- ✅ Tema escolhido te agrada? + +### 5.2. Salvar + +Clique no botão **"Salvar Página"** no final do formulário. + +### 5.3. Submeter para Moderação + +Após salvar, você verá sua página em modo de **preview** (visualização). + +Para torná-la pública, clique em **"Submeter para Moderação"**. + +**O Que Acontece Agora?** +1. Nossa equipe revisa sua página (24-48 horas) +2. Verificamos se segue as diretrizes da comunidade +3. Você recebe email quando for aprovada +4. Sua página fica pública! + +## Passo 6: Visualizar e Compartilhar + +### 6.1. Token de Preview + +Enquanto aguarda aprovação, você pode visualizar sua página usando o **token de preview**: + +1. No Dashboard, clique em "Gerar Token de Preview" +2. Copie o link gerado +3. Abra em uma aba privada ou compartilhe com amigos + +**Exemplo de link de preview:** +``` +bcards.site/page/tecnologia/joao-dev?preview=ABC123XYZ +``` + +### 6.2. Após Aprovação + +Quando sua página for aprovada: +- Ela estará acessível publicamente +- URL final: `bcards.site/page/{categoria}/{seu-slug}` +- Você pode compartilhar em suas redes sociais! + +## Passo 7: Atualizar Bio das Redes Sociais + +Com sua página aprovada, atualize a bio de todas as suas redes: + +### Instagram +1. Vá em "Editar Perfil" +2. Cole seu link BCards no campo "Website" +3. Salve + +### TikTok +1. Editar Perfil +2. Cole o link em "Bio" +3. Salve + +### Twitter/X +1. Editar Perfil +2. Cole o link em "Website" +3. Salve + +### LinkedIn +1. Editar Perfil +2. Cole na seção "Informações de Contato" +3. Salve + +## Dicas de Boas Práticas + +### ✅ Faça: +- Use foto profissional nítida +- Escreva descrição clara e objetiva +- Teste todos os links antes de publicar +- Mantenha a página atualizada +- Responda mensagens rapidamente +- Use call-to-action nos títulos dos links + +### ❌ Evite: +- Links quebrados ou incorretos +- Descrição muito longa ou muito curta +- Excesso de links (foco no essencial) +- Informações enganosas +- Conteúdo que viola diretrizes + +## Atualizando Sua Página Depois + +Você pode editar sua página a qualquer momento: + +1. Acesse o Dashboard +2. Clique em "Editar Página" +3. Faça as alterações +4. Salve + +**Importante:** Mudanças significativas podem exigir nova moderação. + +## Planos e Upgrades + +### Plano Básico (R$ 9,90/mês) +- 5 links +- Temas básicos +- Analytics essenciais + +### Plano Profissional (R$ 24,90/mês) +- 15 links +- Todos os temas +- Analytics completo +- Suporte prioritário + +### Plano Premium (R$ 29,90/mês) +- Links ilimitados +- Customização total +- Temas exclusivos +- Editor CSS +- Suporte VIP + +Para fazer upgrade: +1. Dashboard → "Meu Plano" +2. Escolha o plano desejado +3. Preencha dados de pagamento +4. Confirme + +## Analisando Resultados + +Após sua página estar ativa, acompanhe as métricas no Dashboard: + +- **Total de visitantes**: Quantas pessoas acessaram +- **Cliques por link**: Quais links são mais populares +- **Origem do tráfico**: De onde vieram os visitantes + +Use esses dados para otimizar sua página! + +## Problemas Comuns e Soluções + +### "Meu slug já está em uso" +**Solução:** Escolha outro slug. Tente adicionar seu nome, cidade ou especialidade. + +### "Link não funciona" +**Solução:** Verifique se a URL começa com `https://` e está digitada corretamente. + +### "Página foi rejeitada na moderação" +**Solução:** Leia o email com o motivo da rejeição, ajuste conforme orientações e resubmeta. + +### "Não recebi email de aprovação" +**Solução:** Verifique spam/lixo eletrônico ou entre em contato com suporte. + +## Suporte + +Precisa de ajuda? + +- **Email**: suporte@bcards.site +- **Horário**: Segunda a sexta, 9h às 18h +- **FAQ**: bcards.site/ajuda +- **WhatsApp**: (Link no site) + +## Conclusão + +Parabéns! 🎉 Agora você sabe criar sua página profissional no BCards do zero. + +**Recapitulando:** +1. ✅ Criar conta +2. ✅ Preencher informações +3. ✅ Escolher tema +4. ✅ Adicionar links +5. ✅ Salvar e submeter +6. ✅ Aguardar aprovação +7. ✅ Compartilhar! + +Sua presença online profissional está a apenas alguns cliques de distância. + +**Pronto para começar?** [Criar meu BCard agora →](https://bcards.site/) + +--- + +**Tempo de leitura:** 8 minutos +**Dificuldade:** Iniciante +**Última atualização:** Janeiro 2025 diff --git a/src/BCards.Web/Controllers/SubscriptionController.cs b/src/BCards.Web/Controllers/SubscriptionController.cs index f5077a7..1adf902 100644 --- a/src/BCards.Web/Controllers/SubscriptionController.cs +++ b/src/BCards.Web/Controllers/SubscriptionController.cs @@ -73,7 +73,7 @@ public class SubscriptionController : Controller { case "immediate_with_refund": success = await _paymentService.CancelSubscriptionImmediatelyAsync(request.SubscriptionId, true); - message = success ? "Assinatura cancelada. Reembolso será processado manualmente em até 10 dias úteis." : "Erro ao processar cancelamento."; + message = success ? "Assinatura cancelada com reembolso total. O valor será retornado em até 10 dias úteis." : "Erro ao processar cancelamento."; break; case "immediate_no_refund": @@ -86,7 +86,7 @@ public class SubscriptionController : Controller var (_, canRefundPartial, refundAmount) = await _paymentService.CalculateRefundAsync(request.SubscriptionId); if (success && canRefundPartial && refundAmount > 0) { - message = $"Assinatura cancelada. Reembolso parcial de R$ {refundAmount:F2} será processado manualmente em até 10 dias úteis."; + message = $"Assinatura cancelada com reembolso parcial de R$ {refundAmount:F2}. O valor será retornado em até 10 dias úteis."; } else { diff --git a/src/BCards.Web/Program.cs b/src/BCards.Web/Program.cs index 8245bb2..f57d5c1 100644 --- a/src/BCards.Web/Program.cs +++ b/src/BCards.Web/Program.cs @@ -492,6 +492,9 @@ builder.Services.AddScoped(); builder.Services.AddScoped(); +// Markdown/Articles System - Tutoriais e Artigos Areas +builder.Services.AddScoped(); + // Configure upload limits for file handling (images up to 5MB) builder.Services.Configure(options => { @@ -786,6 +789,56 @@ app.MapControllerRoute( pattern: "terminos", defaults: new { controller = "Legal", action = "TermsES" }); +// ======================================== +// AREAS: Tutoriais e Artigos +// ======================================== +// IMPORTANTE: Ordem importa! Rotas mais específicas primeiro. + +// Artigos Area - Índice (ANTES para evitar conflito) +app.MapAreaControllerRoute( + name: "artigos-index", + areaName: "Artigos", + pattern: "artigos", + defaults: new { controller = "Artigos", action = "Index" }); + +// Artigos Area - Artigo específico +app.MapAreaControllerRoute( + name: "artigos-article", + areaName: "Artigos", + pattern: "artigos/{slug}", + defaults: new { controller = "Artigos", action = "Article" }, + constraints: new { slug = @"^[a-z0-9\-]+$" }); + +// Tutoriais Area - Índice +app.MapAreaControllerRoute( + name: "tutoriais-index", + areaName: "Tutoriais", + pattern: "tutoriais", + defaults: new { controller = "Tutoriais", action = "Index" }); + +// Tutoriais Area - Lista de artigos por categoria +app.MapAreaControllerRoute( + name: "tutoriais-category", + areaName: "Tutoriais", + pattern: "tutoriais/{categoria}", + defaults: new { controller = "Tutoriais", action = "Category" }, + constraints: new { categoria = @"^[a-z\-]+$" }); + +// Tutoriais Area - Artigo específico +app.MapAreaControllerRoute( + name: "tutoriais-article", + areaName: "Tutoriais", + pattern: "tutoriais/{categoria}/{slug}", + defaults: new { controller = "Tutoriais", action = "Article" }, + constraints: new + { + categoria = @"^[a-z\-]+$", // slug de categoria + slug = @"^[a-z0-9\-]+$" // slug do artigo + }); + +// ======================================== +// Rota default +// ======================================== app.MapControllerRoute( name: "default", pattern: "{controller=Home}/{action=Index}/{id?}"); diff --git a/src/BCards.Web/Services/PaymentService.cs b/src/BCards.Web/Services/PaymentService.cs index 29124bb..cba1541 100644 --- a/src/BCards.Web/Services/PaymentService.cs +++ b/src/BCards.Web/Services/PaymentService.cs @@ -372,17 +372,46 @@ public class PaymentService : IPaymentService try { var service = new SubscriptionService(); - + var subscription = await service.GetAsync(subscriptionId); + if (refund) { - // Para reembolso completo, apenas cancela - reembolso deve ser feito manualmente via Stripe Dashboard - await service.CancelAsync(subscriptionId); + // Processar reembolso automático - obter última charge e reembolsá-la + try + { + var chargeService = new ChargeService(); + var charges = await chargeService.ListAsync(new ChargeListOptions + { + Customer = subscription.CustomerId, + Limit = 1 + }); + + if (charges.Data.Any()) + { + var lastCharge = charges.Data.First(); + if (lastCharge.Refunded == false && !string.IsNullOrEmpty(lastCharge.Id)) + { + try + { + var refundService = new RefundService(); + await refundService.CreateAsync(new RefundCreateOptions { Charge = lastCharge.Id }); + } + catch (StripeException) + { + // Reembolso falhou mas continuaremos com o cancelamento + } + } + } + } + catch (StripeException) + { + // Se houver erro ao obter charge, ainda cancela a assinatura + } } - else - { - await service.CancelAsync(subscriptionId); - } - + + // Cancelar a assinatura + await service.CancelAsync(subscriptionId); + // Atualizar subscription local var localSubscription = await _subscriptionRepository.GetByStripeSubscriptionIdAsync(subscriptionId); if (localSubscription != null) @@ -391,7 +420,7 @@ public class PaymentService : IPaymentService localSubscription.UpdatedAt = DateTime.UtcNow; await _subscriptionRepository.UpdateAsync(localSubscription); } - + return true; } catch (StripeException) diff --git a/src/BCards.Web/Views/Shared/_Layout.cshtml b/src/BCards.Web/Views/Shared/_Layout.cshtml index 5ddea93..0819c9e 100644 --- a/src/BCards.Web/Views/Shared/_Layout.cshtml +++ b/src/BCards.Web/Views/Shared/_Layout.cshtml @@ -42,6 +42,14 @@ @await RenderSectionAsync("Styles", required: false) + +