getting started

This commit is contained in:
androidlover5842
2026-01-24 14:42:07 +05:30
commit a5a6aa4999
29 changed files with 1133 additions and 0 deletions

View File

@@ -0,0 +1,11 @@
package com.android.trisolarisserver
import org.springframework.boot.autoconfigure.SpringBootApplication
import org.springframework.boot.runApplication
@SpringBootApplication
class TrisolarisServerApplication
fun main(args: Array<String>) {
runApplication<TrisolarisServerApplication>(*args)
}

View File

@@ -0,0 +1,22 @@
package com.android.trisolarisserver.component
import com.android.trisolarisserver.db.repo.PropertyUserRepo
import com.android.trisolarisserver.models.property.Role
import org.springframework.security.access.AccessDeniedException
import org.springframework.stereotype.Component
import java.util.UUID
@Component
class PropertyAccess(
private val repo: PropertyUserRepo
) {
fun requireMember(propertyId: UUID, userId: UUID) {
if (!repo.existsByIdPropertyIdAndIdUserId(propertyId, userId))
throw AccessDeniedException("No access to property")
}
fun requireAnyRole(propertyId: UUID, userId: UUID, vararg roles: Role) {
if (!repo.hasAnyRole(propertyId, userId, roles.toSet()))
throw AccessDeniedException("Missing role")
}
}

View File

@@ -0,0 +1,18 @@
package com.android.trisolarisserver.controller
import com.android.trisolarisserver.component.PropertyAccess
import org.springframework.stereotype.Component
import org.springframework.web.bind.annotation.GetMapping
import org.springframework.web.bind.annotation.PathVariable
import java.util.UUID
class Rooms {
// private val propertyAccess: PropertyAccess;
// @GetMapping("/properties/{propertyId}/rooms/free")
// fun freeRooms(@PathVariable propertyId: UUID, principal: MyPrincipal): List<RoomDto> {
// propertyAccess.requireMember(propertyId, principal.userId)
// return roomService.freeRooms(propertyId)
// }
}

View File

@@ -0,0 +1,25 @@
package com.android.trisolarisserver.db.repo
import com.android.trisolarisserver.models.property.*
import org.springframework.data.jpa.repository.JpaRepository
import org.springframework.data.jpa.repository.Query
import org.springframework.data.repository.query.Param
import java.util.UUID
interface PropertyUserRepo : JpaRepository<PropertyUser, PropertyUserId> {
fun existsByIdPropertyIdAndIdUserId(propertyId: UUID, userId: UUID): Boolean
@Query("""
select case when count(pu) > 0 then true else false end
from PropertyUser pu join pu.roles r
where pu.id.propertyId = :propertyId
and pu.id.userId = :userId
and r in :roles
""")
fun hasAnyRole(
@Param("propertyId") propertyId: UUID,
@Param("userId") userId: UUID,
@Param("roles") roles: Set<Role>
): Boolean
}

View File

@@ -0,0 +1,36 @@
package com.android.trisolarisserver.db.repo
import com.android.trisolarisserver.models.room.Room
import org.springframework.data.jpa.repository.JpaRepository
import org.springframework.data.jpa.repository.Query
import org.springframework.data.repository.query.Param
import java.util.UUID
interface RoomRepo : JpaRepository<Room, UUID> {
@Query("""
select r
from Room r
where r.property.id = :propertyId
and r.active = true
and r.maintenance = false
and not exists (
select 1 from RoomStay rs
where rs.room = r
and rs.toAt is null
)
order by r.roomNumber
""")
fun findFreeRooms(@Param("propertyId") propertyId: UUID): List<Room>
@Query("""
select r
from Room r
join RoomStay rs on rs.room = r
where r.property.id = :propertyId
and rs.toAt is null
order by r.roomNumber
""")
fun findOccupiedRooms(@Param("propertyId") propertyId: UUID): List<Room>
}

View File

@@ -0,0 +1,63 @@
package com.android.trisolarisserver.models.booking
import com.android.trisolarisserver.models.property.AppUser
import com.android.trisolarisserver.models.property.Property
import jakarta.persistence.*
import java.time.OffsetDateTime
import java.util.UUID
@Entity
@Table(
name = "booking",
uniqueConstraints = [
UniqueConstraint(columnNames = ["property_id", "source", "source_booking_id"])
]
)
class Booking(
@Id
@GeneratedValue
@Column(columnDefinition = "uuid")
val id: UUID? = null,
@ManyToOne(fetch = FetchType.LAZY, optional = false)
@JoinColumn(name = "property_id", nullable = false)
var property: Property,
@ManyToOne(fetch = FetchType.LAZY)
@JoinColumn(name = "primary_guest_id")
var primaryGuest: Guest? = null,
@Enumerated(EnumType.STRING)
@Column(nullable = false)
var status: BookingStatus = BookingStatus.OPEN,
@Column(nullable = false)
var source: String = "WALKIN", // WALKIN, WEBSITE, MMT, AGENT
@Column(name = "source_booking_id")
var sourceBookingId: String? = null,
@Column(name = "checkin_at", columnDefinition = "timestamptz")
var checkinAt: OffsetDateTime? = null,
@Column(name = "checkout_at", columnDefinition = "timestamptz")
var checkoutAt: OffsetDateTime? = null,
@Column(name = "expected_checkin_at", columnDefinition = "timestamptz")
var expectedCheckinAt: OffsetDateTime? = null,
@Column(name = "expected_checkout_at", columnDefinition = "timestamptz")
var expectedCheckoutAt: OffsetDateTime? = null,
var notes: String? = null,
@ManyToOne(fetch = FetchType.LAZY)
@JoinColumn(name = "created_by")
var createdBy: AppUser? = null,
@Column(name = "created_at", columnDefinition = "timestamptz")
val createdAt: OffsetDateTime = OffsetDateTime.now(),
@Column(name = "updated_at", columnDefinition = "timestamptz")
var updatedAt: OffsetDateTime = OffsetDateTime.now()
)

View File

@@ -0,0 +1,9 @@
package com.android.trisolarisserver.models.booking
enum class BookingStatus {
OPEN,
CHECKED_IN,
CHECKED_OUT,
CANCELLED,
NO_SHOW
}

View File

@@ -0,0 +1,37 @@
package com.android.trisolarisserver.models.booking
import com.android.trisolarisserver.models.property.Organization
import jakarta.persistence.*
import java.time.OffsetDateTime
import java.util.UUID
@Entity
@Table(
name = "guest",
uniqueConstraints = [UniqueConstraint(columnNames = ["org_id", "phone_e164"])]
)
class Guest(
@Id
@GeneratedValue
@Column(columnDefinition = "uuid")
val id: UUID? = null,
@ManyToOne(fetch = FetchType.LAZY, optional = false)
@JoinColumn(name = "org_id", nullable = false)
var org: Organization,
@Column(name = "phone_e164")
var phoneE164: String? = null,
var name: String? = null,
var nationality: String? = null,
@Column(name = "address_text")
var addressText: String? = null,
@Column(name = "created_at", columnDefinition = "timestamptz")
val createdAt: OffsetDateTime = OffsetDateTime.now(),
@Column(name = "updated_at", columnDefinition = "timestamptz")
var updatedAt: OffsetDateTime = OffsetDateTime.now()
)

View File

@@ -0,0 +1,35 @@
package com.android.trisolarisserver.models.property
import jakarta.persistence.*
import java.time.OffsetDateTime
import java.util.UUID
@Entity
@Table(
name = "app_user",
uniqueConstraints = [UniqueConstraint(columnNames = ["firebase_uid"])]
)
class AppUser(
@Id
@GeneratedValue
@Column(columnDefinition = "uuid")
val id: UUID? = null,
@ManyToOne(fetch = FetchType.LAZY, optional = false)
@JoinColumn(name = "org_id", nullable = false)
var org: Organization,
@Column(name = "firebase_uid")
var firebaseUid: String? = null, // optional if using firebase
@Column(name = "phone_e164")
var phoneE164: String? = null,
var name: String? = null,
@Column(name = "is_disabled", nullable = false)
var disabled: Boolean = false,
@Column(name = "created_at", nullable = false, columnDefinition = "timestamptz")
val createdAt: OffsetDateTime = OffsetDateTime.now()
)

View File

@@ -0,0 +1,18 @@
package com.android.trisolarisserver.models.property
import jakarta.persistence.*
import java.time.OffsetDateTime
import java.util.*
@Entity
@Table(name = "organization")
class Organization {
@Id
@GeneratedValue
@Column(columnDefinition = "uuid")
val id: UUID? = null
@Column(nullable = false)
var name: String? = null
@Column(name = "created_at", nullable = false, columnDefinition = "timestamptz")
val createdAt: OffsetDateTime = OffsetDateTime.now() }

View File

@@ -0,0 +1,39 @@
package com.android.trisolarisserver.models.property
import jakarta.persistence.*
import java.time.OffsetDateTime
import java.util.UUID
@Entity
@Table(
name = "property",
uniqueConstraints = [UniqueConstraint(columnNames = ["org_id", "code"])]
)
class Property(
@Id
@GeneratedValue
@Column(columnDefinition = "uuid")
val id: UUID? = null,
@ManyToOne(fetch = FetchType.LAZY, optional = false)
@JoinColumn(name = "org_id", nullable = false)
var org: Organization,
@Column(nullable = false)
var code: String, // "TRI-VNS"
@Column(nullable = false)
var name: String, // "Hotel Trisolaris Varanasi"
@Column(nullable = false)
var timezone: String = "Asia/Kolkata",
@Column(nullable = false)
var currency: String = "INR",
@Column(name = "is_active", nullable = false)
var active: Boolean = true,
@Column(name = "created_at", nullable = false, columnDefinition = "timestamptz")
val createdAt: OffsetDateTime = OffsetDateTime.now()
)

View File

@@ -0,0 +1,43 @@
package com.android.trisolarisserver.models.property
import jakarta.persistence.*
import java.io.Serializable
import java.util.UUID
@Entity
@Table(name = "property_user")
class PropertyUser(
@EmbeddedId
val id: PropertyUserId = PropertyUserId(),
@MapsId("propertyId")
@ManyToOne(fetch = FetchType.LAZY)
@JoinColumn(name = "property_id")
var property: Property,
@MapsId("userId")
@ManyToOne(fetch = FetchType.LAZY)
@JoinColumn(name = "user_id")
var user: AppUser,
@ElementCollection(fetch = FetchType.EAGER)
@CollectionTable(
name = "property_user_role",
joinColumns = [
JoinColumn(name = "property_id"),
JoinColumn(name = "user_id")
]
)
@Column(name = "role")
var roles: MutableSet<Role> = mutableSetOf()
)
@Embeddable
class PropertyUserId(
@Column(name = "property_id", columnDefinition = "uuid")
var propertyId: UUID? = null,
@Column(name = "user_id", columnDefinition = "uuid")
var userId: UUID? = null
) : Serializable

View File

@@ -0,0 +1,5 @@
package com.android.trisolarisserver.models.property
enum class Role {
ADMIN, MANAGER, STAFF, HOUSEKEEPING, FINANCE,GUIDE,SUPERVISOR,AGENT
}

View File

@@ -0,0 +1,41 @@
package com.android.trisolarisserver.models.room
import com.android.trisolarisserver.models.property.Property
import jakarta.persistence.*
import java.util.UUID
@Entity
@Table(
name = "room",
uniqueConstraints = [UniqueConstraint(columnNames = ["property_id", "room_number"])]
)
class Room(
@Id
@GeneratedValue
@Column(columnDefinition = "uuid")
val id: UUID? = null,
@ManyToOne(fetch = FetchType.LAZY, optional = false)
@JoinColumn(name = "property_id", nullable = false)
var property: Property,
@ManyToOne(fetch = FetchType.LAZY, optional = false)
@JoinColumn(name = "room_type_id", nullable = false)
var roomType: RoomType,
@Column(name = "room_number", nullable = false)
var roomNumber: Int,
var floor: Int? = null,
@Column(name = "has_nfc", nullable = false)
var hasNfc: Boolean = false,
@Column(name = "is_active", nullable = false)
var active: Boolean = true,
@Column(name = "maintenance", nullable = false)
var maintenance: Boolean = false,
var notes: String? = null
)

View File

@@ -0,0 +1,42 @@
package com.android.trisolarisserver.models.room
import com.android.trisolarisserver.models.booking.Booking
import com.android.trisolarisserver.models.property.AppUser
import com.android.trisolarisserver.models.property.Property
import jakarta.persistence.*
import java.time.OffsetDateTime
import java.util.UUID
@Entity
@Table(name = "room_stay")
class RoomStay(
@Id
@GeneratedValue
@Column(columnDefinition = "uuid")
val id: UUID? = null,
@ManyToOne(fetch = FetchType.LAZY, optional = false)
@JoinColumn(name = "property_id", nullable = false)
var property: Property,
@ManyToOne(fetch = FetchType.LAZY, optional = false)
@JoinColumn(name = "booking_id", nullable = false)
var booking: Booking,
@ManyToOne(fetch = FetchType.LAZY, optional = false)
@JoinColumn(name = "room_id", nullable = false)
var room: Room,
@Column(name = "from_at", nullable = false, columnDefinition = "timestamptz")
var fromAt: OffsetDateTime,
@Column(name = "to_at", columnDefinition = "timestamptz")
var toAt: OffsetDateTime? = null, // null = active
@ManyToOne(fetch = FetchType.LAZY)
@JoinColumn(name = "created_by")
var createdBy: AppUser? = null,
@Column(name = "created_at", nullable = false, columnDefinition = "timestamptz")
val createdAt: OffsetDateTime = OffsetDateTime.now()
)

View File

@@ -0,0 +1,37 @@
package com.android.trisolarisserver.models.room
import com.android.trisolarisserver.models.property.Property
import jakarta.persistence.*
import java.time.OffsetDateTime
import java.util.UUID
@Entity
@Table(
name = "room_type",
uniqueConstraints = [UniqueConstraint(columnNames = ["property_id", "code"])]
)
class RoomType(
@Id
@GeneratedValue
@Column(columnDefinition = "uuid")
val id: UUID? = null,
@ManyToOne(fetch = FetchType.LAZY, optional = false)
@JoinColumn(name = "property_id", nullable = false)
var property: Property,
@Column(nullable = false)
var code: String, // DLX_DBL
@Column(nullable = false)
var name: String, // Deluxe Double
@Column(name = "base_occupancy", nullable = false)
var baseOccupancy: Int = 2,
@Column(name = "max_occupancy", nullable = false)
var maxOccupancy: Int = 3,
@Column(name = "created_at", nullable = false, columnDefinition = "timestamptz")
val createdAt: OffsetDateTime = OffsetDateTime.now()
)

View File

@@ -0,0 +1 @@
spring.datasource.url=jdbc:postgresql://192.168.1.53:5432/trisolaris

View File

@@ -0,0 +1 @@
spring.datasource.url=jdbc:postgresql://localhost:5432/trisolaris

View File

@@ -0,0 +1,7 @@
spring.application.name=TrisolarisServer
spring.datasource.username=android
spring.datasource.password=${DB_PASSWORD}
spring.jpa.hibernate.ddl-auto=update
spring.jpa.open-in-view=false
spring.flyway.enabled=false
spring.flyway.locations=classpath:db/migration

View File

@@ -0,0 +1,180 @@
-- Enable UUIDs
create extension if not exists pgcrypto;
-- ---------- guest ----------
create table guest (
id uuid primary key default gen_random_uuid(),
phone_e164 text unique,
name text,
nationality text,
address_text text,
created_at timestamptz not null default now(),
updated_at timestamptz not null default now()
);
-- ---------- room ----------
create table room (
id uuid primary key default gen_random_uuid(),
room_number int not null unique,
room_type text,
is_active boolean not null default true,
has_nfc boolean not null default false
);
-- ---------- booking ----------
create table booking (
id uuid primary key default gen_random_uuid(),
source text not null default 'WALKIN'
check (source in ('WALKIN','MMT','AGODA','BOOKING.COM','CLEARTRIP','AGENT','OTHER')),
source_booking_id text,
source_payload jsonb,
status text not null default 'RESERVED'
check (status in ('RESERVED','CHECKED_IN','CHECKED_OUT','CANCELLED','NO_SHOW')),
primary_guest_id uuid references guest(id),
checkin_at timestamptz,
checkout_at timestamptz,
estimated_checkout_at timestamptz,
cancelled_at timestamptz,
cancel_reason text,
created_at timestamptz not null default now(),
updated_at timestamptz not null default now(),
unique (source, source_booking_id)
);
create index booking_status_idx on booking(status);
create index booking_checkin_idx on booking(checkin_at);
create table booking_party (
booking_id uuid primary key references booking(id) on delete cascade,
male int not null default 0,
female int not null default 0,
children int not null default 0
);
create table booking_details (
booking_id uuid primary key references booking(id) on delete cascade,
mode_of_transport text,
coming_from text,
going_to text,
purpose text,
relation text
);
-- ---------- room stay segments ----------
create table room_stay (
id uuid primary key default gen_random_uuid(),
booking_id uuid not null references booking(id) on delete cascade,
room_id uuid not null references room(id),
from_at timestamptz not null,
to_at timestamptz,
rate numeric(12,2) not null,
rate_unit text not null default 'NIGHT'
check (rate_unit in ('NIGHT','DAY','HOUR')),
note text);
);
create index room_stay_booking_idx on room_stay(booking_id);
create index room_stay_room_active_idx on room_stay(room_id) where to_at is null;
-- ---------- charges ----------
create table charge (
id uuid primary key default gen_random_uuid(),
booking_id uuid not null references booking(id) on delete cascade,
type text not null
check (type in ('ROOM_RENT','EXTRA_GUEST','EXTRA_BED','FOOD','DAMAGE','DISCOUNT','ADJUSTMENT','CANCELLATION_FEE','ROUNDING','COMMISSION')),
amount numeric(12,2) not null,
note text,
occurred_at timestamptz not null default now(),
created_at timestamptz not null default now()
);
create table audit_log (
id bigserial primary key,
occurred_at timestamptz not null default now(),
actor_type text not null default 'SYSTEM'
check (actor_type in ('SYSTEM','EMPLOYEE','API','GUEST')),
actor_id text, -- store employeeId / uid / api key id as text
actor_ip inet,
user_agent text,
entity_type text not null, -- e.g. BOOKING, PAYMENT, ROOM_STAY, GUEST
entity_id uuid, -- the uuid id if you have it
action text not null, -- e.g. CREATE, UPDATE, CANCEL, CHECKIN, CHECKOUT, ADD_PAYMENT, REFUND, ROOM_CHANGE
message text, -- human-readable note
before jsonb, -- optional previous state
after jsonb, -- optional new state
meta jsonb -- any extra (diff, reason, source, etc.)
);
create table app_user (
id uuid primary key default gen_random_uuid(),
firebase_uid text not null unique,
phone_e164 text,
name text,
is_disabled boolean not null default false,
roles text[] not null default '{}', -- ['admin','staff']
created_at timestamptz not null default now()
);
create index audit_entity_idx on audit_log(entity_type, entity_id, occurred_at desc);
create index audit_action_idx on audit_log(action, occurred_at desc);
create index audit_actor_idx on audit_log(actor_type, actor_id, occurred_at desc);
create type document_type as enum
('UNKNOWN','AADHAR','PASSPORT','DL','VOTER','OTHER');
create table client_ids (
id uuid primary key default gen_random_uuid(),
guest_id uuid not null references guest(id) on delete cascade,
file_key text not null,
uploaded_at timestamptz not null default now(),
ai_raw_text text,
ai_ran_at timestamptz,
full_name text,
date_of_birth date,
gender text,
father_name text,
address text,
city text,
state text,
postal_code text,
country text,
type document_type not null default 'UNKNOWN'
);
create table issued_card (
id uuid primary key default gen_random_uuid(),
card_id text not null, -- "E2E2464E"
card_index int, -- 100590
doc_id text, -- "FBE3D1737DC937F" (lock internal / doc id)
room_number int, -- keep int like you have
booking_id uuid references booking(id) on delete set null, -- optional but useful
issue_at timestamptz not null,
expiry_at timestamptz not null,
issuer_name text,
issuer_firebase_uid text references app_user(firebase_uid) on delete set null,
created_at timestamptz not null default now(),
check (expiry_at > issue_at)
);
create index issued_card_room_idx on issued_card(room_number, issue_at desc);
create index issued_card_booking_idx on issued_card(booking_id, issue_at desc);
create index issued_card_issuer_idx on issued_card(issuer_firebase_uid, issue_at desc);
create unique index issued_card_unique_idx on issued_card(card_id, card_index, issue_at);