cria base para migração da estrutura

.env.example

@@ -2,6 +2,11 @@ TZ=UTC
 PORT=3000
 NODE_ENV=development
 
+# Optional: CORS (used by Application). Comma-separated origins, or * for all.
+CORS_ORIGINS=*
+CORS_METHODS=HEAD,GET,POST,PUT,PATCH,DELETE
+CORS_ALLOWED_HEADERS=Content-Type,Authorization
+
 STORAGE_PATH=./uploads
 
 MYSQL_DATABASE=herbario_dev

.github/workflows/pull_request.yml

@@ -18,7 +18,7 @@ jobs:
       - name: Run checks
         run: yarn lint
 
-  test:
+  unit-test:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout code
@@ -29,8 +29,8 @@ jobs:
           node-version: 'lts/jod'
       - name: Install dependencies
         run: yarn install --frozen-lockfile
-      - name: Run tests with coverage
-        run: yarn test --silent --coverage
+      - name: Run unit tests with coverage
+        run: yarn test:coverage
       - name: Archive code coverage results
         uses: actions/upload-artifact@v4
         with:
@@ -39,6 +39,47 @@ jobs:
           retention-days: 7
           overwrite: true
 
+  integration-test:
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    env:
+      PG_HOST: localhost
+      PG_PORT: 5432
+      PG_DATABASE: herbario_test
+      PG_USERNAME: postgres
+      PG_PASSWORD: testpassword
+      PG_MIGRATION_USERNAME: postgres
+      PG_MIGRATION_PASSWORD: testpassword
+    services:
+      postgres:
+        image: postgis/postgis:18-3.6
+        env:
+          POSTGRES_DB: herbario_test
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: testpassword
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      - name: Setup environment
+        uses: actions/setup-node@v4
+        with:
+          node-version: 'lts/jod'
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile
+      - name: Apply base schema
+        run: psql -h $PG_HOST -p $PG_PORT -U $PG_MIGRATION_USERNAME -d $PG_DATABASE -f test/integration/setup/schema.sql
+        env:
+          PGPASSWORD: ${{ env.PG_MIGRATION_PASSWORD }}
+      - name: Run integration tests
+        run: yarn test:integration
+
   build:
     runs-on: ubuntu-latest
     steps:

.gitignore

@@ -17,3 +17,5 @@ reports/data/settings
 
 *.log
 npm-debug.log
+
+NOTES.md

.husky/pre-push

@@ -1 +1 @@
-npm run test --silent
+npm run test:unit -- --silent

Dockerfile

@@ -77,4 +77,9 @@ USER hcf_api
 
 EXPOSE $PORT
 
-CMD node dist/index.js
+HEALTHCHECK \
+  --interval=30s --timeout=5s \
+  --start-period=40s --retries=3 \
+  CMD wget -qO- http://127.0.0.1:$PORT/health || exit 1
+
+CMD node dist/application/index.js

build.mjs

@@ -7,20 +7,20 @@ rmSync('dist', { recursive: true, force: true })
 const assets = globSync('src/**/*.{ejs,html,ttf,css}')
 
 await build({
-    entryPoints: [
-        ...assets,
-        'src/index.js',
-    ],
-    outdir: 'dist',
-    bundle: true,
-    minify: true,
-    platform: 'node',
-    target: 'node20',
-    packages: 'external',
-    loader: {
-        '.ejs': 'copy',
-        '.html': 'copy',
-        '.ttf': 'copy',
-        '.css': 'copy',
-    }
+  entryPoints: [
+    ...assets,
+    'src/application/index.js',
+  ],
+  outdir: 'dist',
+  bundle: true,
+  minify: true,
+  platform: 'node',
+  target: 'node20',
+  packages: 'external',
+  loader: {
+    '.ejs': 'copy',
+    '.html': 'copy',
+    '.ttf': 'copy',
+    '.css': 'copy',
+  }
 })

compose.integration.yml

@@ -0,0 +1,14 @@
+services:
+  postgres:
+    image: postgis/postgis:18-3.6
+    container_name: herbario_postgresql_e2e
+    environment:
+      POSTGRES_DB: herbario_e2e
+      POSTGRES_USER: postgres
+      POSTGRES_PASSWORD: testpassword
+    ports:
+      - "5433:5432"
+    volumes:
+      - ./test/integration/setup/schema.sql:/docker-entrypoint-initdb.d/schema.sql:ro
+    tmpfs:
+      - /var/lib/postgresql

eslint.config.mjs

@@ -159,6 +159,22 @@ export default defineConfig([
       '@stylistic/object-property-newline': [
         'error',
         { allowAllPropertiesOnSameLine: true }
+      ],
+      '@stylistic/operator-linebreak': [
+        'warn',
+        'before',
+        { overrides: { '=': 'after' } }
+      ],
+      '@stylistic/quote-props': [
+        'error',
+        'as-needed'
+      ],
+      'no-restricted-syntax': [
+        'warn',
+        {
+          message: 'Use EnumOf pattern instead of TypeScript enums.',
+          selector: 'TSEnumDeclaration'
+        }
       ]
     }
   },

package.json

@@ -2,7 +2,7 @@
 	"name": "hcf-api",
 	"version": "0.1.1",
 	"description": "Projeto para construção da API para o sistema do Herbário da UTFPR",
-	"main": "dist/app/index.js",
+	"main": "dist/application/index.js",
 	"author": "Elaine Sangali <e.nani@gmail.com>",
 	"license": "MIT",
 	"private": true,
@@ -15,10 +15,14 @@
 		"tsc:check": "tsc --noEmit",
 		"lint:eslint": "eslint --cache",
 		"lint": "run-p tsc:check lint:eslint",
-		"start": "tsx --watch --env-file=.env src/index.js",
+		"start": "tsx --watch --env-file=.env src/application/index.js",
 		"build": "node build.mjs",
 		"test": "vitest --run",
-		"test:coverage": "vitest --run --coverage",
+		"test:unit": "vitest --run --project unit",
+    "test:unit:watch": "vitest --project unit",
+		"test:integration": "vitest --run --project integration",
+    "test:integration:watch": "vitest --project integration",
+		"test:coverage": "vitest --run --project unit --coverage",
 		"prepare": "husky",
 		"audit": "npm audit --audit-level=moderate",
 		"audit:fix": "npm audit fix"
@@ -62,10 +66,14 @@
 	"devDependencies": {
 		"@eslint/js": "9.39.1",
 		"@stylistic/eslint-plugin": "5.5.0",
+		"@types/cors": "2.8.19",
 		"@types/express": "5.0.5",
+		"@types/morgan": "1.9.10",
 		"@types/pg": "^8.16.0",
 		"@types/react": "19.2.2",
 		"@types/react-dom": "19.2.2",
+		"@types/supertest": "7.2.0",
+		"@types/swagger-ui-express": "^4.1.8",
 		"@vitest/coverage-v8": "4.0.7",
 		"chai": "6.2.0",
 		"chai-http": "^5.1.2",
@@ -77,9 +85,9 @@
 		"husky": "9.1.7",
 		"npm-run-all": "4.1.5",
 		"tsx": "4.21.0",
+		"supertest": "7.2.2",
 		"typescript": "5.9.3",
 		"typescript-eslint": "8.46.3",
 		"vitest": "4.0.7"
-	},
-	"packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"
+	}
 }