05．はじめてスマホアプリを作ってみた（開発フェーズ）

using System;
using OneThird.Domain.Exceptions;
using OneThird.Domain.Models.Slogs.ValueObjects;

namespace OneThird.Domain.Models.Slogs
{
    /// <summary>
    /// 睡眠記録のEntityクラス
    /// ・WakeupDateTimeはSleepDateTimeより後であること
    /// ・WakeUpdateの日付はTargetDateと同じであること
    /// ・SleepDateTimeはTargetDateの前日17時からTargetDate当日16時59分までであること
    /// </summary>
    public class SlogEntity : Entity<SlogId>
    {
        /// <summary> コンストラクタ (Create) </summary>
        /// <param name="slogId">SlogId</param>
        /// <param name="targetDate">TargetDate</param>
        /// <param name="sleepDateTime">SleepDateTime</param>
        /// <param name="wakeupDateTime">WakeupDateTime</param>
        /// <param name="rating">Rating</param>
        /// <param name="note">Note</param>
        /// <param name="userId">UserId</param>
        public SlogEntity(
            SlogId slogId,
            TargetDate targetDate,
            SleepDateTime sleepDateTime,
            WakeupDateTime wakeupDateTime,
            Rating rating,
            Note note,
            UserId userId)
        {
            Id = slogId ?? throw new ArgumentNullException(nameof(slogId));
            TargetDate = targetDate ?? throw new ArgumentNullException(nameof(targetDate));
            SleepDateTime = sleepDateTime ?? throw new ArgumentNullException(nameof(sleepDateTime));
            WakeupDateTime = wakeupDateTime ?? throw new ArgumentNullException(nameof(wakeupDateTime));
            Rating = rating ?? throw new ArgumentNullException(nameof(rating));
            Note = note ?? throw new ArgumentNullException(nameof(note));
            UserId = userId ?? throw new ArgumentNullException(nameof(userId));

            ValidatePreAndPostDates(sleepDateTime, wakeupDateTime);
            ValidateSleepDateTime(sleepDateTime);
            ValidateWakeupDateTime(wakeupDateTime);
        }

        /// <summary> Gets TargetDate </summary>
        public TargetDate TargetDate { get; }

        /// <summary> Gets SleepDateTime </summary>
        public SleepDateTime SleepDateTime { get; }

        /// <summary> Gets WakeupDateTime </summary>
        public WakeupDateTime WakeupDateTime { get; }

        /// <summary> Gets Rating </summary>
        public Rating Rating { get; }

        /// <summary> Gets Note </summary>
        public Note Note { get; }

        /// <summary> Gets UserId </summary>
        public UserId UserId { get; }

        /// <summary> 睡眠時間(TimeSpan) </summary>
        public TimeSpan SleepHours => WakeupDateTime.Value - SleepDateTime.Value;

        /// <summary>
        /// 起床日時(WakeupDateTime)の日付が対象日付(TargetDate)と同日であると
        /// </summary>
        /// <param name="target">SleepDateTime</param>
        private void ValidateWakeupDateTime(WakeupDateTime target)
        {
            if (target.Value.Date != TargetDate.Value)
            {
                throw new OutOfRangeException($"{nameof(WakeupDateTime)}:{target.Value}");
            }
        }

        /// <summary>
        /// SleepDateTime の条件 - 以下２条件を満たすこと
        ///   Condition A : TargetDateの前日17:00 ～ 当日16:59の範囲内
        /// ・Condition B : または、TargetDateの当日17:00以降の場合、
        ///                WakeupDateTimeが当日23:59以前
        /// </summary>
        /// <param name="sleepDateTime">SleepDateTime</param>
        private void ValidateSleepDateTime(SleepDateTime sleepDateTime)
        {
            if (!GetResultOfConditionA(sleepDateTime) &&
                !GetResultOfConditionB(sleepDateTime))
            {
                throw new OutOfRangeException(
                    $"{nameof(SleepDateTime)}:{sleepDateTime.Value}");
            }
        }

        // Condition A : TargetDateの前日17:00 ～ 当日16:59の範囲内
        private bool GetResultOfConditionA(SleepDateTime sleepDateTime)
        {
            var conditionStart = TargetDate.Value.Date.AddDays(-1).AddHours(17);
            var conditionEnd = TargetDate.Value.Date.Add(new TimeSpan(16, 59, 59));

            return conditionStart <= sleepDateTime.Value &&
                   sleepDateTime.Value <= conditionEnd;
        }

        // Condition B : または、TargetDateの当日17:00以降の場合、
        //              WakeupDateTimeが当日23:59以前
        private bool GetResultOfConditionB(SleepDateTime sleepDateTime)
        {
            var condition1 = TargetDate.Value.Date.AddHours(17);
            var condition2 = TargetDate.Value.Date.Add(new TimeSpan(23, 59, 59));

            return condition1 <= sleepDateTime.Value &&
                   WakeupDateTime.Value <= condition2;
        }

        /// <summary> 睡眠日時と起床日時の前後関係を検証する </summary>
        /// <param name="sleepDateTime">SleepDateTime</param>
        /// <param name="wakeupDateTime">WakeupDateTime</param>
        private void ValidatePreAndPostDates(SleepDateTime sleepDateTime, WakeupDateTime wakeupDateTime)
        {
            if (sleepDateTime.Value > wakeupDateTime.Value)
            {
                throw new PreAndPostDateException(
                    $"Sleep DateTime:{sleepDateTime.Value.ToString("yyyy/MM/dd hh:mm")}{Environment.NewLine}Wakeup DateTime:{wakeupDateTime.Value.ToString("yyyy/MM/dd hh:mm")}");
            }
        }
    }
}

using System.Collections.Generic;
using System.Threading.Tasks;
using OneThird.Domain.Models.Slogs.ValueObjects;
using OneThird.Domain.Models.YearMonths;

namespace OneThird.Domain.Models.Slogs
{
    /// <summary> SlogRepository Interface </summary>
    public interface ISlogRepository
    {
        /// <summary> Save new Entity </summary>
        /// <param name="slogEntity">target SlogEntity</param>
        /// <returns>Task</returns>
        Task SaveAsync(SlogEntity slogEntity);

        /// <summary> Delete Entity </summary>
        /// <param name="slogEntity">target SlogEntity</param>
        /// <returns>Task</returns>
        Task DeleteAsync(SlogEntity slogEntity);

        /// <summary> Find one entity by Guid </summary>
        /// <param name="slogEntity">target SlogEntity</param>
        /// <returns>a entity</returns>
        Task<SlogEntity> FindAsync(SlogEntity slogEntity);

        /// <summary> Find all entities </summary>
        /// <param name="userId">target UserId</param>
        /// <returns>IEnumerable entities</returns>
        Task<IEnumerable<SlogEntity>> FindAllAsync(UserId userId);

        /// <summary> 特定期間を指定したクエリメソッド実装 </summary>
        /// <param name="userId">target UserId</param>
        /// <param name="fromDate">from TargetDate</param>
        /// <param name="toDate">targetto TargetDate</param>
        /// <returns>IEnumerable SlogEntities</returns>
        Task<IEnumerable<SlogEntity>> FindSpecificPeriod(UserId userId, TargetDate fromDate, TargetDate toDate);

        /// <summary> TargetDateの年と月をDistinctで取得する </summary>
        /// <param name="userId">target UserId</param>
        /// <returns>IEnumerable YearMonthEntity</returns>
        Task<IEnumerable<YearMonthEntity>> GetYearMonthOfTargetDateWithNoDuplicatesAsync(UserId userId);
    }
}