Skip to content

Commit f3dc7fb

Browse files
mikyllmikyll
authored
Merge pull request #23 from iss2022-BCR/sprint2
Sprint2
2 parents 0b9d904 + 00a6c20 commit f3dc7fb

File tree

299 files changed

+13053
-1644
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

299 files changed

+13053
-1644
lines changed

‎Sprint0/index.html

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -24,8 +24,7 @@
2424
</div>
2525
<a href="resources/userDocs/final_theme.html">Final Theme</a>
2626
<a href="resources/userDocs/requirement_analysis.html">Requirement<br/>Analysis</a>
27-
<a href="resources/userDocs/problem_analysis.html">Problem Analysis</a>
28-
<a href="resources/userDocs/project.html">Project</a>
27+
<a href="resources/userDocs/legend.html">Legend</a>
2928
<a href="resources/userDocs/conclusions.html">Conclusions</a>
3029
<a href="resources/userDocs/team.html">Team</a>
3130
<p class="separator">&mdash;&mdash;&mdash;&ndash;&ndash;&mdash;&mdash;&mdash;</p>

‎Sprint0/resources/userDocs/conclusions.html

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,8 +18,7 @@
1818
<a href="../../index.html">Index</a>
1919
<a href="final_theme.html">Final Theme</a>
2020
<a href="requirement_analysis.html">Requirement<br/>Analysis</a>
21-
<a href="problem_analysis.html">Problem Analysis</a>
22-
<a href="project.html">Project</a>
21+
<a href="legend.html">Legend</a>
2322
<a class="selected" href="conclusions.html">Conclusions</a>
2423
<div class="sidenavSection">
2524
<a href="#Summary">Summary</a>

‎Sprint0/resources/userDocs/final_theme.html

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -33,8 +33,7 @@
3333
</div>
3434
</div>
3535
<a href="requirement_analysis.html">Requirement<br/>Analysis</a>
36-
<a href="problem_analysis.html">Problem Analysis</a>
37-
<a href="project.html">Project</a>
36+
<a href="legend.html">Legend</a>
3837
<a href="conclusions.html">Conclusions</a>
3938
<a href="team.html">Team</a>
4039
<p class="separator">&mdash;&mdash;&mdash;&ndash;&ndash;&mdash;&mdash;&mdash;</p>

‎Sprint0/resources/userDocs/legend.html

Lines changed: 90 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,90 @@
1+
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
2+
<html>
3+
<head>
4+
<title>Sprint0</title>
5+
<link rel="stylesheet" type="text/css" href="../../../commons/resources/styles/templateISS.css">
6+
<link rel="stylesheet" type="text/css" href="../../../commons/resources/styles/main.css">
7+
<link rel="stylesheet" type="text/css" href="../../../commons/resources/styles/navbar.css">
8+
<link rel="stylesheet" type="text/css" href="../../../commons/resources/styles/table.css">
9+
<link rel="stylesheet" type="text/css" href="../../../commons/resources/styles/code.css">
10+
<script type="text/javascript" src="../../../commons/resources/scripts/myScripts.js"></script>
11+
</head>
12+
13+
<body onload="loadNav();">
14+
<div id="openButton" class="openButton" onclick="openNav(true)">&#9776; Menu</div>
15+
<div id="sidenav" class="sidenav">
16+
<a class="closeButton" href="javascript:void(0)" onclick="closeNav(true)">&times;</a>
17+
<a id="currentSprint" class="sprint" href="#">&#8211;&#8212; Sprint0 &#8212;&#8211;</a>
18+
<a href="../../index.html">Index</a>
19+
<a href="final_theme.html">Final Theme</a>
20+
<a href="requirement_analysis.html">Requirement<br/>Analysis</a>
21+
<a class="selected" href="legend.html">Legend</a>
22+
<a href="conclusions.html">Conclusions</a>
23+
<a href="team.html">Team</a>
24+
<p class="separator">&mdash;&mdash;&mdash;&ndash;&ndash;&mdash;&mdash;&mdash;</p>
25+
<a class="sprint" href="../../../Sprint1/index.html">Sprint1</a>
26+
<a class="sprint" href="../../../Sprint2/index.html">Sprint2</a>
27+
<a class="sprint" href="../../../Sprint3/index.html">Sprint3</a>
28+
<bottom-spacer/>
29+
</div>
30+
31+
<div id="main">
32+
<h1 align="center">Legend</h1>
33+
34+
<h2 id="General">General</h2>
35+
36+
<h3 id="Sections">Sections</h3>
37+
The problem analysis will be subdivided in a hierarchy of sections,
38+
denoted by colored boxes:
39+
40+
<ul>
41+
<li>
42+
<h1>Part of the current Sprint</h1>
43+
Only one per file, it represents the document title.
44+
</li>
45+
<li>
46+
<h2>Macro topic</h2>
47+
Groups one or many sub-topics.
48+
</li>
49+
<li>
50+
<h3>Sub-topic</h3>
51+
Concerns a small topic.
52+
</li>
53+
<li>
54+
<h4>Miscellaneous, extras or related content</h4>
55+
Contains extra details or additional information.
56+
</li>
57+
<li>
58+
<div class="remark">Single important parts</div>
59+
Used to remark important parts, independently from the
60+
section/topic location.
61+
</li>
62+
</ul>
63+
64+
<h2 id="Problem-Analysis">Problem Analysis</h2>
65+
Along the analysis, we'll point out some problems which needs to be
66+
analysed, discussed and for wchich one or multiple solution/s
67+
has/have to be found.
68+
<br/><br/>
69+
In general, for each topic or problem, we will have the following blocks:
70+
<ul>
71+
<li>
72+
<problem>The problem</problem>
73+
This is usually followed by a series of questions.
74+
</li>
75+
<li>
76+
<consideration>Considerations, possible solutions or alternatives</consideration>
77+
Contains the densest part of the analysis, where our team discusses
78+
and does brainstorming to try to gather and address each possible aspect
79+
of a problem.
80+
</li>
81+
<li>
82+
<solution>One or more solution described more or less in detail</solution>
83+
Highlights the solution/s that we are going to adopt or try to implement
84+
in the following phases of the sprint.
85+
</li>
86+
</ul>
87+
</div>
88+
</body>
89+
90+
</html>

‎Sprint0/resources/userDocs/problem_analysis.html

Lines changed: 0 additions & 38 deletions
This file was deleted.

‎Sprint0/resources/userDocs/project.html

Lines changed: 0 additions & 38 deletions
This file was deleted.

‎Sprint0/resources/userDocs/requirement_analysis.html

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -44,8 +44,7 @@
4444
</div>
4545
<a href="#Test-Plans">Test Plans</a>
4646
</div>
47-
<a href="problem_analysis.html">Problem Analysis</a>
48-
<a href="project.html">Project</a>
47+
<a href="legend.html">Legend</a>
4948
<a href="conclusions.html">Conclusions</a>
5049
<a href="team.html">Team</a>
5150
<p class="separator">&mdash;&mdash;&mdash;&ndash;&ndash;&mdash;&mdash;&mdash;</p>

‎Sprint0/resources/userDocs/team.html

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,8 +18,7 @@
1818
<a href="../../index.html">Index</a>
1919
<a href="final_theme.html">Final Theme</a>
2020
<a href="requirement_analysis.html">Requirement<br/>Analysis</a>
21-
<a href="problem_analysis.html">Problem Analysis</a>
22-
<a href="project.html">Project</a>
21+
<a href="legend.html">Legend</a>
2322
<a href="conclusions.html">Conclusions</a>
2423
<a class="selected" href="team.html">Team</a>
2524
<p class="separator">&mdash;&mdash;&mdash;&ndash;&ndash;&mdash;&mdash;&mdash;</p>

‎Sprint1/resources/userDocs/problem_analysis.html

Lines changed: 49 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -113,10 +113,11 @@ <h3 id="Waste-Service">Waste Service</h3>
113113
<problem>Service Area Representation</problem>
114114
<b>Problem</b>: How do we represent the Service Area?
115115
<br/>
116-
<solution>
116+
<consideration>
117117
<b>Consideration</b>:
118-
According to the requirements notes, the robot doesn't have to move optimally but shouldn't even wander too much around the room.
119-
<br/>
118+
according to the requirements notes, the robot doesn't have to move optimally but shouldn't even wander too much around the room.
119+
</consideration>
120+
<solution>
120121
<b>Solution</b>:
121122
<ul>
122123
<li>
@@ -220,8 +221,9 @@ <h5 id="Configure-Map-Locations">Configure Map Locations</h5>
220221
<h3 id="Transport-Trolley-and-DDR-Robot">Transport Trolley and DDR Robot</h3>
221222
<problem>Robot Concepts</problem>
222223
<b>Problem</b>: what is the Transport Trolley and what is the DDR Robot?
223-
<solution>
224-
<b>Considerations</b>: The DDR Robot is the final endpoint of the core-business chain,
224+
225+
<consideration>
226+
<b>Considerations</b>: the DDR Robot is the final endpoint of the core-business chain,
225227
the entity that performs the deposit actions and dumps the waste into the containers.
226228
Therefore we can think of it as the actual "robot", which might be real or virtual (e.g. for
227229
simulation purposes).
@@ -240,7 +242,9 @@ <h3 id="Transport-Trolley-and-DDR-Robot">Transport Trolley and DDR Robot</h3>
240242
</tr>
241243
</table>
242244

243-
<br/>
245+
<br/>
246+
</consideration>
247+
<solution>
244248
<b>Solution</b>: we can use the BasicRobot QAK actor, provided by the customer together with unibo.basicRobot22 project,
245249
to have both a <ksi>virtual environment</ksi> to simulate the DDR Robot (WEnv/VirtualRobot), and a <ksi>virtual interface</ksi> to communicate with it (BasicRobot).
246250
<br/><br/>
@@ -417,18 +421,20 @@ <h3 id="Smart-Device-Waste-Service">Smart Device &harr; Waste Service</h3>
417421
<problem>Waste Types</problem>
418422
<b>Problem</b>: how does the smart device know which types of waste can be dumped to the waste service?
419423
<br/>
420-
<b>Possible solution</b>: hard-code the types into the Smart Device.
421-
<br/>
422-
<b>Considerations</b>:
423-
<ol>
424-
<li>
425-
<b>Pros</b>: this is the easiest solution to implement, since they can be just implemented as a list or an enumerative.
426-
</li>
427-
<li>
428-
<b>Cons</b>: not scalable, since it doesn't allow the Waste Service to have different waste containers but
429-
the ones initially specified by the customer in the requirements.
430-
</li>
431-
</ol>
424+
<consideration>
425+
<b>Possible solution</b>: hard-code the types into the Smart Device.
426+
<br/>
427+
<b>Considerations</b>:
428+
<ol>
429+
<li>
430+
<b>Pros</b>: this is the easiest solution to implement, since they can be just implemented as a list or an enumerative.
431+
</li>
432+
<li>
433+
<b>Cons</b>: not scalable, since it doesn't allow the Waste Service to have different waste containers but
434+
the ones initially specified by the customer in the requirements.
435+
</li>
436+
</ol>
437+
</consideration>
432438
<solution>
433439
<b>Better solution</b>: <ksi>ask the Waste Service for the allowed waste types</ksi>, along with the
434440
connection message, and update the Smart Device list to be chosen.
@@ -478,32 +484,36 @@ <h3 id="Smart-Device-Waste-Service">Smart Device &harr; Waste Service</h3>
478484
</li>
479485
</ul>
480486
</solution>
481-
<b>Eventual extra features</b>: having a security layer which allows only trusted devices to send store requests.
482-
This way, by knowing that the smart device will always be an original one (produced and deployed by our
483-
software house), we know for sure that a certain behaviour will be respected,
484-
therefore it won't be possible to send invalid store requests.
485-
487+
<alternative>
488+
<b>Eventual extra features</b>: having a security layer which allows only trusted devices to send store requests.
489+
This way, by knowing that the smart device will always be an original one (produced and deployed by our
490+
software house), we know for sure that a certain behaviour will be respected,
491+
therefore it won't be possible to send invalid store requests.
492+
</alternative>
493+
486494
<problem>Replies and Waste Truck Dismiss</problem>
487495
<b>Problem</b>: when is the reply sent and what message do we send? Do we introduce other messages apart from loadaccepted and loadrejected?
488496
How do we know immediately if the Waste Service can store the waste of a new request? How can we meet the requirement that
489497
the waste truck must be sent away as soon as possible?
490498
<br/>
491-
<b>Considerations</b>:
492-
<ul>
493-
<li>
494-
The Waste Service might receive a new request while it is handling another one.
495-
</li>
496-
<li>The pickup action takes some time (a defined and known amount).</li>
497-
<li>
498-
If the Smart Device sends a request while there is another deposit action
499-
in progress, it must wait it to be completed.
500-
</li>
501-
<li>
502-
If we're able to know if the load can be deposited as soon as we receive the request,
503-
we could reply instantly, and therefore meet the <em>requirement</em> that the truck driver must
504-
be sent away <i>as soon as possible</i>.
505-
</li>
506-
</ul>
499+
<consideration>
500+
<b>Considerations</b>:
501+
<ul>
502+
<li>
503+
The Waste Service might receive a new request while it is handling another one.
504+
</li>
505+
<li>The pickup action takes some time (a defined and known amount).</li>
506+
<li>
507+
If the Smart Device sends a request while there is another deposit action
508+
in progress, it must wait it to be completed.
509+
</li>
510+
<li>
511+
If we're able to know if the load can be deposited as soon as we receive the request,
512+
we could reply instantly, and therefore meet the <em>requirement</em> that the truck driver must
513+
be sent away <i>as soon as possible</i>.
514+
</li>
515+
</ul>
516+
</consideration>
507517
<solution>
508518
<b>Adopted solution</b>:
509519
<ul>

‎Sprint2/Sprint2_ProblemAnalysis/.idea/.name

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)