History

root 6ae4f01f5c Some checks are pending Deploy Backend and Backoffice Dev / build-and-push (push) Waiting to run Details Deploy Backend and Backoffice Dev / deploy (push) Blocked by required conditions Details docs(tasks): Mark video interviews as postponed Record the product decision to keep the video interviews endpoint out of scope for now.\nThis keeps the sprint backlog aligned with current priorities on dev. Co-Authored-By: Claude <noreply@anthropic.com>		2026-03-09 20:49:09 +01:00
..
context	docs: detalha gestão de credenciais via banco de dados	2026-03-07 18:15:09 -03:00
txt	test: increase backend use case coverage	2026-02-16 23:25:26 -03:00
AGENTS.md	docs: update documentation with new features and security analysis	2026-02-25 05:51:06 -06:00
API.md	docs: update documentation with new features and security analysis	2026-02-25 05:51:06 -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
BACKEND_SECURITY.md	docs: update documentation with new features and security analysis	2026-02-25 05:51:06 -06: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
MCP_INTEGRATION.md	feat(config): Add MCP JSON bootstrap and unify docs	2026-03-09 20:39:16 +01: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	feat(config): Add MCP JSON bootstrap and unify docs	2026-03-09 20:39:16 +01:00
ROADMAP.md	docs: unifica documentação e atualiza README principal	2026-02-14 17:07:11 -03:00
TASKS.md	docs(tasks): Mark video interviews as postponed	2026-03-09 20:49:09 +01: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
UNIFIED_STATUS.md	feat(config): Add MCP JSON bootstrap and unify docs	2026-03-09 20:39:16 +01: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.
MCP Integration (MCP_INTEGRATION.md): JSON-based integration for infra/cloud/database bootstrap.
Unified Status (UNIFIED_STATUS.md): Consolidated view of docs + pending activities on dev.

🔌 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.