docs: update all documentation and add AI tooling configs

- Rewrite README.md with current architecture, features and stack
- Update docs/API.md with all current endpoints (corporate, BI, client 360)
- Update docs/ARCHITECTURE.md with cache, modular queries, services, ETL
- Update docs/GUIA-USUARIO.md for all roles (admin, corporate, agente)
- Add docs/INDEX.md documentation index
- Add PROJETO.md comprehensive project reference
- Add BI-CCC-Implementation-Guide.md
- Include AI agent configs (.claude, .agents, .gemini, _bmad)
- Add netbird VPN configuration
- Add status report

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-03-19 13:29:03 -04:00
parent c5b377e788
commit 647cbec54f
3246 changed files with 479789 additions and 983 deletions

View File

@@ -0,0 +1,52 @@
# Tone of Voice Example: SaaS Onboarding Tool
**Context:** B2B SaaS for employee onboarding, target users are HR managers (stressed, overwhelmed, want to feel capable)
---
## Suggested Tone of Voice
### Tone Attributes
1. **Supportive & Reassuring**: HR managers are stressed about onboarding. Our tone should reduce anxiety, not add to it.
2. **Professional but Warm**: B2B context requires professionalism, but warmth builds trust.
3. **Clear & Concise**: Busy users need straightforward communication, no fluff.
4. **Empowering**: Frame actions around user capability, not system features.
### Examples
**Error Message:**
- ✅ "We couldn't find that email. Double-check for typos?"
- ❌ "Error 404: User not found"
**Button Text:**
- ✅ "Add your first employee"
- ❌ "Create new record"
**Empty State:**
- ✅ "Your onboarding dashboard is ready. Let's add your first employee to get started."
- ❌ "No employees added yet"
**Success Message:**
- ✅ "Perfect! Sarah's onboarding is set up. We'll send her the welcome email tomorrow at 9 AM."
- ❌ "Employee record created successfully"
---
## Analysis
**Why This Tone Works:**
- **Supportive**: "We couldn't find" (collaborative) vs "Error" (blaming)
- **Professional but Warm**: Uses proper grammar but friendly language
- **Clear**: Specific, actionable messages without jargon
- **Empowering**: "Add your first employee" (user action) vs "Create new record" (system function)
**Alignment with User State:**
- HR managers are stressed → Reassuring tone reduces anxiety
- Want to feel capable → Empowering language focuses on their actions
- Need efficiency → Clear, concise messaging respects their time
- Professional context → Maintains appropriate formality with warmth
---
_Example demonstrating Tone of Voice definition for B2B SaaS product_