|
1 | | -# OdooApp-Android |
| 1 | +# OdooApp |
2 | 2 |
|
| 3 | +<a href=''><img alt='Get it on Google Play' src='https://play.google.com/intl/en_us/badges/static/images/badges/en_badge_web_generic.png' width=300/></a> |
3 | 4 |
|
4 | | -## Описание |
5 | | -> Приложение мобильный клиент Odoo для платформы Android |
| 5 | +## Description |
| 6 | +> This is **unofficial** [Odoo](https://www.odoo.com/) mobile client for Android with [HSE](https://www.hse.ru/en/) support. Enjoy! |
6 | 7 |
|
7 | | -## Общая структура проекта |
8 | | -- [buildSrc](buildSrc/) - модуль, предназначенный для хранения всех gradle зависимостей, для дальнейшего поделючения во всех остальных модулях |
9 | | -- [common](common/) - модуль, который содержит в себе функциональный куски кода, которые в дальнейшем можно переиспользовать |
10 | | -- [.ci](.ci/) - инкапсуляция конфигов для ci/cd |
11 | | -- [core](core/) - модуль компонентов, которые используются в других модулях проекта |
12 | | -- [.detekt](.detekt/) - конфиги для `detekt` на ci |
13 | | -- [entry](entry/) - модуль для входных точек в приложение |
14 | | -- [feature](feature/) - модуль, который будет описывать логику фичей (например, авторизация) |
| 8 | +## Features |
| 9 | +- Authorization |
| 10 | + - General |
| 11 | + - HSE |
| 12 | +- Selecting modules, pick your favorite |
| 13 | +- Recruitment module `coming soon!` |
| 14 | +- CRM module `coming soon!` |
| 15 | +- Profile `coming soon!` |
15 | 16 |
|
16 | | -## Git flow |
17 | | -Есть несколько основных веток |
| 17 | +## Example of screens |
| 18 | +<img src="documentation/screenshots/Authorization_light.webp" width=300/> <img src="documentation/screenshots/Authorization_dark.webp" width=300/> |
18 | 19 |
|
19 | | -- prod - стабильная ветка релизов |
20 | | -- develop - ветка активной разработки, checkout от prod |
21 | | -- Различные ветки фичей/багфиксов (соостветсвенно по названиям `feature/some_description` и `bugfix/some_description`) |
| 20 | +## Stack |
| 21 | +- Kotlin |
| 22 | +- Jetpack Compose |
| 23 | +- RxJava |
| 24 | +- Clean Architecture + MVVM |
| 25 | +- And other interesting staff |
22 | 26 |
|
23 | | -В конце каждого спринта будет релиз: |
24 | | -- Доливаем все доработки в prod |
25 | | -- Обновляем github |
| 27 | +## Are you a developer? |
| 28 | +Check [README](documentation/README.md) for developers |
26 | 29 |
|
27 | | -## Договоренности |
28 | | -- Комментарии пишем на **русском** |
29 | | -- Разделяем по возможности на **api** **impl**, для разделения методов наружу и их реализацией соответсвенно |
30 | | -- Naming модулей через **camelCase**. Пример - `buildSrc` |
31 | | -- Naming различных реализаций `impl` через *snake_case*, чтобы четко можно выделить особенносить |
32 | | -конректной реализации. Пример: |
33 | | -``` |
34 | | - login/ |
35 | | - api/ |
36 | | - impl/ |
37 | | - impl_hse/ |
38 | | - impl_google/ |
39 | | -``` |
40 | | -- Документация в api модулях очень приветсвуется, как и логгирование |
41 | | -- Naming пакетов должен быть следующим: |
42 | | -`odoo.miem.android.{feature/common/core}.{название модуля}.{api/impl}` |
43 | | - - api/impl - опционально, если присутсвует |
44 | | - - Не касаеися `entry/*` модулей, так как там содержиться базовый путь `odoo.miem.android` |
45 | | - - Пример: `odoo.miem.android.core.di.impl` |
46 | | - |
47 | | -## Как добавить новую gradle зависимость? Что такое модуль buildSrc и зачем он нужен? |
48 | | -В модуле [buildSrc](buildSrc/) в файле [Dependencies](buildSrc/src/main/kotlin/consts/Dependencies.kt) |
49 | | -прописаны все gradle зависимости, при необходимости добавляем/обновляем зависимости именно там. |
50 | | -Подробнее об модуле [buildSrc](buildSrc/) можно почитать в соответсвующем [README.md](buildSrc/README.md) |
51 | | - |
52 | | -## Как подключить модуль к общему DI графу? |
53 | | -Побробнее об этом можно прочитать в соответсвующем [README](core/di/README.md) |
| 30 | +## Download |
| 31 | +Stable release coming soon, keep in touch \(^▽^)/ |
0 commit comments