Merge pull request #11 from C216-Distribuid-System-Project/develop

 Backend To-Do List Setup and Authentication

Author: AlvaroLucioRibeiro

.gitignore

@@ -205,3 +205,4 @@ cython_debug/
 marimo/_static/
 marimo/_lsp/
 __marimo__/
+ToDovenv/

database/02_seed.sql

@@ -0,0 +1,23 @@
+-- insert users
+INSERT INTO users (name, email, phone, birth_date, password_hash)
+VALUES
+  ('Alice Silva', 'alice@example.com', '11999999999', '1995-05-10', '$2b$12$hashfakealice'),
+  ('Bruno Costa', 'bruno@example.com', '21988888888', '1990-07-22', '$2b$12$hashfakebruno'),
+  ('Carla Mendes', 'carla@example.com', '31977777777', '1988-11-03', '$2b$12$hashfakecarla');
+
+-- insert projects
+INSERT INTO projects (user_id, title, description)
+VALUES
+  (1, 'Projeto Casa', 'Organizar tarefas domésticas'),
+  (1, 'Trabalho', 'Atividades da empresa'),
+  (2, 'Viagem', 'Planejamento da viagem para 2025');
+
+-- insert tasks
+INSERT INTO tasks (user_id, project_id, title, description, due_date, reminder, completed)
+VALUES
+  (1, 1, 'Lavar roupa', 'Separar roupas coloridas e brancas', '2025-09-30 18:00:00', TRUE, FALSE),
+  (1, 1, 'Comprar mantimentos', 'Ir ao mercado comprar frutas e verduras', '2025-09-25 20:00:00', FALSE, FALSE),
+  (1, 2, 'Revisar relatório', 'Revisão do relatório trimestral', '2025-09-28 10:00:00', TRUE, FALSE),
+  (2, 3, 'Reservar hotel', 'Hotel em Florianópolis', '2025-10-10 12:00:00', TRUE, FALSE),
+  (2, 3, 'Comprar passagens', 'Passagens aéreas ida e volta', '2025-09-27 15:00:00', FALSE, TRUE),
+  (3, NULL, 'Estudar Python', 'Praticar FastAPI para o backend', '2025-09-26 19:00:00', FALSE, FALSE);

database/database_schema.sql

@@ -0,0 +1,66 @@
+-- Create the database if it doesn't exist
+-- and set the character set and collation
+CREATE DATABASE IF NOT EXISTS todolist
+  CHARACTER SET utf8mb4
+  COLLATE utf8mb4_0900_ai_ci;
+
+USE todolist;
+
+-- 1) USERS
+CREATE TABLE IF NOT EXISTS users (
+  id             INT AUTO_INCREMENT PRIMARY KEY,
+  name           VARCHAR(255)         NOT NULL,
+  email          VARCHAR(255)         NOT NULL UNIQUE,
+  phone          VARCHAR(20)          NULL,
+  birth_date     DATE                 NULL,
+  password_hash  VARCHAR(255)         NOT NULL,
+  created_at     TIMESTAMP            NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  updated_at     TIMESTAMP            NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
+) ENGINE=InnoDB;
+
+-- 2) PROJECTS
+CREATE TABLE IF NOT EXISTS projects (
+  id           INT AUTO_INCREMENT PRIMARY KEY,
+  user_id      INT                  NOT NULL,
+  title        VARCHAR(255)         NOT NULL,
+  description  TEXT                 NULL,
+  created_at   TIMESTAMP            NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  updated_at   TIMESTAMP            NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+  CONSTRAINT fk_projects_user
+    FOREIGN KEY (user_id) REFERENCES users(id)
+    ON DELETE CASCADE
+    ON UPDATE CASCADE
+) ENGINE=InnoDB;
+
+-- 3) TASKS
+CREATE TABLE IF NOT EXISTS tasks (
+  id           INT AUTO_INCREMENT PRIMARY KEY,
+  user_id      INT                  NOT NULL,
+  project_id   INT                  NULL,
+  title        VARCHAR(255)         NOT NULL,
+  description  TEXT                 NULL,
+  due_date     DATETIME             NULL,
+  reminder     BOOLEAN              NOT NULL DEFAULT FALSE,
+  completed    BOOLEAN              NOT NULL DEFAULT FALSE,
+  created_at   TIMESTAMP            NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  updated_at   TIMESTAMP            NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
+  CONSTRAINT fk_tasks_user
+    FOREIGN KEY (user_id) REFERENCES users(id)
+    ON DELETE CASCADE
+    ON UPDATE CASCADE,
+  CONSTRAINT fk_tasks_project
+    FOREIGN KEY (project_id) REFERENCES projects(id)
+    ON DELETE SET NULL
+    ON UPDATE CASCADE
+) ENGINE=InnoDB;
+
+-- Indexes for performance optimization
+CREATE INDEX idx_users_email           ON users(email);
+CREATE INDEX idx_users_phone           ON users(phone);
+CREATE INDEX idx_projects_user         ON projects(user_id);
+CREATE INDEX idx_tasks_user            ON tasks(user_id);
+CREATE INDEX idx_tasks_project         ON tasks(project_id);
+CREATE INDEX idx_tasks_due_date        ON tasks(due_date);
+CREATE INDEX idx_tasks_completed       ON tasks(completed);
+CREATE INDEX idx_tasks_reminder        ON tasks(reminder);
+CREATE INDEX idx_tasks_user_completed  ON tasks(user_id, completed);

docker/API/Dockerfile

@@ -0,0 +1,13 @@
+FROM python:3.11-slim
+
+# Define the working directory inside the container
+WORKDIR /app
+
+# Copy the project files into the container
+COPY . .
+
+# Install dependencies
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Default command to run the API
+CMD ["python", "-m", "src.main"]

docker/MySQL/dockerfile

@@ -0,0 +1,11 @@
+FROM mysql:8.0
+
+# Pattern values for development; use secrets or env vars in production setups
+ENV MYSQL_DATABASE=todolist
+ENV MYSQL_USER=app
+ENV MYSQL_PASSWORD=app_pass
+ENV MYSQL_ROOT_PASSWORD=root_pass
+
+# Copy schema SQL file to the container's initialization directory
+COPY ../../database/database_schema.sql /docker-entrypoint-initdb.d/01_schema.sql
+COPY ../../database/02_seed.sql /docker-entrypoint-initdb.d/02_seed.sql

docker/docker-compose.yaml

@@ -0,0 +1,49 @@
+services:
+  mysql:
+    build:
+      context: ..
+      dockerfile: docker/MySQL/dockerfile
+    image: todolist-mysql
+    container_name: todolist-mysql
+    environment:
+      MYSQL_ROOT_PASSWORD: root_pass
+      MYSQL_DATABASE: todolist
+      MYSQL_USER: app
+      MYSQL_PASSWORD: app_pass
+    ports:
+      - "3307:3306"
+    volumes:
+      - mysql_data:/var/lib/mysql
+    
+  mysql-test:
+    build:
+      context: ..
+      dockerfile: docker/MySQL/dockerfile
+    image: todolist-mysql
+    container_name: todolist-mysql-test
+    environment:
+      MYSQL_ROOT_PASSWORD: root_pass
+      MYSQL_DATABASE: todolist
+      MYSQL_USER: app_test
+      MYSQL_PASSWORD: app_pass_test
+    ports:
+      - "3308:3306"
+    volumes:
+      - mysql_data_test:/var/lib/mysql
+
+  api:
+    build:
+      context: ..
+      dockerfile: docker/API/Dockerfile
+    image: todolist-api
+    container_name: api-container
+    depends_on:
+      - mysql
+    ports:
+      - "8000:8000"
+    environment:
+      DATABASE_URL: "mysql+pymysql://app:app_pass@mysql:3306/todolist"
+
+volumes:
+  mysql_data:
+  mysql_data_test:

docs/en/api_docker_documentation_en.md

@@ -0,0 +1,103 @@
+# Docker for the API
+
+## How the Dockerfile Works
+
+The file [`docker/API/dockerfile`](../../docker/API/dockerfile) is responsible for creating a custom image of the **API** built with **FastAPI**.
+
+### Step by step of what it does:
+
+1. **Base image**
+   ```dockerfile
+   FROM python:3.11-slim
+   ```
+   Uses the official Python 3.11 slim image (lighter version).
+
+2. **Working directory**
+   ```dockerfile
+   WORKDIR /app
+   ```
+   Sets `/app` as the working directory inside the container.
+
+3. **Copy project files**
+   ```dockerfile
+   COPY . .
+   ```
+   Copies the entire project into the container.
+
+4. **Install dependencies**
+   ```dockerfile
+   RUN pip install --no-cache-dir -r requirements.txt
+   ```
+   Installs all dependencies listed in `requirements.txt`.
+
+5. **Run the API**
+   ```dockerfile
+   CMD ["python", "src/main.py"]
+   ```
+   Starts the API using the `src/main.py` file.
+
+---
+
+## How to Run the API
+
+### 1. Build the image
+At the root of the project, run:
+```bash
+docker build -f docker/API/Dockerfile -t api-fastapi .
+```
+
+This creates the image `api-fastapi`.
+
+---
+
+### 2. Run the container
+```bash
+docker run -d --name api-container -p 8000:8000 api-fastapi
+```
+
+Explanation of the parameters:
+- `-d` → runs in background  
+- `--name api-container` → container name  
+- `-p 8000:8000` → maps local port 8000 to container port 8000  
+- `api-fastapi` → name of the image created  
+
+---
+
+## Accessing the API
+
+Once the container is running, the API will be available at:
+
+```
+http://localhost:8000
+```
+
+If Swagger is enabled in your FastAPI project, the interactive documentation will be available at:
+
+```
+http://localhost:8000/docs
+```
+
+---
+
+## Useful Commands
+
+### Access container terminal
+```bash
+docker exec -it api-container bash
+```
+
+### Stop the container
+```bash
+docker stop api-container
+```
+
+### Restart a stopped container
+```bash
+docker start api-container
+```
+
+### Remove the container
+```bash
+docker rm -f api-container
+```
+