██████╗██╗   ██╗██████╗ ███████╗██████╗ ███████╗███████╗███╗   ██╗
██╔════╝╚██╗ ██╔╝██╔══██╗██╔════╝██╔══██╗╚══███╔╝██╔════╝████╗  ██║
██║      ╚████╔╝ ██████╔╝█████╗  ██████╔╝  ███╔╝ █████╗  ██╔██╗ ██║
██║       ╚██╔╝  ██╔══██╗██╔══╝  ██╔══██╗ ███╔╝  ██╔══╝  ██║╚██╗██║
╚██████╗   ██║   ██████╔╝███████╗██║  ██║███████╗███████╗██║ ╚████║
 ╚═════╝   ╚═╝   ╚═════╝ ╚══════╝╚═╝  ╚═╝╚══════╝╚══════╝╚═╝  ╚═══╝

┌─[cyberzen@terminal]─[~]
└──$ ▸ systemctl status zen
▸ CYBERZEN ONLINE
▸ READY FOR PRACTICE

┌─[ REQUIREMENTS ]─
│

TOOL	VERSION
Docker	Latest
Java	25+
Maven	3.9+

┌─[cyberzen@terminal]─[~]
└──$ ▸ java --version
openjdk 25.0.1 2025-10-21 LTS

┌─[cyberzen@terminal]─[~]
└──$ ▸ mvn --version
Apache Maven 3.9.11

┌─[ BOOT SEQUENCE ]─
│

┌─[cyberzen@terminal]─[~/cyberzen]
└──$ ▸ docker-compose up -d
[+] Running 3/3
✔ Network cyberzen_default Created
✔ Volume cyberzen_postgres-data Created
✔ Container cyberzen-database Started

▸ Database: cyberzen_db
▸ Username: cyberzen
▸ Password: cyberzen
▸ Port: 5432

┌─[cyberzen@terminal]─[~/cyberzen]
└──$ ▸ mvn spring-boot:run
[INFO] Started CyberZenApplication in 3.345 seconds

┌─[ ACCESS ]─
│

┌─[cyberzen@terminal]─[~/cyberzen]
└──$ ▸ cat .access-token
Using generated security password: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
⚠️ Changes every reboot

┌─[cyberzen@terminal]─[~/cyberzen]
└──$ ▸ open http://localhost:8080
USER: user
PASS: [your-token]

┌─[ COMMANDS ]─
│

# Start everything
$ docker-compose up -d && mvn spring-boot:run

# Stop database (keep data)
$ docker-compose down

# Reset everything (wipe all data)
$ docker-compose down -v

# Run tests
$ mvn test

# Build JAR
$ mvn clean package
$ java -jar target\cyberzen-1.0-SNAPSHOT.jar

┌─[ CONTRIBUTE ]─
│

1. Fork the repository
2. git switch -c feature/......
3. git commit -m "......"
4. git push origin feature/......
5. Open a Pull Request

┌─[ SYSTEM ARCHITECTURE ]─
│

LAYER	TECHNOLOGY	PURPOSE
CORE	Spring Boot 4.0.4	The engine that powers everything
WEB	Spring MVC + Thymeleaf	REST endpoints + HTML templates
DATA	PostgreSQL + JPA/Hibernate	Your tasks live here
SECURITY	Spring Security	Your private zen zone
UTILS	Lombok + Spring Cache	Less code, faster responses
CONTAINER	Docker + PostgreSQL	One command to boot the database
UNIT TESTS	JUnit + Mockito	Test business logic in isolation
REPO TESTS	@DataJpaTest + H2	Test database queries
CONTROLLER TESTS	@WebMvcTest + MockMvc	Test HTTP endpoints
INTEGRATION TESTS	@SpringBootTest + H2	Test everything together

┌─[cyberzen@terminal]─[~/cyberzen]
└──$ ▸ mvn dependency:tree
▸ Spring Boot 4.0.4 — core framework
▸ PostgreSQL 16 — data persistence
▸ H2 — test database (in-memory)
▸ Lombok — clean code
▸ Spring Cache — speed boost
▸ JUnit 5 + Mockito — unit tests
▸ MockMvc — controller tests

┌─[cyberzen@terminal]─[~/cyberzen]
└──$ ▸ mvn spring-boot:run
▸ Tomcat web server on port 8080
▸ Hibernate creates tables from your Java code
▸ Spring Security handles login
▸ Your tasks are ready

┌─[cyberzen@terminal]─[~/cyberzen]
└──$ ▸ mvn test
[INFO] Tests run: 8, Failures: 0, Errors: 0, Skipped: 0
▸ Unit tests — business logic
▸ Repository tests — database queries
▸ Controller tests — HTTP endpoints
▸ Integration tests — full system flow

┌─[cyberzen@terminal]─[~/cyberzen]
└──$ ▸ mvn clean package
▸ Builds cyberzen-1.0-SNAPSHOT.jar
▸ Ready for deployment