Features de turmas

.cypress-cucumber-preprocessorrc.json

@@ -0,0 +1,8 @@
+{
+  "stepDefinitions": [
+    "cypress/e2e/stepDefinitions/**/*.js"
+  ],
+  "messages": {
+    "enabled": false
+  }
+}

.gitignore

@@ -1,13 +1,60 @@
+# Dependencies
 node_modules/
+package-lock.json
+
+# Build outputs
 server/dist/
 client/build/
 
-# Cucumber test reports
+# TypeScript
+*.tsbuildinfo
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Environment
+.env
+.env.local
+
+# Test files
+test-*.csv
+test-*.xlsx
+test-*.js
+
+# Cypress
+cypress/videos/
+cypress/screenshots/
+cypress/downloads/
+
+# Cucumber test reports (client-side)
 client/reports/
 cucumber-report.*
 
-# jest coverage directory
+# Jest coverage directory
 coverage/
 
-# multer folder
-tmp_data/
+# Multer temporary folder
+tmp_data/
+
+# Notes
+notes/
+
+# Extra (local documentation files)
+commit_log.txt
+demo.csv
+diff_log.txt
+FEATURE_SUMMARY.md

CYPRESS_SETUP.md

@@ -0,0 +1,107 @@
+# Cypress + Cucumber Setup Guide
+
+## Installation Steps
+
+### 1. Install Dependencies
+
+Run the following command from the project root:
+
+```bash
+npm install
+```
+
+This will install Cypress 15.7.0 and the Cucumber preprocessor along with all required dependencies.
+
+### 2. Verify Installation
+
+Check that Cypress was installed successfully:
+
+```bash
+npx cypress --version
+```
+
+You should see output similar to:
+```
+Cypress package version: 15.7.0
+Cypress binary version: 15.7.0
+```
+
+### 3. Project Structure
+
+The following structure has been created:
+
+```
+cypress/
+├── e2e/
+│   ├── features/              # Gherkin .feature files go here
+│   │   └── placeholder.feature
+│   └── stepDefinitions/       # Step definition .js files go here
+│       └── placeholder.js
+├── fixtures/                  # Test data files (CSV, JSON, etc.)
+├── support/
+│   ├── commands.js           # Custom Cypress commands
+│   └── e2e.js                # Global configuration
+└── README.md
+
+Root files:
+├── cypress.config.js                           # Main Cypress configuration
+└── .cypress-cucumber-preprocessorrc.json       # Cucumber preprocessor config
+```
+
+### 4. Running Tests
+
+Make sure both server and client are running before executing tests:
+
+**Terminal 1 - Start Server:**
+```bash
+cd server
+npm run dev
+```
+
+**Terminal 2 - Start Client:**
+```bash
+cd client
+npm start
+```
+
+**Terminal 3 - Run Cypress Tests:**
+
+Interactive mode (Test Runner UI):
+```bash
+npm run cypress:open
+```
+
+Headless mode (CI/CD):
+```bash
+npm run cypress:run
+```
+
+### 5. Next Steps
+
+The structure is now ready. You can:
+- Add actual `.feature` files in `cypress/e2e/features/`
+- Implement step definitions in `cypress/e2e/stepDefinitions/`
+- Add test fixtures (upload files, etc.) in `cypress/fixtures/`
+
+### Configuration Details
+
+**cypress.config.js:**
+- Base URL: `http://localhost:3004` (React client)
+- Spec pattern: `cypress/e2e/features/**/*.feature`
+- Cucumber preprocessor integration with Browserify
+
+**.cypress-cucumber-preprocessorrc.json:**
+- Step definitions path: `cypress/e2e/stepDefinitions/**/*.js`
+- Uses require() syntax as per Cucumber preprocessor standards
+
+**Custom Commands (cypress/support/commands.js):**
+- `cy.cleanupTestData()` - Delete test data via API
+- `cy.createTestClass()` - Create a class via API
+- `cy.createTestStudent()` - Create a student via API
+
+### Important Notes
+
+1. **Syntax:** Always use `const { Given, When, Then } = require("@badeball/cypress-cucumber-preprocessor");`
+2. **Language:** Code in English, with explanatory comments
+3. **Self-contained tests:** Create and cleanup data within each test
+4. **API endpoints:** Server runs on port 3001, Client on port 3004

README.md

@@ -164,6 +164,57 @@ The server provides a REST API:
 
 The application uses ports 3005 and 3004 to avoid conflicts with other applications that might be using ports 3000-3003.
 
+## Running Cucumber Tests
+
+### Method 1: Using the Test Runner Script (Recommended)
+
+```bash
+# From the client directory
+./run-cucumber-tests.sh
+```
+
+This script will:
+- Check if both server and client are running
+- Run all Cucumber tests
+- Generate HTML and JSON reports
+
+### Method 2: Manual Execution
+
+```bash
+# From the client directory
+npm run test -- --watchAll
+```
+
+### Details
+
+Testing with cucumber is further detailed in the /client/CUCUMBER_TESTING.md file.
+
+## Running Cypress Tests
+
+### Option 1: Interactive Mode (Cypress Test Runner)
+
+Open the Cypress Test Runner UI:
+```bash
+npx cypress run open
+```
+
+1. Select "E2E Testing"
+2. Choose your browser
+3. Click on `classComparison.feature`
+4. Watch the test run in real-time
+
+### Option 2: Headless Mode (CI/CD)
+
+Run all tests in headless mode:
+```bash
+npx cypress run
+```
+
+Or run a specific feature, e.g.:
+```bash
+npx cypress run --spec "cypress/e2e/features/classComparison.feature"
+```
+
 ## License
 
 ISC

client/CUCUMBER_TESTING.md

@@ -27,14 +27,7 @@ This script will:
 
 ```bash
 # From the client directory
-npm run test:cucumber
-```
-
-### Method 3: Watch Mode (for development)
-
-```bash
-# From the client directory
-npm run test:cucumber:watch
+npm run test -- --watchAll
 ```
 
 ## 🧪 Test Structure

client/cucumber.js

@@ -1,7 +1,7 @@
 module.exports = {
   default: {
+    requireModule: ['ts-node/register'],
     require: [
-      'ts-node/register',
       'src/step-definitions/**/*.ts'
     ],
     format: [
@@ -12,7 +12,6 @@ module.exports = {
     formatOptions: {
       snippetInterface: 'async-await'
     },
-    paths: ['src/features/**/*.feature'],
-    requireModule: ['ts-node/register']
+    paths: ['src/features/**/*.feature']
   }
 };