{"id":51128697,"url":"https://github.com/a5ur4/pickbyvoice","last_synced_at":"2026-06-25T10:30:32.958Z","repository":{"id":362782603,"uuid":"1260741486","full_name":"a5ur4/pickbyvoice","owner":"a5ur4","description":"Projeto de um pick by voice, feito em arduino uno para a disciplina de Microcontroladores","archived":false,"fork":false,"pushed_at":"2026-06-05T21:14:37.000Z","size":390,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-05T23:07:23.090Z","etag":null,"topics":["arduino","c","fastapi","logistics"],"latest_commit_sha":null,"homepage":"https://www.tinkercad.com/things/6f0p3xCrnIk-modelo-pickbyvoice","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/a5ur4.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-05T20:27:32.000Z","updated_at":"2026-06-05T21:16:15.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/a5ur4/pickbyvoice","commit_stats":null,"previous_names":["a5ur4/pickbyvoice"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/a5ur4/pickbyvoice","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a5ur4%2Fpickbyvoice","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a5ur4%2Fpickbyvoice/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a5ur4%2Fpickbyvoice/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a5ur4%2Fpickbyvoice/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/a5ur4","download_url":"https://codeload.github.com/a5ur4/pickbyvoice/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a5ur4%2Fpickbyvoice/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34771660,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-25T02:00:05.521Z","response_time":101,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arduino","c","fastapi","logistics"],"created_at":"2026-06-25T10:30:31.997Z","updated_at":"2026-06-25T10:30:32.948Z","avatar_url":"https://github.com/a5ur4.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Pick By Voice — Low Cost 🎙️📦\n\nSistema de separação de pedidos (Picking) por comandos de voz de baixo custo, integrado com **Oracle Database**, **FastAPI** e **Arduino**.\n\nEste projeto permite que operadores de armazém realizem a coleta de itens de forma \"hands-free\", recebendo instruções via áudio e confirmando localizações/quantidades por voz, com feedback visual e sonoro através de um módulo Arduino conectado via Bluetooth.\n\n---\n\n## 🏗️ Arquitetura do Sistema\n\nO ecossistema é dividido em três camadas principais:\n\n1.  **Backend (API + DB)**: Centraliza as regras de negócio, controle de estoque e ordens de serviço.\n2.  **Cliente de Voz (Python)**: Roda em um dispositivo móvel (Android/PC) e faz a ponte entre o operador (STT/TTS) e a API.\n3.  **Interface de Hardware (Arduino)**: Fornece sinais visuais (LED/LCD) e sonoros (Buzzer) baseados no status da coleta.\n\n---\n\n## 📂 Estrutura do Projeto\n\n```text\npickbyvoice/\n├── api/                # Backend FastAPI (Assíncrono)\n│   ├── core/           # Configurações e Exceções\n│   ├── database/       # Conexão e Pool (SQLAlchemy + OracleDB)\n│   ├── migrations/     # Versionamento de banco (Alembic)\n│   ├── models/         # Modelos SQLAlchemy 2.0 (Mapped/Identity)\n│   ├── routes/         # Endpoints da API (Operadores, Ordens, Coleta)\n│   ├── schemas/        # Schemas Pydantic (Validação de dados)\n│   └── services/       # Lógica de negócio e Stored Procedures\n├── arduino/            # Firmware C++ para o Arduino Uno\n├── db/                 # Scripts SQL originais (Tabelas, Views, Procs, Seed)\n├── docs/               # Documentação do projeto\n├── .env                # Variáveis de ambiente (DB, API)\n└── README.md           # Este arquivo\n```\n\n---\n\n## 🛠️ Tecnologias Utilizadas\n\n*   **Linguagens**: Python 3.12+ (Backend/Client) e C++ (Arduino).\n*   **Banco de Dados**: Oracle Database XE (rodando em Docker).\n*   **ORM**: SQLAlchemy 2.0 (Modo Assíncrono).\n*   **Migrations**: Alembic.\n*   **Framework Web**: FastAPI (Uvicorn).\n*   **Voz**: Vosk (Speech-to-Text Offline) e pyttsx3 (Text-to-Speech).\n\n---\n\n## 🚀 Como Rodar o Projeto\n\n### 1. Banco de Dados (Oracle XE)\nCertifique-se de ter o Docker instalado e rode o container:\n```bash\ndocker-compose up -d\n```\nA imagem `gvenzl/oracle-xe` inicializará o banco e criará o usuário configurado no `.env`.\n\n### 2. Preparar o Ambiente Python\n```bash\npython -m venv .venv\nsource .venv/bin/activate\npip install -r api/requirements.txt\n```\n\n### 3. Migrações e Dados Iniciais\nAplique as migrações para criar as tabelas e execute o seed se necessário:\n```bash\ncd api\nexport ORACLE_DSN=\"localhost:1521?service_name=XEPDB1\"\nalembic upgrade head\n```\n\n### 4. Executar a API\nNa raiz do projeto:\n```bash\nsource .venv/bin/activate\nexport ORACLE_DSN=\"localhost:1521?service_name=XEPDB1\"\nfastapi run api/main.py\n```\nAcesse `http://localhost:8000/docs` para ver a documentação interativa (Swagger).\n\n### 5. Arduino\n*   Carregue o arquivo `arduino/pick_by_voice.ino` no seu Arduino Uno.\n*   Conecte um módulo Bluetooth (ex: HC-05) aos pinos de Serial.\n*   Pinos padrão: LED OK (8), LED ERRO (9), Buzzer (10), LCD I2C (0x27).\n\n---\n\n## 📢 Demonstração do Sistema\n![Demonstração do Pick By Voice](/arduino/pick_by_voice_demo/Modelo%20PickByVoice.png)\n\nLink para acesso a demonstração no Tinkcard: [PickByVoiceDemo](https://www.tinkercad.com/things/6f0p3xCrnIk-modelo-pickbyvoice?sharecode=3qxVWNa7DNa1RetHDgUN01mvTk6TLsJKgWb01gIXjD4)\n\n---\n\n## 📝 Roteiro de Exentesão\nO roteiro de extensão do projeto está disponível na pasta `docs/` com o nome `ROTEIRO DE EXTENSÃO - PICKBYVOICE.pdf`.\n\nCaso queira, pode acessar a versão do Google Docs através do seguinte link: [Roteiro de Extensão - PickByVoice](https://docs.google.com/document/d/1862g0fcIZiqdanSQVqO9xreU7wXJL9zYPSLBLme-9OA/edit?usp=sharing)\n\n---\n\n## 🗣️ Funcionamento do Pick By Voice\n\n1.  **Login**: O operador informa sua matrícula via voz.\n2.  **Início**: O sistema atribui a ordem de maior prioridade ao operador.\n3.  **Instrução**: A voz sintetizada diz o endereço (Rua, Coluna, Nível) e o produto.\n4.  **Ação no Arduino**: O endereço é exibido no LCD e o LED de alerta acende.\n5.  **Confirmação**: O operador fala o código de verificação presente na prateleira.\n6.  **Validação**: A API valida o código. Se correto, o Arduino apita e acende o LED verde. Se errado, acende o LED vermelho e solicita nova tentativa.\n7.  **Finalização**: Ao concluir todos os itens, o sistema guia o operador para a expedição.\n\n---\n\n## 🛡️ Decisões Técnicas\n*   **Async Oracle**: Utilizamos `oracledb_async` para garantir que a API não bloqueie durante chamadas de banco pesadas ou execuções de stored procedures.\n*   **Identity Columns**: Utilizamos o recurso nativo do Oracle 12c+ (`GENERATED AS IDENTITY`) mapeado no SQLAlchemy para garantir chaves primárias seguras e eficientes.\n*   **Alembic Async**: O script de migração foi customizado para utilizar o driver assíncrono, mantendo a consistência com o restante da aplicação.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fa5ur4%2Fpickbyvoice","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fa5ur4%2Fpickbyvoice","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fa5ur4%2Fpickbyvoice/lists"}