feat: initialize frontend with React, Vite, and Tailwind CSS

- Added package.json for project dependencies and scripts.
- Configured PostCSS with Tailwind CSS.
- Created main application structure with App component and routing.
- Implemented API client for handling requests with Axios.
- Developed authentication API for login, logout, and user verification.
- Created entities API for managing virtual entities.
- Implemented logs API for fetching dispatch logs.
- Added navigation bar component for app navigation.
- Created protected route component for route guarding.
- Set up global CSS with Tailwind directives.
- Configured main entry point for React application.
- Developed basic Dashboard and Login pages.
- Set up router for application navigation.
- Added Jest testing setup for testing library.
- Configured Tailwind CSS with content paths.
- Set TypeScript configuration for frontend.
- Created Vite configuration for development and production builds.
- Added Nginx configuration for serving the application and proxying API requests.

frontend/src/App.tsx

@@ -0,0 +1,6 @@
+import { RouterProvider } from 'react-router-dom'
+import { router } from './router'
+
+export default function App() {
+  return <RouterProvider router={router} />
+}

frontend/src/api/apiClient.ts

@@ -0,0 +1,11 @@
+import axios from 'axios'
+
+const apiClient = axios.create({
+  baseURL: '/api',
+  withCredentials: true,
+  headers: {
+    'Content-Type': 'application/json',
+  },
+})
+
+export default apiClient

frontend/src/api/authApi.ts

@@ -0,0 +1,21 @@
+import apiClient from './apiClient'
+
+export interface LoginRequest {
+  password: string
+}
+
+/** POST /api/auth/login — validates password, sets httpOnly JWT cookie on success. */
+export async function login(data: LoginRequest): Promise<void> {
+  await apiClient.post('/auth/login', data)
+}
+
+/** POST /api/auth/logout — clears the JWT cookie. */
+export async function logout(): Promise<void> {
+  await apiClient.post('/auth/logout')
+}
+
+/** GET /api/auth/me — verifies the current JWT cookie is valid. */
+export async function getMe(): Promise<{ message: string }> {
+  const response = await apiClient.get<{ message: string }>('/auth/me')
+  return response.data
+}

frontend/src/api/entitiesApi.ts

@@ -0,0 +1,58 @@
+import apiClient from './apiClient'
+
+export interface VirtualEntityResponse {
+  id: string
+  name: string
+  email: string
+  jobTitle: string
+  personality: string
+  scheduleCron: string
+  contextWindowDays: number
+  active: boolean
+  createdAt: string
+}
+
+export interface VirtualEntityCreateDto {
+  name: string
+  email: string
+  jobTitle: string
+  personality: string
+  scheduleCron: string
+  contextWindowDays: number
+}
+
+export type VirtualEntityUpdateDto = Partial<VirtualEntityCreateDto>
+
+/** GET /api/v1/virtual-entities — list all virtual entities. */
+export async function getEntities(): Promise<VirtualEntityResponse[]> {
+  const response = await apiClient.get<VirtualEntityResponse[]>('/v1/virtual-entities')
+  return response.data
+}
+
+/** GET /api/v1/virtual-entities/:id — get one entity by id. */
+export async function getEntity(id: string): Promise<VirtualEntityResponse> {
+  const response = await apiClient.get<VirtualEntityResponse>(`/v1/virtual-entities/${id}`)
+  return response.data
+}
+
+/** POST /api/v1/virtual-entities — create a new entity. */
+export async function createEntity(data: VirtualEntityCreateDto): Promise<VirtualEntityResponse> {
+  const response = await apiClient.post<VirtualEntityResponse>('/v1/virtual-entities', data)
+  return response.data
+}
+
+/** PUT /api/v1/virtual-entities/:id — update an entity. */
+export async function updateEntity(id: string, data: VirtualEntityUpdateDto): Promise<VirtualEntityResponse> {
+  const response = await apiClient.put<VirtualEntityResponse>(`/v1/virtual-entities/${id}`, data)
+  return response.data
+}
+
+/** DELETE /api/v1/virtual-entities/:id — soft-delete (deactivate) an entity. */
+export async function deleteEntity(id: string): Promise<void> {
+  await apiClient.delete(`/v1/virtual-entities/${id}`)
+}
+
+/** POST /api/v1/virtual-entities/:id/trigger — manually trigger the entity pipeline. */
+export async function triggerEntity(id: string): Promise<void> {
+  await apiClient.post(`/v1/virtual-entities/${id}/trigger`)
+}

frontend/src/api/logsApi.ts

@@ -0,0 +1,27 @@
+import apiClient from './apiClient'
+
+export type DispatchStatus = 'PENDING' | 'SENT' | 'FAILED'
+
+export interface DispatchLogResponse {
+  id: string
+  entityId: string
+  promptSent: string
+  aiResponse: string
+  emailSubject: string
+  emailBody: string
+  status: DispatchStatus
+  errorMessage: string | null
+  dispatchedAt: string
+}
+
+/** GET /api/v1/dispatch-logs — list all dispatch logs. */
+export async function getLogs(): Promise<DispatchLogResponse[]> {
+  const response = await apiClient.get<DispatchLogResponse[]>('/v1/dispatch-logs')
+  return response.data
+}
+
+/** GET /api/v1/dispatch-logs/entity/:id — list logs for a specific entity. */
+export async function getLogsByEntity(entityId: string): Promise<DispatchLogResponse[]> {
+  const response = await apiClient.get<DispatchLogResponse[]>(`/v1/dispatch-logs/entity/${entityId}`)
+  return response.data
+}

frontend/src/components/NavBar.tsx

@@ -0,0 +1,29 @@
+import { Link, useLocation } from 'react-router-dom'
+
+const NAV_LINKS = [
+  { to: '/', label: 'Dashboard' },
+  { to: '/entities', label: 'Entities' },
+  { to: '/logs', label: 'Logs' },
+]
+
+/** Top navigation bar for authenticated pages. */
+export default function NavBar() {
+  const { pathname } = useLocation()
+
+  return (
+    <nav className="border-b bg-white">
+      <div className="mx-auto flex max-w-7xl items-center gap-6 px-4 py-3">
+        <span className="font-semibold text-gray-900">Condado SA</span>
+        {NAV_LINKS.map(({ to, label }) => (
+          <Link
+            key={to}
+            to={to}
+            className={`text-sm ${pathname === to ? 'font-semibold text-blue-600' : 'text-gray-600 hover:text-gray-900'}`}
+          >
+            {label}
+          </Link>
+        ))}
+      </div>
+    </nav>
+  )
+}

frontend/src/components/ProtectedRoute.tsx

@@ -0,0 +1,22 @@
+import { type ReactNode } from 'react'
+import { Navigate } from 'react-router-dom'
+import { useQuery } from '@tanstack/react-query'
+import { getMe } from '../api/authApi'
+
+interface ProtectedRouteProps {
+  children: ReactNode
+}
+
+/** Redirects to /login if the current JWT session is not valid. */
+export default function ProtectedRoute({ children }: ProtectedRouteProps) {
+  const { data, isLoading, isError } = useQuery({
+    queryKey: ['auth', 'me'],
+    queryFn: getMe,
+    retry: false,
+  })
+
+  if (isLoading) return <div>Loading...</div>
+  if (isError || !data) return <Navigate to="/login" replace />
+
+  return <>{children}</>
+}

frontend/src/index.css

@@ -0,0 +1,3 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;

frontend/src/main.tsx

@@ -0,0 +1,22 @@
+import React from 'react'
+import ReactDOM from 'react-dom/client'
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
+import App from './App'
+import './index.css'
+
+const queryClient = new QueryClient({
+  defaultOptions: {
+    queries: {
+      retry: 1,
+      staleTime: 30_000,
+    },
+  },
+})
+
+ReactDOM.createRoot(document.getElementById('root')!).render(
+  <React.StrictMode>
+    <QueryClientProvider client={queryClient}>
+      <App />
+    </QueryClientProvider>
+  </React.StrictMode>,
+)

frontend/src/pages/DashboardPage.tsx

@@ -0,0 +1,8 @@
+export default function DashboardPage() {
+  return (
+    <div className="p-8">
+      <h1 className="text-2xl font-bold text-gray-900">Dashboard</h1>
+      <p className="mt-2 text-sm text-gray-500">Dashboard — coming in Step 11.</p>
+    </div>
+  )
+}

frontend/src/pages/LoginPage.tsx

@@ -0,0 +1,12 @@
+export default function LoginPage() {
+  return (
+    <div className="flex min-h-screen items-center justify-center bg-gray-50">
+      <div className="w-full max-w-sm rounded-lg bg-white p-8 shadow">
+        <h1 className="mb-6 text-2xl font-bold text-gray-900">
+          Condado Abaixo da Média SA
+        </h1>
+        <p className="text-sm text-gray-500">Login page — coming in Step 11.</p>
+      </div>
+    </div>
+  )
+}

frontend/src/router/index.tsx

@@ -0,0 +1,24 @@
+import { createBrowserRouter } from 'react-router-dom'
+import { lazy, Suspense } from 'react'
+
+const LoginPage = lazy(() => import('../pages/LoginPage'))
+const DashboardPage = lazy(() => import('../pages/DashboardPage'))
+
+export const router = createBrowserRouter([
+  {
+    path: '/login',
+    element: (
+      <Suspense fallback={<div>Loading...</div>}>
+        <LoginPage />
+      </Suspense>
+    ),
+  },
+  {
+    path: '/',
+    element: (
+      <Suspense fallback={<div>Loading...</div>}>
+        <DashboardPage />
+      </Suspense>
+    ),
+  },
+])

frontend/src/test/setup.ts

@@ -0,0 +1 @@
+import '@testing-library/jest-dom'