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 AddressType{

	WORK = 0,

	HOME = 1

}

enum PhoneType{

	WORK = 0,

	HOME = 1,

	MOBILE = 2

}

enum AccountStatus{

	ACTIVE = 0,

	DELETED = 1,

	INACTIVE = 2,

	INCOMPLETE = 3

}

/**

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,

	PRODUCT_QUESTION = 7,

	OTHER = 8

}

/**

Affiliate track log types for affiliate tracking

*/

enum TrackLogType{

    NEW_REGISTRATION = 1,

    PAYMENT_SUCCESS = 2

}

/**

All the social handles

*/

struct SocialHandles{

	1:string facebook,

	2:string opensocial,

	3:string twitter

}

/**

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

}

/**Phone

**/

struct Phone{

	1:i64 id,

	2:string countryCode,

	3:string areaCode,

	4:string number,

	5:string extension,

	6:PhoneType type

}

/**

Internal information to be used by system. various variables which aid in serving the user are identified and put here

**/

struct UserInternalInfo{

	1:i64 userId,

	2:i64 geoZone,

	3:i64 shipmentZone,

	4:i64 taxZone,

	5:double userRankScore

}

/**

structure representing timestamp and ip at which user logged into the system

**/

struct IPMap{

	1:i64 timestamp

	2:string ip

}

/**

dynamic user state 

**/

struct UserState{

	1:i64 userId,

	2:i64 lastLogin,

	3:i64 lastLogout,

	4:i64 emailVerificationSentOn,

	5:i64 smsVerificationSentOn,

	6:bool isEmailVerified,

	7:bool isSMSVerified,

	8:i64 activeSince,

	9:list<IPMap> ips,

	10:AccountStatus status

}

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:SocialHandles socialHandles,

	9:list<Address> addresses,

	10:i64 defaultAddressId,

	11:string communicationEmail,

	12:i64 activeCartId,

	13:string jsessionId,

	14:bool isAnonymous,

	15:string source,

	16:i64 sourceStartTime,

	17: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

}

struct UserNote{

	1:i64 user_id,

	2:i64 entity_id,

	3:string slide,

	4:string note

}

//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

}

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 userId,			//user id to which it belongs

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

	9:double totalPrice,

	10:double discountedPrice,

	11:string couponCode

}

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

}

/**

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),

	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),

    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),

    /**

     Returns a list of active coupons

     */

    list<Coupon> getActiveCoupons() 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)

}

/**

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 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),

	bool deleteUser(1:i64 userId) throws (1:UserContextException ucex),

	UserState getUserState(1:i64 userId) 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)

	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)

	i64 createCart(1:i64 userId) throws (1:ShoppingCartException scx),

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

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

	list<Cart> getCartsForUser(1:i64 userId, 2:CartStatus status) throws (1:ShoppingCartException scx),

	list<Cart> getCartsByStatus(1:CartStatus status) throws (1:ShoppingCartException scx),

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

	void changeCartStatus(1:i64 cartId, 2: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 changeItemStatus(1:i64 cartId, 2:i64 itemId, 3:LineStatus status) throws (1:ShoppingCartException scx),

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

	void applyCouponToCart(1:i64 cartId, 2:string couponCode, 3:double totalPrice, 4:double discountedPrice) 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) 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.

	*/

	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),

	void putUserNote(1:i64 user_id, 2:i64 entity_id, 3:string slide, 4:string note),

	list<UserNote> getUserNotes(1:i64 user_id, 2:i64 entity_id),

	/**

	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)

}