gabspereira/workspace
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
feature/initial-setup
workspace/AGENTS.md
gabspereira 744868caa1 feat(go-crm): full auth, routing, middleware, and supporting infra 
- Add auth handlers (signup, login, logout, account management) with bcrypt
- Add client, customer, service, scheduling, payment, question, answer handlers
- Add dashboard, monthly report, and lead pipeline pages
- Add UTF-8 middleware to force charset on HTML responses
- Add config package with env-based overrides for DB path, secrets, endpoints
- Add parser package for WhatsApp message ingestion
- Add clean-arch layers: pkg/domain, pkg/repo, pkg/usecase for leads
- Add cmd/migrate utility for DB migrations
- Add Makefile, README, run-tests.sh, and dev scripts
- Update docker-compose.yml with memory limits
- Update .air.toml to exclude DB files and stop on errors
- Update whatsapp-sync dependencies and add src/index.js entrypoint
- Add whatsme standalone WhatsApp reader app (source only)
- Untrack .opencode-sandbox/data/go-crm.db from git history
- Expand root .gitignore: ngrok, tmp dirs, sandbox DBs, compiled binaries
2026-05-23 16:55:55 -03:00

3.1 KiB
Raw Permalink Blame History

AGENTS.md

Project Structure

workspace/
├── apps/
│   ├── go-crm/            # Go server (Chi), HTML templates, hot-reload via air
│   ├── whatsapp-crm/      # Next.js 14 App Router, sql.js (browser SQLite), Kanban
│   ├── whatsapp-sync/     # Node.js WhatsApp sync service
│   ├── whatsapp-reader/   # Standalone message reader
│   └── timesfm-forecast/  # Streamlit + TimesFM (Python/uv)
├── data/                  # SQLite DBs: go-crm.db, whatsapp.db
├── data-engineering/      # Udacity DE portfolio (standalone, no unified build)
└── skills/                # dbt reference templates

Developer Commands

go-crm (primary)

cd apps/go-crm
go run main.go              # plain dev (no hot-reload)
air                         # hot-reload dev (uses .air.toml)
go build -o go-crm main.go  # binary
./go-crm                    # run binary

go mod tidy                 # clean go.mod/go.sum

# DB: /workspace/data/go-crm.db  (hardcoded path — do not change)
# WhatsApp session: /workspace/data/whatsapp.db  (hardcoded path)

whatsapp-crm

cd apps/whatsapp-crm
npm run dev     # Next.js dev server 0.0.0.0:3000
npm run build   # production build
npm run lint    # ESLint
npm run test    # Jest (uses tests/setup.ts)

whatsapp-sync

cd apps/whatsapp-sync
npm run start   # node src/index.js
npm run dev     # node --watch src/index.js
npm run sync    # node src/sync.js
npm run test    # Jest (mocks qrcode-terminal + whatsapp-web.js)

whatsapp-reader

cd apps/whatsapp-reader
node index.js   # main script
node sync.js    # sync script
# no test script

timesfm-forecast

cd apps/timesfm-forecast
uv venv && source .venv/bin/activate
uv pip install -e .
ruff check .           # lint (dev dep)
timesfm-app            # run Streamlit app

# See apps/timesfm-forecast/README.md for CUDA/CPU wheel guidance

Important Quirks

WhatsApp auth sessions

  • .wwebjs_auth/ directories store session state — do not commit these
  • whatsapp-sync uses better-sqlite3 for persistence
  • whatsapp-crm browser-side uses sql.js (WebAssembly, no native deps)

go-crm auth

  • X-Internal-Secret header required on requests (value: internal-secret)
  • WhatsApp connector init URL: http://localhost:8080

Docker

docker compose up whatsapp-crm          # CRM only
docker compose --profile sync up        # CRM + sync
docker compose --profile test up       # test runner

go-crm hot-reload

  • Uses air (not go run) — configured in .air.toml
  • Build excludes _test.go and vendor/, tmp/, assets/

TypeScript config (whatsapp-crm, whatsapp-sync)

  • strict: true in tsconfig.json
  • Path alias @/* maps to src/*

Testing mocks

  • whatsapp-sync has manual mocks for qrcode-terminal and whatsapp-web.js in tests/__mocks__/

What to Avoid

  • Do not use go run main.go for development — use air
  • Do not commit .wwebjs_auth/ or .wwebjs_cache/ directories
  • Do not change hardcoded DB paths in main.go
  • The data-engineering/ projects are standalone — no shared build or test commands
Reference in New Issue View Git Blame Copy Permalink