TG
Back to the journal

Consolidation: auth, forms, enums, and docs across 14 workspaces

Centralized auth, react-hook-form + Zod on forms, removed react-aria in favor of shadcn/ui, refactored domain enums, migrated build to Railpack, and documentation sprint.

Second day in a row of heavy work on a client project (NDA). 14 workspaces ran in parallel, 36 agent sessions, 26 unique commits. The focus shifted from foundation (the day before) to consolidation: authentication, form validation, code quality, and onboarding docs.

Client project (NDA)

Centralized auth

I built an AuthProvider (React Context) to handle session and login in one place. The DELETE route for users was returning 500 when the profile in the database was invalid. It now validates and returns a readable error. Renamed generic variables (atualizado to usuarioAtualizado) for clarity.

Forms with react-hook-form + Zod

Migrated the smaller forms to react-hook-form with Zod schemas. The two largest components (NovoRelatorio, ~3k lines, and GestaoRelacional, ~5k lines) stayed out: they have auto-save, debounce, repeatable arrays (useFieldArray), autocompletes with parallel state, and offline integration. Migrating them in bulk would be risky. The infrastructure (schemas, ErrorField, RHF pattern) is ready for incremental adoption.

Component library consolidation

I evaluated whether keeping react-aria-components alongside shadcn/ui made sense. It didn't: shadcn/ui (built on Radix) already covers every component we need. Removed the dependency and simplified the tree.

Domain enums refactor

Applied the domain-enums skill across frontend and backend: typed enums instead of magic strings. Standardized naming (rotulo became label, while domain-specific names like sufixoRelatorio stayed).

Deploy and infra (Railway)

Migrated the backend build from Nixpacks to Railpack. Fixed a build failure and configured the service domain in production. Bootstrapped the initial admin user in the production database and documented the ALLOW_BOOTSTRAP_ADMIN flow. One workspace explored hosting the frontend on Railway too (decided to keep it on Vercel).

Sync and offline PWA

Fixed sync integrity and reliability bugs. Studied offline-first patterns (web.dev) and documented how to test the PWA locally. Improved the "New Report" form UI and reorganized its docs.

Documentation and onboarding

The docs volume was high:

  • CONTRIBUTING.md with step-by-step setup for macOS, Linux, and Windows.
  • Reorganized the docs/ folder (frontend/backend split inside arquitetura/).
  • User guide scoped by role (admin, manager, pilot).
  • Architecture diagram, QA plan, and critical parts documentation.
  • Rule for devs: do not ask an AI agent to run the app more than once (avoids re-running migrations).

UI and reviews

Added a translucent pulse to the WhatsApp button. Opened GitHub issues and tracked progress on ongoing tasks. Created pending tasks for input masks (area field accepting letters, missing type="number" and Zod validation).

tgmarinho-ai-website

Merged the PR with journal entries for the week (days 27 and 28).

A consolidation day where each workspace tackled a specific piece of tech debt. By the end, the codebase was more readable, better documented, and easier for newcomers to get started.

Back to the journal