Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Newer
Older
100644 208 lines (139 sloc) 7.577 kB
b8ed774 updated README/TasksPlan
Suvajit Gupta authored
1 GETTING TASKS & SPROUTCORE CODE
3a807c8 updated README
Suvajit Gupta authored
2 ==============================================================================
997ae12 added to README
Suvajit Gupta authored
3
c4838ed updated README
Suvajit Gupta authored
4 Change to the directory where you would like to work on Tasks and type...
997ae12 added to README
Suvajit Gupta authored
5
c4838ed updated README
Suvajit Gupta authored
6 git clone git://github.com/suvajitgupta/Tasks.git tasks
f310e65 Minor layout adjustments after merging 'touch' branch
Suvajit Gupta authored
7 cd tasks/frameworks
a3607fe updated README to use specific SCUI/SCUDS
Suvajit Gupta authored
8 git clone git://github.com/suvajitgupta/sproutcore.git
9c817e6 Switch to Sai master
Suvajit Gupta authored
9 git clone git://github.com/FrozenCanuck/Ki.git ki
dacd628 Updated GAE README steps
Suvajit Gupta authored
10 git clone git://github.com/etgryphon/sproutcore-ui.git scui
2b62d17 Updated README
Suvajit Gupta authored
11 git clone git://github.com/etgryphon/sai.git
690b68f Updated Tasks Plan & README
Suvajit Gupta authored
12 git clone git://github.com/etgryphon/sproutcore-uds.git scuds
29fa996 Switched back to SCUDS master
Suvajit Gupta authored
13 cd ../
e29b4b6 Added README explaining how to run Tasks and the Persevere server.
Sean Eidemiller authored
14
b81c4ef added Ruby gem update step
Suvajit Gupta authored
15 If you don't have the latest Ruby gems, type...
16
17 sudo gem install thor
18
bab7af8 updated README
Suvajit Gupta authored
19
e29b4b6 Added README explaining how to run Tasks and the Persevere server.
Sean Eidemiller authored
20 RUNNING PERSEVERE
21 ==============================================================================
22
3a807c8 updated README
Suvajit Gupta authored
23 To start the Persevere server...
e29b4b6 Added README explaining how to run Tasks and the Persevere server.
Sean Eidemiller authored
24
9750fba Reorganized documents/scripts into folders
Suvajit Gupta authored
25 ./scripts/server-start.sh
e29b4b6 Added README explaining how to run Tasks and the Persevere server.
Sean Eidemiller authored
26
3a807c8 updated README
Suvajit Gupta authored
27 To stop the Persevere server...
e29b4b6 Added README explaining how to run Tasks and the Persevere server.
Sean Eidemiller authored
28
9750fba Reorganized documents/scripts into folders
Suvajit Gupta authored
29 ./scripts/server-stop.sh
e29b4b6 Added README explaining how to run Tasks and the Persevere server.
Sean Eidemiller authored
30
dacd628 Updated GAE README steps
Suvajit Gupta authored
31 PERSEVERE USER CREATION
e29b4b6 Added README explaining how to run Tasks and the Persevere server.
Sean Eidemiller authored
32 ==============================================================================
33
635264d updated README
Suvajit Gupta authored
34 After starting the Persevere server (see above), run a script to create the
35 first user (after which you can log into Tasks and use the User Manager GUI):
e29b4b6 Added README explaining how to run Tasks and the Persevere server.
Sean Eidemiller authored
36
9750fba Reorganized documents/scripts into folders
Suvajit Gupta authored
37 ./scripts/user-add.sh 'System Admin' 'SA' 'Manager' localhost:8088
5a70f72 completed Task ID routing
Suvajit Gupta authored
38 (enter/reenter password and remember it!)
39
9750fba Reorganized documents/scripts into folders
Suvajit Gupta authored
40 ./scripts/user-add.sh 'Guest User' 'guest' 'Guest' localhost:8088
5a70f72 completed Task ID routing
Suvajit Gupta authored
41 (press Enter twice to create a blank password)
81ec209 updated instructions in README
Suvajit Gupta authored
42
635264d updated README
Suvajit Gupta authored
43 ADMINISTERING PERSEVERE
44 ==============================================================================
45
46 Navigate to the following URL to directly manipulate Persevere data:
47
48 http://localhost:8088/tasks-server/explorer.html
49
bab7af8 updated README
Suvajit Gupta authored
50
e29b4b6 Added README explaining how to run Tasks and the Persevere server.
Sean Eidemiller authored
51 RUNNING TASKS
52 ==============================================================================
53
0a4e5cc merged with latest server
Suvajit Gupta authored
54 1) Start the SproutCore server...
e29b4b6 Added README explaining how to run Tasks and the Persevere server.
Sean Eidemiller authored
55
f310e65 Minor layout adjustments after merging 'touch' branch
Suvajit Gupta authored
56 sc-server --port 4400
e29b4b6 Added README explaining how to run Tasks and the Persevere server.
Sean Eidemiller authored
57
bab7af8 updated README
Suvajit Gupta authored
58 2) Navigate to the following URL...
e29b4b6 Added README explaining how to run Tasks and the Persevere server.
Sean Eidemiller authored
59
8c1387e updated README to use another port
Suvajit Gupta authored
60 http://localhost:4400/tasks
e29b4b6 Added README explaining how to run Tasks and the Persevere server.
Sean Eidemiller authored
61
b419f32 updated README instructions
Suvajit Gupta authored
62 3) Enter 'SA' in the dialog box and the password you set earlier and press Enter.
b72dbf3 updated instructions in README
Suvajit Gupta authored
63 The Tasks GUI should come up.
e29b4b6 Added README explaining how to run Tasks and the Persevere server.
Sean Eidemiller authored
64
bab7af8 updated README
Suvajit Gupta authored
65 4) Add a project, add tasks to it, hit Save periodically, have fun!
78d0898 updated instructions in README
Suvajit Gupta authored
66 Alternatively, to get some sample data to play with, you can click
67 on the Import button and paste in the contents of the file:
68
69 apps/tasks/tests/data/import_data.txt
3a807c8 updated README
Suvajit Gupta authored
70
71
f8e7903 added Tasks GAE deployment instructions
Suvajit Gupta authored
72 GOOGLE APP ENGINE (GAE) DEPLOYMENT
73 ==============================================================================
74 If you want to deploy Tasks on the cloud, you can get a GAE account and deploy it:
75
76 1) If you don't have a GAE account, sign up here:
77 http://code.google.com/appengine/
78
79 2) Download the GAE SDK if you don't have it (link for Mac below):
80 http://googleappengine.googlecode.com/files/GoogleAppEngineLauncher-1.2.8.dmg
81
82 3) Install sproutcore as a gem if you haven't done that already:
83 sudo gem install sproutcore
84
dacd628 Updated GAE README steps
Suvajit Gupta authored
85 4) Build Tasks for deploymente...
86 sc-build -rc --build=<build-name>
f8e7903 added Tasks GAE deployment instructions
Suvajit Gupta authored
87
dacd628 Updated GAE README steps
Suvajit Gupta authored
88 5) Get the Tasks-GAE server code:
f8e7903 added Tasks GAE deployment instructions
Suvajit Gupta authored
89 cd ../
dacd628 Updated GAE README steps
Suvajit Gupta authored
90 git clone git://github.com/joshholt/SproutCoreTasks-AppEngineBackend.git <app-name>
c30e92d updated README
Suvajit Gupta authored
91 cd tasks
f8e7903 added Tasks GAE deployment instructions
Suvajit Gupta authored
92
dacd628 Updated GAE README steps
Suvajit Gupta authored
93 6) After sc-build finishes, copy tasks production build for deployment on GAE:
94 cp -r tmp/build/static ../<app-name>
f8e7903 added Tasks GAE deployment instructions
Suvajit Gupta authored
95
96 7) Inform GAE about production build:
dacd628 Updated GAE README steps
Suvajit Gupta authored
97 cd ../<app-name>
98 <your-favorite-editor> app.yaml
99 - replace <app-name> on first line
100 - replace <build-name> globally
f8e7903 added Tasks GAE deployment instructions
Suvajit Gupta authored
101
102 8) On a Mac, run GoogleAppEngineLauncher (downloaded with GAE SDK earlier):
103 From 'File' menu, choose 'Add Existing Application...'
dacd628 Updated GAE README steps
Suvajit Gupta authored
104 Browse to <app-name> and press 'Choose', then press 'Add' button
f8e7903 added Tasks GAE deployment instructions
Suvajit Gupta authored
105
106 9) Now deploy to the cloud by pressing 'Deploy'
107 Sign up on Tasks running on GAE deployment at http://<application identifier>.appspot.com
dacd628 Updated GAE README steps
Suvajit Gupta authored
108 You can use the GAE 'Dashboard' button at top right and modify User roles. Example below:
f8e7903 added Tasks GAE deployment instructions
Suvajit Gupta authored
109 Click on 'Data Viewer' under Datastore section on left
110 Select 'User' table from select field view
111 Click id of user and change 'role' to '_Manager'
112 Login to Tasks now and start adding projects/tasks/users...
113
dacd628 Updated GAE README steps
Suvajit Gupta authored
114 GOOGLE APP ENGINE (GAE) DEPLOYMENT (Fast Path)
115 ==============================================================================
116
117 1.) Run the following command from inside Tasks' root directory
118 > python tasks.py setup <app-name> <build-name>
119
120 2.) Then follow steps 8 & 9 below in the GOOGLE APP ENGINE DEPLOYMENT
121
f8e7903 added Tasks GAE deployment instructions
Suvajit Gupta authored
122
f2ef997 Added Lebowski steps to README
Suvajit Gupta authored
123 RUNNING LEBOWSKI
124 ==============================================================================
125
126 1) From another terminal window, run the Lebowski server:
127 lebowski-start-server
128
129 2) From another terminal window, run Lebowski scripts:
130 cd spec
5c1b0fb Lebowski scripts update
Suvajit Gupta authored
131 lebowski-spec -f n main.rb
f2ef997 Added Lebowski steps to README
Suvajit Gupta authored
132
133 3) Before reruning step (2), stop Lebowski server (Control-C) and restart it (Step 1)
134
135
b8ed774 updated README/TasksPlan
Suvajit Gupta authored
136 TASKS OVERVIEW
137 ==============================================================================
138
b1b035c updated REAME overview
Suvajit Gupta authored
139 Welcome to "Tasks!" - it was created for a few reasons:
b8ed774 updated README/TasksPlan
Suvajit Gupta authored
140
b1b035c updated REAME overview
Suvajit Gupta authored
141 1. To become a comprehensive sample application that goes beyond "hello world"
b8ed774 updated README/TasksPlan
Suvajit Gupta authored
142 examples (like "clock") and snippets showing off facets of SproutCore
143 (like "drag"). SproutCore is very elegant and powerful framework and my
0e2a918 updated README
Suvajit Gupta authored
144 goal is to use Tasks to ramp up as well as showcase its capabilities on the
145 desktop and iPad with a single application.
b8ed774 updated README/TasksPlan
Suvajit Gupta authored
146
147 2. To illustrate how to engineer a non-trivial application using things like
148 a task plan (scope/assignments), wireframes/mockups (vision/GUI design),
149 statecharts/MVC structure (technical design), and integration with a remote
150 server via REST/JSON.
151
152 3. We all build software and "Tasks" can become your agile software management
153 tool - you won't need the cumbersome task tracking & bean counting tools
154 overhead staff like to justify their existence with :-)
155
0e2a918 updated README
Suvajit Gupta authored
156 4. Last year, SproutCore has undergone an explosive launch and maturation.
157 During this metamorphosis, Tasks has become the SproutCore issue tracking tool
158 What better that an application built with SproutCore itself!
b8ed774 updated README/TasksPlan
Suvajit Gupta authored
159
0e2a918 updated README
Suvajit Gupta authored
160 Tasks is "in progress" - I plan tom ature it into a tool to manage the development
161 of very complex applications. I hope you will find Tasks useful as you start your
162 journey with SproutCore. Please send me your feedback or code contributions!
b8ed774 updated README/TasksPlan
Suvajit Gupta authored
163
164 -Suvajit Gupta (suvajit.gupta@eloqua.com)
165
166
3a807c8 updated README
Suvajit Gupta authored
167 TASKS ARTIFACTS
168 ==============================================================================
169
170 To start getting oriented with Tasks, scan the following artifacts in the
171 docs/ folder:
172
173 1. TasksPlan.txt: shows the work breakdown and assignments - feel free to pick
174 up an item that is not "Done" and hack away at it!
175
176 2. TasksWireframe.png: shows the initial GUI design with callouts explaining
177 the key functionality.
178
179 3. TasksMockup*.png: shows the visual design concepts we used to style Tasks.
180
181 4. TasksStatecharts.pdf: shows the states/transitions within the GUI.
182
183 5. TasksControllers.pdf: shows how the various controllers are wired together
184 and how the views relate to them (implementing thge root controller pattern).
185
186 6. TasksAPI.xml: drag this file into your browser - the files in the "include"
187 folder render this specification in a nice format for you to understand the
188 REST API endpoints.
189
190 7. TasksJSON.xml: documents the model object structure for what is sent to the
191 server via REST calls.
192
193 8. TasksFileFormat.txt: Shows the simple/intuitive syntax for importing data
194 into and exporting data from Tasks. In fact, the TasksPlan.txt is itself
195 written in this format and can be imported into Tasks!
291aa10 reorganized dock button layout/updated FIXMEs
Suvajit Gupta authored
196
197
198 TASKS ATTRIBUTIONS
199 ==============================================================================
200
201 The filter on/off icons:
202 Diagona Icons
203 Copyright (C) 2007 Yusuke Kamiyamane. All rights reserved.
204 The icons are licensed under a Creative Commons Attribution 3.0 license.
205
206 The color indicators on the filter icon, as well as numerous other icons in Tasks:
207 Silk icon set 1.3
635264d updated README
Suvajit Gupta authored
208 Mark James - http://www.famfamfam.com/lab/icons/silk/
Something went wrong with that request. Please try again.