{"id":15091227,"url":"https://github.com/l1ber2y/apartments_search","last_synced_at":"2026-02-17T07:10:05.779Z","repository":{"id":211158897,"uuid":"728367136","full_name":"L1BER2Y/apartments_search","owner":"L1BER2Y","description":"This project was developed to secure the principles of design and development of modern web-applications.","archived":false,"fork":false,"pushed_at":"2024-08-19T16:35:56.000Z","size":721,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-10-14T05:01:52.666Z","etag":null,"topics":["docker","git","java-17","maven","nginx-proxy","open-api","postgresql","spring-boot"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/L1BER2Y.png","metadata":{"files":{"readme":"README.MD","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":"audit-service/Dockerfile","citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-12-06T19:40:40.000Z","updated_at":"2024-08-19T16:35:58.000Z","dependencies_parsed_at":"2024-01-19T13:55:44.593Z","dependency_job_id":"bc09650f-34ba-44b4-b554-4c8c175b16e1","html_url":"https://github.com/L1BER2Y/apartments_search","commit_stats":null,"previous_names":["l1ber2y/apartments_search"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/L1BER2Y%2Fapartments_search","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/L1BER2Y%2Fapartments_search/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/L1BER2Y%2Fapartments_search/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/L1BER2Y%2Fapartments_search/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/L1BER2Y","download_url":"https://codeload.github.com/L1BER2Y/apartments_search/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219848629,"owners_count":16556333,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","git","java-17","maven","nginx-proxy","open-api","postgresql","spring-boot"],"created_at":"2024-09-25T10:36:34.307Z","updated_at":"2025-10-13T10:35:53.955Z","avatar_url":"https://github.com/L1BER2Y.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Description\n\nWeb application based on microservice architecture style. It grants information about relevant flat rent and sale options.\n\n# How to run\n\nTo start the application, follow these steps:\n\n### 1. Clone the repository\n\nClone project repository by this command:\n\n```bash\ngit clone https://github.com/L1BER2Y/apartments_search.git\n```\n\n### 2. Next, go to the root directory and start application in docker by following command:\n\n```bash\ndocker compose up -d\n```\n\n# Application diagram:\n\u003cimg src=\"https://raw.githubusercontent.com/L1BER2Y/apartments_search/main/diagrams/Application%20diagram.png\" alt=\"architecture-diagram\" width=\"1000\"/\u003e\n\n# Application microservices:\n\n**[User-service](https://github.com/L1BER2Y/apartments_search/tree/main/user-service)**\n- This microservice is responsible for admin (creating/editing users, user information, and user (registering, verification, logging in, user information) functions.\n- Also it has user action tracking functionality, that was implemented with the help of Aspect-oriented programming.\n\n**[Flats-service](https://github.com/L1BER2Y/apartments_search/tree/main/flats-service)**\n- Flats-service is used to display information about flats.\n- You can also specify you request with filters (price, bedrooms, area, floors, photos).\n\n**[Parser-service](https://github.com/L1BER2Y/apartments_search/tree/main/parser-service)**\n- This microservice parses info about flats from https://re.kufar.by/ website in real time. \n- Parsed information is stored into application database.\n\n**[Audit-service](https://github.com/L1BER2Y/apartments_search/tree/main/audit-service)**\n- Audit-service accepts audited actions from user-service and stores them into database. \n- It has admin feature to check audited actions for chosen user by id.\n\n**[Report-service](https://github.com/L1BER2Y/apartments_search/tree/main/report-service)**\n- Service create reports based on user's audited actions.\n- It accepts report requests, can display report status, give page of reports, provides created report download link.\n\n**[Mail-service](https://github.com/L1BER2Y/apartments_search/tree/main/mail-service)**\n- Responsible for sending verification codes to email addresses during user registration.\n\n# Used technologies and frameworks:\n- [Java 17](https://docs.oracle.com/en/java/javase/17/docs/api/)\n- [Nginx](https://nginx.org/en/)\n- [JUnit5](https://junit.org/junit5/)\n- [Docker](https://www.docker.com/)\n- [Maven 3.9.6](https://maven.apache.org/)\n- [H2 Database](https://www.h2database.com/html/main.html)\n- [PostgreSQL 16](https://www.postgresql.org/)\n- [Spring Boot 3.2.0](https://spring.io/projects/spring-boot)\n- [Spring Security 3.2.0](https://spring.io/projects/spring-security)\n- [Spring Data JPA 3.2.0](https://spring.io/projects/spring-data-jpa)\n- [Spring Cloud OpenFeign 4.1.0](https://spring.io/projects/spring-cloud-openfeign)\n\n# Future plans:\n- ~~Unit-testing~~\n- Expand audit functionality \n- NoSQL database\n- Message broker (RabbitMQ)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fl1ber2y%2Fapartments_search","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fl1ber2y%2Fapartments_search","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fl1ber2y%2Fapartments_search/lists"}