History

Tiago Yamamoto 222006fb6b docs: rewrite TEST_USERS.md with current credentials and bug post-mortems - Correct all passwords (were wrong/outdated) - Add full table of current seeded users (superadmin, admins, candidates) - Document 3 bugs fixed 2026-02-24: - superadmin placeholder hash (seeder fix) - users.status VARCHAR(20) crash loop (migration fix) - PASSWORD_PEPPER alignment requirement - Add bash ! expansion gotcha for curl testing Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>		2026-02-24 05:55:10 -06:00
..
txt	test: increase backend use case coverage	2026-02-16 23:25:26 -03:00
AGENTS.md	docs: overhaul global documentation with diagrams, test scenarios, and agent directives	2026-02-23 21:16:04 -06:00
API.md	docs: overhaul global documentation with diagrams, test scenarios, and agent directives	2026-02-23 21:16:04 -06:00
API_SECURITY.md	docs: unify documentation structure	2026-02-16 05:57:02 -06:00
APPSEC_STRATEGY.md	feat: implement rotating background hero on companies page	2026-02-23 21:00:01 -06:00
BACKEND_COVERAGE.md	feat: add test coverage and handler improvements	2026-01-02 08:50:29 -03:00
CAREERJET_GAP_ANALYSIS.md	docs: add codex fast-track execution plan for careerjet gaps	2026-02-14 17:37:54 -03:00
CLOUDFLARE.md	docs: add Cloudflare zone info and DNS management agent	2026-02-16 20:33:20 -06:00
DATABASE.md	docs: overhaul global documentation with diagrams, test scenarios, and agent directives	2026-02-23 21:16:04 -06:00
DEVOPS.md	docs: overhaul global documentation with diagrams, test scenarios, and agent directives	2026-02-23 21:16:04 -06:00
FRONTEND_TESTING_STRATEGY.md	docs: add comprehensive frontend testing strategy	2026-02-23 21:13:04 -06:00
FULL_TEST_REPORT.md	feat: add test coverage and handler improvements	2026-01-02 08:50:29 -03:00
GUIA_MIGRACAO_FORGEJO.md	feat: atualiza fluxo de cadastro de candidatos com persistência completa de dados e máscara de telefone	2026-01-06 18:19:47 -03:00
publicar-vaga-routes.md	refactor job posting routes and add dashboard job creation page	2026-02-17 09:42:31 -03:00
README.md	docs: overhaul global documentation with diagrams, test scenarios, and agent directives	2026-02-23 21:16:04 -06:00
ROADMAP.md	docs: unifica documentação e atualiza README principal	2026-02-14 17:07:11 -03:00
TASKS.md	refactor job posting routes and add dashboard job creation page	2026-02-17 09:42:31 -03:00
TEST_REPORT.md	feat: add test coverage and handler improvements	2026-01-02 08:50:29 -03:00
TEST_USERS.md	docs: rewrite TEST_USERS.md with current credentials and bug post-mortems	2026-02-24 05:55:10 -06:00
WORKFLOWS.md	docs: unify documentation structure	2026-02-16 05:57:02 -06:00

README.md

📚 Project Documentation - GoHorseJobs

Welcome to the central documentation hub for GoHorseJobs. This repository contains the collective knowledge, architecture decisions, and operational guides for our B2B SaaS recruitment platform.

Choose a specific domain below to dive deep into our technical implementation and guides.

🤖 1. AI & Developer Directives

Context for AI Agents (AGENTS.md): The supreme source of truth for Claude, Cursor, and other AI coding assistants. Contains stack rules, passwords, gotchas, and layout contexts.
Rules (.agent/rules.md): Absolute system boundaries and deployment limits.

🏗️ 2. High-Level Architecture

DevOps & Infrastructure (DEVOPS.md): Full mapping of Cloudflare DNS, Traefik, VPS (Redbull/Apolo), Docker/Coolify containers, and CI/CD pipelines (Forgejo/Drone). Includes rich Mermaid diagrams.
Database Schema (DATABASE.md): PostgreSQL schemas, relationships, UUID v7 indexing strategies, and ERD visualizing the core data flow.

🔌 3. Application Interfaces (APIs)

API Routes (API.md): Endpoints mapped for the Go Backend (/api/v1), NestJS Backoffice services, and internal Node.js Seeder-API.
API Security (API_SECURITY.md): Details on HS256 JWT implementations, RBAC (Role-Based Access Control) levels, and CORS policies.
AppSec Strategy (APPSEC_STRATEGY.md): The core mitigation plan against XSS, IDOR, Mass Assignment, and testing vectors within Next.js.

🫂 4. Operations & Testing

Test Users & Data (TEST_USERS.md): Comprehensive list of robust local credentials, passwords, dummy candidates, and seeded companies.
Deployment Routes (WORKFLOWS.md): A catalog of our .forgejo and GitHub Actions synchronizations.
Tasks (TASKS.md): Open checklist of internal improvements.

🚀 Quick Launch (Dev)

If you are a new developer or setting up the environment post-clone, rely on our interactive script:

cd /path/to/gohorsejobs
./start.sh

Options overview:

1: General Start (Frontend + Backend)
2: Fresh Start (Reset Postgres Data -> Run Migrations -> Seed Core Data -> Start)
3: God Mode (Frontend + Backend + Backoffice)

🚨 Final Notice

Do NOT alter base configuration settings (such as encryption secrets, or Kubernetes k3s/k8s manifests) unless explicitly guided by the Lead Engineer or following the strict protocols in .agent/rules.md.