https://github.com/rickalves/cultivotrace
Plataforma Completa de Rastreamento e Gerenciamento Agrícola
https://github.com/rickalves/cultivotrace
monorepo nestjs postgresql react-native reactjs supabase typescript
Last synced: 3 months ago
JSON representation
Plataforma Completa de Rastreamento e Gerenciamento Agrícola
- Host: GitHub
- URL: https://github.com/rickalves/cultivotrace
- Owner: rickalves
- License: apache-2.0
- Created: 2026-01-02T21:05:31.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-03-08T01:13:32.000Z (4 months ago)
- Last Synced: 2026-03-08T06:36:46.525Z (4 months ago)
- Topics: monorepo, nestjs, postgresql, react-native, reactjs, supabase, typescript
- Language: TypeScript
- Homepage: https://cultivotrace-landing.vercel.app/
- Size: 654 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# CultivoTrace
**Plataforma de rastreamento e gerenciamento agrícola multi-tenant.**
Monorepo com API backend (NestJS), aplicação web e mobile para gestão de propriedades rurais, lotes e rastreabilidade de produção agrícola.
---
## Stack
| Área | Tecnologias |
|------|-------------|
| Backend | NestJS, TypeScript, TypeORM, PostgreSQL |
| Autenticação | Supabase, JWT |
| Monorepo | pnpm workspaces, Turborepo |
| Testes | Jest (unit + E2E) |
---
## Estrutura do Projeto
```
cultivotrace/
├── apps/
│ ├── api/ # API Backend (NestJS) — ver apps/api/README.md
│ ├── web/ # Aplicação Web (em desenvolvimento)
│ └── mobile/ # Aplicação Mobile (em desenvolvimento)
├── packages/
│ └── shared/ # Código compartilhado
└── docs/ # Documentação técnica e de produto
```
---
## Quickstart
**Pré-requisitos:** Node.js 18+, pnpm 10+, PostgreSQL 14+, conta Supabase.
```bash
# 1. Clone e instale
git clone https://github.com/rickalves/cultivotrace.git
cd cultivotrace
pnpm install
# 2. Configure o ambiente (veja apps/api/.env.example)
cp apps/api/.env.example apps/api/.env
# 3. Execute as migrações
pnpm --filter api migration:run
# 4. Inicie o servidor de desenvolvimento
pnpm dev
```
A API estará disponível em `http://localhost:3000`.
Documentação interativa (Swagger): `http://localhost:3000/api/docs`.
---
## Comandos Principais
```bash
pnpm dev # Inicia todas as apps em modo dev
pnpm build # Build de todas as apps
pnpm test # Testes em todos os projetos
pnpm --filter api test:e2e # Testes E2E da API
pnpm --filter api migration:run # Executa migrações do banco
```
---
## Documentação
- [Documentação Completa](./docs/README.md) — índice central de todas as docs
- [API Backend](./apps/api/README.md) — endpoints, arquitetura e migrações
- [Backlog & Histórias de Usuário](./docs/product/backlog.md)
- [Arquitetura](./docs/architecture/overview.md)
- [ADRs](./docs/adr/README.md) — decisões arquiteturais
---
CultivoTrace — Rastreabilidade Agrícola Multi-Tenant · © 2026