PropTracker — платформа для инвестиций в недвижимость

Частная платформа, созданная на заказ для инвесторов в недвижимость в Худжанде, Таджикистан. Она заменила общую таблицу одной системой для объектов, расходов, оценки сделок и оценок модели.

Клиент: Инвесторы в недвижимость
Место: Худжанд, Таджикистан
Тип: Заказная платформа
Статус: Используется инвесторами, для которых создана
Роли: Админ · Просмотр
Услуги: ИИ-автоматизация · Серверная инфраструктура · Корпоративное ПО

Проблема

Инвесторы вели портфель в Excel. С ростом числа объектов и сделок файлу становилось все сложнее доверять — и все сложнее им делиться.

Хрупкие формулыРасчеты держались на хрупких формулах, которые легко сломать или случайно перезаписать.
Расходящиеся копииЗаписи терялись или устаревали между копиями файла.
Доступ «всё или ничего»Чтобы показать цифры одному человеку, приходилось отправлять ему весь файл.

Что мы создали

PropTracker — не шаблонный продукт. Он спроектирован и создан под процессы этой группы инвесторов: расчеты перенесены из формул таблицы в проверенный код, а доступ разграничен по ролям.

Объекты и хронологияКаждый объект с покупкой, продажей и хронологией событий с датами.
РасходыЗатраты по каждому объекту с разбивкой по категориям.
Общие расчетыВложенный капитал, цена за м², прибыль и остаток к оплате считаются в протестированном коде, общем для сервера и форм.
Оценка сделокПотенциальные сделки оцениваются до покупки; решение и его причина сохраняются.
Оценки моделиОтдельный сервис моделей возвращает оценку цены, оценку сделки, продаваемость, срок продажи и прогноз ROI.
Доступ по ролямАдминистраторы редактируют записи; наблюдатели читают и могут запрашивать оценки. Общий доступ снижает потребность пересылать копии таблицы.

02Архитектура

Типизированное веб-приложение поверх PostgreSQL с отдельным сервисом моделей на Python.

Браузер взаимодействует только с приложением Next.js. Его серверные маршруты проверяют сессию, читают и пишут через Prisma и вызывают сервис моделей с сервера. Обе ветви начинаются в приложении, и оценки возвращаются через него.

БраузерИнвесторы входят в систему

HTTPS-запрос / ответ

Приложение Next.jsСтраницы и серверные маршруты · проверка сессии на рабочих маршрутах

Запросы Prisma

PostgreSQLОбъекты, оценки, прогнозы, события, расходы, пользователи

POST /predict → оценки

Сервис моделей FastAPIМодели scikit-learn · внутренний ключ · /predict

Рис. 1 — Граница приложения и поток данных

Слои

ИнтерфейсЗаписи, оценки и графики в браузере.
ДоступРабочие маршруты проверяют сессию; изменение записей требует роли администратора.
ДанныеРеляционная модель объектов, оценок, прогнозов, событий и расходов.
ОценкиСервис FastAPI, вызываемый с сервера. Приложение ведет историю прогнозов; сбои записи попадают в журнал.

Название: PropTracker — архитектура системы
Приложение: Next.js 14 · TypeScript · Prisma
База данных: PostgreSQL
Сервис моделей: FastAPI · scikit-learn
Лист: 02 / 05

03Модель данных

Упрощенное подмножество реальной модели данных.

Объекты хранят факты покупки и продажи. Оценки могут существовать до покупки; прогнозы относятся к объекту или к оценке. События и расходы добавляются как записи с датами. Остальные таблицы опущены.

Userроль: Admin или Viewer · создает каждую запись1 — n → Property · DealEvaluation · ModelPrediction · PropertyEvent · PropertyExpense

DealEvaluationпотенциальная сделка · решение и причина · необязательная связь с объектом1 — n → ModelPrediction

Propertyдата и цена покупки · дата и цена продажи · статус1 — n → DealEvaluation · ModelPrediction · PropertyEvent · PropertyExpense

ModelPredictionрезультат модели с версией и входными данными · относится к объекту или оценкеProperty? · DealEvaluation?

PropertyEventхронология: просмотр, покупка, выставление, продажа…Property

PropertyExpenseзатраты по категориям: оформление, налог, юридические…Property

Рис. 2 — Сущности и связи, упрощенно

Правила, заложенные в модель

Прогнозы записываютсяКаждый прогноз записывается с версией модели и снимком входных данных; по замыслу это запись о том, что модель знала в тот момент.
События образуют хронологиюСобытия добавляются в хронологию объекта, задуманную как пополняемую без перезаписи.
Дата продажи задает статусЕсли указана дата продажи, сервер ставит статус «продан»; иначе сохраняется переданный статус.
Один модуль расчетовСерверные маршруты и предпросмотр в формах используют один протестированный модуль расчетов.

Название: PropTracker — модель данных
ORM: Prisma
Хранилище: PostgreSQL
Показано сущностей: 6 из 12
Лист: 03 / 05

04Роли и доступ

Доступ после входа, две роли.

Рабочие маршруты требуют сессии после входа; исключение — сам вход. Наблюдатели читают и могут запрашивать оценки, которые приложение записывает в историю прогнозов. Администраторы создают и меняют записи, сохраняют решения по сделкам и выгружают отчеты. Общий доступ снижает потребность пересылать копии таблицы.

Рис. 3 — Доступ по ролям, по серверным маршрутам
Возможность	Администратор	Наблюдатель
Просмотр объектов, оценок и прогнозов
Запрос оценки у модели (приложение записывает запрос в историю)
Добавление и изменение объектов, событий и расходов
Сохранение решения по сделке
Выгрузка отчетов (CSV, XLSX)

Рис. 3 — Доступ по ролям, по серверным маршрутам

Доступ

ВходСессии NextAuth.js; повторные неудачные входы временно блокируют аккаунт.
АдминистраторВедет объекты, события, расходы и оценки; выгружает отчеты.
НаблюдательЧитает записи и может запрашивать оценки; не может редактировать записи.

Название: PropTracker — роли и доступ
Вход: NextAuth.js
Роли: Админ · Просмотр
Правки записей: Только администратор
Лист: 04 / 05

05Статус

Используется, данные закрыты.

PropTracker используют инвесторы, для которых он создан. Данные их портфеля конфиденциальны, поэтому на этой странице нет цифр и скриншотов.

Назад к работам

Услуги в этом проекте