Referências¶

Objetivo¶

Centralizar todas as referências técnicas, arquiteturais e funcionais utilizadas durante o desenvolvimento e evolução do CoreFlow CRM.

Este documento serve como ponto de entrada para consulta de normas, padrões e documentação relacionada.

Documentação da Plataforma¶

CoreFlow Platform¶

• Visão Geral
• Roadmap
• Arquitetura
• Core Services

Engenharia¶

Consultar:

• Standards
• Templates
• Architecture
• DDD
• C4
• ADR
• AI First Documentation

Arquiteturas¶

O CoreFlow CRM segue oficialmente:

• Clean Architecture
• Domain-Driven Design (DDD)
• SOLID
• API First
• Event Driven Architecture
• AI First Documentation

Tecnologias¶

Backend

• Python
• Django
• Django REST Framework

Frontend

• React
• Next.js
• TypeScript
• Tailwind CSS

Banco

• PostgreSQL
• Redis

Infraestrutura

• Docker
• Nginx
• GitHub Actions

Protocolos¶

• HTTP
• HTTPS
• REST
• JSON
• JWT
• OAuth2
• Webhooks

Modelagem¶

Utilizar:

• Mermaid
• C4 Model
• UML quando necessário
• ER Diagram

Banco de Dados¶

Padrões:

• PostgreSQL
• UUID
• Soft Delete
• Auditoria
• Multiempresa

APIs¶

Documentação:

• OpenAPI 3.x

Versionamento:

• REST
• JSON

Segurança¶

Aplicar:

• RBAC
• LGPD
• Auditoria
• HTTPS
• CSP
• HSTS

Qualidade¶

Ferramentas oficiais:

• Ruff
• Black
• mypy
• Pytest
• Coverage

DevOps¶

Padrões:

• Docker
• Docker Compose
• CI/CD
• GitHub Actions
• Observabilidade

Integrações¶

CoreFlow Platform

• Authentication
• Users
• Companies
• Files
• Notifications
• Audit
• AI Gateway

Produtos

• ERP
• Finance
• RH
• BI
• WMS

Convenções¶

Seguir integralmente:

• Standards
• Templates
• ADRs
• AI Engineering Kit

Bibliografia¶

• Domain-Driven Design — Eric Evans
• Implementing Domain-Driven Design — Vaughn Vernon
• Clean Architecture — Robert C. Martin
• Refactoring — Martin Fowler
• Designing Data-Intensive Applications — Martin Kleppmann

Documentação Oficial¶

• Python
• Django
• Django REST Framework
• PostgreSQL
• React
• Next.js
• Docker
• Redis
• OpenAPI
• Mermaid
• Material for MkDocs

Histórico¶

Objetivo Final¶

Manter uma base única de referências técnicas, arquiteturais e bibliográficas que apoie a evolução contínua do CoreFlow CRM e assegure alinhamento com os padrões oficiais da HauxTech Soluções.