model: refactor add_future_value, add documentation