✨(infra) Enhanced Docker configuration, added a Makefile, README updated

Author: juliendemoutiez

Makefile

@@ -0,0 +1,110 @@
+.PHONY: help setup up down restart logs keycloak-wait init-db clean
+
+# Default values
+COMPOSE_FILE := docker-compose-dev.yml
+KEYCLOAK_URL := http://localhost:8080
+INITIAL_USER_EMAIL ?= user.test@anct.gouv.fr
+INITIAL_USER_PASSWORD ?= password
+INITIAL_USER_USERNAME ?= test.user
+INITIAL_USER_FIRST_NAME ?= Test
+INITIAL_USER_LAST_NAME ?= User
+
+help: ## Show this help message
+	@echo "Available targets:"
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | awk 'BEGIN {FS = ":.*?## "}; {printf "  \033[36m%-20s\033[0m %s\n", $$1, $$2}'
+
+bootstrap: ## Complete setup: start services and initialize database
+	@echo "🚀 Starting complete setup..."
+	@$(MAKE) up
+	@echo "⏳ Waiting for services to be ready..."
+	@sleep 10
+	@$(MAKE) keycloak-wait
+	@$(MAKE) init-db
+	@echo "✅ Setup complete! Application is ready at http://localhost:3000"
+	@echo "   Keycloak Admin Console: http://localhost:8080 (admin/admin)"
+	@echo "   Keycloak realm is auto-imported from realm-export.json"
+
+up: ## Start all Docker services
+	@echo "🐳 Starting Docker services..."
+	docker-compose -f $(COMPOSE_FILE) up -d
+	@echo "✅ Services started. Use 'make logs' to view logs."
+
+down: ## Stop all Docker services
+	@echo "🛑 Stopping Docker services..."
+	docker-compose -f $(COMPOSE_FILE) down
+	@echo "✅ Services stopped."
+
+restart: ## Restart all Docker services
+	@echo "🔄 Restarting Docker services..."
+	$(MAKE) down
+	$(MAKE) up
+
+logs: ## Show logs from all services
+	docker-compose -f $(COMPOSE_FILE) logs -f
+
+logs-server: ## Show logs from server only
+	docker-compose -f $(COMPOSE_FILE) logs -f server
+
+logs-keycloak: ## Show logs from Keycloak only
+	docker-compose -f $(COMPOSE_FILE) logs -f keycloak
+
+keycloak-wait: ## Wait for Keycloak to be ready
+	@echo "⏳ Waiting for Keycloak to be ready..."
+	@timeout=60; \
+	while [ $$timeout -gt 0 ]; do \
+		if curl -s -f $(KEYCLOAK_URL)/realms/master/.well-known/openid-configuration > /dev/null 2>&1; then \
+			echo "✅ Keycloak is ready!"; \
+			break; \
+		fi; \
+		echo "   Waiting... ($$timeout seconds remaining)"; \
+		sleep 2; \
+		timeout=$$((timeout - 2)); \
+	done; \
+	if [ $$timeout -le 0 ]; then \
+		echo "❌ Timeout waiting for Keycloak"; \
+		exit 1; \
+	fi
+
+init-db: ## Initialize the database (migrations and seeds)
+	@echo "🗄️  Initializing database..."
+	@echo "   Waiting for postgres to be ready..."
+	@timeout=60; \
+	while [ $$timeout -gt 0 ]; do \
+		if docker-compose -f $(COMPOSE_FILE) exec -T postgres pg_isready -U user -d projets > /dev/null 2>&1; then \
+			break; \
+		fi; \
+		sleep 2; \
+		timeout=$$((timeout - 2)); \
+	done
+	@echo "   Running database migrations and seeds..."
+	docker-compose -f $(COMPOSE_FILE) run --rm \
+		-e DATABASE_URL=postgresql://user:password@postgres:5432/projets \
+		-e DEFAULT_ADMIN_EMAIL=$(INITIAL_USER_EMAIL) \
+		-e DEFAULT_ADMIN_PASSWORD=$(INITIAL_USER_PASSWORD) \
+		-e DEFAULT_ADMIN_NAME="$(INITIAL_USER_FIRST_NAME) $(INITIAL_USER_LAST_NAME)" \
+		-e DEFAULT_ADMIN_USERNAME=$(INITIAL_USER_USERNAME) \
+		server npm run db:init
+	@echo "✅ Database initialized successfully!"
+
+clean: ## Stop services and remove volumes (WARNING: deletes all data)
+	@echo "⚠️  WARNING: This will delete all data including databases!"
+	@read -p "Are you sure? [y/N] " -n 1 -r; \
+	echo; \
+	if [[ $$REPLY =~ ^[Yy]$$ ]]; then \
+		docker-compose -f $(COMPOSE_FILE) down -v; \
+		echo "✅ Cleanup complete. All volumes removed."; \
+	else \
+		echo "❌ Cleanup cancelled."; \
+	fi
+
+ps: ## Show status of all services
+	docker-compose -f $(COMPOSE_FILE) ps
+
+shell-server: ## Open a shell in the server container
+	docker-compose -f $(COMPOSE_FILE) exec server sh
+
+shell-keycloak: ## Open a shell in the Keycloak container
+	docker-compose -f $(COMPOSE_FILE) exec keycloak /bin/bash
+
+shell-postgres: ## Open a psql shell in the postgres container
+	docker-compose -f $(COMPOSE_FILE) exec postgres psql -U user -d projets

README.md

@@ -1,59 +1,157 @@
-# Planka
-#### Elegant open source project tracking.
+# Projets
 
-![David (path)](https://img.shields.io/github/package-json/v/plankanban/planka) ![Docker Pulls](https://img.shields.io/badge/docker_pulls-5M%2B-%23066da5) ![GitHub](https://img.shields.io/github/license/plankanban/planka)
+Projets is the project management tool for [La Suite territoriale](https://suiteterritoriale.anct.gouv.fr/).
 
-![](https://raw.githubusercontent.com/plankanban/planka/master/demo.gif)
+Built on [Planka](https://github.com/plankanban/planka), it provides a customized Kanban-style interface designed specifically for teams managing territorial and digital transformation projects.
 
-[**Client demo**](https://plankanban.github.io/planka) (without server features).
+![Node](https://img.shields.io/badge/node-22-green)
+![License]()
 
-## Features
+[![Deploy to Scalingo](https://cdn.scalingo.com/deploy/button.svg)](https://my.scalingo.com/deploy?source=https://github.com/suitenumerique/st-projects)
 
-- Create projects, boards, lists, cards, labels and tasks
-- Add card members, track time, set due dates, add attachments, write comments
-- Markdown support in card description and comments
-- Filter by members and labels
-- Customize project backgrounds
-- Real-time updates
-- Internal notifications
-- Multiple interface languages
-- Single sign-on via OpenID Connect
+## 🎯 Features
 
-## How to deploy Planka
+- **Project Management**: Create projects, boards, lists, cards, labels, and tasks
+- **Collaboration**: Add card members, track time, set due dates, add attachments, write comments
+- **Rich Content**: Markdown support in card descriptions and comments
+- **Filtering**: Filter by members and labels
+- **Real-time Updates**: Live synchronization across all clients
+- **Notifications**: Internal notification system
+- **Internationalization**: Multiple interface languages (French, English)
+- **Single Sign-On**: OpenID Connect (OIDC) authentication via Keycloak
+- **Modern UI**: Built with React and modern design components
 
-There are many ways to install Planka, [check them out](https://docs.planka.cloud/docs/intro).
+## 🏗️ Architecture
 
-For configuration, please see the [configuration section](https://docs.planka.cloud/docs/category/configuration).
+Projets is a full-stack application with the following components:
 
-## Mobile app
+### Frontend (`client/`)
 
-Here is the [mobile app repository](https://github.com/LouisHDev/planka_app) maintained by the community, where you can build an app for iOS and Android.
+- **Framework**: React 19 with Redux for state management
+- **UI Libraries**:
+  - @gouvfr-lasuite/ui-kit
+  - @openfun/cunningham-react
+- **Key Features**:
+  - Redux-Saga for side effects
+  - Redux-ORM for data modeling
+  - React Router for navigation
+  - Socket.io client for real-time updates
+  - i18next for internationalization
 
-Alternatively, you can download the [Android APK](https://github.com/LouisHDev/planka_app/releases/latest/download/app-release.apk) directly.
+### Backend (`server/`)
 
-If you have an iOS device and would like to test the app, you can join [TestFlight](https://testflight.apple.com/join/Uwn41eY4) (limited to 200 participants).
+- **Framework**: Sails.js (Node.js MVC framework)
+- **Database**: PostgreSQL with Knex.js query builder
+- **Authentication**: OpenID Connect (OIDC) via Keycloak
+- **Real-time**: Socket.io for WebSocket connections
+- **File Storage**: AWS S3 compatible storage for attachments
 
-## Contact
+### Infrastructure
 
-- If you want to get a hosted version of Planka, you can contact us via email contact@planka.cloud
-- For any security issues, please do not create a public issue on GitHub, instead please write to security@planka.cloud
+- **Database**: PostgreSQL 16
+- **Authentication Server**: Keycloak (OIDC provider)
+- **Reverse Proxy**: Nginx
+- **Containerization**: Docker & Docker Compose
 
-We do NOT offer any public support via email, please use GitHub.
+## 📋 Prerequisites
 
-## Development
+Before you begin, ensure you have the following installed:
 
-See the [development section](https://docs.planka.cloud/docs/Development).
+- **Docker** (version 20.10 or later)
+- **Docker Compose** (version 2.0 or later)
+- **Node.js** 22 (for local development without Docker)
+- **npm** or **yarn** (for local development)
 
-## Tech stack
+## 🚀 Quick Start
 
-- React, Redux, Redux-Saga, Redux-ORM, Semantic UI React, react-beautiful-dnd
-- Sails.js, Knex.js
-- PostgreSQL
+### Using Docker (Recommended)
 
-## License
+The easiest way to get started is using the provided Makefile:
 
-Planka is [AGPL-3.0 licensed](https://github.com/plankanban/planka/blob/master/LICENSE).
+```bash
+make bootstrap
+```
 
-## Contributors
+This will:
 
-[![](https://contrib.rocks/image?repo=plankanban/planka)](https://github.com/plankanban/planka/graphs/contributors)
+1. Start all Docker services (PostgreSQL, Keycloak, Server, Client, Nginx)
+2. Wait for services to be ready
+3. Initialize the database with migrations and seeds
+4. Create a default admin user
+
+After setup completes, access the application at:
+
+- **Application**: http://localhost:3000
+- **Keycloak Admin Console**: http://localhost:8080 (admin/admin)
+
+### Manual Docker Setup
+
+If you prefer to use Docker Compose directly:
+
+```bash
+# Start all services
+docker-compose -f docker-compose-dev.yml up -d
+
+# Wait for services to be ready, then initialize database
+make keycloak-wait
+make init-db
+```
+
+### Local Development (Without Docker)
+
+For local development without Docker:
+
+```bash
+# Install dependencies
+npm install
+
+# Set up environment variables
+cp server/.env.sample server/.env
+# Edit server/.env with your configuration
+
+# Initialize database
+npm run server:db:init
+
+# Start development servers
+npm start
+```
+
+This will start both the server (port 3000) and client (port 3001) concurrently.
+
+## 🐳 Docker Services
+
+The development environment includes:
+
+- **postgres**: PostgreSQL 16 database (port 5433)
+- **keycloak-db**: PostgreSQL database for Keycloak
+- **keycloak**: Keycloak authentication server (port 8080)
+- **server**: Sails.js backend server
+- **client**: React development server
+- **proxy**: Nginx reverse proxy (port 3000)
+- **init-db**: One-time database initialization service
+
+## 📚 Additional Resources
+
+- [Planka Documentation](https://docs.planka.cloud/)
+- [Sails.js Documentation](https://sailsjs.com/documentation)
+- [React Documentation](https://react.dev/)
+- [Keycloak Documentation](https://www.keycloak.org/documentation)
+
+## License 📝
+
+This work is released under the MIT License (see [LICENSE](https://github.com/suitenumerique/messages/blob/main/LICENSE)).
+
+While Projets is a public-driven initiative, our license choice is an invitation for private sector actors to use, sell and contribute to the project.
+
+## 📧 Contact
+
+For questions or issues:
+
+- **GitHub Issues**: Use the repository's issue tracker
+- **Security Issues**: Please report security vulnerabilities privately
+
+## Gov ❤️ open source
+
+Projets is currently led by the French [ANCT](https://anct.gouv.fr/) for use in [La Suite territoriale](https://suiteterritoriale.anct.gouv.fr/).
+
+We are welcoming new partners and contributors to join us in this effort! So please [get in touch](mailto:contact@suite.anct.gouv.fr) if you want to help!

client/package.json

@@ -25,6 +25,7 @@
     ]
   },
   "eslintConfig": {
+    "root": true,
     "env": {
       "browser": true,
       "jest": true
@@ -59,7 +60,10 @@
       "prettier/prettier": [
         "error",
         {
-          "endOfLine": "auto"
+          "endOfLine": "auto",
+          "singleQuote": true,
+          "printWidth": 100,
+          "trailingComma": "all"
         }
       ]
     }

client/src/steps/BoardCreateStep/BoardCreateStep.jsx

@@ -114,20 +114,22 @@ const BoardCreateStep = React.memo(
           {data.import ? data.import.file.name : t('action.import')}
         </Button> */}
           </div>
-          <div className={styles.templatesWrapper}>
-            <p>Ou choisissez un tableau pré-défini :</p>
-            <div className={styles.templatesList}>
-              {(templateBoards || []).map((board) => (
-                <BoardListItem
-                  key={board.id}
-                  board={board}
-                  handleClick={() => handleTemplateClick(board.id)}
-                  showDescription
-                  editable={false}
-                />
-              ))}
+          {templateBoards && templateBoards.length > 0 && (
+            <div className={styles.templatesWrapper}>
+              <p>Ou choisissez un tableau pré-défini :</p>
+              <div className={styles.templatesList}>
+                {(templateBoards || []).map((board) => (
+                  <BoardListItem
+                    key={board.id}
+                    board={board}
+                    handleClick={() => handleTemplateClick(board.id)}
+                    showDescription
+                    editable={false}
+                  />
+                ))}
+              </div>
             </div>
-          </div>
+          )}
         </form>
       </>
     );

config/development/Dockerfile.client

@@ -1,20 +1,22 @@
-FROM node:18-alpine AS server-dependencies
+FROM node:22-alpine
 
 RUN apk -U upgrade \
   && apk add build-base python3 --no-cache
 
+# Install pnpm globally (faster than npm install pnpm)
+RUN npm install -g pnpm@9
+
 WORKDIR /app/client
 
-COPY package.json package-lock.json .
+# Copy package files first for better Docker layer caching
+COPY package.json package-lock.json ./
 
-RUN npm install npm --global \
-  && npm install pnpm@9 --global \
-  && pnpm import \
-  && pnpm install
+# Install client dependencies
+RUN pnpm import && pnpm install --frozen-lockfile
 
 WORKDIR /app
 
-COPY ../../package.json ../../package-lock.json .
+# Copy root package files and install root dependencies
+COPY package.json package-lock.json ./
 
-RUN pnpm import \
-  && pnpm install
+RUN pnpm import && pnpm install --frozen-lockfile

config/development/Dockerfile.server

@@ -1,4 +1,4 @@
-FROM node:18-alpine AS server-dependencies
+FROM node:22-alpine
 
 RUN apk -U upgrade \
   && apk add build-base python3 --no-cache