matheus-neves / challenge-database-upload

Challenge 06: Database and file upload in Node.js

Challenge 06: Database and file upload in Node.js

About the Challenge   |    Technologies   |    Routes   |    Installation

🚀 About the Challenge

Application that stores incoming and outgoing financial transactions, allowing the registration and listing of these transactions, in addition to allowing the creation of new records in the database by sending a csv file.

Technologies

• Node.js
• Express
• Multer
• CSV Parser
• Typescript
• TypeORM

Routes

• POST /transactions

{
  "id": "uuid",
  "title": "Salary",
  "value": 3000,
  "type": "income",
  "category": "Lorem"
}

• GET /transactions

{
  "transactions": [
    {
      "id": "uuid",
      "title": "Freelance",
      "value": 4000,
      "type": "income",
      "category": {
        "id": "uuid",
        "title": "Salary"
      }
    },
    {
      "id": "uuid",
      "title": "Salary",
      "value": 2000,
      "type": "income",
      "category": {
        "id": "uuid",
        "title": "Others"
      }
    },
    {
      "id": "uuid",
      "title": "Payment",
      "value": 4000,
      "type": "outcome",
      "category": {
        "id": "uuid",
        "title": "Others"
      }
    },
    {
      "id": "uuid",
      "title": "Product Lorem",
      "value": 1200,
      "type": "outcome",
      "category": {
        "id": "uuid",
        "title": "Shopping"
      }
    }
  ],
  "balance": {
    "income": 6000,
    "outcome": 5200,
    "total": 800
  }
}

Within balance, income is the sum of all transaction values ​​with type income. The outcome is the sum of all transaction values ​​with type outcome, and the total is the value of income - outcome.

• DELETE /transactions/:id

• POST /transactions/import The csv file must follow the model

Installation

Run Server

1. Clone the repository: [e-mail]:matheus-neves/challenge-database-upload.git
2. Access the directory: cd challenge-database-upload
3. Install the dependencies: yarn
4. Run the server: yarn dev:server
5. Server running in http://localhost:3333/

Database

1. Install Docker https://www.docker.com/get-started and check if was installed with the command: docker version
2. Run the command docker run --name gostack_postgres -e POSTGRES_PASSWORD=docker -p 5432:5432 -d postgres
3. Verify if container was created docker ps -a
4. Create a database with name gostack_challenge06

📝 License

This challenge is under license from MIT. See the archive LICENSE for more details.

---

Challenge completed ✔️by Matheus Neves and created with 💜by Rocketseat 👋 Join the community!