Subversion Repositories SmartDukaan

namespace java in.shop2020.model.v1.user

namespace py shop2020.thriftpy.model.v1.user

include "GenericService.thrift"

/**

Exceptions

*/

exception AuthenticationException{

	1:string message,

	2:i32 errorCode

}

exception UserContextException{

	1:i32 errorCode,

	2:string message

}

exception ShoppingCartException{

	1:i64 id,

	2:string message

}

exception UserCommunicationException{

	1:i64 id,

	2:string message

}

exception UserAffiliateException{

    1:i64 id,

    2:string message

}

enum UserType{

	USER = 0,

	ANONYMOUS = 1 

}

enum PromotionType{

	DISCOUNT_COUPON = 0,

	GIFT_VOUCHER = 1 

}

enum AddressType{

	WORK = 0,

	HOME = 1

}

/**

Form types for Contact Us form

*/

enum UserCommunicationType{

	RETURN_FORM = 1,

	ORDER_CANCELLATION = 2,

	DELIVERY_PROBLEM = 3,

	PAYMENT_STATUS = 4,

	ORDER_STATUS = 5,

	PRODUCT_REQUEST = 6,

	RECHARGE_RELATED = 7,

	OTHER = 8

}

/**

Affiliate track log types for affiliate tracking

*/

enum TrackLogType{

    NEW_REGISTRATION = 1,

    PAYMENT_SUCCESS = 2

}

/**

Address

*/

struct Address{

	1:i64 id,

	2:string line1,

	3:string line2,

	4:string landmark,

	5:string city,

	6:string state,

	7:string pin,

	8:string country,

	9:bool enabled,

	10:AddressType type,

	11:i64 addedOn,

	12:string name,

	13:string phone

}

enum Sex{

	MALE,

	FEMALE,

	WONT_SAY

}

/**

The user structure holding the basic information that identifies the user.

**/

struct User{

	1:i64 userId,

	2:string email,

	3:string password,

	4:string name,

	5:string dateOfBirth,

	6:Sex sex,

	7:optional string mobileNumber,

	8:i64 lastLogin,

	9:i64 lastLogout,

	10:i64 activeSince,

	11:list<Address> addresses,

	12:i64 defaultAddressId,

	13:string communicationEmail,

	14:i64 activeCartId,

	15:string jsessionId,

	16:bool isAnonymous,

	17:string source,

	18:i64 sourceStartTime,

	19:double trustLevel

}

struct UserCommunication{

	1:i64 id,

	2:i64 userId,

	3:UserCommunicationType communicationType,

	4:i64 orderId,

	5:string airwaybillNo,

	6:string replyTo,

	7:string productName,

	8:string subject,

	9:string message,

	10:i64 communication_timestamp

}

struct MasterAffiliate{

    1:i64 id,

    2:string name,

    3:i64 addedOn

}

struct Affiliate{

    1:i64 id,

    2:string name,

    3:string url,

    4:i64 masterAffiliateId,

    5:i64 addedOn

}

struct Tracker{

    1:i64 id,

    2:i64 affiliateId,

}

struct TrackLog{

    1:i64 id,

    2:i64 addedOn,

    3:i64 affiliateId,

    4:i64 userId,

    5:TrackLogType eventType,

    6:string url,

    7:string data

}

//Various statuses for line items

enum LineStatus{

	LINE_ACTIVE,			//line is active

	LINE_DELETED,			//line is deleted

	LINE_EXPIRED,			//line is expired, on laspse of fixed amount of time

	LINE_COMMITED,			//line is committed, sent for processing.

	LINE_COMMIT_FAILED,		//line was committed, but commit failed due to some reason, possibly during cart validation.

	LINE_AUTO_DELETED,		//line was auto deleted internally due to some reason(item delisted, price changed etc).

}

//Various statuses for Cart

enum CartStatus{

	ACTIVE,					

	INACTIVE,

	EXPIRED,

	COMMITTED,

	COMMIT_FAILED

}

struct Discount{

	1:i64 cart_id,

    2:i64 item_id,

    3:double discount,

    4:double quantity

}

struct Line{

	1:i64 cartId,				//identifier

	2:i64 itemId,			//item id added

	3:double quantity,		//quantity added 

	4:i64 createdOn,		//addition timestamp

	5:i64 updatedOn, 		//any updation in quantity or status

	6:LineStatus lineStatus,	//current status

	7:i32 estimate,			//delivery estimate in hours

	8:double actualPrice,

	9:double discountedPrice,

	10:list<Discount> discounts,

	11:i64 insurer,

	12:double insuranceAmount

}

struct Cart{

	1:i64 id,				//identifier

	2:list<Line> lines,		//list of lines

	3:CartStatus status,	//current status

	4:i64 createdOn,		//creation timestamp

	5:i64 updatedOn,		//time of last update in cart (like addition/deletion/updation of cart items )

	6:i64 checkedOutOn,		//commited timestamp

	7:i64 addressId,	    //address on which this will be shipped

	8:double totalPrice,

	9:double discountedPrice,

	10:string couponCode,

	11:i64 pickupStoreId,

	12:string message		//This is introduced to display custom message as and when required to the Website for user display.

}

enum WidgetType{

	MY_RESEARCH,

	BROWSE_HISTORY

}

struct UserWidgetItem{

	1:i64 userId,

	2:i64 widgetId,

	3:i64 itemId,

	4:i64 addedOn

}

exception WidgetException{

	1:i64 id,

	2:string message

}

/**

Exceptions for Promotion Service

*/

exception PromotionException{

	1:i64 id,

	2:string message

}

/**

Types for Promotion Service

*/

struct Promotion{

	1:i64 id,

	2:string name,

	3:string ruleExecutionSrc,

	4:i64 startOn,

	5:i64 endOn,

	6:i64 createdOn

}

struct Coupon{

	1:string couponCode,

	2:Promotion promotion,

	3:string arguments

}

struct PromotionTracking{

	1:string couponCode,

	2:i64 transactionId,

	3:i64 userId,

	4:bool appliedOn

}

struct ItemCouponDiscount{

	1:i64 itemId,

	2:string couponCode,

	3:double discount

}

enum VoucherType{

	SPICEDECK_MOBILE=1

}

struct Voucher{

	1:i64 id,

	2:string voucherCode,

	3:VoucherType voucherType,

	4:i64 issuedOn,

	5:double amount,

	6:i64 expiredOn,

	7:string userEmail

}

/**

Promotion Service

*/

service PromotionService extends GenericService.GenericService{

	void createPromotion(1:string name, 2:string ruleExecutionSrc, 3:i64 startOn, 4:i64 endOn) throws (1:PromotionException pex),

	i64 removeAllCouponsByPromotionId(1:i64 promotionId) throws (1:PromotionException pex),

	Coupon getCoupon(1:string couponCode) throws (1:PromotionException pex),

	bool isGiftVoucher(1:string couponCode) throws (1:PromotionException pex),

	bool isCodApplicable(1:string couponCode) throws (1:PromotionException pex),

	list<Promotion> getAllPromotions() throws (1:PromotionException pex),

	Promotion getPromotionById(1:i64 promotionId) throws (1:PromotionException pex),

	void generateCouponsForPromotion(1:i64 promotionId, 2:string couponCode) throws (1:PromotionException pex),

	Cart applyCoupon(1:string couponCode, 2:i64 cartId) throws (1:PromotionException pex),

	map<i64,double>  getEmiDiscount(1:i64 cartId) throws (1:PromotionException pex),

	map<i64, string> applyRechargeCoupon(1:string couponCode, 2:i64 totalAmount, 3:i64 userId) throws (1:PromotionException pex),

    void trackCouponUsage(1:string couponCode, 2:i64 transactionId, 3:i64 userId) throws (1:PromotionException pex),

    i64 getCouponUsageCountByUser(1:string couponCode, 2:i64 userId) throws (1:PromotionException pex),

    list<Coupon> getActiveCodes(1:i64 promotionId) throws (1:PromotionException pex),

    void deleteCoupon(1:string couponCode) throws (1:PromotionException pex),

    list<Coupon> getAllCouponsByPromotionId(1:i64 promotionId) throws (1:PromotionException pex),

    /**

     Returns a list of active coupons

     */

    list<Coupon> getActiveCoupons() throws (1:PromotionException pex),

    /**

     Creates a coupon with prefix (optional, pass null)and returns couponcode if successfully created.

     */

    string createCoupon(1:i64 promotionId, 2:string couponCode, 3:string arguments 4:bool isCod, 5:string prefix) throws (1:PromotionException pex),

    /**

     Returns the count of successful payments done using a given coupon

     */

    i64 getSuccessfulPaymentCountForCoupon(1:string couponCode) throws (1:PromotionException pex),

    /**

     Returns the doc string of the rule module

     */

    string getRuleDocString(1:string ruleName),

    list<ItemCouponDiscount> getItemDiscountMap(1:list<i64> itemIds) throws (1:PromotionException pex),

    map<string, double> getDiscountsForEntity(1:i64 entityId),

    void addVoucher(1:Voucher voucher),

    Voucher assignVoucher(1:i64 userId, 2:string userEmail, 3:VoucherType voucherType, 4:i64 amount),

    bool markVoucherAsRedeemed(1:string voucherCode, 2:i64 redeemedOn)

}

/**

service

*/

service UserContextService extends GenericService.GenericService{

	User createAnonymousUser(1:string jsessionId) throws (1:UserContextException ucex),

	User getUserById(1:i64 userId) throws (1:UserContextException ucex),

	User getUserByCartId(1:i64 cartId) throws (1:UserContextException ucex),

	User getUserByEmail(1:string email) throws (1:UserContextException ucex),

    User getUserByMobileNumber(1:i64 mobileNumber) throws (1:UserContextException ucex),

	User createUser(1:User user) throws (1:UserContextException ucex),

	User updateUser(1:User user) throws (1:UserContextException ucex),

	User authenticateUser(1:string email, 2:string password) throws (1:AuthenticationException auex),

	bool userExists(1:string email) throws (1:UserContextException ucx),

	i64 addAddressForUser(1:i64 userId, 2:Address address, 3:bool setDefault)throws (1:UserContextException ucx),

	bool removeAddressForUser(1:i64 userid, 2:i64 addressId)throws (1:UserContextException ucx),

	bool setUserAsLoggedIn(1:i64 userId, 2:i64 timestamp)throws (1:UserContextException ucx),

	bool setUserAsLoggedOut(1:i64 userid, 2:i64 timestamp)throws (1:UserContextException ucx),

	bool setDefaultAddress(1:i64 userid, 2:i64 addressId)throws (1:UserContextException ucx),

	bool updatePassword(1:i64 userid, 2:string oldPassword, 3:string newPassword)throws (1:UserContextException ucx),

	bool forgotPassword(1:string email, 2:string newPassword)throws (1:UserContextException ucx),

	list<Address> getAllAddressesForUser(1:i64 userId)throws (1:UserContextException ucx),

	Address getAddressById(1:i64 addressId)throws (1:UserContextException ucx),

	i64 getDefaultAddressId(1:i64 userId)throws (1:UserContextException ucx),

	string getDefaultPincode(1:i64 userId)throws (1:UserContextException ucx),

	bool saveUserCommunication(1:i64 userId, 2:string replyTo, 3:i64 communicationType, 4:i64 orderId, 5:string airwaybillNo, 6:string productName, 7:string subject, 8:string message)throws (1:UserCommunicationException ucx)

	UserCommunication getUserCommunicationById(1:i64 id) throws (1:UserCommunicationException ucx)

	list<UserCommunication> getUserCommunicationByUser(1:i64 userId) throws (1:UserCommunicationException ucx)

	list<UserCommunication> getAllUserCommunications() throws (1:UserCommunicationException ucx)

	void removeUserCommunication(1:i64 id) throws (1:UserCommunicationException ucx)

	MasterAffiliate createMasterAffiliate(1:string name, 2:i64 addedOn) throws (1:UserAffiliateException utx)

	list<MasterAffiliate> getAllMasterAffiliates() throws (1:UserAffiliateException utx)

	MasterAffiliate getMasterAffiliateById(1:i64 id) throws (1:UserAffiliateException utx)

    MasterAffiliate getMasterAffiliateByName(1:string name) throws (1:UserAffiliateException utx)

	Affiliate createAffiliate(1:string name, 2:string url, 3:i64 masterAffiliateId, 4:i64 addedOn) throws (1:UserAffiliateException utx)

	Affiliate getAffiliateById(1:i64 id) throws (1:UserAffiliateException utx)

	Affiliate getAffiliateByName(1:string name) throws (1:UserAffiliateException utx)

	Tracker getTrackerById(1:i64 id) throws (1:UserAffiliateException utx)

	list<Affiliate> getAffiliatesByMasterAffiliate(1:i64 id) throws (1:UserAffiliateException utx)

	i64 addTrackLog(1:i64 affiliateId, 2:i64 userId, 3:TrackLogType event, 4:string url, 5:string data, 6:i64 addedOn) throws (1:UserAffiliateException utx)

	TrackLog getTrackLogById(1:i64 id) throws (1:UserAffiliateException utx)

	list<TrackLog> getTrackLogsByAffiliate(1:i64 affiliateId, 2:i64 startDate, 3:i64 endDate) throws (1:UserAffiliateException utx)

	list<TrackLog> getTrackLogsByUser(1:i64 userId) throws (1:UserAffiliateException utx)

	list<TrackLog> getTrackLogs(1:i64 userId, 2:string event, 3:string url) throws (1:UserAffiliateException utx)

	Cart getCurrentCart(1:i64 userId) throws (1:ShoppingCartException scx),	

	Cart getCart(1:i64 cartId) throws (1:ShoppingCartException scx),

	list<Cart> getCartsByTime(1:i64 from_time, 2:i64 to_time, 3:CartStatus status) throws (1:ShoppingCartException scx),

	string addItemToCart(1:i64 cartId, 2:i64 itemId, 3:i64 quantity, 4:i64 sourceId) throws (1:ShoppingCartException scx),

	void deleteItemFromCart(1:i64 cartId, 2:i64 itemId) throws (1:ShoppingCartException scx),

	void addAddressToCart(1:i64 cartId, 2:i64 addressId) throws (1:ShoppingCartException scx),

	void addStoreToCart(1:i64 cartId, 2:i64 storeId) throws (1:ShoppingCartException scx),

	void applyCouponToCart(1:Cart cart, 2:string couponCode) throws (1:ShoppingCartException scx),

	void removeCoupon(1:i64 cartId) throws (1:ShoppingCartException scx),

	/**

	Deletes all the discounts associated with the cart

	*/

	void deleteDiscountsFromCart(1:i64 cartId) throws (1:ShoppingCartException scx),

	/**

	Accepts a list of thrift objects of Discount type and saves them

	*/

	void saveDiscounts(1:list<Discount> discounts) throws (1:ShoppingCartException scx),

	/**

	 Creates a transaction and multiple orders for the given cart. Returns the transaction ID created.

	*/

	i64 createOrders(1:i64 cartId, 2:string sessionSource, 3:i64 sessionStartTime, 4:string firstSource, 5:i64 firstSourceTime, 6:i64 userId, 7:i64 schemeId) throws (1:ShoppingCartException scx),

	/**

	 Validates that:

	 1. The checkout timestamp is greater than the updatedOn timestamp.

	 2. All of the lines in the cart are active items.

	 3. The estimate for any of the lines in cart doesn't change.

	 If all three are true, returns empty string; else returns appropriate message.

	*/

	list<string> validateCart(1:i64 cartId, 2:i64 sourceId) throws (1:ShoppingCartException scex),

	/**

	 Merges the lines from the first cart into the second cart. Lines with duplicate items are removed.

	*/

	void mergeCart(1:i64 fromCartId, 2:i64 toCartId),

	/**

	 Sets the checkedOutOn timestamp of the cart. Raises an exception if the specified cart can't be found.

	*/

	bool checkOut(1:i64 cartId) throws (1:ShoppingCartException scex),

	/**

	 The second parameter is a map of item ids and their quantities which have been successfully processed.

	 This methods removes the specified quantiry of the specified item from the cart.

	 */

	bool resetCart(1:i64 cartId, 2:map<i64, double> items) throws (1:ShoppingCartException scex),

	/**

	Returns number of registered users.

	If userType = null, then it returns count of all users, including anonymous

	If userType = UserType.ANONYMOUS, then it returns count of anonymous users only

	If userType = UserType.USER, then it returns count of non-anonymous users only

	*/

	i64 getUserCount(1:UserType userType),

	/**

	Returns list of users of type userType who registered between startDate and endDate (both inclusive).

	If any of startDate or endDate is -1, then that filter is ignored. 

	If userType is null, then returns all the users, irrespective of anonymous flag

	*/

	list<User> getAllUsers(1:UserType userType, 2:i64 startDate, 3:i64 endDate),

	/**

	Returns list of item ids in myresearch for the user

	*/

	list<i64> getMyResearchItems(1:i64 userId) throws (1:WidgetException scx),

	/**

	add item to my research for a user

	*/

	bool updateMyResearch(1:i64 userId, 2:i64 itemId) throws (1:WidgetException scx),

	/**

	delete item from my research for a user

	*/

	void deleteItemFromMyResearch(1:i64 userId, 2:i64 itemId) throws (1:WidgetException scx),

	/**

	Returns list of item ids in browse history for the user. It will return maximum 10 items.

	*/

	list<i64> getBrowseHistoryItems(1:i64 userId) throws (1:WidgetException scx),

	/**

	add item to browse history for a user

	*/

	void updateBrowseHistory(1:i64 userId, 2:i64 itemId),

	/**

	Returns count of Carts with given coupon applied

	*/

	i64 getCartsWithCouponCount(1:string couponCode),

	/**

	 * Updates COD trust level of a user

	 */

	oneway void increaseTrustLevel(1:i64 userId, 2:double trustLevelDelta),

	/**

	 * Get trust level of a user

	 */	

	double getTrustLevel(1:i64 userId),

	/**

	 * Returns true/false depending on wether COD is allowed for a cart or not

	 */

	bool showCODOption(1:i64 cartId, 2:i64 sourceId, 3:string pincode),

	/**

	 * Get email addresses for users activated within a given date range

	 */

	list<string> getUserEmails(1:i64 startDate, 2:i64 endDate),

	/**

	 * Mark a cart lineitem as insured. Returns true/false. 

	 */

	 bool insureItem(1:i64 itemId, 2:i64 cartId, 3:bool toInsure),

	 /**

	 * Cancel insurance for all items in the cart

	 */

	 bool cancelInsurance(1:i64 cartId),

	 /**

	 * Stores insurance specific details like date of birth and guardianName

	 */

	 bool storeInsuranceSpecificDetails(1:i64 addressId, 2:string dob, 3:string guardianName),

	 /**

	 * Return true or false based on whether the user has stored any insurance info corresponding to the given addressId

	 */

	 bool isInsuranceDetailPresent(1:i64 addressId)

	/**

	 * Returns whether product is added to cart from startDate to endDate 

	 */

	bool isProductAddedToCart(1:i64 itemId, 2:i64 startDate, 3:i64 endDate)

}